Skip to main content

Preferences

Preferences.json

Plug in your USB Nova in setup mode to edit the preferences.json file on the drive.

tip

When you edit the JSON file, make sure it stays correctly formatted. Otherwise the USB Nova won't be able to apply your settings. You can easily test if your file is valid with online tools like jsonformatter.

info

If you run into problems, delete preferences.json and edit the new file that gets created after plugging the USB Nova back in.

{
"$schema": "https://raw.githubusercontent.com/SpacehuhnTech/USBNova/main/schema.json",
"enable_msc": false,
"enable_led": true,
"enable_hid": true,
"hid_vid": "16D0",
"hid_pid": "11A4",
"hid_rev": "0100",
"msc_vid": "SpHuhn",
"msc_pid": "USB Nova",
"msc_rev": "1.0",
"default_layout": "US",
"default_delay": 5,
"main_script": "main_script.txt",
"attack_color": [
128,
0,
0,
0
],
"setup_color": [
0,
0,
20,
0
],
"idle_color": [
0,
30,
0,
0
],
"disable_capslock": true,
"run_on_indicator": false,
"initial_delay": 1000
}

Settings Explained

info

Restart is required to apply changes! Some features only work on Windows (*).

SettingDefault ValueExplanation
enable_mscfalseEnable USB mass storage (USB drive) in attack mode
enable_ledtrueEnable RGB LED
enable_hidtrueEnable HID in setup mode
hid_vid16D0USB Keyboard Vendor ID
hid_pid11A4USB Keyboard Product ID
hid_rev0100USB Keyboard Product Revision
msc_vidSpHuhnUSB Mass Storage Vendor ID
msc_pidUSB NovaUSB Mass Storage Product ID
msc_rev1.0USB Mass Storage Product Revision
default_layoutUSDefault Keyboard Layout (see all available layouts)
default_delay5Default delay between each line
main_scriptmain_script.txtName of your BadUSB script
attack_color[128,0,0,0]LED color for attack mode
setup_color[0,0,20,0]LED color for setup mode
idle_color[0,30,0,0]LED color for finished attack
disable_capslocktrue(*) Turn off capslock before starting attack
run_on_indicatorfalse(*) Start script when the user presses capslock, numlock, or another indicator key
initial_delay1000Startup delay
note

Colors are defined like this: [Red, Green, Blue, Blink-Interval]. The color values go from 0 to 255. The blink interval is in milliseconds, and 0 means it's not blinking.

Made with ❤️ by

Spacehuhn

dev 9fbbf84a