Repolode
投稿する
corvofeng

corvofeng/atv-core

iPhoneのコントロールセンターにあるApple TV Remoteで、Android TV／Google TV端末やMacをローカルネットワーク経由で操作できます。

GitHub で見る
スター
382
フォーク
19
未解決の Issue
6
最終コミット
13 日前

これは何？

atv-coreは、Android TV、Google TV、macOSマシンを、iPhoneやiPadの標準Apple TV RemoteからApple TVの操作対象として認識できるようにするレシーバーです。コントロールセンターを開いて端末を選び、PIN「1111」を入力すれば、タッチパッドでスワイプやカーソル移動を行い、ボタンで選択、戻る、再生／一時停止、音量操作ができます。スマートフォンへのアプリのインストールは不要です。

Android TVでは、ローカルのADB接続（dadb to 127.0.0.1:5555）を通じてD-padやメディアのキーコードを送信し、グローバルな戻る／ホーム操作にはAccessibility Serviceをフォールバックとして使います。macOSではメニューバーアプリとCLIとして動作し、Accessibility APIを使ってカーソル操作やキー入力を行います。Windows版はシステムトレイから起動し、トラックパッドモードや感度を設定できるローカルWebコンソールを備えています。

さらに、ポート8765のWebインスペクターとポート8766の診断機能、Android TVエミュレーターでのテスト用ブリッジスクリプトも提供します。コントローラーと操作対象は同じLANに接続する必要があります。また、macOSアプリは自己署名されているため、Gatekeeperを回避するための初回のみの対応が必要です。

主な機能

  • 01iPhoneのコントロールセンターにある標準Apple TV Remoteを使うため、スマートフォン用アプリは不要です。
  • 02ローカルADB経由でキーコードを送信してAndroid TVやGoogle TVを操作し、Accessibilityをフォールバックとして利用します。
  • 03滑らかなカーソル操作やメディアキーに対応したmacOSメニューバーアプリとCLIを提供します。
  • 04トラックパッド設定用のローカルWebコンソールを備えたWindowsシステムトレイ版を提供します。
  • 05タッチ操作やプロトコルセッションのデバッグに使えるWebインスペクターと診断ページを備えています。

ユースケース

  • 専用リモコンを購入せずに、iPhoneからAndroid TVやGoogle TVのボックスを操作する。
  • ソファからiPhoneのリモコンを使って、Macのメディア再生やカーソルを操作する。
  • Android StudioのAndroid TVエミュレーターで、Apple TV Remoteプロトコルの通信をテストする。

クイックスタート

  1. 1

    ダウンロードセクションからDMG（Mac）またはAPK（Android TV）をインストールします

  2. 2

    iPhoneと接続先デバイスを同じWi-Fiに接続し、AP隔離を無効にします

  3. 3

    権限を付与します：macOSではアクセシビリティ、Android TVではネットワークADBを有効にし、「常に許可」の確認に応答します

  4. 4

    iPhoneでコントロールセンターを開き、Apple TV Remoteアイコンをタップして接続先を選び、PIN「1111」を入力します

使う前に知っておきたいこと

  • Android TVではネットワークADBを有効にし、テレビに表示されるRSA確認を承認する必要があります。
  • macOSアプリは自己署名されているため、初回起動時にGatekeeperの警告が表示されます。
  • コントローラーと接続先は、AP隔離を無効にした同じLAN上にある必要があります。
  • リポジトリのメタデータにはライセンスの記載がありませんが、READMEにはMITと記載されています。

トピック

#apple-tv#android-tv#remote-control#adb#macos#rust#companion-link

よくある質問

atv-core とは？
iPhoneのコントロールセンターにあるApple TV Remoteで、Android TV／Google TV端末やMacをローカルネットワーク経由で操作できます。 atv-coreは、Android TV、Google TV、macOSマシンを、iPhoneやiPadの標準Apple TV RemoteからApple TVの操作対象として認識できるようにするレシーバーです。コントロールセンターを開いて端末を選び、PIN「1111」を入力すれば、タッチパッドでスワイプやカーソル移動を行い、ボタンで選択、戻る、再生／一時停止、音量操作ができます。スマートフォンへのアプリのインストールは不要です。
atv-core は無料で使えますか？ライセンスは？
atv-core にはライセンスが明記されていません。コードは公開されていますが、ライセンスがない場合は再利用の許諾がないため、利用前に作者に確認することをおすすめします。
atv-core は今もメンテナンスされていますか？
活発にメンテナンス中。atv-core の最終コミットは 2026年10月7日 です。
atv-core は何に使えますか？
専用リモコンを購入せずに、iPhoneからAndroid TVやGoogle TVのボックスを操作する。 ソファからiPhoneのリモコンを使って、Macのメディア再生やカーソルを操作する。 Android StudioのAndroid TVエミュレーターで、Apple TV Remoteプロトコルの通信をテストする。
atv-core のインストール方法は？
ダウンロードセクションからDMG（Mac）またはAPK（Android TV）をインストールします iPhoneと接続先デバイスを同じWi-Fiに接続し、AP隔離を無効にします 権限を付与します：macOSではアクセシビリティ、Android TVではネットワークADBを有効にし、「常に許可」の確認に応答します iPhoneでコントロールセンターを開き、Apple TV Remoteアイコンをタップして接続先を選び、PIN「1111」を入力します
atv-core はどこで入手できますか？
ソースコードとインストール手順は GitHub にあります：https://github.com/corvofeng/atv-core

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト