jsammarco/flipper-subghz-analyzer

This is a desktop application for examining radio signal captures recorded by a device called Flipper Zero. Flipper Zero is a small handheld tool that can receive and record radio signals from things like remote controls, garage door openers, and ceiling fan remotes. It saves those recordings as files with a .sub extension. This application opens those files and gives you a set of tools for understanding what is inside the signal. When you load a capture file, the app reads the raw timing data, which is a sequence of positive and negative numbers representing how long the radio signal was on or off at each moment. It then splits that stream into individual packets based on unusually long gaps, so you can see each button press or transmission as a separate frame. From there, you can apply different decoding strategies to convert the timing pattern into a series of ones and zeros, since different types of remote controls encode bits in different ways. The main visual panel shows all the decoded frames as horizontal rows of colored bars, letting you see repeated patterns at a glance. Clicking on a row highlights other frames that look similar, which helps identify consistent parts of a signal from variable parts. A separate analysis function compares frames side by side and tries to label regions as a fixed header, device identifier, command bits, rolling code section, or checksum, though the README is clear that these are heuristic guesses meant to speed up investigation rather than definitive protocol decoding. Once you have identified the structure, you can edit the bits in a selected frame directly in the interface, convert between binary and hexadecimal representations, and save a modified version of the capture file. The intended use case is reverse engineering: capturing a signal multiple times, comparing the recordings across different button presses, and working out which parts of the signal change and which stay fixed. The application is written entirely in Python using the standard library's Tkinter interface toolkit. It requires Python 3.10 or later and has no third-party dependencies. Four sample ceiling fan and ceiling light captures are included for testing.