πŸ“ˆ GH Trending Explorer 🎲 Surprise me

← all repos

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

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