vzbc / revo-shell
git clone https://github.com/vzbc/revo-shell.git
Revo Shell Dotfiles
β
stars, 24h
β
stars, 7 days
+93
stars, 30 days Β· #2,494
93
β
total
5
forks Β· 4 open issues
Star history starts 2026-10-20; the chart appears after the second daily snapshot.
LanguageQML
Licenseβ
Created2026-09-24 (26d ago)
Last push1d ago
Watchers1
OwnerUser
Links
- GitHub: github.com/vzbc/revo-shell
- Releases Β· Issues Β· Hacker News mentions
README excerpt
# Revo Shell Dotfiles Revo Shell its place to Add all ypur quickShells in one place if you share any video to this dot files in tik tok or insta pleas mention me : @_flz4 ## Showcase https://github.com/user-attachments/assets/42df3de9-9fab-4843-9afc-35f82d5852f7 ## Layout | Path | Deploy target | |------|----------------| | `hypr/` | `~/.config/hypr` | | `quickshell/` | `~/.config/quickshell` | | `wallpapers/` | `~/Pictures/Wallpapers` | | `rofi/` | `~/.config/rofi` | | `kitty/` | `~/.config/kitty` | | `SystemSettings/` | built β `~/.local/bin/systemsettings` | | `install.sh` | **run this (CLI)** | | `update` / `update.sh` | **run this to pull new additions** | | `qs-gui-installer/` | run this (GUI) | ## Install (CLI β recommended) One-time clone, then run the installer: [code] On a TTY you get a **multi-select shell menu** (same idea as the GUI Stage 3): [code] **A fresh install always says what to deploy**: non-interactive runs (scripts, no TTY) need `--shells` β the installer refuses to guess and deploys only what you picked (the first shell becomes the default). Re-running without `--shells` re-applies your previous choice, so updates keep working. What `install.sh` does: 1. Lets you pick which shells to install (menu / `--shells` β required on a fresh install; you get only what you pick) 2. Detects your package manager (pacman / apt / dnf) 3. Installs **system packages** needed by the installer and shells 4. Installs AUR packages via yay/paru when available (`quickshell-git`, fonts, β¦) 5. Installs Python deps (`pip --user`) 6. Deploys `hypr/`, selected `quickshell/` shells (+ shared root assets), `rofi/`, `kitty/` β `~/.config/`, `wallpapers/` β `~/Pictures/Wallpapers` 7. Sets the **first selected shell** as the Hyprland default (`# REVO_DEFAULT_SHELL` in autostart) β a previously saved default is re-applied on updates 8. Rewrites hardcoded `/home/revo` β `$HOME` 9. Builds CMake shells (caelestia + Clavis) and the **SystemSettings** app β `~/.local/bin/systemsettings` 10. Enables pipewire / NetworkManager / bluetooth 11. Installs **hyprpm plugins** β adds the `hyprliquid` + `Hypr3D` repos, enables the liquid-glass engine, and points `hyprland.conf` / `hyprland.lua` at the per-user plugin `.so` files in `/var/cache/hyprpm/$USER/`. `HyprGlass` is **skipped by default** (its build hangs on fresh installs and `hyprliquid` is the engine the configs enable β `WITH_HYPRGLASS=1 ./install.sh` adds it back). Plugin builds are **bounded by `HYPRPM_TIMEOUT` (default 600s)**, so a slow or hanging `hyprpm add` is abandoned and the install still finishes; plugins are optional, the desktop works without them (`./install.sh --check` retries). 12. **Verifies every requirement** β prints `[ok]` / `[MISS]` / `[fixed]` for each, **auto-installs any missing package** (pacman / apt / dnf + yay/paru for AUR) 13. **Health check** β proves the result actually works: `hyprpm` + its repos, the default-shell marker, the deployed `autostart.lua` (the old `h.` build k