{"id":41219035,"url":"https://github.com/saihgupr/remotecompanion","last_synced_at":"2026-02-06T18:15:35.182Z","repository":{"id":333689692,"uuid":"1137604704","full_name":"saihgupr/RemoteCompanion","owner":"saihgupr","description":"RemoteCompanion brings fast, scriptable system control to modern rootless jailbreaks.","archived":false,"fork":false,"pushed_at":"2026-01-22T20:43:22.000Z","size":4096,"stargazers_count":8,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-24T11:38:03.433Z","etag":null,"topics":["jailbreak","rootless"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/saihgupr.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"ko_fi":"saihgupr"}},"created_at":"2026-01-19T15:33:33.000Z","updated_at":"2026-01-23T12:50:02.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/saihgupr/RemoteCompanion","commit_stats":null,"previous_names":["saihgupr/remotecompanion"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/saihgupr/RemoteCompanion","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saihgupr%2FRemoteCompanion","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saihgupr%2FRemoteCompanion/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saihgupr%2FRemoteCompanion/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saihgupr%2FRemoteCompanion/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/saihgupr","download_url":"https://codeload.github.com/saihgupr/RemoteCompanion/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saihgupr%2FRemoteCompanion/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28741621,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-25T01:40:51.112Z","status":"online","status_checked_at":"2026-01-25T02:00:06.841Z","response_time":113,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["jailbreak","rootless"],"created_at":"2026-01-23T00:11:06.649Z","updated_at":"2026-02-06T18:15:35.176Z","avatar_url":"https://github.com/saihgupr.png","language":"C","funding_links":["https://ko-fi.com/saihgupr"],"categories":[],"sub_categories":[],"readme":"# RemoteCompanion\n\nRemoteCompanion brings fast, scriptable system control to modern rootless jailbreaks. It lets you bind physical gestures and hardware buttons to system actions, media controls, and custom scripts.\n\n\u003e [!IMPORTANT]\n\u003e **What's New in v2.1**\n\u003e - **iOS 14 \u0026 Rootful Support**: Broader compatibility covering legacy firmware and rootful jailbreak environments.\n\u003e - **Unified Device Pickers**: Discovery-based, searchable live lists for nearby AirPlay and Bluetooth hardware.\n\u003e - **Action Editing**: Modify any existing action in your sequence by simply tapping it.\n\u003e - **Port Change \u0026 Speed**: Default TCP port moved to `12340` with optimized local probes for instant (~0.25s) execution.\n\u003e - **iPad Experience**: Official support for iPads with full landscape orientation and optimized layouts.\n\u003e - **Home Button**: Native simulation of the Home button for all device models (physical and gesture-based).\n\u003e - **Modern Code Editor**: Completely redesigned, edge-to-edge UI with iOS 17 aesthetics.\n\u003e - **True Multitasking**: Concurrent server handling powered by GCD—zero battery drain, zero blocking.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"images/IMG_1396.PNG\" width=\"250\" alt=\"RemoteCompanion Interface\" /\u003e\n  \u003cimg src=\"images/IMG_1394.PNG\" width=\"250\" alt=\"Trigger Config\" /\u003e\n  \u003cimg src=\"images/IMG_1397.PNG\" width=\"250\" alt=\"Search and Select\" /\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"images/IMG_1389.PNG\" width=\"250\" alt=\"Haptic Settings\" /\u003e\n  \u003cimg src=\"images/IMG_1390.PNG\" width=\"250\" alt=\"Settings View\" /\u003e\n  \u003cimg src=\"images/IMG_1395.PNG\" width=\"250\" alt=\"Action Picker\" /\u003e\n\u003c/p\u003e\n\n## Features\n- **Instant Response**: Actions execute in milliseconds using a optimized, dependency-free architecture.\n- **Smart Control**: Run multi-step action sequences, open apps, or control settings remotely.\n- **Hardware Triggers**: Bind actions to Power/Volume buttons, Home button, Touch ID (Tap/Hold), or the Ringer Switch.\n- **Visual Excellence**: Modern iOS aesthetics with Large Titles, SF Symbols, and frosted glass effects.\n- **Universal Search**: Instantly find actions, shortcuts, and devices with integrated search bars in every picker.\n- **Native Experience**: Redesigned edge-to-edge Terminal and Lua editors with full iPad landscape support.\n- **Advanced Automation**: Full support for NFC tags, custom scripts, and Siri integration.\n- **Live Discovery**: Real-time management and connection for nearby AirPlay and Bluetooth hardware.\n\n## What you can do\n\n### Media \u0026 Volume\n- `rc play` / `rc pause` / `rc playpause` / `rc next` / `rc prev`\n- `rc volume 0-100` - Set volume.\n- `rc volume` - Get current volume percentage.\n- `rc mute [on|off|toggle|status]` - Control media mute state.\n- `rc anc [on|off|transparency]` - Control headphone ANC (requires Sonitus).\n\n### Device Control\n- `rc lock` / `rc lock toggle` / `rc lock status`\n- `rc unlock \u003cpin\u003e` - Wakes and unlocks the device.\n- `rc button [power|lock|home|volup|voldown|mute]` - Simulate physical buttons.\n- `rc brightness 0-100` - Set screen brightness.\n- `rc flashlight [on|off|toggle]` - Control the torch.\n- `rc rotate [lock|unlock|toggle|status]` - Orientation lock control.\n- `rc dnd [on|off|toggle]` - Toggle Do Not Disturb.\n- `rc low power mode [on|off|toggle]` - Toggle battery saver.\n- `rc airplane [on|off|toggle]` - Control Airplane Mode.\n- `rc haptic` / `rc screenshot`\n\n### Apps \u0026 Shortcuts\n- `rc open \u003calias|bundleID\u003e` (e.g., `youtube`, `spotify`, `settings`, `messages`, `home`, `photos`, `camera`, `clock`, `maps`, `calendar`, `weather`, `notes`, `reminders`, `appstore`, `mail`, `music`, `phone`, `stocks`, `calculator`, `tv`, `wallet`, `facetime`, `files`).\n- `rc kill \u003calias|bundleID\u003e` - Force close an app.\n- `rc app` - Get current foreground app's bundle ID.\n- `rc shortcut -r \"Name\" [-p \"Input\"]` - Run any Shortcut (requires SpringCuts).\n- `rc url \"https://google.com\"` - Open any link (with smart unlock).\n- `rc spotify \u003cplaylist|album|artist\u003e \u003cid\u003e` - Play specific Spotify content.\n- `rc spotify play` - Resume Spotify playback.\n\n### Connectivity\n- `rc wifi [on|off|toggle]` / `rc bluetooth [on|off|toggle]`\n- `rc bluetooth [connect|disconnect] \u003cname\u003e` - Manage paired devices.\n- `rc airplay list` - See speakers and their UIDs.\n- `rc airplay connect \u003cUID|Name\u003e` / `rc airplay disconnect`\n\n### Hardware Triggers (Tweak App)\nConfigure these in the `RemoteCompanion` app for custom action sequences. Tip: **Long-press** any trigger in the app to instantly test and run its assigned actions.\n- **Hardware Buttons**:\n  - **Power**: Double-tap, Long-press, **Triple/Quadruple click**, or **Power + Volume Up/Down** combos.\n  - **Volume**: Long hold Up/Down (0.3s) or **Volume Up + Down** combo.\n  - **Home**: Double-tap (Touch ID), Double, Triple, or Quadruple click.\n- **Touch ID Sensor**: **Single Tap** and **Hold (Rest Finger)** triggers.\n- **NFC Triggers**: Scan physical NFC tags to run actions on screen wake (Optional toggle in Settings).\n- **Ringer Switch**: Mute, Unmute, or Toggle triggers.\n- **Gestures**: \n  - **Status Bar**: Hold (Left/Center/Right) or Swipe Left/Right.\n  - **Edge Gestures**: Vertical swipe on left/right edges.\n\n### Text \u0026 Notifications\n- `rc type \"Text\"` - Type text (supports symbols).\n- `rc paste \"Text\"` - Paste into clipboard.\n- `rc key \u003chex\u003e` - Specific keyboard keys (e.g., `0x04` for 'A', `0x28` for Enter).\n- `rc notify -t \"Title\" -m \"Msg\" [-p priority]` - Send push notifications (via ntfy). Priority: `min`, `low`, `default`, `high`, `urgent`.\n\n### System \u0026 Diagnostics\n- `rc respring` - Restart SpringBoard.\n- `rc is-locked` - Check if device contains a passcode lock and is currently locked.\n\n## Getting Started\n\n### 1. Requirements\n- A **Jailbroken Device** (iOS 14+). Supports both Rootless (iOS 15+) and Rootful (iOS 14) environments.\n- The `RemoteCompanion` tweak installed.\n\n### 2. Installation Options\n\n#### Option 1: Repository (Recommended)\nAdd `https://saihgupr.github.io/RemoteCompanion` to Zebra, or use `zbra://sources/add/https://saihgupr.github.io/RemoteCompanion`\n\n#### Option 2: Manual Install\nDownload the `.deb` from [Releases](https://github.com/saihgupr/RemoteCompanion/releases).\n\n#### Option 3: Build from Source\n`cd Tweak \u0026\u0026 make package install`.\n\n### 3. Usage Options\nChoose the control method that best fits your needs:\n\n#### Option 1: TCP Server (Fastest)\nControl your iPhone from your computer terminal using the `rc` script.\n\n\u003e [!NOTE]\n\u003e This method is **faster** than SSH because it avoids the encryption handshake overhead. Recommended for low-latency triggers. **Requires \"TCP Server\" enabled in app settings.**\n\n1. Copy the script to your path:\n   ```bash\n   chmod +x rc\n   sudo cp rc /usr/local/bin/rc\n   ```\n2. Set your iPhone's IP (add this to your `~/.zshrc`):\n   ```bash\n   export RC_IPHONE_IP=192.168.1.10\n   ```\n3. Run the command:\n   ```bash\n   rc play\n   ```\n\n#### Option 2: SSH Direct (Secure)\nControl the device directly via SSH using the `rc` command installed on the iPhone.\nThis method works even if the external \"TCP Server\" is disabled in settings.\n\n```bash\nssh mobile@iphone.local \"rc lock\"\nssh mobile@iphone.local \"rc volume 50\"\nssh mobile@iphone.local \"rc respring\"\n```\n\n#### Option 3: Shortcuts (via Powercuts)\nActions can even be fired from shortcuts using Powercuts.\n\n1. Add the **Run shell command** action.\n2. Enter your command:\n   ```bash\n   rc open Music\n   rc volume 50\n   ```\n\n## Home Assistant Setup\n\nAdd this to your `configuration.yaml`:\n```yaml\nshell_command:\n  iphone_remote: \u003e\n    bash -c 'echo '\\''{{ cmd }}'\\'' \u003e /dev/tcp/YOUR_IPHONE_IP/12340'\n```\nThen call it with:\n\n```yaml\nservice: shell_command.iphone_remote\ndata:\n  cmd: 'play'\n```\n## Troubleshooting\n\n### Apple Pay Issues\nIf you experience the \"Updating Cards\" screen or other conflicts with Apple Pay when waking your device, you can disable the background NFC scanning feature.\n1. Go to the **Settings** tab (gear icon).\n2. Toggle off **NFC Scanning**.\n\nThis ensures the tweak does not attempt to access the NFC controller on wake, resolving conflicts with system services.\n\n## Support \u0026 Feedback\n\nIf you encounter any issues or have feature requests, please [open an issue](https://github.com/saihgupr/RemoteCompanion/issues) on GitHub.\n\nIf you like this project, consider giving it a star ⭐ or making a small donation.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsaihgupr%2Fremotecompanion","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsaihgupr%2Fremotecompanion","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsaihgupr%2Fremotecompanion/lists"}