{"id":24611136,"url":"https://github.com/jonathanporta/droidcat","last_synced_at":"2025-03-18T15:24:44.458Z","repository":{"id":232588119,"uuid":"778302336","full_name":"JonathanPorta/droidcat","owner":"JonathanPorta","description":"Extract data from an android device.","archived":false,"fork":false,"pushed_at":"2024-03-27T16:56:19.000Z","size":3,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-01-24T19:37:08.038Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/JonathanPorta.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2024-03-27T13:21:12.000Z","updated_at":"2024-03-27T16:56:23.000Z","dependencies_parsed_at":"2024-04-10T13:47:11.974Z","dependency_job_id":"bee54a0d-b2fb-4d4c-a47a-a91196f6fcd2","html_url":"https://github.com/JonathanPorta/droidcat","commit_stats":null,"previous_names":["jonathanporta/droidcat"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JonathanPorta%2Fdroidcat","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JonathanPorta%2Fdroidcat/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JonathanPorta%2Fdroidcat/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JonathanPorta%2Fdroidcat/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/JonathanPorta","download_url":"https://codeload.github.com/JonathanPorta/droidcat/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244247118,"owners_count":20422561,"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":[],"created_at":"2025-01-24T19:34:53.834Z","updated_at":"2025-03-18T15:24:44.436Z","avatar_url":"https://github.com/JonathanPorta.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# DroidCat: Android Data Extraction and Backup Unpacking Tool\n\nDroidCat is a fledgling, yet versatile command-line utility designed for extracting data from Android devices and unpacking Android backup files (.ab). This tool simplifies the process of pulling accessible data and app data from a connected Android device and offers functionality to unpack and decrypt Android backup files.\n\n## Features\n\n- **Data Extraction**: Efficiently pull data and app data from connected Android devices.\n- **Backup Unpacking**: Unpack and decrypt password-protected `.ab` backup files into a readable format.\n- **Custom ID Tagging**: Option to tag extraction and backup operations with a custom identifier for easy organization.\n- **Helpful Documentation**: Includes usage instructions to guide through each available command.\n\n## Prerequisites\n\nBefore using DroidCat, ensure the following requirements are met:\n\n- **ADB (Android Debug Bridge)**: Must be installed and properly configured on your system. Verify its installation by running `adb version` in your terminal.\n- **Java**: Required for running the Android Backup Extractor (ABE). Ensure Java is installed and available in your system's PATH.\n- **Android Backup Extractor (ABE)**: DroidCat relies on ABE for unpacking .ab files. ABE must be present in the system's PATH. ABE can be obtained from [https://github.com/nelenkov/android-backup-extractor](https://github.com/nelenkov/android-backup-extractor). Follow the installation instructions provided in the repository to ensure ABE is set up correctly.\n\n## Installation\n\n1. Clone or download the DroidCat script to your local machine.\n2. Ensure that `adb`, `java`, and `abe.jar` are in your system's PATH, or adjust the script to point to their locations.\n3. Make the script executable by running `chmod +x droidcat` in your terminal.\n\n## Usage\n\nDroidCat can be invoked with the following commands:\n\n### Extract Data from Device\n\n```sh\n./droidcat extract [ID]\n```\n\nThis command pulls all accessible data from the connected device. If an optional ID is provided, it tags the backup directory and file names for easy identification.\n\n### Unpack an Android Backup File\n\n```sh\n./droidcat unpack /path/to/backup.ab [password]\n```\n\nUnpacks a given Android backup file. If the backup is password-protected, provide the password as the second argument. If no password is provided, the script attempts to unpack the backup without a password.\n\n### Display Help Information\n\n```sh\n./droidcat --help\n```\n\nShows usage information for DroidCat, detailing available commands and options.\n\n## Note on ABE\n\nThe Android Backup Extractor (ABE) is essential for unpacking .ab files. Ensure that `abe.jar` is located in a directory included in your system's PATH or adjust the `unpack_backup` function in the DroidCat script to point directly to its location.\n\n## Contributing\n\nContributions to DroidCat are welcome! Please refer to the project's issues and pull requests to propose improvements or submit bug fixes.\n\n## License\n\nDroidCat is distributed under the MIT License. See the LICENSE file for more information.\n\n---\n\nDroidCat is designed to simplify data extraction and backup management for Android devices, streamlining what can otherwise be a complex process. Whether for backup, recovery, or analysis purposes, DroidCat offers a powerful toolset for Android data handling.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjonathanporta%2Fdroidcat","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjonathanporta%2Fdroidcat","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjonathanporta%2Fdroidcat/lists"}