ローカル画面ストリームでの0.5秒周期的な引っかかりはmacOSのAWDLが原因だった
A 0.5s periodic hitch in my local screen stream turned out to be macOS AWDL (github.com)
要約
tapflowは、モバイルQAチーム向けのセルフホスト型Appetize/BrowserStack代替ツールです。iOSシミュレーターとAndroidエミュレーターをブラウザで実行でき、ツールチェーンのセットアップやデバイスプールの管理、クラウドへのアップロードなしで、ビルド、ストリーム、録画を自社インフラ内で完結させることができます。モバイル開発者以外のチームメンバーも、Macを共有してモバイルアプリのQAをブラウザから簡単に行えるように設計されています。
全文翻訳
tapflow — 全ての人に品質を。
モバイルQAチームのためのセルフホスト型Appetize / BrowserStack代替
iOSシミュレーターとAndroidエミュレーターを任意のブラウザで実行 — ツールチェーンのセットアップ不要、デバイスプール不要、クラウドへのアップロード不要。
あなたのビルド、ストリーム、録画は、あなたが管理するインフラストラクチャ上に保持されます。
WebDriverAgent不要 · 2行のセットアップ · MIT
[画像: GitHubスター数] [画像: Dockerプル数] [画像: 最新リリース] [画像: 前回のコミット] [画像: OpenSSFベストプラクティス] [画像: macOSエージェント]
📖 ドキュメント · 🚀 クイックスタート · 🎥 デモ · 🎬 セットアップ
tapflow-demo.mp4[動画]
H.264 over H.264でストリーミング、ゼロバッファデコーダー(MSEなし) — 遅延測定 ↗
v0.x、活発に開発中 — デフォルトで後方互換性あり。破壊的な変更は稀で、常に変更履歴に記載されます。ロードマップ →
なぜtapflowか?
モバイルQAは通常、シミュレーター、エミュレーター、または物理デバイスへのアクセスに依存しますが、チーム全体でのそのアクセスは均一ではありません。
モバイル開発者にとっては、MacでXcodeやAndroid Studioを開くことを意味します。それ以外の全員にとっては、毎回モバイル開発者に尋ねることを意味することがよくあります。
バックエンド開発者 — 「デプロイされたものを確認するために、サンドボックスビルドをどのようにインストールすればよいですか?」
プロダクトマネージャー — 「動作を比較するためだけに、バージョンをインストールしたり削除したりし続けています。」
デザイナー — 「画面サイズごとのレイアウトを確認する必要がありますが、適切なデバイスを持っていません。」
物理デバイスは、OSバージョンのカバレッジ、可用性、充電、ストレージ、ハンドオフといった独自のオーバーヘッドを追加します。クラウドシミュレーターサービスはアクセス問題を解決しますが、サードパーティサービスに内部ビルドをアップロードし、自分のMacがすでに同じシミュレーターを実行できるのにリモートデバイスに料金を支払う必要があります。
私たちはこの問題をまさに経験し、tapflowを構築しました。
| ソリューション | 欠点 |
|---|---|
| Appetize / BrowserStack | 継続的なコスト — そしてアプリビルドはサードパーティのクラウドにアップロードされる |
| 物理デバイス | コスト、可用性、OSカバレッジ、管理オーバーヘッド |
| Xcode / Android Studio | 各チームメンバーはMacと完全なモバイルツールチェーンを必要とする |
| tapflow | 自分のMacを再利用 — データはあなたが管理するインフラストラクチャ上に留まり、チーム全体がブラウザからQAを行う |
仕組み
tapflowは3つの部分を接続します。
- セルフホスト型リレー (LinuxまたはMac) — 同じポートでダッシュボードも提供するため、別個のWebサーバーは不要です。
- macOSエージェント — iOSシミュレーターとAndroidエミュレーターを操作します。リレーにアウトバウンドで接続し(インバウンドファイアウォールルール不要)、WebDriverAgentなしでiOSタッチを直接注入します。
- ブラウザダッシュボード — チームの他のメンバー向け。利用可能なデバイスを選択し、シミュレーターがMac上で実行され続ける間、リアルタイムで操作します。
ブラウザ(あなたのチーム) ←─ WebSocket ─→ リレーサーバー ←─ WebSocket (アウトバウンド) ─→ Macエージェント
(Linux / Mac) (iOS · Android)
tapflowではないもの
tapflowはネイティブモバイル開発ツールを置き換えるものではありません。モバイル開発者は引き続きXcode、Android Studio、およびそれらのビルドツールを使用します。tapflowは、実行中のシミュレーターとエミュレーターをブラウザ経由でチームの他のメンバーにアクセス可能にし、デバイスファームではありません。自動化されたQA軸(決定論的なフローランナーとLLMエージェント用のMCPサーバー)はありますが、WebDriverAgentやAppiumのような外部自動化フレームワークを接続することは範囲外です。tapflowは独自の最小限のランナーを提供します。
これがどこへ向かうかは、VISION.mdに概説されています。手動QAを、必要に応じて自動化へと成長させていきます。
クイックスタート
1. インストール
npm install -g tapflow
# または: yarn global add tapflow | pnpm add -g tapflow
2. 環境設定
エージェントを実行するMacで、シミュレーター/エミュレーターの前提条件を一度にインストールします。
tapflow setup
リレー専用サーバー(Linux)ではこれをスキップしてください。環境設定を参照してください。
3. リレー + エージェントの起動
tapflow start
# ✓ Relay started on http://localhost:4000
# ✓ iOS Agent connected (3 simulators available)
これにより、同じMac上でリレーとエージェントの両方が起動します(ローカルモード)。
4. 最初の管理者アカウントの作成
ブラウザで http://localhost:4000 を開きます。tapflowは /setup にリダイレクトして管理者アカウントを作成させます。
ヘッドレスサーバーの場合?
tapflow admin initを使用して、CLI経由で管理者アカウントを作成してください。
5. ダッシュボードを開く
http://localhost:4000 に移動し、作成したアカウントでサインインします。
問題がありますか?
tapflow doctorを実行して、いつでも前提条件を再確認してください。
要件
| コンポーネント | 要件 |
|---|---|
| リレーサーバー | Node.js ≥ 22、任意のOS(Linux/macOS)、約512MB RAM |
| iOSエージェント | macOS 26または27、Xcode 26または27 + iOSシミュレーターランタイム(または tapflow setup ios を実行)、Node.js ≥ 22 |
| Androidエージェント | macOS、Java + Android SDKとAVD(または tapflow setup android を実行)、Node.js ≥ 22 |
| ブラウザ(QA) | 任意のモダンブラウザ — Chrome、Firefox、Safari、Edge |
エージェントはmacOSのみで実行されます(Mac上のiOSシミュレーターとAndroidエミュレーターを操作するため)。リレーはどこでも実行できます。
特徴
- QAユーザー向けのモバイルツールチェーン不要 — チームメンバーはXcode、Android Studio、またはローカルシミュレーターツールをインストールせずにブラウザからテストできます。
- デフォルトでセルフホスト — サードパーティのクラウドや外部アカウントは不要。すべて既存のハードウェアで実行されます。
- 既存のMac環境を活用 — iOSシミュレーターまたはAndroidエミュレーターがすでに利用可能なMacでエージェントを実行します。
- APIファースト — RESTエンドポイントとパーソナルアクセストークンは、CI/CDおよびAIエージェントワークフローをサポートします。
含まれるもの:
- ブラウザストリーミング — iOS & Androidを約30fpsで、デバイス上に特別なアプリは不要。どちらも2層デコーダー(セキュアコンテキストではWebCodecs、プレーンHTTPではWASM/tinyh264)を介してH.264でストリームするため、デコードパスからメディア要素バッファが削除されます。解像度は接続に合わせて適応します — セキュアコンテキストではネイティブ、プレーンHTTP LANではダウンサンプリングされます。1
- コーデックフォールバック — ストリームはクライアントごとにコーデックをネゴシエートし、ハードウェアまたはWASMデコーダーが利用できない場合はJPEGにフォールバックするため、古いブラウザでも動作します。
- タッチ、スワイプ、ピンチ — リアルタイム入力をシミュレーターまたはエミュレーターに転送します。
- ディープリンクツールバー — サポートされているディープリンクをQAツールバーから直接開きます。
- キーボードショートカット — キーボードからシミュレーターツールバーのアクションをトリガーします。
- クリップボード同期 — Macとデバイス間で双方向にコピー&ペーストできます。デバイスからのコピーにはHTTPSまたはlocalhost上のダッシュボードが必要です。プレーンHTTPではテキストはデバイス自身のクリップボードにコピーされ、ダッシュボードにその旨が表示されます。
- デバイスオーディオ — アプリのサウンドがブラウザタブに戻ります。
- ネットワーク制御 — デバイスをネットワークから切断し、再度接続して、アプリがオフラインでどのように動作するかをテストします。iOSは一度ネットワークフィルターをインストールします。Androidは何も必要ありません。
- App Center —
.app.zip/.apkをアップロードし、ビルドをステータス(バックログ / 進行中 / 完了 / 却下)で追跡します。 - セッション録画 — QAセッションを録画・共有できます。リレーに約72時間保存され、その後自動的にパージされます。
- スクリーンショットRESTエンドポイント — CIおよびAIエージェント用の
GET /api/v1/sessions/:sessionId/screenshot。 - Macリソース監視 — エージェントごとのCPUとRAMを監視し、セッション割り当て前に過負荷のホストを特定します。
- チーム管理 — 招待リンク、ロール(管理者/開発者/QA/ビューア)、およびパーソナルアクセストークン。
- フローランナー —
tapflow flow runは、条件付き待機とJUnitレポートを備えたYAMLフローをリプレイし、リプレイ時にはLLMを呼び出しません。実験的です。 - MCPサーバー —
@tapflowio/mcp-serverを使用すると、Claude CodeなどのLLMエージェントがシミュレーターをネイティブツールとして制御できます。実験的です。
1 実際のLANでは、デコードから表示までの測定値は数十ミリ秒(WASMソフトウェアデコーダーでp50 ~11–17 ms、HTTPS上のWebCodecsでさらに高速)です。エンドツーエンドの「ガラスからガラスまで」の遅延は、それにネットワークのラウンドトリップが加わります。ストリーミング遅延ログで完全な測定値、条件、既知の制限事項を確認してください。
セキュリティとプライバシー
tapflowは設計上セルフホスト型です — ビルドファイル、デバイスストリーム、セッション録画は、あなたが管理するインフラストラクチャ上に留まり、サードパーティサービスに送信されることはありません。
| データ | どこに留まるか |
|---|---|
アプリバイナリ(.app.zip / .apk) | リレーのストレージ |
| デバイスストリーム(ビデオ・タッチ) | あなたがホストするリレー↔ブラウザパス |
| セッション録画 | リレーのストレージ。72時間後に期限切れ、その後パージ |
| アカウントとチームデータ | リレーのSQLite DB |
| サードパーティシミュレータークラウド | 不要 |
- LAN優先 — エージェント↔リレー間の通信は内部トラフィックです。デバイスストリームはサードパーティを経由しません。
- リレーが信頼の境界線 — アカウント、ビルド、ライブデバイス制御を保持するため、それにアクセスできるものが公開される対象となります。エージェントはアウトバウンド接続のみを行います。
- デフォルトでオフホスト認証 — リレーは、自身のマシン(
localhost)からの認証されていない接続のみを受け入れます。それ以外の場所からアクセスするブラウザはサインインします。別マシン上のエージェントはagentスコープのトークンを提示します。トンネルを介したトラフィックは、トンネルクライアントがリレーのマシン上で実行されていても、オフホストと見なされます。 - PAT + ロール — パーソナルアクセストークンはスコープ(CIアップロード用の
builds:write、リモートエージェント用のagent)を持ち、チームロール(管理者/開発者/QA/ビューア)はダッシュボードへのアクセスを制御します。
脆弱性を発見しましたか? SECURITY.md を参照してください。完全なモデルについては、セキュリティとプライバシーをお読みください。
セルフホスティング
単一のMacでは、tapflow start(クイックスタートを参照)以外に何も必要ありません。チームの場合は、リレーを別のLinuxサーバーまたは専用Macで実行し、各Macエージェントをそれに接続します。
リレーサーバー:
# 推奨:PM2で自動再起動
npm install -g pm2 tapflow
JWT_SECRET=$(openssl rand -hex 32) pm2 start tapflow --name relay -- relay start
pm2 save && pm2 startup
またはDockerでリレーを実行:
docker run -d -p 4000:4000 -v "$PWD/data:/app/.tapflow/data" tapflow/tapflow:latest
イメージはリレーのみです — エージェントはあなたのMac上に残ります。ボリュームは必須です(サインインシークレットを保持するため)、招待リンクには
TAPFLOW_RELAY_URLが必要です。Docker Composeで完全なセットアップを参照してください。
各Macエージェント:
tapflow agent start --relay wss://your-relay-url --token <agent-token>
別のマシン上のリレーは、
agentスコープのトークンがないとエージェントを受け入れません — 設定 → トークン(管理者のみ)で作成します。リレー自身のマシン上のエージェント(tapflow start)はトークンを必要としません。リモートリレー認証を参照してください。nginx / Caddyリバースプロキシ設定と外部アクセスについては、外部アクセスを参照してください。
CLIリファレンス
| コマンド | 説明 |
|---|---|
tapflow start | リレーとエージェントを一緒に起動(ローカルモード) |
tapflow relay start | リレーのみを起動 |
tapflow agent start --relay <url> [--token <pat>] | エージェントを起動し、リレーに接続(リモートリレーにはagentスコープのトークンが必要) |
tapflow init | このマシンのtapflowを設定(デフォルトは~/.tapflow) |
tapflow admin init | 最初の管理者アカウントを作成(CLIフォールバック) |
tapflow doctor [platform] | 前提条件を診断(Node、iOS、Android) |
tapflow setup [platform] | ローカル環境をインストール・設定 |
tapflow devices | 利用可能なシミュレーターとエミュレーターを一覧表示 |
| `tapflow boot <name | udid>` |
tapflow status | 接続されているエージェント、デバイス、アクティブなセッションを表示 |
tapflow reset | すべてのシミュレーターとエミュレーターをシャットダウン |
tapflow logs | 最近のリレーログエントリを表示(リレーホストで実行) |
完全なリファレンス → CLIドキュメント
ドキュメント
完全なドキュメント:www.tapflow.dev
- ガイド — クイックスタート · 環境設定 · セルフホスティング · ビルドのアップロード(CI/CD) · トラブルシューティング
- リファレンス — CLI · 設定 · REST API · セキュリティとプライバシー
- AIエージェント — MCPサーバー
貢献
tapflowは活発に開発されており、PRを歓迎します — ブランチ戦略、コミット規約、アーキテクチャ概要については、CONTRIBUTING.mdを参照してください。詳細については、コントリビューターノートでSimulatorKitのリバースエンジニアリングとストリーミングレンダリングパイプラインをカバーしています。参加するすべての人に、行動規範に従うことが期待されます。
要件: Node.js ≥ 22、pnpm ≥ 9
git clone https://github.com/jo-duchan/tapflow.git
cd tapflow
pnpm install
pnpm dev
ライセンス
MIT — Copyright © 2026-present tapflow contributors
tapflowはAndroid画面ストリーミングのためにscrcpy-server(Apache-2.0)をバンドルしています。完全な帰属表示についてはNOTICEを参照してください。