Aygea
0481603e62
macOS/Ubuntu/Arch config files for iTerm2, tmux, starship prompt, and fox kitsune fetch scripts in brand colors. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
227 lines
5.4 KiB
Markdown
227 lines
5.4 KiB
Markdown
# 🦊 AygeaNight Terminal Setup Guide
|
||
|
||
Tokyo Night base · Aygea brand accent colors
|
||
Baby blue, sapphire, pink, silver — dark navy background
|
||
|
||
---
|
||
|
||
## 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
|
||
|
||
```bash
|
||
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)
|
||
|
||
```bash
|
||
brew install starship
|
||
mkdir -p ~/.config
|
||
cp starship.toml ~/.config/starship.toml
|
||
echo 'eval "$(starship init zsh)"' >> ~/.zshrc
|
||
source ~/.zshrc
|
||
```
|
||
|
||
### Linux — Ubuntu
|
||
|
||
```bash
|
||
curl -sS https://starship.rs/install.sh | sh
|
||
mkdir -p ~/.config
|
||
cp starship.toml ~/.config/starship.toml
|
||
```
|
||
|
||
Add to `~/.bashrc` **above everything else**:
|
||
|
||
```bash
|
||
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`:
|
||
|
||
```bash
|
||
eval "$(starship init bash)"
|
||
```
|
||
|
||
**Locale setup (required — fixes broken ╭─ ╰─ ❯ inside tmux):**
|
||
|
||
```bash
|
||
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
|
||
|
||
```bash
|
||
curl -sS https://starship.rs/install.sh | sh
|
||
mkdir -p ~/.config
|
||
cp starship.toml ~/.config/starship.toml
|
||
```
|
||
|
||
Add to `~/.bashrc` **above everything else**:
|
||
|
||
```bash
|
||
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**:
|
||
```bash
|
||
eval "$(starship init bash)"
|
||
```
|
||
|
||
**Locale setup on Arch** (different from Ubuntu — no package needed):
|
||
|
||
```bash
|
||
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)
|
||
|
||
```bash
|
||
chmod +x fetch/aygeafetch.zsh
|
||
cp fetch/aygeafetch.zsh ~/aygeafetch.zsh
|
||
```
|
||
|
||
Add to `~/.zshrc` (at the end):
|
||
|
||
```bash
|
||
aygeafetch
|
||
# or: source ~/aygeafetch.zsh
|
||
```
|
||
|
||
### Ubuntu (bash)
|
||
|
||
```bash
|
||
chmod +x fetch/aygeafetch-ubuntu.sh
|
||
sudo cp fetch/aygeafetch-ubuntu.sh /usr/local/bin/aygeafetch
|
||
```
|
||
|
||
Add to `~/.bashrc` (at the end):
|
||
|
||
```bash
|
||
aygeafetch
|
||
```
|
||
|
||
### Arch Linux (bash)
|
||
|
||
```bash
|
||
chmod +x fetch/aygeafetch-arch.sh
|
||
sudo cp fetch/aygeafetch-arch.sh /usr/local/bin/aygeafetch
|
||
```
|
||
|
||
Add to `~/.bashrc` (at the end):
|
||
|
||
```bash
|
||
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* 🦊
|