EnsixD/Panacea

Panacea Shell

One pill for everything. A Hyprland desktop where the whole shell is a single capsule at the edge of the screen.

No bar, no tray, no scattered popups. Wi‑Fi, Bluetooth, power profiles, the launcher, notifications, the media player, a file manager, a password manager, the power menu and the settings all live inside one pill that morphs into whatever you asked for and flows back when you're done. It hugs its screen edge with two concave corners, like a hardware notch: no floating rectangle, no gap, no border — only the content changes.

The island can sit at any edge — top, bottom, left or right — and always opens towards the centre of the screen. At the side edges it turns vertical and stacks its text letter under letter, so nothing has to be read with a tilted head.

_{A short tour recorded with the pill's own screen recorder. The same clip is committed as demo.mp4; the link above is GitHub's own upload, since it only plays videos inline when they come from its editor rather than from a file in the repository.}

Every panel is the same capsule at a different size, so the whole shell shares one geometry, one palette and one animation timeline.

Hovering the pill opens it too — the player if something is playing, quick settings otherwise. Every page closes with the same key, Escape, or a click outside. Collapsed, it shows day, clock, workspace, layout and battery.

Minimalist desktop cards that live directly on your wallpaper (Super + I → Appearance → Desktop widgets):

• Nothing Analog Clock: Signature 12-dot dial with cardinal points, double dot at 12 o'clock, clean white hands, and an orbiting red accent second hand (colCrit). Click to toggle between Analog and Digital Dot Clock.
• Concentric System Monitor: Dual concentric minimalist arcs (outer ring for RAM %, inner ring for root SSD %) with dot-matrix percentage in the center. Click the card or icon to toggle between Weather details and the System monitor.
• Life Bar / Day & Year Progress: A 24-segment dot bar representing the hours of the day (elapsed hours in solid white, current hour pulsing red, future hours dimmed) and time remaining. Click to switch between 24-hour Day Progress and 365-day Year Progress.

Settings has twelve sections, searchable from the top of the panel: Bar & Island (a mock‑up of your desktop with the real island on it, its screen edge and geometry), Media, Clock & Date, Appearance (palette, fonts, interface language), Motion, Launcher, Notifications, Control Center (the quick settings tiles, rearranged by dragging), Lock Screen, Display (resolution, refresh rate, scale, orientation, VRR, multi‑monitor arrangement, brightness and digital vibrance), Mouse and System.

If this machine has more than one operating system on it, three separate things here know about that.

The boot menu is themed. grub/panacea/ is a GRUB theme in the same language as the island — the wallpaper, a capsule highlight on the selected entry, nothing else. The installer copies it to /boot/grub/themes/panacea, points /etc/default/grub at it and regenerates the config. Skip it with --no-grub.

Other systems are made to show up. Arch disables os-prober by default, which is why a fresh GRUB config often lists only Linux and quietly loses the Windows that is still sitting on the disk. The installer sets GRUB_DISABLE_OS_PROBER=false when os-prober is installed, and says so if it is missing.

You can restart into another system from the launcher. Open it, type windows — or whatever the system is called — and press Enter. There is no fixed list of two: panacea/scripts/bootos.sh finds what is actually there, so three systems give three entries and one system gives none at all. Names are tidied for reading, so Windows Boot Manager (on /dev/nvme0n1p1) becomes Windows, while distributions keep their versions.

The choice is one‑shot: it sets the next boot only, through grub-reboot (or BootNext in EFI variables when GRUB is not the bootloader). Your default system does not change, and the boot after that comes back here. Touching the bootloader needs root, so pkexec asks for a password — that prompt is also the confirmation, which is why there is no separate "are you sure". These entries never appear in an empty launcher and are never remembered as recent: a line that reboots the machine should not sit one careless Enter away from the browser.

There is one palette for the whole system, in hypr/palette.conf. hypr/scripts/palette.sh spreads it across the terminal, btop, fish, neovim and the login screen. Changing the wallpaper never touches the colours — and never touches a file that Hyprland sources, so your windows are left alone.

The pill is also the notification daemon and the polkit agent, so don't run mako, dunst or hyprpolkitagent alongside it. Only one process can own org.freedesktop.Notifications, and the rival never has to be launched to win — D‑Bus starts it on the first notification, and from then on it draws them in its own window instead of the island. The installer masks dunst and mako for that reason; systemctl --user unmask dunst.service puts one back.

git clone https://github.com/EnsixD/Panacea.git
cd Panacea
./install.sh

The script checks the dependencies, then checks for an AUR helper — yay, paru or pikaur. If you have one it says which and moves on; if you have none it offers to build yay-bin there and then, since quickshell itself lives in the AUR. Declining is fine: everything from the repos still installs. It then backs up anything it would overwrite, copies the configs, enables Bluetooth / power‑profiles / iwd, spreads the palette across the applications, restores the wallpaper and warms up its thumbnails. It then offers, one prompt at a time: the wallpaper pack (300+ wallpapers bundled in wallpapers/), the GRUB boot theme and the SDDM login theme.

Flags: --no-deps, --no-sddm, --no-grub, --no-services, --no-wallpapers, --no-restart, --yes.

Panacea checks GitHub for new commits on its own and offers an Update button in Settings → System. If your copy predates that — it was installed before the updater existed, or ~/.config/panacea/.version is missing — run the updater by hand once:

curl -fsSL https://raw.githubusercontent.com/EnsixD/Panacea/main/panacea/scripts/update.sh | bash -s apply

No reinstall, and nothing to do to Hyprland itself. The script clones the repo, carries your settings.json, your keybindings, your wallpapers and anything you put in panacea/assets across the install, reinstalls the configs, records the version and restarts the shell. Packages, the login theme and the boot theme are left alone — those are installed once. From then on updates arrive through the button.

Prefer to do it by hand? Copy panacea hypr foot fish fastfetch nano into ~/.config, nano/nanorc to ~/.nanorc, bin/* to ~/.local/bin, then run hypr/scripts/palette.sh, hypr/scripts/switch_theme.sh --restore and hyprctl reload.

The real config is hypr/hyprland.lua with the modules under hypr/lua/. hypr/hyprland.conf beside it is a fallback for Hyprland versions that cannot read Lua configs: they would otherwise come up bare — no bindings, no pill, no way to open a terminal. It carries only the essentials and makes no attempt to mirror lua/; if something is missing there, the answer is to update Hyprland.

Networking supports both NetworkManager (nmcli, standard on Fedora / Ubuntu) and iwd (iwctl, common on minimal Arch). Panacea detects the active daemon automatically — no manual configuration required. Power profiles go through power-profiles-daemon over D‑Bus. Everything resolves $HOME at runtime — no hardcoded paths.

Choose a system locale in Settings → Appearance. Panacea's interface has built-in Russian, English and Turkish translations. For any other system locale, the Panacea interface uses English while applications use the selected locale after the next login. There is no online translation service or API key. If you would like another interface language, please open a GitHub issue with the language and locale code so it can be added to the built-in translations.

Panacea is designed so your personal tweaks — shell aliases, terminal fonts, window rules, keybindings — survive all updates without conflicts or overwrites:

As an extra safety net, the updater backs up modified configurations to ~/.config/<name>.bak-update before applying changes and retains two earlier update snapshots. Files owned by the shell, such as panacea/shell.qml and hypr/lua/keybindings.lua, are replaced to deliver code updates. Put durable overrides in settings.json or the custom/ directories above; a direct edit to an owned file remains in the .bak-update copy for manual recovery.

Hold Right Alt, speak, let go — the recognised text lands in the focused field. It runs offline through voxtype; the installer sets it up, but the speech model is a separate ~1.5 GB download. If dictation does nothing, the model is what's missing — the one used here is Whisper medium:

mkdir -p ~/.local/share/voxtype/models
curl -L --progress-bar \
  https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-medium.bin \
  -o ~/.local/share/voxtype/models/ggml-medium.bin
curl -sL \
  https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-silero-vad.bin \
  -o ~/.local/share/voxtype/models/ggml-silero-vad.bin
systemctl --user restart voxtype

The second file is the Silero VAD model — it drops silence and background noise, and transcription stalls without it because the config enables VAD. A smaller model is fine too (ggml-small.bin, ggml-base.bin); set the name in model = under [whisper] in ~/.config/voxtype/config.toml.

panacea/   the pill: QML, scripts, settings.json
hypr/      Hyprland (Lua config, palette, wallpapers, scripts)
wallpapers/ bundled collection of 300+ wallpapers
niri/      Niri (config.kdl, custom overrides, scripts)
grub/      boot theme + the script that generates its assets
sddm/      login theme
bin/       standalone helper scripts
fish/      shell config and prompt
foot/      terminal
applications/  desktop entries that make the shell the default handler
fastfetch/ nano/

Nothing on a fresh Arch install decides what opens a file, so the fallbacks decide instead: images end up in the browser and folders in a KDE file manager that is not otherwise used here. The installer fixes that by pointing images, video and directories at the shell's own viewer and file manager — they reach the running instance over its IPC rather than starting a second copy — and leaves the browser handling what belongs to a browser. Set them by hand with xdg-mime default, or skip the whole step by not running the installer.

Shortcuts live in panacea/settings.json and compile into hypr/lua/binds_data.lua from the settings panel; that generated file is gitignored, and without it the defaults in keybindings.lua apply. Every ordinary Hyprland shortcut, including workspace switching and window movement for desks 1–10, can be changed in Super+/. Mouse, media, and lid bindings accept a typed Hyprland combination in the same editor. Keyboard layouts and switching options live in Settings → Devices → Input and are generated from settings.json; on Niri, edit the preserved ~/.config/niri/config.kdl.

No wallpaper here is mine — each belongs to its author, and they are bundled only so a fresh install has something to show. Author of one and want it gone? Open an issue.

• matteogini/dotfiles — ember_stripes.jpg and misty_peaks.jpg; the rice this setup grew out of.
• HyDE — spring_bloom.jpg, from its Graphite Mono theme; hypr/palette.conf is derived from it.
• ilyamiro/shell-wallpapers — the wallpaper collection bundled in wallpapers/.

Video wallpapers play through mpvpaper; none are bundled. Drop .mp4, .webm, .mkv or .mov into ~/.config/hypr/wallpaper/live, or take them from DesktopHut, Wallper, TuxPapers or Papyrus — each on its own terms.

Interface font: JetBrains Mono Nerd Font (SIL OFL), with Material Design Icons for every glyph. assets/logo*.png is drawn for this project, same licence as the code.

Built on Hyprland · Quickshell · cava · cliphist · hyprpaper / hyprsunset · wf-recorder · fish

MIT — see LICENSE. It covers the configs, the QML and the scripts. Wallpapers, fonts and anything else bundled from elsewhere keep the terms of their own authors.