jensoft/moonriver repository overview

⁠Moonriver - CLI для управления Klipper 3D принтером

Moonriver — это утилита командной строки для удалённого управления 3D принтерами на базе Klipper через Moonraker API.

⁠О проекте

Исходный репозиторий: https://github.com/willpuckett/moonriver⁠

Moonriver собран из официального репозитория и упакован в Docker контейнер для удобного использования на Windows, Linux и macOS.

⁠Возможности

• ✅ Управление принтером через WebSocket
• ✅ Отправка G-code команд
• ✅ Мониторинг состояния принтера в реальном времени
• ✅ Просмотр координат инструмента (X, Y, Z, E)
• ✅ Интерактивный интерфейс командной строки
• ✅ Управление движением (homing, jogging)
• ✅ Контроль температуры

⁠Быстрый старт

⁠Установка образа

docker pull jensoft/moonriver:latest

⁠Запуск с подключением к принтеру

Замени 192.168.0.30 на IP адрес твоего Moonraker/Klipper:

docker run -it --rm jensoft/moonriver:latest --host 192.168.0.30 --port 7125

⁠Windows - Запуск из консоли

1. Нажми Win+R
2. Введи cmd и нажми Enter
3. Скопируй и вставь эту команду:

docker run -it --rm jensoft/moonriver:latest --host 192.168.0.30 --port 7125

1. Нажми Enter

⁠Параметры запуска

⁠Пример использования

# Подключение к принтеру на локальной сети
docker run -it --rm jensoft/moonriver:latest --host 192.168.0.30 --port 7125

# Подключение к локальному Moonraker
docker run -it --rm jensoft/moonriver:latest --host localhost --port 7125

⁠Команды в интерфейсе Moonriver

После запуска контейнера будет доступен интерактивный интерфейс:

⁠Требования

• Docker (установлен и запущен)
• Доступ к Moonraker на локальной сети (порт 7125)
• Klipper 3D принтер с Moonraker

⁠Построение образа локально

Если нужно собрать образ самостоятельно:

git clone https://github.com/willpuckett/moonriver.git
cd moonriver
docker build -t moonriver:latest .

⁠Поддерживаемые платформы

• ✅ Windows 10/11 с Docker Desktop
• ✅ Linux с Docker
• ✅ macOS с Docker Desktop

⁠Размер образа

32.6 MB (компактный и быстро загружается)

⁠Лицензия

Moonriver - исходный проект: https://github.com/willpuckett/moonriver⁠

⁠Поддержка

Для вопросов и проблем:

• GitHub: https://github.com/willpuckett/moonriver/issues⁠
• Docker Hub: https://hub.docker.com/r/jensoft/moonriver⁠

⁠Скриншот

C:\Windows\system32\cmd.exe - docker run -it --rm moonriver:latest --host 192.168.0.30 --port 7125

192.168.0.30:7125   Standby      Position
E16.9°/0°   I 17.1°/0°   uC:42.5°   uC:19.8°   uC:22.9°ctD 0%(0rpm)raη 100%   ⊞ 0%(Rpm)

DX:60.0   DY:105.0   DZ:-5.00   |   ⊞ Home All

Current Position ─────────────────────────────────────────────────────────────

⊞ X:     60.00 mm
⊞ Y:    105.00 mm
⊞ Z:     -5.00 mm
  E:      0.00 mm

Movement Controls ─────────────────────────────────────────────────────────────

Homing Controls

  x - Home X axis
  y - Home Y axis
  z - Home Z axis
  a - Home all axes

Jogging (Coming Soon)
  Arrow keys - Jog X/Y
  PgUp/PgDn - Jog Z
  +/- - Change distance

[P]osition   [O]bs   [H]elp   [X/Y/Z]Home   [A]ll   [E]mp   [L]oc   [Q]uit

Дата создания: 2026-02-13
Версия: 1.0
Статус: Активный