🌐 日本語 — Community translation View in English

デスクトップアプリ

This page covers installing the Meshtastic desktop app, connecting a radio, and how it differs from Android. The desktop app shares its core codebase with Android via Kotlin Multiplatform, so most features work identically across Linux, macOS, and Windows.

インストール

Linux

  • Download the .deb, .rpm, or .AppImage package from the releases page
  • Or install from Flathub: flatpak install flathub org.meshtastic.MeshtasticDesktop
  • または、./gradlew :desktopApp:run を使ってソースからビルドします

macOS

  • Download the .dmg package from the releases page
  • または、ソースからビルドします

Windows

  • Download the .msi or .exe installer from the releases page
  • または、ソースからビルドします

無線機を接続する

USB シリアル（主要）

The most reliable connection method on desktop:

Connect your radio via USB. The app detects the serial port automatically; if it doesn’t, select the port from the Connect menu.

TCP/IP

ネットワーク接続された無線機の場合：

  1. 無線機の IP アドレスとポート（既定：4403）を入力します。
  2. 「接続」をクリックします。

Bluetooth（BLE）

Bluetooth Low Energy is supported on desktop via the Kable library:

  1. システムに Bluetooth アダプターがあることを確認します。アプリが近くの Meshtastic 無線機を自動的にスキャンします。
  2. Select your radio from the Connect screen.

機能の対応状況

機能 Android デスクトップ 備考
メッセージング ✓ ✓ 完全対応
ノードリスト ✓ ✓ 完全対応
マップ ✓ ✓ Interactive MapLibre map, with base map and overlay pickers and custom tile sources. Offline terrain (hillshade and contours) can be downloaded; offline base-map packs and local .mbtiles archives cannot
Map layers (.kml/.kmz/GeoJSON) ✓ ✓ Same layer store and sheet as Android; imported files draw on the desktop map
サイトプランナー ✓ ✓* *Opens in your browser on desktop; the estimate is not drawn on the desktop map
設定 ✓ ✓ 完全対応
Bluetooth（BLE） ✓ ✓ デスクトップでは Kable 経由
ファームウェアの更新 ✓ ✓ In-app USB, BLE, and Wi-Fi (ESP32) update work the same as Android. The USB maintenance flow — nRF52/RP2040 factory erase and bootloader upgrade — is Android-only
通知 ✓ ✓ OS ネイティブの通知
ウィジェット ✓ ✗ Android のみ
AI アシスタント（Chirpy） ✓* ✗ Google 版の Android のみ
アプリ機能（システム AI） ✓† ✗ Google 版の Android のみ

*Chirpy AI には、対応ハードウェアを備えた Google 版ビルドで Android 14 以降が必要です。

†アプリ機能は、Google 版ビルドで、アプリの操作を Android のシステム AI に公開します。アプリ機能 を参照してください。

UI の違い

The desktop app uses the same Compose Multiplatform UI with adaptations for larger screens and desktop interaction.

キーボードショートカット

ショートカットは、macOS では ⌘（Command）、Windows と Linux では Ctrl を使用します。 （Super／Windows キーは割り当てられていません。）

ショートカット 操作
⌘/Ctrl+Q Quit the app
⌘/Ctrl+, 設定を開く
⌘/Ctrl+1 メッセージタブに切り替え
⌘/Ctrl+2 ノードタブに切り替え
⌘/Ctrl+3 マップタブに切り替え
⌘/Ctrl+4 接続タブに切り替え
⌘/Ctrl+/ バージョン情報を開く

ウィンドウとシステムトレイ

  • ウィンドウのサイズ変更：レスポンシブなレイアウトがウィンドウの寸法に合わせて調整されます
  • System tray — closing the window minimizes to the system tray for background mesh operation. On a desktop environment with no tray, there is nowhere to minimize to, so closing quits the app instead
  • トレイメニュー：トレイアイコンを右クリックして、ウィンドウ表示または終了します
  • マウス操作：ホバー状態と標準的なデスクトップのナビゲーション

通知の設定

The desktop app provides in-app toggles for controlling which notifications are shown. Find them in the App Notifications section of the Settings screen: Direct message notifications, New node notifications, and Low battery notifications.

組み込みのドキュメントブラウザー

The desktop app includes a built-in documentation browser for quick access to help content without leaving the app.

目次付きのドキュメントブラウザー

ブラウザーは、すべてのドキュメントを対象とした全文検索に対応しています：

ドキュメントブラウザーの検索

個々のドキュメントページは、完全な書式で表示されます：

ドキュメントページ

ソースからビルドする 

git clone https://github.com/meshtastic/Meshtastic-Android.git
cd Meshtastic-Android
./gradlew :desktopApp:run

要件：

  • JDK 25 (Gradle can provision the toolchain itself via foojay)
  • デスクトップのみのビルドに Android SDK は不要です

既知の制限

  • Offline base-map downloads and local .mbtiles archives are not available on desktop. Offline terrain is — see Map & Waypoints.
  • .kml/.kmz/GeoJSON layer import works — see Map & Waypoints. Site Planner opens in your browser rather than in the app; to bring its coverage estimate onto the map, click the transmitter pin in the browser and use the planner’s GeoJSON export, then add the file as a layer — not the KML export, which is a ground-overlay image this map cannot draw. Custom network tile sources work too — see Map & Waypoints
  • The USB maintenance flow — nRF52/RP2040 factory erase and bootloader upgrade — is Android-only, and the desktop app does not offer it. Use the Web Flasher instead
  • 一部の Android 固有の機能（ウィジェット、特定の通知チャンネル）は利用できません
  • Compose Desktop を実行する低スペックのハードウェアでは、パフォーマンスが変わることがあります
  • デスクトップでは BLE のボンディングはまだサポートされていません（ペアリングはボンディングなしで機能します）

関連トピック