docs: update README for swaync, cliphist service, /usr/bin paths
All checks were successful
Update PKGBUILD version / update-pkgver (push) Successful in 2s

- dunst → swaync throughout
- Clipboard section: cliphist + Walker, wiped on session start
- Helper scripts: /usr/local/bin → /usr/bin (package-managed)
- User services: moved to /etc/systemd/user/, added cliphist/nautilus
- Startup diagram: swaync, nm-applet, systemd services listed
- moonarch-dnd removed (dunst-specific)
This commit is contained in:
nevaforget 2026-04-07 11:34:30 +02:00
parent 80c395fc14
commit 9f994d03fb

View File

@ -23,8 +23,8 @@ desktop that can be rebuilt from scratch in minutes.
| **Shell** | Zsh | Programmable completion, FZF integration, syntax highlighting. |
| **Audio** | PipeWire | Drop-in replacement for PulseAudio/JACK with lower latency. RNNoise input denoising configured out of the box. |
| **Display Management** | [kanshi](https://sr.ht/~emersion/kanshi/) + [wdisplays](https://github.com/artizirk/wdisplays) | kanshi auto-switches output profiles on hotplug. wdisplays for manual GUI configuration. |
| **Notifications** | [dunst](https://dunst-project.org/) | Lightweight, scriptable. DND mode exposed as Waybar module. |
| **Clipboard** | Walker clipboard provider | Built-in clipboard history with image support. Managed by Elephant backend. |
| **Notifications** | [swaync](https://github.com/ErikReider/SwayNotificationCenter) | GTK4 notification daemon with DND toggle, grouping, MPRIS support. Fractional scaling via native GTK4. |
| **Clipboard** | [cliphist](https://github.com/sentriz/cliphist) + Walker | Clipboard history stored in runtime dir, wiped on session start. Walker provides the picker UI. |
| **GTK Theme** | Colloid-Grey-Dark-Catppuccin | Catppuccin Mocha palette, grey accent, explicit dark variant. |
| **Icons** | Colloid-Grey-Catppuccin-Dark | Catppuccin-colored icon set matching the GTK theme. |
| **Cursor** | Sweet-cursors | Visible on dark backgrounds without clashing. |
@ -114,7 +114,7 @@ defaults/
waybar/config, style.css Bar: modules, layout, Catppuccin styling
walker/config.toml, themes/ Launcher: Walker config + gtk-inherit theme
foot/foot.ini Terminal: font, colors, keybinds
dunst/dunstrc Notifications: geometry, colors, behavior
swaync/config.json, style.css Notifications: appearance, behavior, MPRIS
kanshi/config Display profiles (empty, user-configured)
stasis/stasis.rune Idle manager: AC/battery power plans
pipewire/ Audio: RNNoise input denoising
@ -122,11 +122,10 @@ defaults/
fastfetch/config.jsonc System info display
gtk-3.0/, gtk-4.0/ GTK theme settings
bin/ Helper scripts (deployed to /usr/local/bin/)
bin/ Helper scripts (deployed to /usr/bin/)
moonarch-sink-switcher Audio output switcher (walker dmenu + pactl)
moonarch-vpn VPN connection manager (walker dmenu + nmcli)
moonarch-cpugov CPU governor switcher (walker dmenu + auto-cpufreq)
moonarch-dnd Dunst Do Not Disturb toggle (Waybar JSON output)
moonarch-btnote Bluetooth device battery monitor (upower + notify-send)
moonarch-capsnote Caps Lock toggle notification
moonarch-waybar-cpugov Waybar module: CPU governor status
@ -136,7 +135,7 @@ defaults/
shell/zshrc Zsh config: prompt, aliases, FZF, completion
etc/greetd/ greetd daemon + greeter Niri config
etc/moongreet/ moongreet configuration
user/systemd/user/ Systemd user services (kanshi, walker, elephant)
etc/systemd/user/ Systemd user services (cliphist, kanshi, walker, nautilus)
user/waybar/ Per-user Waybar overrides (only copied if missing)
backgrounds/wallpaper.jpg Default wallpaper (shared by desktop, greeter, lock screen)
```
@ -151,10 +150,11 @@ greetd ─► niri (greeter instance) ─► moongreet ─► user authenticates
┌──────────┬────────┬────────┬──────────┐
▼ ▼ ▼ ▼ ▼
waybar dunst foot waypaper cliphist
(bar) (notify) (server) (wallpaper) (clipboard)
waybar swaync foot waypaper nm-applet
(bar) (notify) (server) (wallpaper) (VPN)
kanshi runs as a systemd user service (graphical-session.target)
systemd user services (graphical-session.target):
kanshi, cliphist, walker, nautilus
```
## Keybinds (Default)
@ -191,13 +191,13 @@ All system configs live in `/etc/xdg/` and can be overridden per-user in `~/.con
| Waybar | `/etc/xdg/waybar/` | `~/.config/waybar/` |
| Walker | `/etc/xdg/walker/` | `~/.config/walker/` |
| Foot | `/etc/xdg/foot/foot.ini` | `~/.config/foot/foot.ini` |
| Dunst | `/etc/xdg/dunst/dunstrc` | `~/.config/dunst/dunstrc` |
| swaync | `/etc/xdg/swaync/` | `~/.config/swaync/` |
| kanshi | `/etc/xdg/kanshi/config` | `~/.config/kanshi/config` |
| PipeWire | `/etc/xdg/pipewire/` | `~/.config/pipewire/` |
| Zsh | `/etc/zsh/zshrc.moonarch` | `~/.zshrc` + `~/.zshrc.d/` |
Helper scripts in `/usr/local/bin/moonarch-*` are not meant to be overridden — they
are part of the system and updated via `moonarch-update`.
Helper scripts in `/usr/bin/moonarch-*` are not meant to be overridden — they
are part of the system and updated via `paru -Syu`.
## System Services
@ -215,8 +215,9 @@ are part of the system and updated via `moonarch-update`.
| Service | Purpose |
|---------|---------|
| cliphist | Clipboard history (wipes on session start, stores in runtime dir) |
| kanshi | Dynamic display configuration (auto-switch output profiles on hotplug) |
| elephant | Walker data provider backend (apps, clipboard, bluetooth, audio) |
| nautilus | File manager preload (faster first launch) |
| walker | Walker application launcher (GTK4 service mode for instant startup) |
## Moonarch Ecosystem