_)
__ _ __ __
/ _|_ _ ___ ___ | |__ | \/ |__ _ _ _ __ _ ___
| _| '_/ -_)(_-< | '_ \ | |\/| / _` | ' \/ _` / _ \
|_| |_| \___)/___||_||_| |_| |_\__,_|_||_\__, \___/
|___/
A terminal UI for Linux fan control via nbfc-linux, built with the Charmbracelet stack.
- Dashboard — Live CPU temperature and fan speed monitoring with real-time graphs
- Curve Editor — Visual temperature-to-fan-speed threshold editor
- Installer Wizard — Guided setup for nbfc-linux detection, model configuration, and service activation
- Hub Navigation — Central hub-and-spoke menu for quick access to all views
- Warm Ember Theme — Amber/teal color palette designed for extended terminal sessions
- Go 1.24+
- Linux (nbfc-linux is Linux-only)
- nbfc-linux installed and available on
$PATH
git clone https://github.com/juandagalo/fresh-mango.git
cd fresh-mango
make buildThe binary is written to ./freshMango.
go install github.com/mango/freshMango@latest# Run freshMango (some nbfc operations require root)
freshMango
# Or with sudo for full fan control
sudo freshMangoOn first run, if nbfc-linux is not detected or not configured, freshMango launches the Installer Wizard to walk you through setup. Once configured, the app opens to the Hub where you can navigate to any view.
| Key | Action |
|---|---|
↑ / k |
Move up |
↓ / j |
Move down |
1–6 |
Jump to menu item |
Enter |
Select / confirm |
Esc |
Back to hub |
q |
Quit |
freshMango/
├── main.go # Entry point — launches Bubble Tea program
├── internal/
│ ├── tui/ # Terminal UI layer (Bubble Tea models & views)
│ │ ├── app.go # Root model, startup state machine, view routing
│ │ ├── hub.go # Hub menu (central navigation)
│ │ ├── dashboard.go # Live monitoring view
│ │ ├── curve.go # Curve editor view
│ │ ├── installer.go # Installer wizard (setup flow)
│ │ └── styles.go # Warm Ember theme (colors & Lipgloss styles)
│ ├── nbfc/ # nbfc-linux CLI wrapper
│ │ └── nbfc.go # Commands: status, config set/list, start/stop
│ └── system/ # System-level utilities
│ └── system.go # Root detection, command execution helpers
├── Makefile # Build, test, lint, coverage targets
└── .github/
└── workflows/ci.yml # CI pipeline (lint, test, build)
Stack: Bubble Tea (TUI framework) · Lipgloss (styling) · nbfc-linux (fan control backend)
| Phase | Focus | Status |
|---|---|---|
| 1 | Foundation | ✅ Complete — theme, hub, installer wizard, smart entry routing |
| 2 | Core Controls | 🔜 Next — fan speed override, profile switching |
| 3 | Profiles & Sensors | 🔜 Planned — sensor configuration UI, config rating system |
| 4 | IPC & Polish | 🔜 Planned — real-time IPC, dashboard enhancements, settings |
Contributions are welcome! Please read CONTRIBUTING.md for guidelines on branching, commit messages, and the pull request process.
This project uses Conventional Commits and enforces quality gates via make check.
This project is released under the MIT License.