A single palette runs through every component:

Ghostty, Hyprland borders, Starship prompt, Fastfetch logo, and the mpv OSC all read from this palette so nothing ever clashes.

dotfiles/
├── install.sh               one-shot installer (idempotent, with backups)
├── config/                  → symlinked into ~/.config/
│   ├── hypr/hyprland.conf       window manager, binds, monitors, animations
│   ├── ghostty/config           GPU terminal, Deep Space palette
│   ├── fastfetch/               system fetch (logo + config)
│   │   ├── config.jsonc
│   │   ├── galaxy.ansi          pre-rendered Milky Way (re-gen with spacefetch --regen)
│   │   └── galaxy.jpg
│   ├── mpv/                     mpv + ModernZ OSC theme
│   │   ├── mpv.conf
│   │   ├── fonts/modernz-icons.ttf
│   │   ├── script-opts/modernz.conf
│   │   └── scripts/modernz.lua
│   ├── ambxst/                  bar / dock / notch / theme (Ambxst shell)
│   │   ├── binds.json
│   │   └── config/*.json
│   └── starship.toml            `user@[host] ~/path $` prompt
├── home/                    → symlinked into ~/
│   ├── zshrc                    starship + fish-like autosuggestions + highlighting
│   ├── bashrc                   interactive bash + spacefetch greeter
│   ├── profile                  adds ~/.local/bin to PATH
│   └── gitconfig                gh-backed credential helper
├── bin/                     → installed to ~/.local/bin (or /usr/local/bin)
│   ├── repeat                   run a command / echo stdin N times
│   ├── spacefetch               fastfetch wrapper with an ANSI galaxy logo
│   └── ambxst                   thin launcher for the Ambxst CLI
├── typing/                  Rust source for the `typing` binary
│   ├── Cargo.toml
│   ├── Cargo.lock
│   └── src/main.rs              piped-output typewriter effect
└── wallpapers/
    └── wallpaper.mp4            animated wallpaper (tracked with Git LFS)

• Dual 3440×1440 @ 179 Hz (ASUS on DP-1, Alienware on HDMI-A-1).
• Purple gradient borders, soft shadows, blur on special layers.
• Binds follow the muscle-memory default (SUPER + RETURN/Q/E/R/M/P/J + 1–9 workspaces + SHIFT for move). Multimedia and brightness keys are wired.
• Ambxst generated rules are sourced from ~/.local/share/ambxst/hyprland.conf at the bottom of the config.

• Quickshell-based shell with a top bar, bottom dock, overview, notch, launcher, clipboard, emoji picker, notes, and pomodoro.
• Theme is OLED-black with the cosmic palette; cursor theme is oreo_spark_purple_cursors.
• Idle: dim after 150 s → lock at 300 s → screen off at 330 s → suspend at 30 min.

Ambxst itself is not distributed here (it's an external project). Install the Ambxst CLI first, then this repo drops its configs into ~/.config/ambxst/.

• Iosevka Nerd Font Mono, 12 pt, ligatures on.
• 16-color palette matched to the Deep Space theme, 94 % opacity + 24 px blur.
• copy-on-select to the system clipboard, shell integration for cursor/sudo/title.

Minimal, bash-shaped line: user@[hostname] ~/path $, with git branch + dirty state in purple. Works in both zsh and bash.

• Pre-rendered Milky Way ANSI (galaxy.ansi) for instant startup.
• spacefetch --regen [size] re-renders the logo from galaxy.jpg via artem.
• Auto-runs on interactive bash shells (respects SSH/tmux).

ModernZ on-screen controller, themed in the same purples. Native mpv OSC/border are disabled so ModernZ can draw its own UI.

Animated wallpaper.mp4 ships via Git LFS in wallpapers/wallpaper.mp4. On install it's copied to ~/Pictures/Wallpapers/wallpaper.mp4, ready for mpvpaper, hyprpaper with a video plugin, or any tool of your choice.

sudo pacman -S --needed git git-lfs
git lfs install
git clone https://github.com/<you>/dotfiles.git ~/Documents/dotfiles
cd ~/Documents/dotfiles
git lfs pull    # pulls wallpaper.mp4

./install.sh            # interactive, prompts per section
./install.sh --all      # install everything unattended
./install.sh --help     # list all flags

The installer:

1. Installs required pacman + AUR packages (via yay or paru when present).
2. Symlinks config/* into ~/.config/ and home/* into ~/.
3. Drops the user scripts into ~/.local/bin (and the ambxst wrapper into /usr/local/bin).
4. Builds typing from Rust source and installs it to /usr/local/bin.
5. Copies the wallpaper into ~/Pictures/Wallpapers/wallpaper.mp4.

Every file that would be replaced is moved to ~/.dotfiles-backup/<timestamp>/ first, so the installer is always safe to re-run.

chsh -s /usr/bin/zsh   # switch login shell
# log out, choose Hyprland from your display manager

The installer invokes pacman and an AUR helper (yay or paru) when it finds one; otherwise it prints what to install manually.

• Monitors — edit the two monitor= lines at the top of config/hypr/hyprland.conf.
• Palette — swap the Ghostty palette = ... lines, config/ambxst/config/theme.json (via ambxst config), and the color blocks in config/mpv/script-opts/modernz.conf + config/starship.toml.
• Fetch logo — drop a new image in config/fastfetch/galaxy.jpg and run spacefetch --regen 55.
• Binds — Hyprland binds live at the bottom of hyprland.conf; Ambxst binds live in config/ambxst/binds.json (or edit them via the Ambxst dashboard).

• Configs are installed as symlinks, so edits to files inside this repo take effect immediately — just git commit your changes.
• Backups are never deleted by the installer; prune ~/.dotfiles-backup/ manually once you're happy.
• The Hyprland config sources ~/.local/share/ambxst/hyprland.conf; that file is generated by axctl at runtime and is intentionally not tracked here.

MIT. Use, fork, remix, rice.