From 9f994d03fb302d97e4c9d4f75b55ec7e09cac571 Mon Sep 17 00:00:00 2001 From: nevaforget Date: Tue, 7 Apr 2026 11:34:30 +0200 Subject: [PATCH] docs: update README for swaync, cliphist service, /usr/bin paths MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 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) --- README.md | 27 ++++++++++++++------------- 1 file changed, 14 insertions(+), 13 deletions(-) diff --git a/README.md b/README.md index 9a9fa4b..5a46701 100644 --- a/README.md +++ b/README.md @@ -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