{"id":25979201,"url":"https://github.com/neurarian/matshell","last_synced_at":"2025-03-05T06:28:55.172Z","repository":{"id":242291822,"uuid":"809153262","full_name":"Neurarian/matshell","owner":"Neurarian","description":"Simple Astal multi-monitor desktop shell config.","archived":false,"fork":false,"pushed_at":"2025-03-04T22:10:52.000Z","size":142,"stargazers_count":6,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-04T22:29:49.384Z","etag":null,"topics":["ags","astal","dotfiles","hyprland","linux","material-design"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Neurarian.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-06-01T21:09:31.000Z","updated_at":"2025-03-04T22:10:56.000Z","dependencies_parsed_at":null,"dependency_job_id":"d1826e92-1fc4-4a20-8469-4d39df55fdab","html_url":"https://github.com/Neurarian/matshell","commit_stats":null,"previous_names":["neurarian/ags-bar","neurarian/matshell"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Neurarian%2Fmatshell","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Neurarian%2Fmatshell/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Neurarian%2Fmatshell/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Neurarian%2Fmatshell/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Neurarian","download_url":"https://codeload.github.com/Neurarian/matshell/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241978438,"owners_count":20051981,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ags","astal","dotfiles","hyprland","linux","material-design"],"created_at":"2025-03-05T06:28:54.626Z","updated_at":"2025-03-05T06:28:55.162Z","avatar_url":"https://github.com/Neurarian.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Simple Material Design desktop shell made with [Astal](https://github.com/Aylur/astal)\n\nThis is heavily inspired by [fufexan's](https://github.com/fufexan/dotfiles) AGSv1 config, tailored to personal taste and my multi-monitor desktop setup on [hyprland](https://github.com/hyprwm/Hyprland). This can be dynamically themed either with the color-theme generation scripts that I yanked and botched from [end-4](https://github.com/end-4/dots-hyprland), or together with the [matugen](https://github.com/InioX/matugen) templates also included here. Some snippets for CPU / RAM widgets are inspired by [AhmedSaadi0](https://github.com/AhmedSaadi0/my-hyprland-config/tree/main). The design is also influenced by [saimoomedits](https://github.com/saimoomedits/eww-widgets).\n\n______________________________________________________________________\n\n### ⛓️ Dependencies\n\n\u003cdetails\u003e\n  \u003csummary\u003eshow dependency list\u003c/summary\u003e\n\n#### Required:\n\n- astal\n- ags\n- hyprland\n- adw-gtk3-git\n- adwaita-icon-theme\n- coreutils\n- dart-sass\n- gawk\n- imagemagick\n- procps-ng\n- ripgrep\n- util-linux\n- Material Symbols Outlined Font\n- ***For the end-4 scripts:***\n  - python-materialyoucolor-git\n  - gradience-git\n  - python-libsass\n  - python-material-color-utilities\n  - python-build\n  - python-pillow\n  - python-pywal\n  - python-setuptools-scm\n  - python-wheel\n- ***For matugen:***\n  - matugen\n  - [image-hct](https://github.com/Neurarian/NixOS-config/tree/master/packages/image-hct) (optional; for additional chroma/tone based theming)\n\n#### Not required but launched by Astal widgets:\n\n- gnome-control-center\n- mission-center\n- overskride\n- pwvucontrol\n\n\u003c/details\u003e\n\n### 🛠️ Installation\n\n**Before you start make sure to create a backup of your current config if you want to keep it!**\n\nClone this repo...\n\n```console\ngit clone https://github.com/Neurarian/matshell\n```\n\n... and link/move/copy its content into ~/.config/astal or your stowed ags dotfiles directory. E.g.\n\n```console\nmv matshell ~/.config/astal\n```\n\nFor the color generation with the end-4-scripts to work, run this command to create the necessary additional directories:\n\n```console\nmkdir -p $XDG_STATE_HOME/astal/{scss,user} $XDG_CACHE_HOME/astal/user/generated\n```\n\nAfter using hyprpaper or some other means to set your wallpaper, run the script from [end-4](https://github.com/end-4/dots-hyprland) like this:\n\n```console\n$HOME/.config/astal/scripts/colorgen.sh \"$HOME/.cache/current_wallpaper.jpg\" --apply --smart\n```\n\nThe color generation works better with wallpapers that have a bit of contrast.\nFor a NixOS implementation and example [script](https://github.com/Neurarian/NixOS-config/blob/master/home/Liqyid/common/optional/scripts/wal_set.nix) for use with hyprpaper, matugen, and a [custom cli utility](https://github.com/Neurarian/NixOS-config/tree/master/packages/image-hct) to get chroma/tone, check my [NixOS-config](https://github.com/Neurarian/NixOS-config).\n\n______________________________________________________________________\n\n### 🌚 Dark example\n\n![screenshot-20240602-010310](https://github.com/Neurarian/ags-bar/assets/110474238/39baf677-26bf-402a-8d33-8a8cd326bbe3)\n\n![screenshot-20240602-010238](https://github.com/Neurarian/ags-bar/assets/110474238/e3e87c15-e8f4-481c-b71a-1625542887d1)\n\n______________________________________________________________________\n\n### 🌞 Light example\n\n![screenshot-20240602-010428](https://github.com/Neurarian/ags-bar/assets/110474238/4efbb62d-b416-44e2-a044-92e4704b3d83)\n\n![screenshot-20240602-005946](https://github.com/Neurarian/ags-bar/assets/110474238/36195074-559a-4a52-ba26-96869a512db1)\n\n______________________________________________________________________\n\nhttps://github.com/Neurarian/ags-bar/assets/110474238/3f01073e-552a-479b-99f9-d82647138e55\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fneurarian%2Fmatshell","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fneurarian%2Fmatshell","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fneurarian%2Fmatshell/lists"}