Meshtastic-Android/main/docs/ja-rJP/user/desktop.html

<!DOCTYPE html>
<html lang="ja-rJP" dir="ltr">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>デスクトップアプリ</title>
  <link rel="stylesheet" href="../../styles/docs.css">
</head>
<body data-page="desktop" data-locale="ja-rJP">
<pre class="markdown-content"># デスクトップアプリ

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](https://github.com/meshtastic/Meshtastic-Android/releases)
- Or install from Flathub: `flatpak install flathub org.meshtastic.MeshtasticDesktop`
- または、`./gradlew :desktopApp:run` を使ってソースからビルドします

### macOS

- Download the `.dmg` package from the [releases page](https://github.com/meshtastic/Meshtastic-Android/releases)
- または、ソースからビルドします

### Windows

- Download the `.msi` or `.exe` installer from the [releases page](https://github.com/meshtastic/Meshtastic-Android/releases)
- または、ソースからビルドします

## 無線機を接続する

### 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](https://github.com/JuulLabs/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 に公開します。[アプリ機能](app-functions) を参照してください。

## 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.

![目次付きのドキュメントブラウザー](../../assets/screenshots/docs-browser_toc.png)

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

![ドキュメントブラウザーの検索](../../assets/screenshots/docs-browser_search.png)

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

![ドキュメントページ](../../assets/screenshots/docs-browser_page.png)

## ソースからビルドする

```shell
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 &amp; Waypoints](map-and-waypoints).
- `.kml`/`.kmz`/GeoJSON layer import works — see
  [Map &amp; Waypoints](map-and-waypoints#map-layers). 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 &amp; Waypoints](map-and-waypoints#adding-your-own-tile-source)
- 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](https://flasher.meshtastic.org) instead
- 一部の Android 固有の機能（ウィジェット、特定の通知チャンネル）は利用できません
- Compose Desktop を実行する低スペックのハードウェアでは、パフォーマンスが変わることがあります
- デスクトップでは BLE のボンディングはまだサポートされていません（ペアリングはボンディングなしで機能します）

## 関連トピック

- [コネクション](connections)：接続方法の概要
- [Firmware Updates](firmware) — in-app USB, BLE, and Wi-Fi update all work the same as on Android
- [Map &amp; Waypoints](map-and-waypoints) — base maps, layers, custom tile sources, and what the desktop map does not do
</pre>
</body>
</html>