Customization
gpulse is designed to look great in any terminal. This guide covers themes, fonts, terminal recommendations, and the full keybinding reference.
Themes
gpulse ships with 15 built-in colour themes. Press t to cycle through them. The active theme name is shown briefly in the status bar.
Available Themes
| Theme | Notes |
|---|---|
| Electric Green | Default gpulse theme; high contrast on dark backgrounds |
| Dracula | Dark purple/pink palette popular with VS Code users |
| Nord | Muted blue/arctic tones; easy on the eyes |
| Gruvbox Dark | Warm retro browns and yellows |
| Gruvbox Light | Light-mode variant of Gruvbox |
| Tokyo Night | Deep indigo with neon accents |
| Catppuccin Mocha | Pastel dark theme |
| Catppuccin Latte | Pastel light theme |
| One Dark | Atom One Dark palette |
| Solarized Dark | Low-contrast dark mode with calibrated colours |
| Solarized Light | Low-contrast light mode |
| Monokai | High-contrast; strong green, pink, and yellow accents |
| Rose Pine | Muted warm tones |
| Kanagawa | Japanese woodblock print inspired; deep blues and golds |
| Monochrome | Pure greyscale; maximum compatibility |
Colorblind-Safe Options
- Solarized Dark / Light — uses hue and brightness together, not colour alone, for status encoding
- Monochrome — uses only brightness and symbols; fully accessible
Recommended Fonts
gpulse uses Unicode box-drawing characters and Braille block characters for sparklines. These render correctly only with fonts that include the relevant Unicode ranges.
| Font | Notes |
|---|---|
| JetBrains Mono | Excellent Unicode coverage; slightly wider box-drawing glyphs look good in gpulse |
| Fira Code | Programming ligatures; clean, thin box-drawing |
| Cascadia Code | Microsoft's terminal font; very complete Unicode coverage |
Minimum recommended size: 12 pt at standard DPI, or 14 pt on HiDPI / Retina displays. If box-drawing characters appear as question marks, switch to one of these fonts and restart your terminal.
Terminal Emulators
gpulse works in any VT100-compatible terminal. These emulators provide the best experience:
iTerm2 (macOS)
Native macOS app with excellent Retina rendering, 24-bit true colour, and GPU-accelerated Metal renderer.
Alacritty (cross-platform)
Written in Rust; designed for speed with minimal overhead. Ideal for large GPU fleets.
Kitty (cross-platform)
GPU-accelerated with OpenGL. Native support for extended colour sequences and ligatures.
Ghostty (macOS, Linux)
Modern terminal written in Zig. Ships with JetBrains Mono — no configuration needed for correct gpulse rendering.
Terminal Size
| Setting | Value |
|---|---|
| Minimum | 80 columns x 24 rows |
| Recommended | 120 columns x 40 rows |
| Ideal for 8+ GPU Grid | 160 columns x 50 rows |
Below 80x24, gpulse displays a resize prompt and pauses rendering. Wider terminals allow more GPU tiles per row in Grid view.
Keybinding Reference
| Key | Action |
|---|---|
| ? | Open keyboard shortcut help overlay |
| q | Quit gpulse |
| g | Switch to Grid view |
| d | Switch to Detail view |
| v | Switch to List view |
| P | Switch to Predict (leak detection) view |
| c | Switch to Compare view |
| t | Topology view / cycle themes (context-dependent) |
| F | Fleet view (Pro) |
| o | Cycle sort order |
| Ctrl+P | Open command palette |
| Up / Down | Navigate GPU list / process table |
| Left / Right | Navigate Compare view targets |
| Enter | Select highlighted GPU |
| PgUp / PgDn | Previous / next page (16+ GPU systems) |
Note: t switches to Topology view from most views, but cycles themes when pressed from Topology view itself. To cycle themes from any view, use the command palette (Ctrl+P) and search for "theme".