OpenCCVoice for DVSwitch ダッシュボード 導入/取扱説明書
2026年6月23日
2026年6月27日
このドキュメントでは、DVSwitch 向けダッシュボード「OpenCCVoice for DVSwitch Web Dashboard」の導入(インストール)、確認、削除(アンインストール)の手順を説明します。

概要
OpenCCVoice for DVSwitch Web Dashboard は、DVSwitch Bot の設定・監視・サービス制御を行う軽量な Web ダッシュボードです。Raspberry Pi 上の Flask アプリとして動作します。
主な機能
| 機能 | 説明 |
|---|---|
| サービス制御 | dvswitch-bot の Start / Stop / Restart |
| Bot 設定 | bot_config.json の全項目を Web フォームで編集(送出音量 TX_GAIN を含む) |
| カスタム音声 | 標準音声(intro/001/002)を cstm_*.wav に個別に差し替え。ファイルが無ければ自動で標準音声にフォールバック |
| DVSwitch 設定 | MMDVM_Bridge.ini / Analog_Bridge.ini を Web フォームで編集 |
| 自動バックアップ | DVSwitch 設定保存時に /opt/dvswitch_bot/bak/ini/ へ自動バックアップ |
| ログ表示 | MMDVM_Bridge ログ末尾 5 行を表示・30 秒自動更新 |
| バックアップ一覧 | ini バックアップのタイムスタンプ一覧(最新 10 件) |
| 変更ログ | Bot 設定の変更履歴(項目・変更前後の値・日時)を記録・表示 |
前提条件
本手順は、以下の環境を前提としています。
- Raspberry Pi(Raspbian / Raspberry Pi OS)
- Python 3 +
python3-flask - DVSwitch(MMDVM_Bridge + Analog_Bridge)インストール済み
dvswitch-botサービス設定済み- Raspberry Pi がインターネットに接続できること
📝 メモ:インストール・アンインストールには管理者権限が必要です。コマンド実行時に
sudo のパスワードを求められる場合があります。導入(インストール)
インストールの実行
- Raspberry Pi のターミナルを開きます。
- 以下のコマンドを実行し、インストールスクリプトを取得・実行します。
curl -fsSL https://raw.githubusercontent.com/ji2tab/OpenCCVoice-For-DVSwitch/main/dashboard/install.sh | sudo bash
確認
インストール後、サービスが正常に起動しているかを確認します。
sudo systemctl status dvswitch-web
期待される出力は次のとおりです(active (running) が表示されれば正常です)。
● dvswitch-web.service Loaded: loaded Active: active (running)
アクセス方法
- Web ブラウザを開きます。
- アドレスバーに以下の URL を入力してアクセスします(ポートは
8081)。<Raspberry-Pi-IP>は対象機の IP アドレスに置き換えてください。
http://<Raspberry-Pi-IP>:8081/
サービス管理コマンド
ダッシュボードのサービスは、以下のコマンドで管理できます。状態確認、起動、停止、再起動、ログ確認をそれぞれ実行できます。
sudo systemctl status dvswitch-web
sudo systemctl start dvswitch-web
sudo systemctl stop dvswitch-web
sudo systemctl restart dvswitch-web
サービスのログを確認するには、以下を実行します。
journalctl -u dvswitch-web -n 50
削除(アンインストール)
⚠️ 注意:この操作により、ダッシュボードに関連する設定やファイルがシステムから削除されます。実行前に、削除して問題ないか必ず確認してください。
アンインストールの実行
- Raspberry Pi のターミナルを開きます。
- 以下のコマンドを実行し、アンインストールスクリプトを取得・実行します。
curl -fsSL https://raw.githubusercontent.com/ji2tab/OpenCCVoice-For-DVSwitch/main/dashboard/uninstall.sh | sudo bash
確認
アンインストール後、サービスが削除されたことを確認します。次のコマンドでサービスが見つからなければ、削除は完了しています。
systemctl status dvswitch-web
期待される出力は次のとおりです(could not be found が表示されれば削除済みです)。
Unit dvswitch-web.service could not be found.
📝 執筆:JI2TAB(尾張旭 DMR デジピーター 管理人)
🏛 JJ2YYK あいちデジタルコミュニケーションハムクラブ