Repository navigation
Releases
BALAN v0.4.0
BALAN v0.4.0
Balance Board Assisted Reading And Navigation — Wii Balance Board を、足で操作する常駐スクロールアプリ。
v0.4.0 の変更点
電池が弱ったときに、ボードのセンサーが反応しなくなる問題への対応です。
- センサーが固まったときの検知と警告: 接続は生きているのに、センサーの生の値が 60 秒間まったく変化しない(または荷重のデータが 3 秒届かない)と、警告を出します。そのとき、画面とトレイの通信ランプが赤になり、状態が「Sensors frozen」になります(接続は切りません。値が戻れば緑に戻ります)
- 電池残量の%表示をやめました: 実機では、電池が切れる直前まで 98% のままで、当てになりませんでした。ボード自身が「電池残量わずか」と報告したときだけ「Battery LOW」と警告します
- 切断の原因ログ: 想定外の切断が起きたとき、接続時間、受信フレーム数、例外などをフッターと
balan.log(Windows:%APPDATA%\BALAN\、Linux:~/.config/BALAN/)に残します - ボードの電池の生の値も
balan.logに記録します
v0.3.1 までの機能(Horizontal モード、二重起動の防止、トレイのモード切替、シャットダウン時の修正)は、そのまま含みます。
モード
- Vertical(既定): 右足で進む、左足で止まる。TR = 上 / BR = 下、TL または BL が 5 kg 以上でブレーキ
- Horizontal: 右足で右へ、左足で左へ。TR/BR = 右、TL/BL = 左
荷重が 2 kg 未満は無反応、2〜3 kg が Slow、3〜4 kg が Medium、4 kg 以上が Fast(なめらかなカーブ)。
ダウンロード
| ファイル | 対象 | 状態 |
|---|---|---|
BALAN-win-x64.zip |
Windows 10/11 x64(.NET 不要、単一 exe) | 実機で動作確認済み(Horizontal・二重起動防止・トレイのモード切替・シャットダウン時の修正・センサー固まりの検知を含む) |
BALAN-linux-x64.tar.gz |
Linux x64(.NET 不要) | 実機で動作確認済み(v0.3 まで)。v0.4.0 の新機能は未テスト(下記) |
SHA-256:
e077629d0c4d03fdf8de4562eca5ec8b7695b0aa5308d29354b139e171388215 BALAN-win-x64.zip
7ffa31c7e5fc4c30b04fefe4b9a43b7e19eecdd21886b9e57fef98028efef871 BALAN-linux-x64.tar.gz
Linux 版について
Linux 版は、v0.3 までの機能(接続、スクロール、トレイなど)を、実機の Wii Balance Board で確認しました。
v0.4.0 で追加した、センサーが固まったときの検知と警告、電池の警告表示は、Linux では未テストです(Windows と共通のコードで、Windows の実機では確認済みです)。
注意: ボードが他の端末(Windows など)とペアリングされていると、接続できません。その場合は、先に相手側でペアリングを解除してください(KUNAI と同じ挙動です)。
動かない場合や不具合は、Issue で教えてください。Linux では、初回だけ権限の設定が必要です。
tar xzf BALAN-linux-x64.tar.gz && cd BALAN-linux-x64
sudo cp 99-balan.rules /etc/udev/rules.d/
sudo udevadm control --reload-rules && sudo udevadm trigger
sudo usermod -aG input "$USER" # ログインし直す
sudo modprobe uinput
./BALAN
使い方
- Connect を押し、ボードの赤い SYNC ボタン(電池ボックス内)を押す
- 足をボードに載せた状態(押さずに)で Calibrate
- Scroll Mode を選び(画面、またはトレイの右クリックメニュー)、足で操作する
起動オプション: --simulate --minimized --no-tray --no-autoconnect
詳細は docs/DESIGN.md を参照してください。
BALAN v0.3.1
BALAN v0.3.1
Balance Board Assisted Reading And Navigation — Wii Balance Board を、足で操作する常駐スクロールアプリ。
v0.3.1 の変更点
- 修正: BALAN を起動したまま Windows をシャットダウン/サインアウトすると、例外が出て止まる問題
- 終了時に接続管理が二重に破棄されて例外になっていた問題を修正
- 終了要求をキャンセルして OS のシャットダウンを阻止していた問題を修正(終了時の後始末をその場で済ませるように変更)
v0.3.0 までの機能(Horizontal モード、二重起動の防止、トレイのモード切替)は、そのまま含みます。
モード
- Vertical(既定): 右足で進む、左足で止まる。TR = 上 / BR = 下、TL または BL が 5 kg 以上でブレーキ
- Horizontal: 右足で右へ、左足で左へ。TR/BR = 右、TL/BL = 左
荷重が 2 kg 未満は無反応、2〜3 kg が Slow、3〜4 kg が Medium、4 kg 以上が Fast(なめらかなカーブ)。
ダウンロード
| ファイル | 対象 | 状態 |
|---|---|---|
BALAN-win-x64.zip |
Windows 10/11 x64(.NET 不要、単一 exe) | 実機で動作確認済み(Horizontal・二重起動防止・トレイのモード切替・シャットダウン時の修正を含む) |
BALAN-linux-x64.tar.gz |
Linux x64(.NET 不要) | 実機で動作確認済み(下記に注意事項) |
SHA-256:
0fd00463664afaf216c6f5ffbde7cd3563a632f5e0a1aeff7615705284b7fc01 BALAN-win-x64.zip
6b5c69d67aebe968f4c6613965026ad47a6768def9bb4fe9443ceb7c61fbbf7a BALAN-linux-x64.tar.gz
Linux 版について
Linux 版は、実機の Wii Balance Board で動作を確認しました。
注意: ボードが他の端末(Windows など)とペアリングされていると、接続できません。その場合は、先に相手側でペアリングを解除してください(KUNAI と同じ挙動です)。
動かない場合や不具合は、Issue で教えてください。Linux では、初回だけ権限の設定が必要です。
tar xzf BALAN-linux-x64.tar.gz && cd BALAN-linux-x64
sudo cp 99-balan.rules /etc/udev/rules.d/
sudo udevadm control --reload-rules && sudo udevadm trigger
sudo usermod -aG input "$USER" # ログインし直す
sudo modprobe uinput
./BALAN
使い方
- Connect を押し、ボードの赤い SYNC ボタン(電池ボックス内)を押す
- 足をボードに載せた状態(押さずに)で Calibrate
- Scroll Mode を選び(画面、またはトレイの右クリックメニュー)、足で操作する
起動オプション: --simulate --minimized --no-tray --no-autoconnect
詳細は docs/DESIGN.md を参照してください。
BALAN v0.3.0
BALAN v0.3.0
Balance Board Assisted Reading And Navigation — Wii Balance Board を、足で操作する常駐スクロールアプリ。
v0.3.0 の変更点
- トレイの右クリックメニューからモードを切り替え可能に: 「Scroll Mode: Vertical (click to switch)」のように現在のモードが表示され、クリックで Vertical ⇄ Horizontal が切り替わります(画面の設定と連動、次回起動時も保持)
v0.2.0 から引き続き、Horizontal(チルトホイール)モードと二重起動の防止を含みます。
モード
- Vertical(既定): 右足で進む、左足で止まる。TR = 上 / BR = 下、TL または BL が 5 kg 以上でブレーキ
- Horizontal: 右足で右へ、左足で左へ。TR/BR = 右、TL/BL = 左
荷重が 2 kg 未満は無反応、2〜3 kg が Slow、3〜4 kg が Medium、4 kg 以上が Fast(なめらかなカーブ)。
ダウンロード
| ファイル | 対象 | 状態 |
|---|---|---|
BALAN-win-x64.zip |
Windows 10/11 x64(.NET 不要、単一 exe) | 実機で動作確認済み(Horizontal・二重起動防止を含む) |
BALAN-linux-x64.tar.gz |
Linux x64(.NET 不要) | 実機で動作確認済み(下記に注意事項) |
SHA-256:
0a92bbc90adf76edc0aa7c8dce7a5ad7996d3548214a8dddbcd2ced7b0d6d4a2 BALAN-win-x64.zip
7e05888cf25ca0c6463cfddabd56ea1248689705fc63f910bb737496513942c6 BALAN-linux-x64.tar.gz
Linux 版について
Linux 版は、実機の Wii Balance Board で動作を確認しました。
注意: ボードが他の端末(Windows など)とペアリングされていると、接続できません。その場合は、先に相手側でペアリングを解除してください(KUNAI と同じ挙動です)。
動かない場合や不具合は、Issue で教えてください。Linux では、初回だけ権限の設定が必要です。
tar xzf BALAN-linux-x64.tar.gz && cd BALAN-linux-x64
sudo cp 99-balan.rules /etc/udev/rules.d/
sudo udevadm control --reload-rules && sudo udevadm trigger
sudo usermod -aG input "$USER" # ログインし直す
sudo modprobe uinput
./BALAN
使い方
- Connect を押し、ボードの赤い SYNC ボタン(電池ボックス内)を押す
- 足をボードに載せた状態(押さずに)で Calibrate
- Scroll Mode を選び(画面、またはトレイの右クリックメニュー)、足で操作する
起動オプション: --simulate --minimized --no-tray --no-autoconnect
詳細は docs/DESIGN.md を参照してください。
BALAN v0.2.0
BALAN v0.2.0
Balance Board Assisted Reading And Navigation — Wii Balance Board を、足で操作する常駐スクロールアプリ。
v0.2.0 の変更点
- Horizontal(チルトホイール)モードを追加: 設定の Scroll Mode で Vertical / Horizontal を切り替え(既定は Vertical、設定は保存されます)
- 右足(TR / BR)= 右スクロール、左足(TL / BL)= 左スクロール。ブレーキはなく、足を離せば止まります
- 荷重 → 速度の変換は Vertical と共通
- Windows は水平ホイール、Linux は
REL_HWHEELで送出
- 二重起動の防止: 既に起動している場合、2 つ目は何も表示せずに終了します
- README・モック・スクリーンショットを現在の画面に更新
モード
- Vertical(既定): 右足で進む、左足で止まる。TR = 上 / BR = 下、TL または BL が 5 kg 以上でブレーキ
- Horizontal: 右足で右へ、左足で左へ。TR/BR = 右、TL/BL = 左
荷重が 2 kg 未満は無反応、2〜3 kg が Slow、3〜4 kg が Medium、4 kg 以上が Fast(なめらかなカーブ)。
ダウンロード
| ファイル | 対象 | 状態 |
|---|---|---|
BALAN-win-x64.zip |
Windows 10/11 x64(.NET 不要、単一 exe) | 実機で動作確認済み(Horizontal・二重起動防止を含む) |
BALAN-linux-x64.tar.gz |
Linux x64(.NET 不要) |
SHA-256:
ea5947a9b1444c83809a6143772436ae46ee5e795bbc1306c4700258f0459d98 BALAN-win-x64.zip
f1cdba813cd9a117f6ed245738f68781056d4345f37e3f5bca3197d23aac5aec BALAN-linux-x64.tar.gz
⚠️ Linux 版は未テストです
Linux 版は、Wii Balance Board の実機では一度も動作確認していません(Horizontal の REL_HWHEEL 送出も同様です)。確認できているのは、単体テストと、WSLg 上での --simulate 起動までです。
未検証: 実際のスクロール送出(uinput)/ BlueZ での探索と L2CAP 接続 / Linux 実機での Balance Board / トレイ表示
動かない場合や不具合は、Issue で教えてください。Linux では、初回だけ権限の設定が必要です。
tar xzf BALAN-linux-x64.tar.gz && cd BALAN-linux-x64
sudo cp 99-balan.rules /etc/udev/rules.d/
sudo udevadm control --reload-rules && sudo udevadm trigger
sudo usermod -aG input "$USER" # ログインし直す
sudo modprobe uinput
./BALAN
使い方
- Connect を押し、ボードの赤い SYNC ボタン(電池ボックス内)を押す
- 足をボードに載せた状態(押さずに)で Calibrate
- Scroll Mode を選び、足で操作する
起動オプション: --simulate --minimized --no-tray --no-autoconnect
詳細は docs/DESIGN.md を参照してください。
BALAN v0.1.0
BALAN v0.1.0
Balance Board Assisted Reading And Navigation — Wii Balance Board を、足で速度を制御する巡航スクロールに使う常駐アプリ。
右足で進む。左足で止まる。
座って足でボードの 4 隅を踏んで操作します。
- TR = 上スクロール / BR = 下スクロール(荷重が大きい方が勝つ)。2 kg 未満は無反応、2〜3 kg が Slow、3〜4 kg が Medium、4 kg 以上が Fast。速度はなめらかなカーブで上がります
- TL または BL が 5 kg 以上でブレーキ(アクセルより優先)。しきい値は画面で調整できます
- 何も踏まなければ停止。センサー途絶・切断でも停止します
ダウンロード
| ファイル | 対象 | 状態 |
|---|---|---|
BALAN-win-x64.zip |
Windows 10/11 x64(.NET 不要、単一 exe) | 実機で動作確認済み |
BALAN-linux-x64.tar.gz |
Linux x64(.NET 不要) |
SHA-256:
95c51eb71a555364face17c279572465e4dcfea914015828f319fbe9de16dad3 BALAN-win-x64.zip
3f1b2e74147b4d087eeb2796962a6530a192aa3443f338f8fc08ed9fb01c38ed BALAN-linux-x64.tar.gz
⚠️ Linux 版は未テストです
Linux 版は、Wii Balance Board の実機では一度も動作確認していません。確認できているのは次の範囲だけです。
- 単体テスト(uinput のイベント列、バイト列の組み立て、Bluetooth 探索出力の解析など)
- WSLg 上で
--simulate(模擬ボード)が起動して動くこと
未検証: 実際のスクロール送出(uinput)/ BlueZ での探索と L2CAP 接続 / Linux 実機での Balance Board / トレイ表示(XEmbed・StatusNotifierItem)
動かない場合や不具合は、Issue で教えてください。
Linux では、初回だけ権限の設定が必要です。
tar xzf BALAN-linux-x64.tar.gz && cd BALAN-linux-x64
sudo cp 99-balan.rules /etc/udev/rules.d/
sudo udevadm control --reload-rules && sudo udevadm trigger
sudo usermod -aG input "$USER" # ログインし直す
sudo modprobe uinput
./BALAN
使い方
- Connect を押し、ボードの赤い SYNC ボタン(電池ボックス内)を押す
- 足をボードに載せた状態(押さずに)で Calibrate
- 右足で TR / BR を踏むと上 / 下へスクロール、左足で TL / BL を踏むとブレーキ
起動オプション: --simulate(実機なしで画面と巡航を確認) --minimized --no-tray --no-autoconnect
詳細は docs/DESIGN.md を参照してください。