スマホからMac/PCのキーボードショートカットを発火させるリモコンアプリ
Remote keyboard shortcut controller for Mac/PC via smartphone

English | 日本語

TapKeyは、スマートフォンをMac/Windows PCのリモートキーボードとして使えるアプリです。カスタマイズ可能なボタンを配置して、ショートカットキーやテキスト入力をワンタップで実行できます。

• 音声入力アプリの操作 - SuperWhisperなどの録音開始/停止
• プレゼンテーション - スライド操作のリモコン
• 動画編集 - よく使うショートカットをワンタップで
• 配信 - OBSのシーン切り替えなど

Note: macOSでは初回起動時に「開発元を確認できない」または「壊れている」という警告が出る場合があります。以下のコマンドをターミナルで実行してください：

xattr -cr /Applications/TapKey.app

または、システム設定 > プライバシーとセキュリティ から「このまま開く」を選択してください。

ダウンロードしたファイルを実行してインストールします。

初回起動時にアクセシビリティ権限を求められます。これはキーボード入力をシミュレートするために必要です。

1. システム設定（macOS Ventura以降）またはシステム環境設定（それ以前）を開く
2. プライバシーとセキュリティ > アクセシビリティ を選択
3. 左下の鍵アイコンをクリックしてロックを解除
4. リストにある TapKey にチェックを入れる

Note: TapKeyがリストにない場合は、「+」ボタンをクリックしてアプリケーションフォルダからTapKeyを追加してください。

TapKeyはenigoライブラリを使用してキーボード入力をシミュレートします。macOSではセキュリティ上の理由から、他のアプリケーションにキー入力を送信するにはアクセシビリティ権限が必要です。この権限がないとキー送信が機能しません。

1. TapKeyを一度終了（メニューバーアイコン → Quit）
2. アクセシビリティのリストからTapKeyのチェックを外す
3. 再度チェックを入れる
4. TapKeyを再起動

1. Mac/PCとスマホを同じWi-Fiネットワークに接続
2. メニューバー（Mac）またはシステムトレイ（Windows）のTapKeyアイコンをクリック
3. 「QRコード表示」を選択
4. スマホでQRコードをスキャン、またはURLを直接入力

設定画面の「ボタン設定」タブで：

• ボタンを追加 - 「+ ボタン追加」をクリック
• ラベル - ボタンに表示するテキスト
• 位置とサイズ - グリッド上の配置を指定
• 色 - ボタンの背景色
• アクション - ショートカットキーまたはテキスト入力
• 長押しリピート - Backspaceなど連打したいキーに

プレビュー上でドラッグ&ドロップでも位置を変更できます。

スマホのブラウザでTapKeyを開いた状態で：

• iPhone: 共有ボタン → 「ホーム画面に追加」
• Android: メニュー → 「ホーム画面に追加」

これでアプリのように使えます。

修飾キー（Cmd, Ctrl, Alt, Shift）と通常キーの組み合わせを設定できます。

例：

• Cmd + Shift + R - SuperWhisperの録音開始
• Cmd + N - 新規ファイル
• F5 - プレゼンテーション開始

定型文を入力してEnterを送信します。チャットでよく使うフレーズなどに。

Backspaceや矢印キーなど、長押しで連続入力したいキーに設定できます。

不正アクセスを防ぐためPINを設定できます（任意）。

• 通信は同一LANネットワーク内のみ
• PIN認証でアクセス制限可能
• ファイアウォールで必要に応じてポートを制限

• Node.js 18+
• Rust 1.70+
• Tauri CLI

# 依存関係をインストール
npm install

# 開発サーバー起動
npm run tauri dev

# ビルド
npm run tauri build

MIT License

@abalol

TapKey turns your smartphone into a remote keyboard for your Mac/Windows PC. Configure custom buttons to trigger keyboard shortcuts or text input with a single tap.

• Voice input apps - Start/stop recording with SuperWhisper, etc.
• Presentations - Control slides remotely
• Video editing - Quick access to frequently used shortcuts
• Streaming - OBS scene switching, etc.

Note: On macOS, you may see a warning saying the app is "damaged" or from an "unidentified developer". Run this command in Terminal to fix it:

xattr -cr /Applications/TapKey.app

Alternatively, go to System Settings > Privacy & Security and click "Open Anyway".

Run the downloaded file to install.

On first launch, you'll be prompted to grant accessibility permission. This is required to simulate keyboard input.

1. Open System Settings (macOS Ventura+) or System Preferences (earlier versions)
2. Go to Privacy & Security > Accessibility
3. Click the lock icon at bottom-left to unlock
4. Check the box next to TapKey in the list

Note: If TapKey isn't in the list, click the "+" button and add TapKey from your Applications folder.

TapKey uses the enigo library to simulate keyboard input. On macOS, sending key events to other applications requires accessibility permission for security reasons. Without this permission, key simulation won't work.

1. Quit TapKey (Menu bar icon → Quit)
2. Uncheck TapKey in the Accessibility list
3. Check it again
4. Restart TapKey

1. Connect your Mac/PC and phone to the same Wi-Fi network
2. Click the TapKey icon in the menu bar (Mac) or system tray (Windows)
3. Select "Show QR Code"
4. Scan the QR code with your phone, or enter the URL directly

In the settings window under "Buttons" tab:

• Add button - Click "+ Add Button"
• Label - Text displayed on the button
• Position and size - Specify grid placement
• Color - Button background color
• Action - Keyboard shortcut or text input
• Long-press repeat - For keys like Backspace that you want to repeat

You can also drag and drop buttons on the preview to reposition them.

With TapKey open in your phone's browser:

• iPhone: Share button → "Add to Home Screen"
• Android: Menu → "Add to Home Screen"

This gives you an app-like experience.

Configure combinations of modifier keys (Cmd, Ctrl, Alt, Shift) with regular keys.

Examples:

• Cmd + Shift + R - Start SuperWhisper recording
• Cmd + N - New file
• F5 - Start presentation

Input preset text and send Enter. Great for frequently used chat phrases.

For keys like Backspace or arrow keys that you want to repeat when held down.

Set a PIN to prevent unauthorized access (optional).

• Communication is limited to the same LAN
• PIN authentication available for access control
• Configure firewall to restrict port access if needed

• Node.js 18+
• Rust 1.70+
• Tauri CLI

# Install dependencies
npm install

# Start development server
npm run tauri dev

# Build
npm run tauri build

MIT License

@abalol