Update

As you can see, I kinda forgot about this project. It's been nearly three months since the last commit and it's just a simple bugfix. If you want to mantain this project, message me on Telegram: @milk_cool

flippulator

An emulator for the Flipper Zero
Based on Flipper Zero Firmware

Requirements

A linux system
Packages make, gcc, libsdl2-dev:i386, gcc-12-multilib (or an alternative that's compatible with your current gcc version), libbsd-dev:i386

Usage

npm start will generate the out_<app name>/<app name> executable.

Limitations

The main function cannot be called main
furi.h must be included
Right now, only the InputTypePress and InputTypeRelease input types are supported
A variable cannot be named time
The %lu and %ld format specifiers expect just long unsigned int, so uint32_ts (defined as unsigned ints) and int32s (defined as ints) won't work with them despite having the same size. (As of October 25th, 2023, it does not look like it's possible to fix this. As an alternative, I can suggest using macros like PRIu32.)

Known issues

Defining a string as char* str = "abc" and then setting its value using snprintf gives you a segfault\

What's supported so far:

Canvas and viewports (no icons)
Input
Some core functions
Records
Vibration
FuriStrings
FuriThreads
FuriSemaphores
FuriMutexes
FuriPubSubs
FuriEventFlags
FuriApiLocks
Timers
Crashing
CLI (although very limited)
Storage

TODOs

Use ~~GTK~~ SDL instead of ncurses
Write support for FuriTypes (FuriString, FuriMutex, etc.)
Add settings to the notification service
Storage CLI
Remove code duplicating in storage_ext.c and storage_int.c

FAQs

Q: How does the application tell if it's running in Flippulator?

A: Flippulator defines _FLIPPULATOR and the app can use #ifdef to tell in which environment it's running.

Uhm, akstually, it is not an emulator 🤓☝️...

Yes, it is not. It just compiles flipper applications for your computer.

Credits and copyrights

The FontStruction “HaxrCorp 4089” (https://fontstruct.com/fontstructions/show/192981) by “sahwar” is licensed under a Creative Commons Attribution Share Alike license (http://creativecommons.org/licenses/by-sa/3.0/).

Milk-Cool / flippulator