�️
Terminal User Interface (TUI)
Full-featured dashboard with real-time monitoring, interactive controls, and mouse support
MoonriverTerminal Console for Klipper
Fast, efficient, and color-coded printer control from the command line
Skip to content
Quick Example
bash
# Launch the Terminal User Interface
moonriver --host 192.168.1.100 --port 7125
# Interactive dashboard with:
# - Temperature bar (click setpoints to edit)
# - Fan speed control (click percentages to edit)
# - Position bar (click coordinates to move)
# - Job browser with mouse scroll and click (press j)
# - Console (press c)
# - Global temperature/position toggles (t/l keys)
# - Mouse support throughoutbash
# Connect to your printer
moonriver --repl --host 192.168.1.100 --port 7125
# Start typing commands
> G28
> M105
> SET_HEATER_TEMPERATURE HEATER=extruder TARGET=200bash
# Execute commands directly
moonriver --host printer.local --port 7125 G28
# Multiple commands with comma separator
moonriver --host printer.local --port 7125 "G28, M105, GET_POSITION"bash
# Use with GNU Parallel
parallel -j 0 moonriver --host {} --port 7125 G28 ::: printer1 printer2 printer3Why Moonriver?
Moonriver brings the power of Klipper control directly to your terminal, perfect for:
- System Administrators: Manage printers via SSH without a GUI
- Power Users: Faster workflows with keyboard-driven interface
- Automation: Integrate printer control into scripts and workflows
- Multiple Printers: Efficiently manage printer farms
- Debugging: Quick access to printer status and commands
Installation
bash
cargo install moonriverbash
git clone https://github.com/willpuckett/moonriver.git
cd moonriver
cargo build --releasebash
cargo binstall moonriverCommunity
- GitHub Discussions - Ask questions and share ideas
- Issue Tracker - Report bugs and request features
- Contributing Guide - Learn how to contribute
License
Moonriver is MIT licensed.