{"id":18746699,"url":"https://github.com/matrixeditor/samloader3","last_synced_at":"2025-09-01T07:32:48.748Z","repository":{"id":212630404,"uuid":"731595848","full_name":"MatrixEditor/samloader3","owner":"MatrixEditor","description":"Cross-Platform Samsung device firmware downloader (fast).","archived":false,"fork":false,"pushed_at":"2023-12-28T07:04:31.000Z","size":214,"stargazers_count":5,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-02T11:51:33.491Z","etag":null,"topics":["firmware","samsung","samsung-firmwares"],"latest_commit_sha":null,"homepage":"https://matrixeditor.github.io/samloader3/","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/MatrixEditor.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}},"created_at":"2023-12-14T12:40:21.000Z","updated_at":"2025-02-28T08:10:13.000Z","dependencies_parsed_at":"2023-12-28T08:26:02.598Z","dependency_job_id":null,"html_url":"https://github.com/MatrixEditor/samloader3","commit_stats":null,"previous_names":["matrixeditor/samloader3"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/MatrixEditor/samloader3","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MatrixEditor%2Fsamloader3","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MatrixEditor%2Fsamloader3/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MatrixEditor%2Fsamloader3/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MatrixEditor%2Fsamloader3/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MatrixEditor","download_url":"https://codeload.github.com/MatrixEditor/samloader3/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MatrixEditor%2Fsamloader3/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273088766,"owners_count":25043559,"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-01T02:00:09.058Z","response_time":120,"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":["firmware","samsung","samsung-firmwares"],"created_at":"2024-11-07T16:26:33.883Z","updated_at":"2025-09-01T07:32:48.481Z","avatar_url":"https://github.com/MatrixEditor.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# samloader3\n\nCross plattform Firmware downloader and decryptor for Samsung devices with maximum download speed.\nA list of API examples are given in the documentation available at [Github-Pages](https://matrixeditor.github.io/samloader3).\n\n\u003e [!NOTE]\n\u003e This project was formerly hosted at `nlscc/samloader`, and has moved from `samloader/samloader` to a refactored and updated version with enhanced CLI support and an API documentation.\n\n## Installation\n\nYou can easily install it by using the `pip` package manager.\n\n```console\npip install git+https://github.com/MatrixEditor/samloader3.git\n```\n\n## CLI\n\nThe interface procided here is separated into two layers. In The first one, one can set basic options, such as the device's country code, model name, IMEI number or a global timeout value. Next, you will\noperate on a shell that takes commands with arguments as input.\n\n```console\n$ python3 -m samloader3 -M \"SM-A336B\" -R \"SFR\" -I \"12345678901234\"\n(sl3)\u003e # type commands here\n```\n\n### List firmware information\n\nUtilizing the `list` command you can list all available firmwares for a specific model within\nthe selected region.\n\n\u003e [!NOTE]\n\u003e Make sure to always set the device's model name and region code, otherwise you won't get any\n\u003e valid results. For simplicity, we don't write the model and region code explicitly.\n\nUsing this command without any arguments will result in a table view that displays all available\nversions:\n\n\u003cp align=\"center\"\u003e\n\n![cmd_list](/docs/source/cmd_list.png)\n\n\u003c/p\u003e\n\n\u003e [!TIP]\n\u003e If you just want to list the latest firmware use `-l` and if you want to print out the version\n\u003e strings only, use `-q`. Using `-v VERSION` you can also view details on one specific version.\n\n\n### Download Firmware\n\nWith this updated version of `samloader`, you can download multiple firmware files at one (though, most likely not a real use case) and accelerate to the maximum download speed. Using one version\nstring from the output before, simply run the following command:\n\n```console\n(sl3)\u003e download -o \"/path/to/destination/\" \"$version1\" \"$version2\" ...\n```\n\nAs these files can be huge, once canceled, the donwload will resume at the current download\nposition. You can disable that behaviour using `--no-cache`. With a special version identifier (`*`) you can download all firmware binaries at once.\n\n\u003e [!WARNING]\n\u003e Because of some issues with python.rich, parallel download is disabled by default. It can be\n\u003e enabled using `--parallel`.\n\nTo decrypt files directly after downloading them, use `--decrypt`.\n\n\n### Decrypt Firmware\n\nThe decryption command (`decrypt`) is designd to operate on one file only. You just have\nto provide a version number and the file path:\n\n```console\n(sl3)\u003e decrypt -v \"$version\" \"/path/to/firmware.zip.enc4\"\n```\n\n\u003e [!TIP]\n\u003e If you only want to generate the decryption key, use `--key-only`. Note that the actual\n\u003e key is the MD5 value\n\n## License\n\nDistributed under the GNU General Public License (V3). See LICENSE for more information.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmatrixeditor%2Fsamloader3","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmatrixeditor%2Fsamloader3","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmatrixeditor%2Fsamloader3/lists"}