{"id":13499390,"url":"https://github.com/wetox-team/flipperzero-firmware","last_synced_at":"2025-03-29T04:31:18.414Z","repository":{"id":40516946,"uuid":"434665350","full_name":"wetox-team/flipperzero-firmware","owner":"wetox-team","description":"Flipper Zero Firmware fork by the 2LNLWTX team","archived":false,"fork":true,"pushed_at":"2023-12-02T19:15:55.000Z","size":64564,"stargazers_count":69,"open_issues_count":0,"forks_count":4,"subscribers_count":3,"default_branch":"dev","last_synced_at":"2024-02-13T20:34:58.181Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"flipperdevices/flipperzero-firmware","license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/wetox-team.png","metadata":{"files":{"readme":"ReadMe.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-12-03T16:37:24.000Z","updated_at":"2024-01-30T06:11:18.000Z","dependencies_parsed_at":"2023-02-16T21:00:38.974Z","dependency_job_id":null,"html_url":"https://github.com/wetox-team/flipperzero-firmware","commit_stats":null,"previous_names":[],"tags_count":69,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wetox-team%2Fflipperzero-firmware","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wetox-team%2Fflipperzero-firmware/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wetox-team%2Fflipperzero-firmware/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wetox-team%2Fflipperzero-firmware/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wetox-team","download_url":"https://codeload.github.com/wetox-team/flipperzero-firmware/tar.gz/refs/heads/dev","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246140565,"owners_count":20729797,"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-07-31T22:00:32.700Z","updated_at":"2025-03-29T04:31:13.391Z","avatar_url":"https://github.com/wetox-team.png","language":"C","funding_links":[],"categories":["Firmwares \u0026 Tweaks"],"sub_categories":["*Outdated/Unmaintained firmware*","Outdated/Unmaintained firmware"],"readme":"\u003c\u003c\u003c\u003c\u003c\u003c\u003c HEAD\n# Flipper Zero Firmware (Wetox fork, unofficial!)\n=======\n\u003cpicture\u003e\n    \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"/.github/assets/dark_theme_banner.png\"\u003e\n    \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"/.github/assets/light_theme_banner.png\"\u003e\n    \u003cimg\n        alt=\"A pixel art of a Dophin with text: Flipper Zero Official Repo\"\n        src=\"/.github/assets/light_theme_banner.png\"\u003e\n\u003c/picture\u003e\n\n# Flipper Zero Firmware\n\n- [Flipper Zero Official Website](https://flipperzero.one). A simple way to explain to your friends what Flipper Zero can do.\n- [Flipper Zero Firmware Update](https://update.flipperzero.one). Improvements for your dolphin: latest firmware releases, upgrade tools for PC and mobile devices.\n- [User Documentation](https://docs.flipperzero.one). Learn more about your dolphin: specs, usage guides, and anything you want to ask.\n\u003e\u003e\u003e\u003e\u003e\u003e\u003e upstream/dev\n\n# Contributing\n\n\u003c\u003c\u003c\u003c\u003c\u003c\u003c HEAD\nWelcome to the [Wetox Flipper Zero](https://wetox.team/)'s Firmware repo!\nThis is a modified unofficial version of the Flipper Zero firmware with some additional features.\n\n# If you want to incorporate our features into your firmware fork, please contact us beforehand!\n\n# Feature list\n\n* Removing T5577 passwords via the cli command `rfid clear_pass_t5577` using a dictionary attack\n* Support for inverted screens via a toggle in the desktop settings\n=======\nOur main goal is to build a healthy and sustainable community around Flipper, so we're open to any new ideas and contributions. We also have some rules and taboos here, so please read this page and our [Code of Conduct](/CODE_OF_CONDUCT.md) carefully.\n\u003e\u003e\u003e\u003e\u003e\u003e\u003e upstream/dev\n\n## I need help\n\nThe best place to search for answers is our [User Documentation](https://docs.flipperzero.one). If you can't find the answer there, check our [Discord Server](https://flipp.dev/discord) or our [Forum](https://forum.flipperzero.one/).\n\n## I want to report an issue\n\nIf you've found an issue and want to report it, please check our [Issues](https://github.com/flipperdevices/flipperzero-firmware/issues) page. Make sure the description contains information about the firmware version you're using, your platform, and a clear explanation of the steps to reproduce the issue.\n\n## I want to contribute code\n\nBefore opening a PR, please confirm that your changes must be contained in the firmware. Many ideas can easily be implemented as external applications and published in the [Flipper Application Catalog](https://github.com/flipperdevices/flipper-application-catalog). If you are unsure, reach out to us on the [Discord Server](https://flipp.dev/discord) or the [Issues](https://github.com/flipperdevices/flipperzero-firmware/issues) page, and we'll help you find the right place for your code.\n\nAlso, please read our [Contribution Guide](/CONTRIBUTING.md) and our [Coding Style](/CODING_STYLE.md), and make sure your code is compatible with our [Project License](/LICENSE).\n\nFinally, open a [Pull Request](https://github.com/flipperdevices/flipperzero-firmware/pulls) and make sure that CI/CD statuses are all green.\n\n# Development\n\nFlipper Zero Firmware is written in C, with some bits and pieces written in C++ and armv7m assembly languages. An intermediate level of C knowledge is recommended for comfortable programming. C, C++, and armv7m assembly languages are supported for Flipper applications.\n\n# Firmware RoadMap\n\n[Firmware RoadMap Miro Board](https://miro.com/app/board/uXjVO_3D6xU=/)\n\n## Requirements\n\nSupported development platforms:\n\n- Windows 10+ with PowerShell and Git (x86_64)\n- macOS 12+ with Command Line tools (x86_64, arm64)\n- Ubuntu 20.04+ with build-essential and Git (x86_64)\n\nSupported in-circuit debuggers (optional but highly recommended):\n\n- [Flipper Zero Wi-Fi Development Board](https://shop.flipperzero.one/products/wifi-devboard)\n- ST-Link\n- J-Link\n\nFlipper Build System will take care of all the other dependencies.\n\n## Cloning source code\n\nMake sure you have enough space and clone the source code:\n\n```shell\ngit clone --recursive https://github.com/flipperdevices/flipperzero-firmware.git\n```\n\n## Building\n\n\u003c\u003c\u003c\u003c\u003c\u003c\u003c HEAD\nFlipper Zero's firmware consists of two components:\n\n- Core2 firmware set - proprietary components by ST: FUS + radio stack. FUS is flashed at factory and you should never update it.\n- Core1 Firmware - HAL + OS + Drivers + Applications.\n\nThey both must be flashed in the order described.\n\n## With offline update package\n\nWith Flipper attached over USB:\n\n`./fbt flash_usb`\n\nJust building the package:\n\n`./fbt updater_package`\n\nTo update, copy the resulting directory to Flipper's SD card and navigate to `update.fuf` file in Archive app. \n\n## With STLink\n\n### Core1 Firmware\n\nPrerequisites:\n\n- Linux / macOS\n- Terminal\n- [arm-gcc-none-eabi](https://developer.arm.com/tools-and-software/open-source-software/developer-tools/gnu-toolchain/gnu-rm/downloads)\n- openocd\n\n\nOne liner: `./fbt firmware_flash`\n\n\n## With USB DFU \n\n1. Download latest [Firmware](https://github.com/wetox-team/flipperzero-firmware/releases)\n\n2. Reboot Flipper to Bootloader\n - Press and hold `← Left` + `↩ Back` for reset \n - Release `↩ Back` and keep holding `← Left` until blue LED lights up\n - Release `← Left`\n\n3. Run `dfu-util -D full.dfu -a 0`\n\n# Build with Docker\n\n## Prerequisites\n\n1. Install [Docker Engine and Docker Compose](https://www.docker.com/get-started)\n2. Prepare the container:\n\n ```sh\n docker-compose up -d\n ```\n\n## Compile everything\n\n```sh\ndocker-compose exec dev ./fbt\n```\n\nCheck `dist/` for build outputs.\n\nUse **`flipper-z-{target}-full-{suffix}.dfu`** to flash your device.\n\nIf compilation fails, make sure all submodules are all initialized. Either clone with `--recursive` or use `git submodule update --init --recursive`.\n\n# Build on Linux/macOS\n\nCheck out `documentation/fbt.md` for details on building and flashing firmware. \n\n## macOS Prerequisites\n\nMake sure you have [brew](https://brew.sh) and install all the dependencies:\n```sh\nbrew bundle --verbose\n```\n\n## Linux Prerequisites\n\n### gcc-arm-none-eabi\n\n```sh\ntoolchain=\"gcc-arm-none-eabi-10.3-2021.10\"\ntoolchain_package=\"$toolchain-$(uname -m)-linux\"\n\nwget -P /opt \"https://developer.arm.com/-/media/Files/downloads/gnu-rm/10.3-2021.10/$toolchain_package.tar.bz2\"\n\ntar xjf /opt/$toolchain_package.tar.bz2 -C /opt\nrm /opt/$toolchain_package.tar.bz2\n\nfor file in /opt/$toolchain/bin/* ; do ln -s \"${file}\" \"/usr/bin/$(basename ${file})\" ; done\n```\n\n### Optional dependencies\n\n- openocd (debugging/flashing over SWD)\n- heatshrink (compiling image assets)\n- clang-format (code formatting)\n- dfu-util (flashing over USB DFU)\n- protobuf (compiling proto sources)\n\nFor example, to install them on Debian, use:\n```sh\napt update\napt install openocd clang-format-13 dfu-util protobuf-compiler\n```\n\nheatshrink has to be compiled [from sources](https://github.com/atomicobject/heatshrink).\n\n## Compile everything\n\n```sh\n=======\nBuild firmware using Flipper Build Tool:\n\n```shell\n\u003e\u003e\u003e\u003e\u003e\u003e\u003e upstream/dev\n./fbt\n```\n\n## Flashing firmware using an in-circuit debugger\n\nConnect your in-circuit debugger to your Flipper and flash firmware using Flipper Build Tool:\n\n```shell\n./fbt flash\n```\nOr connect via the blackmagic board and run:\n```sh\nBLACKMAGIC=\u003cboard's IP\u003e:2345 make blackmagic_load\n```\n\n## Flashing firmware using USB\n\n\u003c\u003c\u003c\u003c\u003c\u003c\u003c HEAD\n* Telegram: [@wetox_flipper](https://t.me/wetox_flipper)\n=======\nMake sure your Flipper is on, and your firmware is functioning. Connect your Flipper with a USB cable and flash firmware using Flipper Build Tool:\n\n```shell\n./fbt flash_usb\n```\n\n## Documentation\n\n- [Flipper Build Tool](/documentation/fbt.md) - building, flashing, and debugging Flipper software\n- [Applications](/documentation/AppsOnSDCard.md), [Application Manifest](/documentation/AppManifests.md) - developing, building, deploying, and debugging Flipper applications\n- [Hardware combos and Un-bricking](/documentation/KeyCombo.md) - recovering your Flipper from the most nasty situations\n- [Flipper File Formats](/documentation/file_formats) - everything about how Flipper stores your data and how you can work with it\n- [Universal Remotes](/documentation/UniversalRemotes.md) - contributing your infrared remote to the universal remote database\n- And much more in the [documentation](/documentation) folder\n\u003e\u003e\u003e\u003e\u003e\u003e\u003e upstream/dev\n\n# Project structure\n\n- `applications`    - applications and services used in firmware\n- `assets`          - assets used by applications and services\n- `furi`            - Furi Core: OS-level primitives and helpers\n- `documentation`   - documentation generation system configs and input files\n- `firmware`        - firmware source code\n- `lib`             - our and 3rd party libraries, drivers, etc.\n- `scripts`         - supplementary scripts and python libraries home\n\nAlso, see `ReadMe.md` files inside those directories for further details.\n\n# Links\n\n- Discord: [flipp.dev/discord](https://flipp.dev/discord)\n- Website: [flipperzero.one](https://flipperzero.one)\n- Forum: [forum.flipperzero.one](https://forum.flipperzero.one/)\n- Kickstarter: [kickstarter.com](https://www.kickstarter.com/projects/flipper-devices/flipper-zero-tamagochi-for-hackers)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwetox-team%2Fflipperzero-firmware","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwetox-team%2Fflipperzero-firmware","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwetox-team%2Fflipperzero-firmware/lists"}