{"id":25231384,"url":"https://github.com/davidecelentano/iosctlsh","last_synced_at":"2025-10-24T20:16:44.285Z","repository":{"id":274239149,"uuid":"901550518","full_name":"davidecelentano/iosctlsh","owner":"davidecelentano","description":"Manage and control iOS devices from a Linux environment using USB.","archived":false,"fork":false,"pushed_at":"2025-08-29T16:54:42.000Z","size":122,"stargazers_count":7,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-08-29T19:23:31.450Z","etag":null,"topics":["backup","bash","command-line","developermode","devicediagnostics","devicemanagement","firmware","ios","jq","linux","opensource","pymobiledevice3","python","recoverymode","restore","shellscript","softwareupdate","usb"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/davidecelentano.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":"CODEOWNERS","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}},"created_at":"2024-12-10T21:42:40.000Z","updated_at":"2025-05-24T20:57:57.000Z","dependencies_parsed_at":null,"dependency_job_id":"bae87298-e2a7-4189-92df-917d2f0279e2","html_url":"https://github.com/davidecelentano/iosctlsh","commit_stats":null,"previous_names":["davidecelentano/iosctlsh"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/davidecelentano/iosctlsh","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davidecelentano%2Fiosctlsh","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davidecelentano%2Fiosctlsh/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davidecelentano%2Fiosctlsh/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davidecelentano%2Fiosctlsh/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/davidecelentano","download_url":"https://codeload.github.com/davidecelentano/iosctlsh/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davidecelentano%2Fiosctlsh/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":280858372,"owners_count":26403314,"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-10-24T02:00:06.418Z","response_time":73,"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":["backup","bash","command-line","developermode","devicediagnostics","devicemanagement","firmware","ios","jq","linux","opensource","pymobiledevice3","python","recoverymode","restore","shellscript","softwareupdate","usb"],"created_at":"2025-02-11T12:28:35.171Z","updated_at":"2025-10-24T20:16:44.280Z","avatar_url":"https://github.com/davidecelentano.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# `iOS Control` - Manage iOS devices on Linux via USB\n_A Linux-based command-line utility for managing iOS devices, including backups, restores, updates, and more._\n\n### Disclaimer\nThis project is an independent, open-source tool and is **not affiliated with, endorsed by, or sponsored by Apple Inc.** iOS, iPhone, and other related trademarks are the property of Apple Inc. This tool is provided as-is for managing iOS devices on Linux systems.\n\n---\n\n## Table of Contents\n\n- [About the Project](#about-the-project)\n  - [Features](#features)\n  - [Built With](#built-with)\n- [Getting Started](#getting-started)\n  - [Prerequisites](#prerequisites)\n  - [Installation](#installation)\n- [Overview](#overview)\n- [License](#license)\n\n---\n\n## About the Project\n\n`iosctlsh` is a Linux-based command-line utility designed to manage iOS devices effortlessly. From performing software updates to creating backups, restoring encrypted backups, and enabling developer mode, this tool simplifies complex iOS management tasks for Linux users.\n\n### Features\n\n- Perform **iOS software updates** and **restores** using signed firmwares downloaded from [ipsw.me](https://ipsw.me).\n- Create **full backups** or **delta (incremental) backups**.\n- **Restore backups** from other iOS devices or encrypted backups.\n- Enable **Developer Mode** for advanced debugging and development tools.\n- Exit or enter **Recovery Mode**.\n- Retrieve detailed **device diagnostics**, including model information and encryption backup status.\n\n---\n\n### Built With\n\n- [Bash](https://www.gnu.org/software/bash/) - Shell scripting language.\n- [pymobiledevice3](https://github.com/doronz88/pymobiledevice3) - A Python library for managing iOS devices.\n- [jq](https://stedolan.github.io/jq/) - Command-line JSON processor.\n\n---\n\n## Getting Started\n\nTo set up `iosctlsh` on your Linux system, follow these steps.\n\n### Prerequisites\n\nEnsure you have the following dependencies installed (package names may vary by distro):\n\n- **usbmuxd**\n- **libusb**\n- **python3**\n- **python3-devel**\n- **jq**\n\nFor Debian-based distros if python is not recognized, create a symbolic link to python3:\n\n`sudo ln -s /usr/bin/python3 /usr/bin/python`\n\n### Installation\n\n1. Clone the repository: `git clone https://github.com/davidecelentano/iosctlsh.git`\n\n2. Navigate to the project directory: `cd iosctlsh`\n\n3. Make the script executable: `chmod +x iosctl.sh`\n\n4. Run the script: `./iosctl.sh`\n\n### Overview\n\n![Screenshot From 2025-01-22 23-19-02](https://github.com/user-attachments/assets/439a51e0-84a2-406b-854d-674560da2dce)\n\n### License\n\nThis project is licensed under the GNU General Public License v3.0. See the LICENSE file for details.\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdavidecelentano%2Fiosctlsh","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdavidecelentano%2Fiosctlsh","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdavidecelentano%2Fiosctlsh/lists"}