{"id":20857117,"url":"https://github.com/flipperdevices/flipper-factory-reset","last_synced_at":"2025-04-10T21:09:27.832Z","repository":{"id":211098835,"uuid":"727611690","full_name":"flipperdevices/flipper-factory-reset","owner":"flipperdevices","description":"Fully reset flipper and set it to the shipping state","archived":false,"fork":false,"pushed_at":"2023-12-06T13:37:32.000Z","size":822,"stargazers_count":10,"open_issues_count":0,"forks_count":4,"subscribers_count":4,"default_branch":"dev","last_synced_at":"2025-04-10T21:09:19.399Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","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/flipperdevices.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,"publiccode":null,"codemeta":null}},"created_at":"2023-12-05T08:06:54.000Z","updated_at":"2025-04-06T07:16:17.000Z","dependencies_parsed_at":null,"dependency_job_id":"0b657099-9d5b-45d3-af83-5728c8d0c846","html_url":"https://github.com/flipperdevices/flipper-factory-reset","commit_stats":null,"previous_names":["flipperdevices/flipper-factory-reset"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flipperdevices%2Fflipper-factory-reset","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flipperdevices%2Fflipper-factory-reset/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flipperdevices%2Fflipper-factory-reset/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flipperdevices%2Fflipper-factory-reset/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/flipperdevices","download_url":"https://codeload.github.com/flipperdevices/flipper-factory-reset/tar.gz/refs/heads/dev","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248298340,"owners_count":21080320,"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":"2024-11-18T04:36:17.692Z","updated_at":"2025-04-10T21:09:27.813Z","avatar_url":"https://github.com/flipperdevices.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# flipper-factory-reset\n\n## This was tested on ubuntu 22.10 and above and on latest macOS. Current version is for NON-TRANSPARENT VERSION!!\n\nFully reset flipper and set it to the shipping state:\n\nHere are two ways of resetting your flipper zero to factory state:\n\n# Required items\n- SD card (preferably less 8GB, but not crucial)\n- USB Type-C cable for flipper\n- Flipper must be updated with any OFFICIAL release firmware \u003e= 0.64.3\n- Ubuntu 22.10 or latest macOS\n\n# Semi-automatic reset\n\n## Preparation\nYou will need to have git installed and clone this repository\n```shell\ngit clone --recursive https://github.com/flipperdevices/flipper-factory-reset.git\n```\n\nDo following step one time, when setting up your reset bench. It will clone our repo and download the toolchain.\nIt will download about 1gb of data, so it may take a while.\n```shell\n./install_requirements.sh\n```\nThis needs to be done single time as well, unless you need new SD card. Prepare an SD card, preferably lower size, insert it into a functional Flipper Zero. \n\n!! THIS ACTION WILL WIPE ALL DATA ON SD CARD\n\nYou can check [flipper docs](https://docs.flipper.net/basics/first-start) on how to insert SD card or power on the device\n```shell\n./prepare_sdcard.sh\n```\n\n## Flipper reset\n\n- Plug USB cable into device and computer.\n\n- Insert SD card into the device\n\nThis script will update to a factory firmware, prepare a slideshow, disable debug and do a factory reset\n```shell\n./automatic_reset.sh\n```\n- Unplug the device and remove SD card.\n\n- Power off the device by holding back button for 5 seconds and then pressing right.\n\n\n# Manual reset (Advanced)\nYou can check [flipper docs](https://docs.flipper.net/basics/first-start) on how to insert SD card or power on the device\n\n- Install [qFlipper](https://update.flipperzero.one/builds/firmware/0.64.4/) app for your operating system. Or alternatively you can use internal update system, by copying files into an update folder on your formatted sd-card. (Manual update folder in this repository)\n\n\n- Install BLE stack for the firmware. Note that version of firmware, its location and file type may vary on your system\n```shell\n./qFlipper-x86_64-1.3.2.AppImage cli core2radio ./stm32wb5x_BLE_Stack_full_fw.bin\n```\n- Install factory firmware\n```shell\n./qFlipper-x86_64-1.3.2.AppImage cli firmware ./flipper-z-f7-full-0.64.4.dfu\n```\n- Install python 3.10 or higher\n- Install all required python packages\n```shell\npip install pyserial colorlog numpy==1.22.3 protobuf==3.20.2 protoletariat Pillow isort opencv-python termcolor\n```\n- Go to flipper settings-\u003esystem-\u003efactory reset. \n- Go to settings-\u003esystem and disable debug and set logging level to Default.\n- Make sure you do not open any apps, if you do, factory reset flipper again continue from this point. \n- Copy following script and change flipper name to one on the device.\n```shell\n./slideshow/slideshow_gen.sh flipper\n```\n```shell\n./storage.py send /tmp/flipper_slideshow /int/.slideshow\n```\n\n- Make sure SD-card is removed from the device\n- Power off the device and place it in the box\n\n\n# Troubleshooting\n- If you get errors when installing firmware, or flipper does not boot, try to use Repair in qFlipper app","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fflipperdevices%2Fflipper-factory-reset","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fflipperdevices%2Fflipper-factory-reset","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fflipperdevices%2Fflipper-factory-reset/lists"}