AygeaNight terminal theme
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>
This commit is contained in:
Aygea
@@ -0,0 +1,226 @@
|
||||
# 🦊 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* 🦊
|
||||
Reference in New Issue
Block a user