{"id":27194720,"url":"https://github.com/AndroidDumps/Firmware_extractor","last_synced_at":"2025-04-09T19:04:20.493Z","repository":{"id":35181645,"uuid":"277184338","full_name":"AndroidDumps/Firmware_extractor","owner":"AndroidDumps","description":"Extract given archive to images","archived":false,"fork":false,"pushed_at":"2024-10-15T18:40:10.000Z","size":23354,"stargazers_count":262,"open_issues_count":5,"forks_count":80,"subscribers_count":11,"default_branch":"master","last_synced_at":"2024-10-17T21:53:09.166Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","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/AndroidDumps.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}},"created_at":"2020-07-04T20:59:19.000Z","updated_at":"2024-10-15T18:40:13.000Z","dependencies_parsed_at":"2024-10-16T17:56:55.538Z","dependency_job_id":"3b745f19-5cda-49a8-b378-0b8e15e256e3","html_url":"https://github.com/AndroidDumps/Firmware_extractor","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AndroidDumps%2FFirmware_extractor","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AndroidDumps%2FFirmware_extractor/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AndroidDumps%2FFirmware_extractor/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AndroidDumps%2FFirmware_extractor/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AndroidDumps","download_url":"https://codeload.github.com/AndroidDumps/Firmware_extractor/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248094986,"owners_count":21046770,"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-04-09T19:02:28.966Z","updated_at":"2025-04-09T19:04:20.483Z","avatar_url":"https://github.com/AndroidDumps.png","language":"Python","readme":"# Extract given archive to images (`Firmware_extractor`)\nThis repository is used mainly by `dumpyara` in order to pull all images from an archive and easily extract them to directories.\n\nMain objective of this project is so transform files from different manufacturers to simple EXT2 (or similar) images, in order to extract them via `7z` or any other unarchiving program.\n\n## Set-up\nAs previously mentioned, this is supposed to be ran in-line with `dumpyara`. The needed packages are already installed by the `setup.sh` script [here](https://github.com/AndroidDumps/dumpyara/blob/master/setup.sh), but you might aswell run thse commands individually and execute the script standalone;\n```\n$ sudo apt install unace unrar zip unzip p7zip-full p7zip-rar sharutils rar uudeview mpack arj cabextract rename liblzma-dev python-pip brotli lz4 protobuf-compiler git gawk\n$ pip install backports.lzma protobuf pycrypto twrpdtgen extract-dtb pycryptodome\n```\n\n## How to use\n### Download\nDownload, through `git`, the repository to your directory of choice.\n```\ngit clone --recurse-submodules https://github.com/AndroidDumps/Firmware_extractor.git\n```\n\n### Extract images from firmware URL\nBeforehand, make sure you're gonna to extract an archive we support. You can check the complete list [below](#supported-firmwares). The output with all the extracted images will be displayed on the folder of your choice or, if not specified, to the `out/` directory.\n\n```\n$ cd Firmware_extractor\n$ wget https://dl.google.com/dl/android/aosp/walleye-pq3a.190705.001-factory-cc471c8c.zip -o firmware.zip\n$ ./extractor.sh firmware.zip walleye/\n```\n\n#### Syntax\n```bash\nUsage: ./extractor.sh {firmware.zip} [firmware/]\n        {firmware.zip}: path to the archive\n        [firmware/]: directory of choice to extract all images to\n```\n\n## Supported firmware(s)\n * A-only over-the-air update packages\n * A/B over-the-air update packages\n    - Un-zipped packages (plain `payload.bin`)\n * RAW image(s)\n     - Un-zipped packages (plain `super.img`)\n * Samsung's archives (`.tar.md5`)\n * Chunk image(s)\n * QFIL packages\n * Archive with image(s)\n * OPPO's archives (`.ozip`)\n * Sony's upgrade packages (`.tft`)\n * ZTE `update.zip`\n * KDDI's `.bin`\n * Archive as binary (`.bin`)\n * Unisoc's upgrade packages (`.pac`)\n     - Un-zipped packages (plain `[...].pac`)\n * sign, along with *auth DA*, images (`[...]-sign.img`)\n * Nokia's upgrade packages (`.nb0`)\n * LG's update packages (`.kdz`)\n * HTC's proprietary upgrade packages (RUU)\n * Amlogic's upgrade packages\n * Rockchip's upgrade packages\n","funding_links":[],"categories":["Recently Updated","Tools"],"sub_categories":["[Apr 08, 2025](/content/2025/04/08/README.md)","Misc Tools"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FAndroidDumps%2FFirmware_extractor","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FAndroidDumps%2FFirmware_extractor","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FAndroidDumps%2FFirmware_extractor/lists"}