{"id":19223759,"url":"https://github.com/coldcard/recovery-images","last_synced_at":"2026-03-01T11:32:51.925Z","repository":{"id":235189178,"uuid":"790203059","full_name":"Coldcard/recovery-images","owner":"Coldcard","description":"Build \"recovery\" disk images used to save bricked COLDCARD Mk4 and Q","archived":false,"fork":false,"pushed_at":"2024-06-26T19:15:49.000Z","size":8840,"stargazers_count":2,"open_issues_count":0,"forks_count":2,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-02-23T10:14:53.414Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Makefile","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Coldcard.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"COPYING-CC","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":"2024-04-22T13:00:51.000Z","updated_at":"2024-06-26T19:15:52.000Z","dependencies_parsed_at":null,"dependency_job_id":"be0e7d3c-4757-459a-8ac4-0580791cdc78","html_url":"https://github.com/Coldcard/recovery-images","commit_stats":null,"previous_names":["coldcard/recovery-images"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Coldcard/recovery-images","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Coldcard%2Frecovery-images","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Coldcard%2Frecovery-images/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Coldcard%2Frecovery-images/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Coldcard%2Frecovery-images/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Coldcard","download_url":"https://codeload.github.com/Coldcard/recovery-images/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Coldcard%2Frecovery-images/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29968483,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-01T10:55:55.490Z","status":"ssl_error","status_checked_at":"2026-03-01T10:55:55.175Z","response_time":124,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":[],"created_at":"2024-11-09T15:09:28.016Z","updated_at":"2026-03-01T11:32:51.908Z","avatar_url":"https://github.com/Coldcard.png","language":"Makefile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Recovery Disk Images\n\n## Background\n\nIf a COLDCARD is powered down during the firmware update process,\nthe intended (new) firmware image has been lost because it it held\nin PSRAM (volatile memory) during the flash writing process.\nThe COLDCARD bootloader is smart enough to detect this specific case,\nand read an SD card to recover and avoid becoming a brick.\n\nThe bootloader will only install an image of _exactly_ the same\nversion as was being installed when interrupted. This is done by\nverifying the checksum vs. the value that had been set in SE1 by\nthe PIN holder. This prevents side-loading or up/downgrade attacks.\n\nThis projects holds data and code to build a special SD card disk\nimage with all possible releases. The goal is a single disk image that\ncan be used restore a COLDCARD of any version included.\n\nWe may not update this every single release, but if you have a need,\nplease contact support and we are happy to update it!\n\n## How to Use\n\nTake the most recent `*.img.xz` file from [output directory](output)\nand image it onto an SD Card, uncompressed. We recommend Balena\nEtcher to do this in one step on MacOS. Turn on the COLDCARD with\nthe card inserted, and the rest is automatic (although not fast).\n\nNote you cannot see the files on this card, and please do not make\nany changes to the card after imaging it. It's not really a\nFAT-formated filesystem, and the firmware images need to be located\nat specific blocks.\n\n## Building Yourself\n\nAdd DFU files you want to include in [releases](releases). You can\ninclude as many or as few as you wish, since the bootloader will\ntry each one in sequence until it finds a working checksum.\n\nYou will need `mtools` installed and basic Unix utilities in your path.\n\nType `make` to run the Makefile and construct a new file in `output`.\n\n# Supported Hardware\n\n- COLDCARD Mk4\n- COLDCARD Q\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcoldcard%2Frecovery-images","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcoldcard%2Frecovery-images","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcoldcard%2Frecovery-images/lists"}