Installation
Install the latest stable release from the AUR, then initialize the user configuration in English:
paru -S hyprism-shell
hyprism-shell init
Use hyprism-shell init --lang pt-BR for a new Brazilian Portuguese configuration. The initializer preserves existing user settings and unmanaged configuration paths.
The development package follows every commit on main and is intended for users who explicitly want unreleased changes:
paru -S hyprism-shell-git
hyprism-shell init
paru is only an example AUR helper. Both packages can also be cloned from the AUR and installed with the standard makepkg -si workflow.
For a repository-managed installation instead, clone Hyprism and run the installer directly:
git clone https://github.com/kristyancarvalho/hyprism.git
cd hyprism
make install
Install the interface in Brazilian Portuguese explicitly:
make install-ptbr
The equivalent variable form is make install LANG=pt-BR. Reapply an existing installation while preserving its language and user configuration with:
make update
Useful maintenance targets are available through make help. Run make check to validate the repository, make reload to reload Quickshell, and make uninstall to remove Hyprism-managed paths.
[!WARNING] Installation provisions packages and replaces user paths managed by Hyprism. Conflicting paths are moved to
~/.local/state/hyprism/backups/before links are created. Uninstallation archives the runtime anduser.jsonunder~/.local/state/hyprism/uninstalled/.
The AUR packages own immutable files under /usr/share/hyprism and /usr/bin. User preferences remain under ~/.config/hyprism and are not removed with the package.
Requirements and support
- Arch Linux with internet access during initial package provisioning.
- A regular user with package-installation privileges. The repository installer additionally uses
sudofor packages, fonts, and SDDM configuration. - Hardware and drivers suitable for a current Hyprland and Wayland session.
- A standard user
PATHcontaining~/.local/binafter installation.
The installer and package lists target Arch Linux. Other distributions are not currently supported by the automated installation workflow. Hyprism owns a broad set of linked configuration paths and is best evaluated as a complete, opinionated desktop environment rather than layered over an unrelated dotfiles setup.
Packages
The AUR packages pull in the runtime the shell needs, including hyprland, quickshell 0.2.0 or newer, awww, matugen, python-pillow, networkmanager, wireplumber, upower, power-profiles-daemon, wl-clipboard with cliphist, grim, slurp and satty, and the Kvantum, qt5ct, qt6ct, and Papirus theming stack. Optional extras such as ddcutil for external monitor brightness, flatpak, and fastfetch are listed as optional dependencies; pacman -Qi hyprism-shell shows them with their purpose. The repository installer reads packages/pacman.txt and packages/aur.txt instead.
First launch
After hyprism-shell init, choose Hyprland in your display manager, or start it from a TTY. The shell, wallpaper, and theme start automatically from Hyprland’s autostart. Set your weather location with hyprism-shell weather location "City" and review the configuration reference for everything else.
Troubleshooting
| Symptom | What to check |
|---|---|
| No bar or widgets after login | ~/.cache/hyprism/quickshell-startup.log; run hyprism-shell reload |
hyprism-shell: command not found after a repository install |
~/.local/bin must be on PATH |
| Weather stays empty | Set a location with hyprism-shell weather location; the service needs network access to Open-Meteo |
| Lock request refused | /etc/pam.d/hyprism-lock must exist; reinstall the package or run make update |
| Colors did not follow a wallpaper change | The palette may be set to a preset; hyprism-shell theme palette set wallpaper |
| Paths you configured were replaced | Conflicting files are kept in ~/.local/state/hyprism/backups/ |