Something went wrong. Try again.
Hyprland / Quickshell setup
Something went wrong. Try again.
Files
- QML 90%
- Lua 5%
- Shell 5%
- GLSL <1%
- CSS <1%
README.md
# tsubasa
Hyprland + Quickshell setup: bar, launcher, notifications, OSD, overview, power menu, theme switcher, wallpaper picker and monitor manager. Adwaita-dark GTK, Yaru-purple icons and macOS-style font rendering.
Not tied to a distro: install the packages below with your package manager,
then run `install.sh`.
Incorporates run-or-raise, agent status dots on workspaces (supports CC + Codex + OC + Crush + pi), webapp installation from the launcher, widgets for Bluetooth / WiFi and a notification centre.
## Screenshots
<details>
<summary>Desktop, tiling, launcher</summary>



</details>
## Layout
```
config/<name>/ → ~/.config/<name>
config/quickshell/doannc → ~/.config/quickshell/doannc (state files stay outside the repo)
home/ → ~/.bashrc, ~/.bash_profile
bin/ → ~/.local/bin
sddm/ optional login screen theme config (see extras.sh sddm_theme)
install.sh symlinks + GTK settings; safe to rerun
extras.sh user-level builds of things many distros don't package; safe to rerun
```
`install.sh` moves anything already at a target aside to `<name>.pre-dotfiles`.
## Install
1. **Packages.** Names vary by distro; install what yours calls these.
| For | Packages |
|---|---|
| Desktop | hyprland (with Lua config support), xdg-desktop-portal-hyprland, xdg-desktop-portal-gtk, hyprlock, hypridle, hyprpolkitagent, hyprpaper, hyprpicker, hyprsunset |
| Shell | quickshell (0.3+, with `Quickshell.Networking`), Qt 6 wayland/declarative/multimedia/svg, jq, NetworkManager, pipewire + wireplumber, bluez |
| Tools | grim, slurp, wl-clipboard, playerctl, brightnessctl, libnotify (`notify-send`), alacritty, nautilus |
| Look | adw-gtk3, Yaru icon theme, Ubuntu fonts, Verdana (MS core fonts), Noto Sans / CJK / Color Emoji, Nerd Font symbols, M+ Nerd Font |
| Optional | matugen or wallust (colours from wallpaper), sa…