{"id":13530741,"url":"https://github.com/libimobiledevice/ifuse","last_synced_at":"2025-05-14T23:07:21.112Z","repository":{"id":6929534,"uuid":"8180717","full_name":"libimobiledevice/ifuse","owner":"libimobiledevice","description":"A fuse filesystem to access the contents of iOS devices","archived":false,"fork":false,"pushed_at":"2024-12-02T05:44:38.000Z","size":122,"stargazers_count":872,"open_issues_count":54,"forks_count":146,"subscribers_count":42,"default_branch":"master","last_synced_at":"2025-04-15T00:44:35.828Z","etag":null,"topics":["afc","c","fuse","fuse-filesystem","ifuse","ios","mount"],"latest_commit_sha":null,"homepage":"https://libimobiledevice.org","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"OpenBazaar/OpenBazaar-Installer","license":"lgpl-2.1","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/libimobiledevice.png","metadata":{"files":{"readme":"README.md","changelog":"NEWS","contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS","dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2013-02-13T14:35:37.000Z","updated_at":"2025-04-12T17:35:59.000Z","dependencies_parsed_at":"2023-01-13T14:10:58.383Z","dependency_job_id":"3c04b5e0-cb28-4399-a22b-99f8a28c27bd","html_url":"https://github.com/libimobiledevice/ifuse","commit_stats":{"total_commits":163,"total_committers":18,"mean_commits":9.055555555555555,"dds":0.7484662576687117,"last_synced_commit":"c4ab3d64bd589d52804b6a2974a000138046fff7"},"previous_names":[],"tags_count":13,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/libimobiledevice%2Fifuse","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/libimobiledevice%2Fifuse/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/libimobiledevice%2Fifuse/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/libimobiledevice%2Fifuse/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/libimobiledevice","download_url":"https://codeload.github.com/libimobiledevice/ifuse/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254243362,"owners_count":22038046,"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","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":["afc","c","fuse","fuse-filesystem","ifuse","ios","mount"],"created_at":"2024-08-01T07:00:54.442Z","updated_at":"2025-05-14T23:07:16.105Z","avatar_url":"https://github.com/libimobiledevice.png","language":"C","readme":"# ifuse\n\n*A fuse filesystem implementation to access the contents of iOS devices.*\n\n## Features\n\nThis project allows mounting various directories of an iOS device locally using\nthe [FUSE file system interface](https://github.com/libfuse/libfuse).\n\nSome key features are:\n\n- **Media**: Mount media directory of an iOS device locally\n- **Apps**: Mount sandbox container or document directory of an app\n- **Jailbreak**: Mount root filesystem on jailbroken devices *(requires AFC2 service)*\n- **Browse**: Allows to retrieve a list of installed file-sharing enabled apps\n- **Implementation**: Uses [libimobiledevice](https://github.com/libimobiledevice/libimobiledevice) for communication with the device\n\n## Installation / Getting started\n\n### Debian / Ubuntu Linux\n\nFirst install all required dependencies and build tools:\n```shell\nsudo apt-get install \\\n\tbuild-essential \\\n\tpkg-config \\\n\tcheckinstall \\\n\tgit \\\n\tautoconf \\\n\tautomake \\\n\tlibtool-bin \\\n\tlibplist-dev \\\n\tlibimobiledevice-dev \\\n\tlibfuse3-dev \\\n\tusbmuxd\n```\n\nThen clone the actual project repository:\n```shell\ngit clone https://github.com/libimobiledevice/ifuse.git\ncd ifuse\n```\n\nNow you can build and install it:\n```shell\n./autogen.sh\nmake\nsudo make install\n```\n\n### Setting up FUSE\n\nNote that on some systems, you may have to load the `fuse` kernel\nmodule first and to ensure that you are a member of the `fuse` group:\n\n```shell\nsudo modprobe fuse\nsudo adduser $USER fuse\n```\n\nYou can check your membership of the `fuse` group with:\n\n```shell\nid | grep fuse \u0026\u0026 echo yes! || echo not yet...\n```\n\nIf you have just added yourself, you will need to logout and log back\nin for the group change to become visible.\n\n## Usage\n\nTo mount the media partition from the device run:\n```shell\nifuse \u003cmountpoint\u003e\n```\n\n**HINT:** *If you mount your device as regular user, the system might complain that\nthe file `/etc/fuse.conf` is not readable. It means you do not belong to the\n`fuse` group (see below).*\n\nTo unmount as a regular user you must run:\n```shell\nfusermount -u \u003cmountpoint\u003e\n```\n\nBy default, ifuse (via the AFC protocol) gives access to the `/var/root/Media/`\nchroot on the device (containing music/pictures). This is the right and safe\nway to access the device. However, if the device has been jailbroken, a full\nview of the device's filesystem might be available using the following command\nwhen mounting:\n```shell\nifuse --root \u003cmountpoint\u003e\n```\n\nNote that only older jailbreak software installed the necessary AFC2 service on\nthe device to enable root filesystem usage. For instance  blackra1n does not\ninstall it and thus does not enable root filesystem access by default!\nUse with care as the AFC protocol was not made to access the root filesystem.\n\nIf using libimobiledevice \u003e= 1.1.0, ifuse can also be used with the iTunes\nfile/document sharing feature. It allows you to exchange files with an\napplication on the device directly through it's documents folder by specifing\nthe application identifier like this:\n```shell\nifuse --documents \u003cappid\u003e \u003cmountpoint\u003e\n```\n\nThe following example mounts the documents folder of the VLC app to `/mnt`:\n```shell\nifuse --documents org.videolan.vlc-ios /mnt\n```\n\nIt is also possible to mount the sandboxed root folder of an application\nusing the `--container` parameter:\n```shell\nifuse --container \u003cappid\u003e \u003cmountpoint\u003e\n```\n\nThe `\u003cappid\u003e` (bundle identifier) of an app can be obtained using:\n```shell\nifuse --list-apps\n```\n\nPlease consult the usage information or manual page for a full documentation of\navailable command line options:\n```shell\nifuse --help\nman ifuse\n```\n\n## Contributing\n\nWe welcome contributions from anyone and are grateful for every pull request!\n\nIf you'd like to contribute, please fork the `master` branch, change, commit and\nsend a pull request for review. Once approved it can be merged into the main\ncode base.\n\nIf you plan to contribute larger changes or a major refactoring, please create a\nticket first to discuss the idea upfront to ensure less effort for everyone.\n\nPlease make sure your contribution adheres to:\n* Try to follow the code style of the project\n* Commit messages should describe the change well without being too short\n* Try to split larger changes into individual commits of a common domain\n* Use your real name and a valid email address for your commits\n\nWe are still working on the guidelines so bear with us!\n\n## Links\n\n* Homepage: https://libimobiledevice.org/\n* Repository: https://github.com/libimobiledevice/ifuse.git\n* Repository (Mirror): https://git.libimobiledevice.org/ifuse.git\n* Issue Tracker: https://github.com/libimobiledevice/ifuse/issues\n* Mailing List: https://lists.libimobiledevice.org/mailman/listinfo/libimobiledevice-devel\n* Twitter: https://twitter.com/libimobiledev\n\n## License\n\nThis software is licensed under the [GNU Lesser General Public License v2.1](https://www.gnu.org/licenses/lgpl-2.1.en.html),\nalso included in the repository in the `COPYING` file.\n\n## Credits\n\nApple, iPhone, iPad, iPod, iPod Touch, Apple TV, Apple Watch, Mac, iOS,\niPadOS, tvOS, watchOS, and macOS are trademarks of Apple Inc.\n\nThis project is an independent software application and has not been authorized,\nsponsored, or otherwise approved by Apple Inc.\n\nREADME Updated on: 2024-11-15\n","funding_links":[],"categories":["Uncategorized","C"],"sub_categories":["Uncategorized"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flibimobiledevice%2Fifuse","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flibimobiledevice%2Fifuse","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flibimobiledevice%2Fifuse/lists"}