-
Notifications
You must be signed in to change notification settings - Fork 117
JavaScript ‐ Momentum
Momentum has the most complete support for JavaScript files. The JavaScript model changed on Oct 15, 2024 - so scripts written before this date will need to be migrated to the latest API. This is non-trivial, as you have to rewrite the script to use event_loop for the messaging. I created a video about the new features at https://youtu.be/WCIIimWm1qg which may be helpful for migration.
Example scripts can be found in the Momentum firmware under the js_app/examples folder. You can also ask people in the Momentum Discord server. The Discord server has a "Coding/javascript" folder for discussion & a "Coding/script-sharing" for people to share scripts.
Flipper Zero uses mjs. This version of JavaScript has many restrictions. Scripts are typically saved to the SD Card/apps/Scripts folder. You launch JS files by starting at the Main Menu on the Flipper Zero and selecting Apps/Scripts/name.js file.
Feb 8, 2025 - Momentum runs the latest Flipper Zero JavaScript. ** Scripts made before Oct 15, 2024 will not run!**
- CLI support (from a CLI window run the "js" command).
- BadUSB keyboard support, including different keyboard layouts.
- Read and write to files on the Flipper.
- Read and write to serial port (TX/RX or C1/C0 pins).
- GPIO for digital input/output.
- GPIO for analog input.
- I2C and SPI support.
- Run a function when GPIO pin transitions value.
- Run a function after a specific amount of time.
- File Picker dialog to pick a file.
- Dialog with Left/Right/Center choices.
- Empty & Loading screen.
- Submenu with items to pick.
- On-screen keyboard for text input or byte input.
- Dynamic textbox (update text contents while app still running).
- Get the pitch, roll and yaw of the Video Game Module (VGM)
- Widget support for rending more complex screens.
- Success/Error notifications.
- Math functions.
- Get the battery level of the Flipper.
- Get the name of the Flipper.
- Conditional logic, Loops, Number to String, String to Number.
- BLE Beacon support.
- Transmit a Sub-GHz file.
- See if a Sub-GHz frequency has strong signal on it.
- Manipulate a virtual USB drive.
As of Feb 8, 2025, the following features are only in Momentum:
- CLI support (from a CLI window run the "js" command).
- I2C support. "i2c"
- SPI support. "spi"
- Get the pitch, roll and yaw of the Video Game Module (VGM). "vgm"
- Widget support for rendering more complex screens. "widget"
- BLE Beacon support. "blebeacon"
- Transmit a Sub-GHz file. "subghz"
- See if a Sub-GHz frequency has strong signal on it. "subghz"
- Manipulate a virtual USB drive. "usbdisk"
- TextInput supports show/hide "illegal symbols" (keyboard lacks symbols). "gui-textinput-illegalsymbols"
As of Feb 8, 2025, the following features are only in Momentum:
- Manipulate a virtual USB drive. "usbdisk"
- TextInput supports show/hide "illegal symbols" (keyboard lacks symbols). "gui-textinput-illegalsymbols"
Feb 8, 2025 - Scripts written for RogueMaster will not work in Momentum. Scripts written for Momentum will not work in RogueMaster.
Scripts made for Official Flipper Zero JavaScript will work on Momentum Firmware too. If you use extra features provided by Momentum, you are encouraged to use syntax like if (doesSdkSupport(["feature-name"])) { ... } so that your JS app can work on Official Firmware too. If some of those extra features are essential to the functionality of your app, you can use checkSdkFeatures(["feature1", "feature2"]) near the beginning of your script, which will show a warning to the user that these features are not available in their firmware distribution.
Features supported by doesSdkSupport and checkSdkFeatures are:
- Modules: "blebeacon", "i2c", "spi", "subghz", "usbdisk", "vgm", "widget".
- Functions: "gui-textinput-illegalsymbols", "storage-virtual", "usbdisk-createimage", "widget-addicon".