Text-mode Flipper Zero remote-control.
- Display the Flipper Zero's screen in the console in real time
- Send button presses from the keyboard
- Record and replay a screen session
- Record and replay button presses
usage_video.mp4
- Connect the Flipper Zero to a USB port
- Open a terminal
- Run
python tflipper.py
The utility connects to the Flipper Zero and displays its screen in the console.
Hit Ctrl-K to see the keyboard-to-buttons mapping. To remain compatible with most terminals, the keyboard input uses separate keys to emulate short and long Flipper Zero button presses.
- Run
python tflipper.py -Mto render the display using mid-density semigraphics: the entire display will then fit in a 80 x 24 console, at the cost of a slightly distorted image, because the aspect ratio cannot be respected:
- Run
python tflipper.py -Hto render the display using high-density 8-dot Braille characters: the entire display will be even smaller and the aspect ratio will be respected, but the image is rendered as disconnected dots rather than full-size pixels, and depending on your terminal, it may show black horizontal lines. This may or may not be improved by the-Bswitch, which causes the characters to be dislayed in bold:
-
Run
python tflipper.py -t session.txtto record the session as ANSI text insession.txt, including timing markers and button press events:- The screen session can be replayed with the correct timing with
python tfreplay.py session.txt - The button presses can be replayed on the Flipper zero with
python tflipper.py -rt session.txt
- The screen session can be replayed with the correct timing with
-
Run
python tflipper.py -g session.gifto record the session as an animated GIF insession.gif, including timing markers and button press events:-
The animated GIF can be replayed using most image viewers, video players and web browsers
-
The button presses can be replayed on the Flipper zero with
python tflipper.py -rg session.gif
-
-
Run
python tflipper.py -nto suppress the normal display output and only print button press events (also works when replaying them from a text or GIF file):$ python tflipper.py -n [3.943s] ↰ [3.943s] ↰ [3.943s] ↰ [7.099s] o [10.404s] → [11.730s] ↓ [12.675s] ↓ [13.231s] ↓ [16.166s] ↰ [20.519s] o (long press) [22.855s] o (long press) [26.734s] ← (long press)
-
Install Python 3
-
Install the following modules:
$ python -m pip install flipperzero-protobuf $ python -m pip install readchar $ python -m pip install Pillow -
In Windows, you also need to install:
$ python -m pip install colorama -
Clone this repository
-
Copy
tflipper.pyandtfreplay.pyanywhere you find convenient in the executable path
MIT