Skip to content

JavaScript ‐ Momentum

Jump to bottom
Derek Jamison edited this page Feb 9, 2025 · 11 revisions

Overview

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.

Capabilities

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.

Vs Official firmware

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"

Vs Unleashed firmware

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"

Best Practice

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".

Common Script Usage

The most common JavaScript pattern that I've seen used in Momentum firmware was for advanced BadUSB scripts. Momentum supports "storage-virtual" and "usbdisk-createimage" making it possible to copy payloads from the Flipper Zero onto the host computer and to also exfil payloads back onto the Flipper Zero, instead of needed to send to a webhook.

  • Use badusb to connect the keyboard to computer
  • Press Windows+R and type powershell
  • Runs the following badusb script (which starts executing after the entire script is entered):
    • tell user to close window when window closes
    • sleep 10 seconds
    • find "Flipper Mass Storage" drive
    • run commands (sometimes from USB drive, sometimes locally)
    • copy output to USB drive
    • delete MRU and history
    • close window
  • Attach USB drive
  • Wait for USB drive to be ejected
  • Stop USB drive

Clone this wiki locally