Skip to main content

Settings

The BLEShark Nano gives you two places to tune how the device behaves, both under the Config entry on the main menu:

  • Config -> Settings is the on-device editor. Toggle features, pick values, set names, no computer needed.
  • Config -> Transfer opens the file portal. Upload scripts or captive portal HTML, and export captured handshakes or your current settings.

Editing Settings On-Device​

Open Config -> Settings to bring up the full settings editor. Use [L] and [R] to move through the list, and [S] to change or enter a row. Toggles flip on press. Numbers, pickers, and text fields open a small editor where [L] / [R] change the value and [S] saves.

Settings are grouped by category:

Shiver​

  • BLE Adv - turn regular Bluetooth advertising on or off.
  • Shiver - enable Shiver, the multi-device protocol. See Shiver Overview.
  • Name - the mesh name other Nanos see for this device. Up to 8 characters. Leave blank to fall back to the first four bytes of the eFuse ID.
  • Long Range - toggle the mesh's Long Range radio rate. See Long Range Mode for the tradeoffs.

WiFi​

  • WiFi Nets - manage the list of saved Wi-Fi networks. The Nano cycles through this list automatically on boot and during firmware updates until it finds one that's available, so you rarely need to touch it after first-time setup. Use the rows here to add new networks or remove old ones. The separate Wi-Fi -> Connect menu (not in Settings) is a testing tool for forcing a connection to a specific saved network so you can observe DHCP traffic, find an IoT device's IP, or run other tests against it.
  • Deauth Dly - delay between deauth frames, in milliseconds. Range 0 to 50.
  • AP Count - maximum number of access points to list when scanning. Range 10 to 500.
  • Evil SSID - Wi-Fi name the device broadcasts when running Evil Portal. Up to 32 characters.
  • Portal SSID - Wi-Fi name the device broadcasts when running Captive Portal. Up to 32 characters.

Bluetooth​

  • Key Delay - delay between keystrokes when sending Bad-BT payloads, in milliseconds. Range 1 to 100.
  • BT Name - the Bluetooth name the device advertises to phones and computers. Up to 20 characters.
  • Keypad - edit the eight Mini Keypad macro slots. Each slot holds one key combination up to 24 characters, for example ctrl+alt+delete.

IR​

  • Remotes - manage saved IR remotes. Rename or delete the ones you've captured.

Display​

  • Brightness - OLED brightness. Range 5 to 255, stepped by 5.
  • Boot Screen - pick which screen the device opens to after power-on: Main Menu, BLE Spam, Node Menu, IR Menu, Wi-Fi, BLE Tools, or Games.
  • Screensaver - toggle the screensaver, set its timeout, and pick a style. See Screensaver.

System​

  • Emergency - enable or disable Emergency Mode. See Emergency Mode.
  • Low Batt - battery percentage at which the low-battery warning kicks in. Range 5% to 25%.
  • Updates - Auto Update toggles the automatic OTA firmware check on boot, and Beta opts this device into beta firmware builds.
  • Upload AP - customize the Wi-Fi network the device uses when you open Config -> Transfer: SSID, username, password, and Rand Pass to have the device auto-generate a random password each time.

At the bottom of the category list you'll find Reset All, which restores every setting on the device to its factory default. Use with care.

Transferring Files​

Open Config -> Transfer to bring up the file portal. The device starts its own Wi-Fi network; connect to it from a phone or computer and open the portal in your browser.

  • Open Config -> Transfer on your BLEShark Nano.
  • Connect to the Wi-Fi network shown on the screen, using the login credentials displayed on the device.
  • The captive portal should open automatically. If it doesn't, visit nano.place in your browser to force it.
  • From the portal, upload or download the files you need.

What You Can Upload​

  • DuckyScript files for Bad-BT.
  • Text files for the TxtViewer app.
  • Captive portal HTML for the Captive Portal and Evil Portal apps.
  • Custom Wi-Fi name lists (CSV) for Wi-Fi AP Spam.

What You Can Download​

  • Handshake PCAP - a ZIP archive of every Wi-Fi handshake captured on the device.
  • Settings JSON - the device's current settings file, so you can back it up or transfer it to another Nano.
  • Portal JSON - submitted credentials captured by the Evil Portal and Captive Portal apps.
  • Portal HTML - the last HTML page you uploaded, so you can pull it back for editing.
  • Wi-Fi names list - the CSV you uploaded for AP Spam.
tip

If you have a mesh set up, you can also move handshakes, settings, and portal submissions between Nanos over Shiver, no computer needed. See Sync.