β¦ Showcase Β Β·Β β Spotlights Β Β·Β π§© Modules Β Β·Β π Install Β Β·Β β¨οΈ Keybindings Β Β·Β π Maintenance Β Β·Β π Changelog
Irminsul turns a bare Arch + Hyprland install into a living piece of Teyvat β from the very first boot splash to the Quit Game dialog. Every piece is hand-built, themed after the game, and installable on its own. No theme frameworks. No hidden dependencies on HyDE.
| π§© | π | π | π§ | πΈ | πͺ |
|---|---|---|---|---|---|
| 18 modules |
4 time-of-day phases |
7 elemental workspaces |
85+ Traveler cards |
eng + fas OCR |
1 installer |
Everything you touch, from power button to power menu, belongs to the same world.
flowchart LR
A["π Power on"] --> B["π
Plymouth loading screen<br/>hardware clock β Day / Night"]
B --> C["π° SDDM Celestia<br/>Dawn Β· Day Β· Dusk Β· Night"]
C --> D["πΏ Hyprland<br/>standalone Lua core"]
D --> E["π Waybar Β· π Rofi Β· π Dunst<br/>πΆ Wi-Fi Β· π΅ Bluetooth Β· π Sound Β· π¦οΈ Weather"]
E --> F["π Hyprlock"]
F --> G["π§ Quit Game?"]
The pieces that make Irminsul more than a wallpaper pack.
A complete Wi-Fi experience that replaces nm-applet and every other network popup.
| π±οΈ Left-click the bar icon | Mini Popup β Paimon-style quick panel for fast connect / disconnect |
| π±οΈ Right-click the bar icon | Akasha Terminal β the full, Inventory-style network console |
| π Enterprise-ready | 802.1X and VPN profiles via the NetworkManager connection editor |
| ποΈ Smooth, cheap motion | one shared timer, frame-region redraws and auto-sleep β animated but idle-friendly |
| π¨ Custom bar icons | Genshin-style SVG glyphs for Wi-Fi / Ethernet / Off, in a pill that matches the battery |
| π§Ή Clean-up tools | dry-run-by-default scripts that remove every other network UI and tray applet |
GTK3 Β· gtk-layer-shell Β· NetworkManager (nmcli)
A native, D-Bus-driven Bluetooth app. Everything is live β signals from BlueZ, no polling.
| Page | What lives there |
|---|---|
| π§ Companions | paired and nearby devices |
| πΊοΈ Ley Line Atlas | discovery and scanning |
| πΌ Resonance | audio-device awareness through PipeWire / Pulse |
| π¨ Transmission | file transfer over OBEX |
| πΏ Statue of the Seven | power and adapter control |
| βοΈ Archive Settings | preferences |
Plus the Teyvat Ley Line Network β a lightning-fast Rofi quick popup for when you just want to connect a device:
Alt+1 Elemental Sight Β Β·Β Alt+2 Power Β Β·Β Alt+3 Open the Archive Β Β·Β Alt+4 Refresh
GTK3 Β· PyGObject Β· Cairo Β· BlueZ (org.bluez) Β· obexd Β· PipeWire/Pulse
Audio control with the weight of an in-game menu.
- ποΈ
irminsul-volumeβ a compact volume popup (press again to dismiss) - ποΈ
irminsul-settingsβ the full settings window, The Resonance Archive - ποΈ EQ Β· Mono Β· Clear Voice β switchable audio effects
- π€ Co-op Output β play your system audio on several devices at once (two headphones, a speaker and a headsetβ¦), choose exactly which devices join, with latency sync to keep them together
- β»οΈ Everything is restored at login β EQ, Mono, Co-op and Clear Voice come back after you sign in
- π Genshin-styled volume / brightness HUD that follows the media keys
Super+Alt+A popup Β Β·Β Super+Alt+Shift+A full settings
PipeWire Β· WirePlumber Β· GTK3 Β· Cairo
- β‘ The battery icon itself animates while charging β SVG frame animation right in the bar
- π±οΈ Click it for a Genshin-styled panel: Elemental Energy %, Charging state, Power flow, Until full, Vessel health
- ποΈ One-tap power profiles β Power Saver Β· Balanced Β· Performance
- π The same battery readout appears on the lock screen
A native weather panel that feels like an in-game menu, drawn with Quickshell (QML).
| Tab | What lives there |
|---|---|
| βοΈ Today | temperature, condition, feels-like, high / low, wind, humidity, pressure, UV index, visibility, precipitation, a sun arc and the moon phase |
| π Hourly | the hours ahead |
| π Week | the week ahead |
| π Air | air quality |
- π₯ The weather is shown as an element (Anemo, β¦) and the whole card glows in that element's colour
- β‘ Special conditions get Genshin reaction names β Overloaded, Electro-Charged, Frozen, Vaporize, Swirl
- ποΈ A live animated weather scene sits behind the temperature
- π§ A Paimon tip banner comments on the weather
- π Click the city name to search for another city
- π¦οΈ A matching weather capsule lives in the bar
Open or close it with teyvat-forecast toggle. Position and monitor are set in ~/.config/teyvat-forecast/config.json.
Quickshell Β· QML
A real Polkit authentication agent, not a skin. Whenever pkexec, a package-manager GUI, a disk mount or NetworkManager asks for admin rights, you get a full-screen dimmed Genshin dialog.
- π Three looks β Theme, Classic, Gold
- π«οΈ Wayland-native overlay through gtk-layer-shell
- π Falls back gracefully to the system agent if yours isn't installed
One look for every app, not just the ones you themed by hand.
- πͺ GTK3 Β· GTK4 / libadwaita Β· Qt5 Β· Qt6 (qt5ct / qt6ct and KDE colors)
- ποΈ Genshin file-chooser dialog for every Open / Save window
- π§ Coloured sidebar icons β round badges with an elemental colour, a golden rim and a dark glyph
- π§Ώ Icon pack where every category has its own element:
| Element | Used for |
|---|---|
| π Anemo | browser Β· network Β· photos |
| β‘ Electro | terminal |
| πͺ¨ Geo | files Β· calculator |
| π± Dendro | code Β· system monitor |
| π§ Hydro | chat Β· sound Β· Bluetooth |
| π₯ Pyro | media Β· PDF |
| βοΈ Cryo | games Β· settings |
- β©οΈ Fully reversible β every installer ships an
--undo/--uninstall
| Shortcut | Result |
|---|---|
| Super+P | region capture |
| Super+Ctrl+P | freeze the screen and snip |
| Super+Alt+P | focused monitor |
| all monitors | |
| Super+Shift+P | colour picker |
After every shot, a post-shot Rofi menu offers Swappy editing (with its own GenshinSwappy GTK3 theme), OCR in English + Persian, a QR scanner, copy and save.
- ποΈ Theme Builder (GTK3) β create and manage themes, collections and accents
- πΌοΈ
swwwwallpaper engine with a horizontal Teyvat Wallpaper Gallery in Rofi - π Next / previous wallpaper in the active theme from the keyboard
- π Dynamic Elemental Resonance β the whole desktop's accent follows the wallpaper
- π Ambience Menu β Auto-Resonance, glass opacity, night light and HUD reload
- π― Wallpaper hooks (
wallpaper-hooks.d/) so your own scripts can react to a change
| π Boot | A 1:1 Genshin loading screen (Plymouth). The hardware clock picks Day or Night inside initramfs, so it is right from the first frame. |
| π° Login | SDDM Celestia with four phases β Dawn Β· Day Β· Dusk Β· Night. |
| π Lock | Hyprlock with Genshin typography, a clock, battery and status widgets. |
| π§ Power | Paimon's Quit Game? dialogue β shutdown, reboot, logout and lock, reachable from the bar or Super+Backspace / Ctrl+Alt+Del. |
A capsule top bar that looks like the in-game HUD:
- π₯ 7 Elemental Workspaces β Pyro Β· Hydro Β· Anemo Β· Electro Β· Dendro Β· Cryo Β· Geo
- π Resin Β· Mora Β· Ping status capsules
- π World Level (
AR) β your uptime, levelled up - βοΈ Day / Night indicator and mail badge for your notification history
- π¦οΈ Weather capsule β the current temperature, one click from the full forecast
- πΆ Celestia Wi-Fi Β· π΅ Bluetooth Β· π Sound Β· π Battery β all themed
- π©Ή Auto-recovery β
start.shbrings the bar back, and calling it twice is harmless
- π± Kitty + Zsh with autosuggestions, syntax highlighting and Starship
- πͺͺ Fastfetch Traveler card β a rotating character card built from 85+ Genshin characters
avatar.sh --allΒ·avatar.sh <name>Β·avatar.sh --listΒ·avatar.sh --wall(card from your current wallpaper) - π Dunst notifications with circular elemental and Paimon medals
- π±οΈ Official Genshin cursor (size 32) locked across Hyprland, GTK3/4, XWayland and
dconf, with a guard that puts it back if an app changes it - π€ Official fonts (
SDK_SC_Web,HYWenHei-85W) with system-wide fontconfig rules
Eighteen independent modules β install all of them or pick only what you need.
| Module | What it does | |
|---|---|---|
| π§© | hypr |
Standalone Hyprland Lua core, Theme Builder v3, swww wallpaper engine, dynamic Elemental Resonance, cursor guard |
| π | wiring |
Entry-point loader (~/.config/hypr/hyprland.lua) |
| π€ | fonts |
Official fonts with system-wide fontconfig rules |
| π±οΈ | cursor |
Official cursor, locked across every toolkit |
| Module | What it does | |
|---|---|---|
| π | waybar |
Capsule top bar, Celestia Wi-Fi v4, animated battery, custom SVG icons, tray & Wi-Fi clean-up tools |
| π | rofi |
Paimon launcher, Wallpaper Gallery, clipboard archive, window switcher, file finder |
| πΈ | osd |
Kamera screenshot suite plus volume / brightness HUD |
| π | notif |
Dunst with elemental and Paimon medals |
| π» | terminal |
Kitty Β· Fastfetch Traveler cards Β· Zsh + Starship |
| π¦οΈ | forecast |
Teyvat Forecast β Quickshell weather popup with Today / Hourly / Week / Air tabs |
| Module | What it does | |
|---|---|---|
| π΅ | bluetooth |
Teyvat Archive (GTK3 D-Bus manager) and the Ley Line Network quick popup |
| π | audio |
Irminsul Sound Console β volume popup, Resonance Archive settings, EQ, Mono, Clear Voice, Co-op output |
| π‘οΈ | polkit |
Genshin admin-password dialog β Theme / Classic / Gold |
| π¨ | celestia-icons |
Celestia icon theme, file-chooser dialog, sidebar icons, GTK/Qt global theme |
| Module | What it does | |
|---|---|---|
| β³ | boot |
1:1 Genshin loading screen with automatic hardware-clock Day / Night sync |
| π° | login |
SDDM Celestia with four time-of-day phases |
| π | lock |
Hyprlock with Genshin typography and status widgets |
| π§ | power |
Paimon Quit Game / power dialogue |
πΊοΈ How the pieces fit together
flowchart TB
I["install.sh<br/>dry run by default"] --> CORE & SHELL & CONN & ATMO
subgraph CORE["π Core"]
hypr --- wiring --- fonts --- cursor
end
subgraph SHELL["πͺ Shell"]
waybar --- rofi --- osd --- notif --- terminal --- forecast
end
subgraph CONN["π‘ Connectivity & System"]
bluetooth --- audio --- polkit --- celestia-icons
end
subgraph ATMO["π Atmosphere"]
boot --- login --- lock --- power
end
style CORE stroke:#f5c542,stroke-width:2px
style SHELL stroke:#4cc2f1,stroke-width:2px
style CONN stroke:#74c2a8,stroke-width:2px
style ATMO stroke:#9b7dff,stroke-width:2px
Note
install.sh is a dry run by default. Nothing on your system changes until you pass --apply.
git clone https://github.com/R0nov4/irminsul.git
cd irminsul1 Β· Preview what will change
./install.sh2 Β· Install everything β packages, user configs, SDDM and the Plymouth boot screen
./install.sh --deps --apply --system --boot3 Β· Check that everything is healthy
./doctor.shInstaller flags
| Flag | Effect |
|---|---|
| (none) | Dry run, preview only |
--deps |
Install required packages |
--apply |
Apply user configs |
--system |
Install system-level parts (SDDM) |
--boot |
Install the Plymouth boot screen |
--update |
git pull, then re-apply only the installed modules |
--only a,b,c |
Limit the install to the listed modules |
Install only some modules
# just the shell
./install.sh --apply --only hypr,waybar,rofi,osd
# just the connectivity apps
./install.sh --apply --only waybar,bluetooth,audioSingle-file standalone installers
Every module is also built as a self-extracting script in dist/(Download dist files from the releases page). Each one works on its own:
./dist/genshin-all.sh --deps --apply --system --boot # everything
./dist/genshin-bluetooth.sh --apply # just Bluetooth
./dist/genshin-audio.sh --apply # just the sound console
./dist/genshin-polkit.sh --apply # just the Polkit dialog
./dist/genshin-celestia-icons.sh --apply # just the icon themeSuper is the Windows / Meta key.
Super + 1 β¦ 7
| 1 | 2 | 3 | 4 | 5 | 6 | 7 |
|---|---|---|---|---|---|---|
| π₯ Pyro | π§ Hydro | π Anemo | β‘ Electro | π± Dendro | βοΈ Cryo | πͺ¨ Geo |
π Apps & Windows
| Shortcut | Action |
|---|---|
| Super + T | Terminal (kitty) |
| Super + E | File manager (dolphin) |
| Super + B | Web browser |
| Super + C | Code editor |
| Super + A | Paimon Application Launcher (Rofi) |
| Super + Tab | Window switcher |
| Super + Shift + E | File finder |
| Super + Q / Alt + F4 | Close active window |
| Super + F | Toggle maximize |
| Shift + F11 | Cycle fullscreen |
| Super + W | Toggle floating |
π¨ Themes & Wallpapers
| Shortcut | Action |
|---|---|
| Super + Shift + T | Genshin Theme Builder v3 β theme, collection and accent manager |
| Super + Shift + W | Teyvat Wallpaper Gallery β horizontal Rofi preview |
| Super + Alt + β / β | Next / previous wallpaper in the active theme |
| Super + Shift + R | Teyvat Ambience Menu β Auto-Resonance, glass opacity, night light, HUD reload |
π Sound
| Shortcut | Action |
|---|---|
| Super + Alt + A | Irminsul volume popup (press again to close) |
| Super + Alt + Shift + A | The Resonance Archive β full sound settings |
| F10 / F11 / F12 and media keys | Mute Β· volume down Β· volume up, with the Genshin HUD |
πΈ Clipboard & Screenshots
| Shortcut | Action |
|---|---|
| Super + V | Clipboard Archive β history (cliphist) |
| Super + Shift + V | Clear / manage clipboard history |
| Print / Super + P | Kamera β all monitors / region β Swappy Β· OCR Β· QR Β· Save |
| Super + Ctrl + P | Freeze the screen and snip |
| Super + Alt + P | Screenshot the focused monitor |
| Super + Shift + P | Colour picker (hyprpicker) |
βοΈ System
| Shortcut | Action |
|---|---|
| Super + L | Lock screen (hyprlock) |
| Super + BackSpace / Ctrl + Alt + Del | Quit Game / power menu |
| Super + K | Switch keyboard layout (set yours in ~/.config/hypr-genshin/keyboard.conf) |
./capture.sh # capture live system configs into modules/ (converts $HOME to @HOME@)
./build-dist.sh # build self-extracting installers into dist/
./doctor.sh # run full diagnosticsTip
Tweaked something on your machine? Run ./capture.sh and commit β paths are stored as @HOME@, so the configs stay portable.
π§Ή Extra tools
All of them are generic and dry-run by default β they read what is really on your system instead of assuming a setup.
| Tool | What it does |
|---|---|
tools/genshin-tray-doctor.py |
Lists every system-tray icon, finds who starts it, and removes the unwanted ones (Wi-Fi applets by default) |
tools/genshin-wifi-cleanup.sh |
Removes every other Wi-Fi / network UI so only Celestia remains β everything is backed up first |
tools/genshin-wifi-icon.sh |
Swaps the plain font glyph of the bar's network module for Genshin SVG icons β safe to re-run |
python3 tools/genshin-tray-doctor.py # preview
python3 tools/genshin-tray-doctor.py --apply # do it
bash tools/genshin-wifi-cleanup.sh --applyβ©οΈ Reverting
- Back up your previous Hyprland config? Restore it with
genshin-hypr-standalone.sh deactivate - Icon theme and file chooser: run the module installer with
--undo - Global Celestia theme: run
celestia-theme-installer.sh --uninstall - Tools back up whatever they change (
*.bak-*) before touching it
irminsul/
βββ install.sh β¦ installer (dry run by default)
βββ doctor.sh β¦ diagnostics
βββ build-dist.sh β¦ builds the self-extracting installers
βββ dist/ β¦ build output: genshin-all.sh + one script per module (18)
βββ tools/ β¦ tray doctor Β· Wi-Fi clean-up Β· Wi-Fi bar icon
βββ shell/ β¦ zshrc
βββ reference/ β¦ screenshots, package lists, old installers, system notes
βββ modules/ β¦ 18 modules, each laid out like the target filesystem
β
βββ hypr/ home/.config/hypr-genshin/ β Lua core (standalone/), Theme Builder,
β wallpaper engine + wallpaper-hooks.d/, cursor guard, Ambience menu
βββ wiring/ home/.config/hypr/hyprland.lua β entry-point loader
βββ fonts/ Genshin-UI.ttf + fontconfig alias rules
βββ cursor/ Genshin-Official Xcursor theme, GTK 2/3/4, xsettingsd, uwsm env
β
βββ waybar/ waybar-genshin/ β config, styles, scripts/ (Wi-Fi, battery, mail, AR, ping, weather),
β assets/ (elements, bat/, bat-ios/, bluetooth/, wifi/)
βββ rofi/ rofi-genshin/ β launcher, clipboard, wallpaper gallery, shot menu
βββ osd/ osd-genshin/ β Kamera screenshot suite, volume / brightness HUD,
β GenshinSwappy GTK3 theme
βββ notif/ dunst-genshin/ β dunstrc, elemental + Paimon medal icons
βββ terminal/ kitty-genshin, fastfetch-genshin (avatars/ + cards/), Zsh bits
βββ forecast/ home/.config/quickshell/teyvat-forecast/ β Quickshell (QML) weather popup,
β components/ (moon phase, sun arc, AQI meter, city searchβ¦)
β
βββ bluetooth/ Teyvat Archive (teyvat_archive.py) + desktop entry + quick popup
βββ audio/ irminsul-volume Β· irminsul-settings Β· pavucontrol shim
βββ polkit/ agent.py, launcher, autostart (system agent masked)
βββ celestia-icons/ install.sh + scripts/ (icon pack, dialogs, sidebar icons, theme installer)
β
βββ boot/ root/ β Plymouth themes (genshin, genshin-loading day/night frames),
β genshin-daynight service + initcpio hook, early-KMS config
βββ login/ root/ β SDDM themes (Genshin, genshin-celestia) + sddm.conf.d
βββ lock/ home/.config/hyprlock-genshin/ β template, backgrounds, battery widget
βββ power/ home/.config/power-genshin/ β Quit Game dialogue (launch.sh, theme.rasi, icons)
Inside a module, home/ is copied into $HOME and root/ into / (needs --system or --boot). celestia-icons ships its own installer instead.
- π¦οΈ Added weather β the new
forecastmodule: the Teyvat Forecast popup and a weather capsule in the bar. - π The bar's day/night capsule is now the weather capsule (it still shows a sun or moon, and a click opens the forecast).
- Boot day/night phase assumes UTC. Set your offset in seconds in
/etc/genshin-daynight.conf(GS_UTC_OFFSET=, e.g.3600for UTC+1) and rebuild the initramfs withsudo mkinitcpio -P. - Early KMS is set up for
amdgpuandi915. NVIDIA users should edit/etc/mkinitcpio.conf.d/genshin-kms.conf.
Genshin Impact, its characters, artwork, fonts and cursor are Β© HoYoverse / COGNOSPHERE. This is an unofficial, non-commercial fan project and is not affiliated with or endorsed by HoYoverse. All game assets belong to their respective owners.
Irminsul is an unofficial, fan-made, non-commercial project. It is not affiliated with, authorized, sponsored or endorsed by HoYoverse, COGNOSPHERE, miHoYo or any of their subsidiaries or affiliates. Nothing here should be read as an official product, collaboration or partnership.
- Ownership. Genshin Impact and everything derived from it, including names, characters, logos, artwork, music, fonts, cursors and related marks, belongs to its respective owners. The author claims no ownership over that material and does not seek to register any copyright, trademark or other right over it.
- Third-party work. Wallpapers, fonts, icons and other artwork made by third parties remain the property of their authors and are subject to their own terms. Full credit goes to the original creators.
- Scope of the license. The original code, scripts and configuration written by the author are licensed under the GNU GPL v3.0. That license does not extend to game-derived or third-party material, which is not the author's to license and stays under its owners' terms.
- Fan content is for personal, non-commercial use. Game-derived and third-party material included here is shared free of charge for personal, non-commercial use only. Do not sell it or include it in paid products or services.
- No warranty. This project installs system-level components (boot splash, login manager, lock screen, polkit agent, initramfs hooks). It is provided as is, without warranty of any kind, and the author is not liable for data loss, broken boots, lockouts or any other damage. Run the installer in dry-run mode first, back up your system, and know how to recover from a TTY.
Takedown requests. If you are a rights holder and believe something here infringes your rights, please open an issue titled "Takedown request" listing the affected files. The maintainer will remove them promptly and in good faith.

















