https://github.com/neurarian/matshell
Simple Astal multi-monitor desktop shell config.
https://github.com/neurarian/matshell
ags astal dotfiles hyprland linux material-design
Last synced: over 1 year ago
JSON representation
Simple Astal multi-monitor desktop shell config.
- Host: GitHub
- URL: https://github.com/neurarian/matshell
- Owner: Neurarian
- License: gpl-3.0
- Created: 2024-06-01T21:09:31.000Z (about 2 years ago)
- Default Branch: master
- Last Pushed: 2025-03-04T22:10:52.000Z (over 1 year ago)
- Last Synced: 2025-03-04T22:29:49.384Z (over 1 year ago)
- Topics: ags, astal, dotfiles, hyprland, linux, material-design
- Language: TypeScript
- Homepage:
- Size: 139 KB
- Stars: 6
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Simple Material Design desktop shell made with [Astal](https://github.com/Aylur/astal)
This 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).
______________________________________________________________________
### ⛓️ Dependencies
show dependency list
#### Required:
- astal
- ags
- hyprland
- adw-gtk3-git
- adwaita-icon-theme
- coreutils
- dart-sass
- gawk
- imagemagick
- procps-ng
- ripgrep
- util-linux
- Material Symbols Outlined Font
- ***For the end-4 scripts:***
- python-materialyoucolor-git
- gradience-git
- python-libsass
- python-material-color-utilities
- python-build
- python-pillow
- python-pywal
- python-setuptools-scm
- python-wheel
- ***For matugen:***
- matugen
- [image-hct](https://github.com/Neurarian/NixOS-config/tree/master/packages/image-hct) (optional; for additional chroma/tone based theming)
#### Not required but launched by Astal widgets:
- gnome-control-center
- mission-center
- overskride
- pwvucontrol
### 🛠️ Installation
**Before you start make sure to create a backup of your current config if you want to keep it!**
Clone this repo...
```console
git clone https://github.com/Neurarian/matshell
```
... and link/move/copy its content into ~/.config/astal or your stowed ags dotfiles directory. E.g.
```console
mv matshell ~/.config/astal
```
For the color generation with the end-4-scripts to work, run this command to create the necessary additional directories:
```console
mkdir -p $XDG_STATE_HOME/astal/{scss,user} $XDG_CACHE_HOME/astal/user/generated
```
After 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:
```console
$HOME/.config/astal/scripts/colorgen.sh "$HOME/.cache/current_wallpaper.jpg" --apply --smart
```
The color generation works better with wallpapers that have a bit of contrast.
For 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).
______________________________________________________________________
### 🌚 Dark example
______________________________________________________________________
### 🌞 Light example
______________________________________________________________________
https://github.com/Neurarian/ags-bar/assets/110474238/3f01073e-552a-479b-99f9-d82647138e55