{"id":19358093,"url":"https://github.com/ciderapp/cider-remote","last_synced_at":"2026-02-14T14:32:13.771Z","repository":{"id":254895697,"uuid":"847885243","full_name":"ciderapp/Cider-Remote","owner":"ciderapp","description":"Control your Cider client using only your iPhone or iPad using Cider Remote, designed by Cider Collective","archived":false,"fork":false,"pushed_at":"2025-08-03T13:04:41.000Z","size":4040,"stargazers_count":15,"open_issues_count":5,"forks_count":5,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-01T07:09:53.141Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://cider.sh/remote","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ciderapp.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"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":{"github":"ciderapp","ko_fi":"cryptofyre","open_collective":"ciderapp","custom":"https://opencollective.com/ciderapp/donate/10/month/Support%20Development?redirect=https://cidercollective.dev/thanks"}},"created_at":"2024-08-26T18:23:11.000Z","updated_at":"2025-08-03T13:04:44.000Z","dependencies_parsed_at":"2024-09-12T00:42:00.884Z","dependency_job_id":"7d2f1434-84ad-4d1e-b6ff-a1853b594694","html_url":"https://github.com/ciderapp/Cider-Remote","commit_stats":{"total_commits":10,"total_committers":2,"mean_commits":5.0,"dds":"0.19999999999999996","last_synced_commit":"85e20040536eff28614c58bc5dffc85b20a09d30"},"previous_names":["ciderapp/cider-remote"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ciderapp/Cider-Remote","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ciderapp%2FCider-Remote","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ciderapp%2FCider-Remote/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ciderapp%2FCider-Remote/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ciderapp%2FCider-Remote/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ciderapp","download_url":"https://codeload.github.com/ciderapp/Cider-Remote/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ciderapp%2FCider-Remote/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273997107,"owners_count":25204473,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-07T02:00:09.463Z","response_time":67,"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":[],"created_at":"2024-11-10T07:10:17.550Z","updated_at":"2026-02-14T14:32:13.764Z","avatar_url":"https://github.com/ciderapp.png","language":"Swift","funding_links":["https://github.com/sponsors/ciderapp","https://ko-fi.com/cryptofyre","https://opencollective.com/ciderapp","https://opencollective.com/ciderapp/donate/10/month/Support%20Development?redirect=https://cidercollective.dev/thanks"],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://cider.sh/remote\"\u003e\n        \u003cimg src=\"https://cider.sh/og-remote.png\" alt=\"Cider Remote Banner\"\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://apps.apple.com/app/id6670149407\"\u003e\n        \u003cimg src=\"https://apps.lumaa.fr/assets/images/en_app_store_black_badge.svg\" alt=\"Cider Remote on the App Store\" width=200 /\u003e\n    \u003c/a\u003e\n\u003c/p\u003e\n\n# About Remote\n\n[Cider Remote](https://cider.sh/remote) is a native iOS app, built with [SwiftUI](https://developer.apple.com/swiftui/) and [Socket.io](https://socket.io/), that gives remote controls to [Cider](https://cider.sh/).\n\n\u003e [!NOTE]\n\u003e Cider Remote is also available on Android: [`ciderapp/Cider-Remote-RN`](https://github.com/ciderapp/Cider-Remote-RN)\n\n[Cider Remote](https://cider.sh/remote) is the official [Cider](https://cider.sh/) remote control app on iPhone and iPad using iOS 17 or later, with these features:\n\n- Seamless communications between [Remote](https://cider.sh/remote) and [Cider](https://cider.sh/)\n- Live Activity with the playing track and quick actions ([ActivityKit](https://developer.apple.com/documentation/ActivityKit))\n- Horizontal Layout (Landscape)\n- Queue Management\n- Apple Music \u0026 MusixMatch Lyrics (+ Immersive Lyrics in Horizontal Layout)\n- Siri Shortcuts actions ([App Intents](https://developer.apple.com/documentation/appintents))\n- Control Center actions ([WidgetKit](https://developer.apple.com/documentation/widgetkit/creating-controls-to-perform-actions-across-the-system#Add-a-control-toggle-to-your-app), iOS 18+)\n- Liquid Glass design (iOS 26+)\n\n# Feedback\n\nTo make a feedback about Cider Remote, you can do the following:\n\n- You can [write a review](https://apps.apple.com/app/id6670149407?action=write-review) on the App Store.\n- You can send a feedback on TestFlight with an attached screenshot or not. It is recommended to also share your email address with your TestFlight feedback, but not required.\n- Send a message in [#cider-chat](https://discord.com/channels/843954443845238864/1254248941780729898) on the [Cider Discord](https://discord.gg/applemusic) server\n- You can [create an issue](https://github.com/ciderapp/Cider-Remote/issues/new) on GitHub.\n- If the beta app crashes, TestFlight will recommend you to send a feedback with the crash info.\n\n# Connection Guide\n\nThis guide may help you through the connection of Cider Remote to Cider\\\n_This guide works for iPhones and iPads in iOS 17 or later_\n\n### Prerequisites\n\n- Ensure that Cider is installed with version v2.5.0 or later and is running on your computer (Windows, macOS, or Linux).\n- For LAN mode, your iPhone should be connected to the same local network as Cider.\n- For WAN mode, you can control Cider from anywhere, as long as both devices have internet access.\n- Cider's RPC server should be enabled.\n\n### Setting Up Cider Remote\n\n#### LAN Mode (Local Area Network)\n\n1. **Configure Cider to Pair with Your iPhone:**\n\n   - On your computer, open Cider.\n   - Navigate to **Settings \u003e Help \u003e Connect a Remote app**.\n   - Click on the **Pair** button at the top of the alert.\n   - Choose a name, your connection method, and optionally, a host address.\n   - Click on **Create QR Code**.\n\n2. **Connect Your iPhone to Cider (LAN Mode):**\n   - Launch the Cider Remote app on your iPhone.\n   - Tap on the \"Add a New Cider Device\" button. This will open a QR code scanner.\n   - Scan the QR Code on Cider, then choose your device's name.\n\n#### WAN Mode (Wide Area Network)\n\nIf you need to control Cider from a different network or while away from home, you can switch to WAN mode.\n\n1. **Switch to WAN Mode:**\n   - Follow steps 1 and 2 from LAN mode to add a new Cider device.\n   - When prompted to select the connection method, choose **WAN** instead of **LAN**.\n   - Continue pairing your iPhone with Cider by scanning the QR code as before.\n   - Once paired, Cider Remote will allow you to control playback from anywhere with internet access (thanks to [localtunnel](https://theboroer.github.io/localtunnel-www/)), not just on the same local network.\n\n## Important Notes\n\n- **LAN Mode:** Cider Remote works over a local network, using the RPC server on port **10767**. Ensure that both your iPhone and Cider are on the same network.\n- **WAN Mode:** Cider Remote in WAN mode allows for control from anywhere with internet access. Be sure that both devices have a stable internet connection.\n- **Firewall Settings:** If Cider Remote cannot connect to Cider, you may need to allow Cider or port **10767** through your computer’s firewall.\n- **Connectivity:** Both the Cider RPC server and WebSocket need to be enabled in settings for Cider Remote to function correctly.\n\n## Troubleshooting\n\n### Common Issues \u0026 Solutions\n\n- **Cider Remote Cannot Find Cider (LAN):**\n\n  - Ensure that both your iPhone and Cider client are connected to the same local network.\n  - Check if the RPC server is running on Cider (port 10767).\n  - Restart both your iPhone and the Cider client to refresh the connection.\n  - **Solution:** If the LAN connection fails, try using **WAN mode** to control Cider over the internet.\n\n- **Firewall Issues:**\n\n  - If you're using a firewall, make sure that Cider or port **10767** is allowed through.\n  - On Windows, go to **Control Panel \u003e System and Security \u003e Windows Defender Firewall \u003e Allow an app or feature through Windows Defender Firewall**. Ensure that Cider is listed and allowed.\n  - On macOS, go to **System Preferences \u003e Network \u003e Firewall \u003e Options**, and add Cider to the list of allowed apps.\n  - On Linux, use your distribution's firewall management tool to allow the necessary port.\n\n- **QR Code Scanning Issues:**\n  - Ensure that the QR code is clearly visible and well-lit when scanning with your iPhone.\n  - If the scan fails, try moving your phone closer or further away from the screen.\n\nBy following these steps, you should be able to set up and use Cider Remote without any issues, whether on LAN or WAN.\n\n# Beta of Cider Remote\n\n\u003e [!IMPORTANT]\n\u003e Cider Remote's beta allows users to test new features before they release on the App Store, which might use capabilities that will be available in iOS Beta versions, be careful though, bugs may occur more often in beta than in the [App Store](https://apps.apple.com/app/id6670149407) version. Make sure to report bugs and issues through [a feedback](#feedback).\n\nJoin the [TestFlight beta](https://testflight.apple.com/join/qTeV2T2w) here.\n\n# License \u0026 Copyright\n\nThis project is licensed under the Attribution-NonCommercial-ShareAlike 4.0 International (CC BY-NC-SA 4.0) license. See the [LICENSE](./LICENSE) file for details.\n\n© Cider Collective 2024-2025\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fciderapp%2Fcider-remote","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fciderapp%2Fcider-remote","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fciderapp%2Fcider-remote/lists"}