📏 Bed Mesh Visualizer

Профессиональный инструмент для анализа карты стола 3D-принтера на базе Klipper.

✨ Особенности

• 🚀 Умный импорт: Авто-парсинг файла printer_mutable.cfg (JSON и текстовый форматы).
• 📊 Side-by-Side View: Компактное отображение 3D и 2D графиков в один ряд.
• 🔧 Мастер выравнивания: Пошаговые инструкции для настройки винтов (обороты) или валов Z (миллиметры).
• 🖱️ Полный интерактив: Вращайте и изучайте рельеф в реальном времени.

⬇️ Скачать

• Windows (PyQt6): скачайте файл Bed.Mesh.Visualizer.exe из раздела Releases этого репозитория.
• macOS (PyQt6): скачайте файл BedMeshVisualizer_Mac.dmg из раздела Releases этого репозитория.
• Android: скачайте .apk из раздела Releases этого репозитория.

🔄 Автообновления

В приложении есть тихая проверка обновлений при запуске:

• Если доступна новая версия, появится уведомление и кнопка обновления
• На Windows кнопка «Обновить» скачивает новый .exe из GitHub Releases и перезапускает приложение
• На macOS кнопка «Обновить» открывает страницу релиза для скачивания .dmg
• На Android кнопка «Обновить» скачивает .apk из GitHub Releases и открывает системную установку (потребуется подтверждение пользователя)

📄 Политики проекта

• Лицензия: LICENSE (MIT)
• Кодекс поведения: CODE_OF_CONDUCT.md
• Security policy: .github/SECURITY.md

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

Требования

• Python 3
• Зависимости из bedmesh/win/pyqt6/requirements.txt

Запуск

Windows, из папки win/pyqt6:

py -3 main.py

macOS, из папки mac:

python3 main.py

🌿 Ветки (как работаем правильно)

В репозитории есть:

• main — общая база и “источник истины” для всего, что не привязано к платформе.
• windows / mac / android / online — платформенные ветки для изменений, которые реально специфичны и не должны сразу попадать в общий код.

Правило №1 (главное)

Общие изменения делаем через main.
Платформенные ветки регулярно подтягивают main, чтобы не копить большие расхождения.

Как вносить изменения

• Общее/кроссплатформенное (форматы данных, парсер, документация, общий протокол, общие багфиксы):
  • делаем PR в main
  • после мержа обновляем платформенные ветки из main
• Платформенное (UI/сборка/инсталляторы/CI конкретной платформы):
  • делаем PR в соответствующую ветку (windows/mac/android/online)
  • если часть стала общей — отдельным PR переносим в main

Как обновлять платформенную ветку из main

Пример для mac (аналогично для остальных):

git checkout mac
git pull
git merge main
git push

Если вы предпочитаете “линейную” историю, можно вместо merge использовать rebase:

git checkout mac
git pull
git rebase main
git push --force-with-lease

Важно: rebase с --force-with-lease используйте только если вы понимаете последствия (лучше договориться в команде и применять единообразно).

🏷️ Релизы (как публиковать новую версию)

Для Windows и macOS релизы публикуются по тегу:

• Тег формата vX.YYY-win или vX.YYY-mac
• После пуша тега GitHub Actions собирает соответствующий артефакт и прикрепляет его к релизу
• Имена файлов в релизе:
  • Windows: Bed.Mesh.Visualizer.exe
  • macOS: BedMeshVisualizer_Mac.dmg

Пример:

git tag v0.153-win
git push origin v0.153-win

git tag v0.163-mac
git push origin v0.163-mac