A single palette runs through every component:
| Role | Hex |
|---|---|
| Void | #05020c |
| Nebula (primary) | #9d4edd |
| Nebula bright | #c77dff |
| Starlight | #e0aaff |
| Foreground | #e6dcff |
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 onHDMI-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 +SHIFTfor move). Multimedia and brightness keys are wired. - Ambxst generated rules are sourced from
~/.local/share/ambxst/hyprland.confat 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-selectto 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 fromgalaxy.jpgviaartem.- 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.
| Binary | Purpose |
|---|---|
spacefetch |
Wrapper around Fastfetch with the ANSI galaxy logo + regen helper |
repeat |
echo 'hi' | repeat -n 5 or repeat -n 3 -- date +%T |
typing |
echo 'hello' | typing -s 30 — typewriter animation for pipes |
ambxst |
Thin wrapper that execs ~/.local/src/ambxst/cli.sh |
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 flagsThe installer:
- Installs required pacman + AUR packages (via
yayorparuwhen present). - Symlinks
config/*into~/.config/andhome/*into~/. - Drops the user scripts into
~/.local/bin(and theambxstwrapper into/usr/local/bin). - Builds
typingfrom Rust source and installs it to/usr/local/bin. - 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| Category | Packages |
|---|---|
| Core (pacman) | hyprland, ghostty, mpv, fastfetch, starship, zsh, thunar |
| Zsh plugins | zsh-autosuggestions, zsh-syntax-highlighting |
| Hyprland helpers | brightnessctl, playerctl, wireplumber |
| Fonts | ttf-iosevka-nerd, ttf-roboto |
| Build | rust, git, curl |
| AUR | artem-bin, hyprlauncher |
| External | Ambxst (installed separately) |
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 ofconfig/hypr/hyprland.conf. - Palette — swap the Ghostty
palette = ...lines,config/ambxst/config/theme.json(viaambxst config), and the color blocks inconfig/mpv/script-opts/modernz.conf+config/starship.toml. - Fetch logo — drop a new image in
config/fastfetch/galaxy.jpgand runspacefetch --regen 55. - Binds — Hyprland binds live at the bottom of
hyprland.conf; Ambxst binds live inconfig/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 commityour 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 byaxctlat runtime and is intentionally not tracked here.
MIT. Use, fork, remix, rice.