Aleph1-9012/Tsugumori

KNIGHTS OF SIDONIA-INSPIRED HYPRLAND DESKTOP // ARCH LINUX

Watch the showcase in higher quality on YouTube

You need a fully updated Arch Linux installation, Hyprland 0.55.2 or newer, a normal user account, and sudo access. Complete your normal full system update before running the installer. The installer uses the existing Pacman package databases; it does not refresh them or perform a system upgrade.

bash <(curl -fsSL https://raw.githubusercontent.com/Aleph1-9012/Tsugumori/main/install.sh)

To see the available installer options without changing your system:

bash <(curl -fsSL https://raw.githubusercontent.com/Aleph1-9012/Tsugumori/main/install.sh) --help

Tsugumori uses official Arch packages. IBM Plex Mono and Share Tech Mono ship with their licenses, so the installer does not need an AUR helper.

Fish support is optional. Select it when asked, or add --fish to the install command. This installs basic aliases and adds ~/.local/bin to Fish's PATH through config/fish/conf.d/tsugumori.fish. It does not change your login shell or install a Fish prompt.

The Fish fragment goes in $XDG_CONFIG_HOME/fish/conf.d/tsugumori.fish, using ~/.config when XDG_CONFIG_HOME is unset. Your existing fish/config.fish and fish/config.fish.local remain intact. The fragment reads the latter for personal overrides; Fish loads config.fish afterward. An unrelated file at the fragment's destination is left in place and the installer stops with an explanation.

Pinned package manifests are not currently shipped. --pinned stops before package installation or config deployment when its manifest is missing or invalid. See tested versions.

• Hyprland with a native Lua configuration and custom keybindings
• A NieR:Automata-style Control Center with a Knights of Sidonia theme
• Quickshell launcher, lock screen, notifications, player, and wallpaper picker
• Wi-Fi, Bluetooth, audio, per-monitor brightness, and Quickshare controls
• Standalone quick notes drawer on SUPER + N, with local autosave and deletion Undo
• Clipboard history on SUPER + C, with search, image previews, pins, and deletion Undo
• Compact music player with an artwork glyph matrix, hover colour reveal, and local track drawer
• Waybar and Kitty configurations, plus themed Fastfetch and btop
• Nautilus as the default file manager and a graphical file picker for Quickshare
• Optional Nautilus and file-dialog theme
• Native Phase lock and wallpaper-picker transitions, shared red curtains, and bundled wallpapers

See desktop design and runtime notes for the terminal, widgets, fonts, and native animation details.

These links point to repository sources. See the customization guide for installed file locations.

The installer preserves ~/.config/hypr/user.lua and Quickshell's Settings.qml during upgrades, and leaves ~/.bashrc.local untouched. See the customization guide and the configuration map before editing other installed files.

See controls and keybindings for the complete guide.

Quick Notes is a standalone drawer, separate from the Control Center. Press SUPER + N again to close it, or use the shortcut on another monitor to move the same drawer there. Notes autosave locally, and deleted notes can be restored with Undo during the current shell session.

• Common problems and recovery
• Tested software versions

Inspired by caelestia-dots/shell, flickowoa/dotfiles, and samyns/Unit-3.

MIT