aygeaNights/TERMINAL-SETUP.md

AygeaNight Terminal Setup Guide

Tokyo Night base · Aygea brand accent colors Baby blue, sapphire, pink, silver — dark navy background

The recommended way to install is the automated installer: ./install.sh This guide covers the manual step-by-step process for reference or customization.

---

Files in this repo

File	Goes to	What it does
AygeaNight.itermcolors	double-click to install	iTerm2 color scheme
tmux.conf	~/.tmux.conf	tmux status bar + colors
starship.toml	~/.config/starship.toml	shell prompt
fetch/aygeafetch.zsh	macOS system fetch	fox + system info
fetch/aygeafetch-ubuntu.sh	Ubuntu system fetch	fox + system info
fetch/aygeafetch-arch.sh	Arch system fetch	fox + system info

---

Step 1 — Install a Nerd Font (required for icons)

Without this you'll see boxes or > instead of icons and powerline arrows in tmux and Starship.

1. Go to https://www.nerdfonts.com/font-downloads
2. Download JetBrainsMono Nerd Font
3. Unzip and double-click each .ttf file to install via Font Book
4. In iTerm2: Preferences → Profiles → Text → Font → select JetBrainsMono Nerd Font
   • Check "Use a different font for non-ASCII text" → same font

---

Step 2 — Install iTerm2 color scheme (macOS only)

1. Double-click AygeaNight.itermcolors — iTerm2 imports it automatically
2. iTerm2 → Preferences → Profiles → Colors → Color Presets → AygeaNight

Optional vibe tweaks:

• Profiles → Window → Transparency: ~10–15%
• Profiles → Window → Blur: ~20
• Profiles → Window → Background image: drag any image, set opacity ~8%

---

Step 3 — Set up tmux

cp tmux.conf ~/.tmux.conf
tmux kill-server
tmux

Reload from inside tmux any time with Ctrl+A then R.

---

Step 4 — Starship prompt

macOS (zsh)

brew install starship
mkdir -p ~/.config
cp starship.toml ~/.config/starship.toml
echo 'eval "$(starship init zsh)"' >> ~/.zshrc
source ~/.zshrc

Linux — Ubuntu

curl -sS https://starship.rs/install.sh | sh
mkdir -p ~/.config
cp starship.toml ~/.config/starship.toml

Add to ~/.bashrc above everything else:

export LANG=en_US.UTF-8
export LC_ALL=en_US.UTF-8
export TERM=xterm-256color
export COLORTERM=truecolor

Then add starship at the very end of ~/.bashrc:

eval "$(starship init bash)"

Locale setup (required — fixes broken ╭─ ╰─ ❯ inside tmux):

sudo apt-get install -y locales
sudo locale-gen en_US.UTF-8
sudo update-locale LANG=en_US.UTF-8
# must fully log out and back in — source alone is not enough
tmux kill-server
tmux

Linux — Arch

curl -sS https://starship.rs/install.sh | sh
mkdir -p ~/.config
cp starship.toml ~/.config/starship.toml

Add to ~/.bashrc above everything else:

export LANG=en_US.UTF-8
export LC_ALL=en_US.UTF-8
export TERM=xterm-256color
export COLORTERM=truecolor

Then add at the very end:

eval "$(starship init bash)"

Locale setup on Arch (different from Ubuntu — no package needed):

sudo nano /etc/locale.gen
# uncomment this line:
# en_US.UTF-8 UTF-8
sudo locale-gen
sudo localectl set-locale LANG=en_US.UTF-8
# log out and back in
tmux kill-server
tmux

---

Step 5 — Fetch Scripts (optional — system info with fox mascot)

Three self-contained fetch scripts that display a chibi white fox kitsune alongside your system info in AygeaNight brand colors. No dependencies — pure shell.

File	Platform	Shell
fetch/aygeafetch.zsh	macOS	zsh
fetch/aygeafetch-ubuntu.sh	Ubuntu Linux	bash
fetch/aygeafetch-arch.sh	Arch Linux	bash

macOS (zsh)

chmod +x fetch/aygeafetch.zsh
cp fetch/aygeafetch.zsh ~/aygeafetch.zsh

Add to ~/.zshrc (at the end):

aygeafetch
# or: source ~/aygeafetch.zsh

Ubuntu (bash)

chmod +x fetch/aygeafetch-ubuntu.sh
sudo cp fetch/aygeafetch-ubuntu.sh /usr/local/bin/aygeafetch

Add to ~/.bashrc (at the end):

aygeafetch

Arch Linux (bash)

chmod +x fetch/aygeafetch-arch.sh
sudo cp fetch/aygeafetch-arch.sh /usr/local/bin/aygeafetch

Add to ~/.bashrc (at the end):

aygeafetch

---

Troubleshooting

Icons showing as boxes/squares: → Nerd Font not set in iTerm2. Preferences → Profiles → Text → Font.

Powerline arrows showing as > or ?: → Same as above — Nerd Font required.

╭─ ╰─ showing as _─ or garbled in tmux: → Locale not installed. Follow the locale setup steps for your distro. Must log out completely, not just source.

tmux colors look wrong / still greenish: → Run tmux kill-server then start fresh. Sourcing .tmux.conf alone doesn't always apply all color changes.

Selection highlight invisible in tmux: → Check ~/.tmux.conf has: set -g mode-style "fg=#0F1020,bg=#AFCBFF,bold"

Prompt not drawing correctly inside tmux: → Make sure TERM and COLORTERM exports are at the top of ~/.bashrc before everything else, then tmux kill-server and start fresh.

Starship not loading: → The eval line must be at the very END of your rc file, after all exports.

Locale error: cannot change locale (en_US.UTF-8): → The locale isn't generated yet. Run the locale setup steps for your distro above.

Mac prompt has unwanted gap between ╭─ and ╰─: → Remove any blank line or trailing \ after $time in ~/.config/starship.toml.

tmux prefix key: → This config uses Ctrl+A instead of the tmux default Ctrl+B.

---

AygeaNight — built March 2026 🦊