examples/ プログラム一覧

cuskey_settings.py で管理するハードウェア設定を共通で利用する CircuitPython サンプル集です。すべてのスクリプトはボタン1個 + モードスイッチ1個の構成を前提としています。

1. auto_keysend.py

自動矢印キー送信

漫画のながら読みにぴったり。ボタンを短押しすることで自動送信の ON/OFF をトグルし、設定した秒数間隔で矢印キーを自動送信します。長押し中は手動で連続送信が可能で、プレゼンのスライド送りや定期的なキー入力の自動化に使用します。

主要定数: SEND_INTERVAL（秒）、LONG_PRESS_TIME、MANUAL_SEND_INTERVAL

2. meeting_controller.py

リモート会議用コントローラー

Zoom・Teams・Google Meet などのオンライン会議でよく使う「マイクミュート切り替え」と「音量調整」をボタン1個で操作できます。短押しでミュートトグル、長押しでモードに応じた音量変更を行います。

主要定数: LONG_PRESS_TIME（0.3秒）、VOLUME_INTERVAL（0.1秒）

3. pin_sender.py

PINコード自動入力キーボード

ボタンを押すだけで、あらかじめ設定した数字列（PINコード）を自動でタイプします。Mode A / B に2種類の PIN を登録でき、ロック解除画面への入力補助などに使用します。

PIN は平文保存のため、銀行等の重要情報への使用は非推奨です。

主要定数: PIN_MODE_A、PIN_MODE_B、DIGIT_INTERVAL、PRE_SEND_ESCAPE、POST_SEND_ENTER

4. ptt_key.py

Push-To-Talk（PTT）キーボード

Whisper Flow・Discord・Zoom などの PTT（押している間だけマイク ON）操作と、PDFビューアやブラウザのページスクロールをモードで切り替えて使うコントローラーです。ダブルクリック検出により、1つのボタンで3種類のアクションを割り当てられます。

主要定数: PTT_KEYS（最大3キー同時押し）、DOUBLE_CLICK_TIME、LONG_PRESS_TIME、WHEEL_SCROLL_INTERVAL

5. random_mouse.py

ランダムマウス移動コントローラー

ボタンを押すたびにマウスのランダム移動を開始 / 停止します。スクリーンセーバーや画面ロックの防止、PCのアイドル状態を回避するために使用します。Modeでランダム移動の幅を大小切り替えられます。

主要定数: MOVE_RANGE（30px）、MOVE_RANGE_B（10px）、MOVE_INTERVAL_MIN / MOVE_INTERVAL_MAX

6. youtube_controller.py

メディアプレイヤーコントローラー

YouTubeなどの動画プレイヤーを手元のボタンで操作するためのコントローラーです。短押しで再生・一時停止、長押しで巻き戻し / ページスクロールを操作できます。Keyboard・ConsumerControl・Mouse をすべて組み合わせたリファレンス実装です。

主要定数: LONG_PRESS_THRESHOLD（cuskey_settings.py で管理）

HID機能の使用一覧

次のステップ

• 1キーカスタムキーボード “cuskey”
• CircuitPython入門ガイド