Bed Mesh Visualizer

Анализ карты стола (bed mesh) для 3D-принтеров на Klipper/GoKlipper (в т.ч. Anycubic Kobra S1).

Клиенты: Windows, macOS, Android. На принтер ставится лёгкая веб-панель (gkbridge).

Возможности

Desktop (Windows / macOS)

• Автоимпорт printer_mutable.cfg (JSON и текстовый формат)
• 2D и 3D визуализация рельефа стола
• Мастер выравнивания: пошаговые инструкции (обороты / мм по Z)
• Подключение к принтеру по SSH (без USB)
• Live-калибровка стола с отображением точек и сохранением полной сетки
• Редактор конфигурации с резервными копиями и перезапуском принтера
• Вкладка «Сопло» сохраняет диаметр и материал с резервированием конфигураций и полным перезапуском
• Ace Pro: пресеты скорости подачи/отката до 500%

Веб-панель на принтере (http://<IP>:8088)

• Статус печати, температуры, пауза / стоп
• Живая камера, история событий
• Вкладка Стол: цветная карта mesh (heatmap), сводка min/max/range, кнопка «Обновить»

Android

• SSH-загрузка конфигов, 2D / псевдо-3D, статистика и коррекции
• Live-калибровка стола с отображением точек и сохранением полной сетки
• Редактор расширенных секций конфигурации с бекапами, настройки сопла и перезапуск
• Вкладка Принтер: постоянный SSH (dropbear) и установка веб-панели gkbridge

Подробности: архитектура, webpanel/README.md, android/README.md.

Скачать

Из раздела Releases:

Платформа	Артефакт
Windows	Bed.Mesh.Visualizer.exe
macOS	BedMeshVisualizer_Mac.dmg
Android	BedMeshVisualizer.apk

Клиенты проверяют обновления по своим платформенным тегам; Windows предлагает установить EXE из приложения, а macOS и Android используют опубликованный релиз и системный/браузерный установщик.

Запуск из исходников

Windows (win/pyqt6):

cd win/pyqt6
py -3 main.py
cd ../..

macOS (mac):

Основные операции совпадают с Windows: live-калибровка, сопло и полный перезапуск принтера из редактора. В обеих desktop-сборках 3D-вид использует OpenGL; Windows дополнительно показывает QR-код поддержки проекта.

cd mac
python3 main.py
cd ..

Зависимости Windows: win/pyqt6/requirements.txt. Корневой requirements.txt относится к историческому Streamlit-скрипту и не нужен для PyQt6-клиента.

Android: см. android/README.md.

Работа с Git и релизы

Рабочая ветка проекта — main. Изменения выполняются непосредственно в main; новые ветки и PR для этого проекта не используются.

Теги релизов используют общий номер и платформенный суффикс, например v0.181-win, v0.181-mac, v0.181-android. GitHub Actions собирает и публикует соответствующий артефакт, затем оставляет последний стабильный релиз для этой платформы; исторические Git-теги сохраняются для release notes. Версии находятся в win/pyqt6/utils/version.py, mac/utils/version.py, android/app/build.gradle.kts и webpanel/gkbridge.version.

Правила вкладов: CONTRIBUTING.md.

Веб-панель (gkbridge)

Ставится на принтер из Windows- или Android-приложения (вкладка SSH / Принтер).
После установки: http://<IP принтера>:8088.

Панель получает собственные релизы vX.Y.Z-gkbridge с бинарником Linux ARMv7 и SHA-256. Установщики и самообновление скачивают артефакт из релиза; у панели хранится один последний стабильный релиз, исторические Git-теги сохраняются.

Сборка, API и выпуск версий панели: webpanel/README.md.

Проверки

python win/pyqt6/run_tests.py
cd android; .\gradlew.bat :app:testDebugUnitTest; cd ..
cd webpanel; .\build.ps1; cd ..

Подробное описание потоков данных и сборки: docs/ARCHITECTURE.md.