Настольное приложение
Настольное приложение Meshtastic использует общий код с Android через Kotlin Multiplatform. Большинство функций работают одинаково на Linux, macOS и Windows.
Установка
Linux
- Скачайте пакет
.debили.AppImageсо страницы релизов - Или соберите из исходного кода с помощью
./gradlew :desktopApp:run
macOS
- Скачайте пакет
.dmgиз релизов - Или соберите из исходных кодов
Windows
- Загрузите установщик
.msiсо страницы релизов - Или соберите из исходных кодов
Подключение твоей радиостанции
Последовательная USB (Основной)
Наиболее надежный способ подключения к компьютеру:
- Подключите свою радиостанцию Meshtastic через USB-кабель.
- Приложение должно автоматически определить последовательный порт.
- Если порт не определён, выберите правильный последовательный порт в меню “Подключение”.
TCP/IP
Для радиостанций, подключённых по сети:
- Введите IP-адрес и порт радиостанции (по умолчанию: 4403).
- Нажмите “Подключиться”.
Bluetooth (BLE)
Bluetooth Low Energy поддерживается в настольном приложении с помощью библиотеки Kable:
- Убедитесь, что ваша система оснащена Bluetooth-адаптером.
- Приложение автоматически сканирует находящиеся поблизости радиостанции Meshtastic.
- Выберите своё устройство на экране «Подключение».
Паритет функций
| Функция | Android | Desktop | Заметки |
|---|---|---|---|
| Обмен сообщениями | ✓ | ✓ | Полное равенство |
| Список узлов | ✓ | ✓ | Полное равенство |
| Карта | ✓ | ◐ | Вкладка карты присутствует в настольном приложении, но интерактивный просмотр карты доступен только на Android |
| Настройки | ✓ | ✓ | Полное равенство |
| Bluetooth (BLE) | ✓ | ✓ | Через Kable в настольном приложении |
| Обновление прошивки | ✓ | ✓ | Внутри приложенное обновление по USB, BLE и Wi-Fi (ESP32) работает так же, как на Android |
| Уведомления | ✓ | ✓ | Системные уведомления |
| Виджеты | ✓ | ✗ | Только Android |
| Android Auto | ✓ | ✗ | Только Android — недоступно в настольном приложении или iOS |
| AI-ассистент (Chirpy) | ✓* | ✗ | Только в Google-версии для Android |
| Функции приложения (системный ИИ) | ✓† | ✗ | Только в Google-версии для Android |
*Chirpy AI требует Android 14+ в Google-версии на поддерживаемом оборудовании.
†Функции приложения предоставляют действия приложения системному ИИ Android в Google-версии. См. Функции приложения.
Различия интерфейса
Настольное приложение использует тот же интерфейс на Compose Multiplatform с адаптациями для больших экранов и настольного взаимодействия.
Сочетания клавиш
Сочетания клавиш используют ⌘ (Command) на macOS и Ctrl на Windows и Linux. (Клавиша Super / Windows не используется.)
| Сочетание | Действие |
|---|---|
| ⌘/Ctrl+Q | Выйти из приложения |
| ⌘/Ctrl+, | Открыть настройки |
| ⌘/Ctrl+1 | Перейти во вкладку “Сообщения” |
| ⌘/Ctrl+2 | Перейти во вкладку “Узлы” |
| ⌘/Ctrl+3 | Перейти во вкладку “Карта” |
| ⌘/Ctrl+4 | Перейти во вкладку “Подключение” |
| ⌘/Ctrl+/ | Открыть “О программе” |
Окно и системный трей
- Изменение размера окна — адаптивный макет подстраивается под размеры окна
- Системный трей — сверните в системный трей для фоновой работы mesh-сети
- Меню трея — щёлкните правой кнопкой мыши по значку в трее, чтобы показать окно или выйти
- Взаимодействие с мышью — состояния при наведении и стандартная настольная навигация
Настройки уведомлений
Настольное приложение предоставляет встроенные переключатели для управления отображением уведомлений: сообщения, новые узлы и предупреждения о низком заряде батареи. Доступ к ним осуществляется через Настройки → Уведомления в самом приложении.
Встроенный браузер документации
Настольное приложение включает встроенный браузер документации для быстрого доступа к справочным материалам без выхода из приложения.

Браузер поддерживает полнотекстовый поиск по всей документации:

Отдельные страницы документации отображаются с полным форматированием:

Сборка из исходного кода
git clone https://github.com/meshtastic/Meshtastic-Android.git
cd Meshtastic-Android
./gradlew :desktopApp:run
Требования:
- JDK 21
- Для сборки только настольной версии Android SDK не требуется
Известные ограничения
- Интерактивный просмотр карты доступен только на Android — вкладка «Карта» присутствует в настольном приложении, но не отображает карту
- Некоторые специфичные для Android функции (виджеты, отдельные каналы уведомлений) недоступны
- Производительность может варьироваться на маломощном оборудовании при запуске Compose Desktop
- BLE-связывание пока не поддерживается в настольном приложении (сопряжение работает без связывания)
Связанные темы
- Подключения — обзор методов подключения
- Обновление прошивки — обновление по USB, BLE и Wi-Fi работает так же, как на Android