Home > Apps > iOS

iOS App

The Biscuit Manager app for iOS provides the full suite of Biscuit features with native iOS integration.


Requirements

  • iOS 16.0 or later
  • iPhone with Bluetooth Low Energy support
  • Location Services enabled (required for BLE scanning and wardriving)

First Launch

The first time you open Biscuit Manager, you will see the License Agreement screen. You must tap Accept to continue. Tapping Decline closes the app; reopening it brings the License Agreement back. Once accepted, the screen does not appear again, including across app updates.


Connecting to Your Device

The app opens straight to the Dashboard. Tap the connect button in the top-right to open the device panel, which slides in from the right. It lists every Biscuit you have connected before – each with its model picture, name, and a live Nearby badge with signal strength when it is in range. (On your very first launch, with nothing remembered yet, the panel opens for you automatically.)

  • Connect – tap a device. A status banner drops down from the top (Connecting… then Connected) and the panel closes once you are linked. Tap the X on the banner to cancel a connection attempt.
  • Switch devices – while you are connected, the panel shows your current device marked Connected alongside the rest. Tap a different one to hand off – it disconnects the first and connects the second.
  • Add a new device – tap + Add new device to show nearby Biscuits you have not connected before, then tap one to connect.
  • Out of range? – you can still tap a remembered device that is not nearby; the app keeps trying and connects when it powers back on or comes into range.
  • Forget a device – swipe a remembered device to remove it from the list.

Your devices are remembered between sessions and each keeps its own name. If you rename a Biscuit it updates in the list automatically, so using two devices just works. If the connection drops, the same top banner shows Reconnecting… while the app re-links – tap the X on it to stop.

To view the Patreon supporters or support Biscuit development, open Settings and tap the heart in the top-right.

Faster BLE transfers

Open Settings → Connection → Faster BLE Transfers to opt in to faster Bluetooth data transfers during wardrives and other scans. This setting is off by default, including after updating from an app version that adjusted the speed automatically. Leave it off to use the device’s normal connection speed.

This works on some phones. If you experience disconnects during wardrives or other scans, turn it back off. Turning it off requests the device’s normal connection settings for the current session as well.

When enabled, the app requests a faster connection while scanning or wardriving and returns to its idle speed when the operation ends. Scans can start immediately while the connection adjusts. Your iPhone chooses the final connection speed.

This option requires Pro or Ultra with WROOM firmware v1.5.44 or later, or DIY or Crumb with C5 firmware v1.5.23 or later. Older firmware continues to work with its existing connection settings.


Temperature and CPU frequency

Open Settings → Logging & Terminal and enable Thermal Pill or CPU Frequency Pill to show these readings on the Dashboard. Both options are off by default and require the updated app and firmware v1.6.0 with diagnostic status support.

The thermal pill shows the C5 module’s temperature in Celsius. Pro and Ultra use this reading to guide cooling for both modules; it is not a separate temperature measurement of the WROOM. The CPU pill shows both module speeds on Pro and Ultra, or the C5 speed on DIY.

Readings refresh about every five seconds while the app is active. Unavailable readings are hidden, and the pills clear when disconnected or when fresh readings stop arriving. Thermal throttling works whether these options are enabled or disabled. It does not add repeated messages to the terminal.


Themes

Open Settings → Display & UI → Appearance to pick a theme. Each entry shows a colour preview and a name; tap to apply.

  • System – follows your iPhone’s light or dark mode setting.
  • Light – Biscuit Classic on a light background.
  • Dark – Biscuit Classic on a dark background (default).
  • WDGWars – deep near-black surfaces with electric cyan, magenta, purple, and lavender accents inspired by WDGWars.
  • Talking Sasquatch Synthwave – bright cyan background fading to deep plum at the top, with white text, cyan action buttons, and dark purple nav.
  • Midwest Gadgets Brown – cream paper background with dark brown nav and text, in an earth-tone palette.
  • Ghost Strats Purple – pitch-black background with bright indigo accents and mint highlights.
  • Valley Tech Moonlight – black background with bright silver moonlight accents, white highlights, and chrome outlines.
  • Black Wire Militia – true-black background with bold red highlights, buttons, and outlines throughout.
  • Frostbyte Ice Blue – deep navy-blue background with teal and bright-cyan accents, icy-white text, and a navy depth gradient.

Your selection is saved and applied immediately across every screen. WDGWars, Sasquatch, Ghost, Valley Tech Moonlight, Black Wire Militia, and Frostbyte are fixed dark palettes; Midwest is a fixed light palette. The partner themes do not switch with the iPhone’s light/dark setting.


Scan and Attack Controls

On scan, sniff, capture, and attack screens, use the play and stop controls in the toolbar to start or stop the operation. These controls include the Start and Stop labels for accessibility. Other actions remain separate toolbar controls, so each action is available on its own. Depending on the device and screen layout, the system may arrange the toolbar horizontally or vertically. Wardriving keeps its existing controls, and controls shown inside setup or results panels stay where they are.


Map Appearance

Below the Appearance picker, Settings → Display & UI → Map Appearance lets you choose how maps are styled, independent of the app theme:

  • System – map follows your iPhone’s light or dark mode.
  • Light – forces the standard Apple Maps light style.
  • Dark – forces Apple Maps dark style.

Only the standard map is affected. Satellite and Hybrid map types use Apple’s imagery and are unchanged by this setting.


Permissions

The app requests the following permissions:

Permission Why It’s Needed
Bluetooth Communicating with your Biscuit device
Location (While Using) GPS data for wardriving and BLE scanning (iOS requires location permission for BLE)
Location (Always) Optional – enables background wardriving
Notifications Firmware update alerts and operation status

Live Activities

On iOS 16.1+, Biscuit Manager supports Live Activities for monitoring operations without opening the app:

  • Lock Screen Widget – Shows the current operation type, duration, and key statistics
  • Dynamic Island – Compact status indicator on supported iPhones
  • Apple Watch Smart Stack – A compact card on your wrist: operation icon, elapsed time, GPS accuracy, and live counts
  • CarPlay Dashboard – The same compact card on your car’s screen while an operation is running
  • Automatically starts when you begin a scan, attack, or wardrive
  • Updates with live stats; wardrive counters refresh about every 10 seconds to limit background work
  • Tap to jump back into the app

Live Activities keep you informed about long-running operations like wardriving sessions without needing to keep the app in the foreground.


Apple Watch Companion

Biscuit Manager ships with a companion app for Apple Watch (watchOS 10+) that mirrors key status and lets you control wardriving from your wrist. It installs automatically when you install Biscuit Manager on a paired iPhone.

The Apple Watch app is a remote for your iPhone – it does not connect to the Biscuit device directly. Your iPhone must be nearby and running Biscuit Manager (foreground or background) for the watch to receive updates and send commands.

Dashboard page

Glanceable rows show:

  • Connection status – connected / scanning / disconnected / Bluetooth off
  • Device name – the paired Biscuit
  • Battery – with a colour-coded icon (red below 15%, amber below 30%)
  • Current operation – the active scan/attack/wardrive and an elapsed timer

Wardrive page

  • Mode picker – WiFi, BT Only, or All (matches the iPhone modes)
  • Start / Stop – begins or ends a wardriving session on the Biscuit via the iPhone
  • Live stats – AP count, station count, BT count, distance travelled, and elapsed time, updated once per second while wardriving is active

When the iPhone is unreachable

The dashboard shows a “Phone not reachable” banner and the Start button is disabled. Reachability returns automatically once the iPhone is back in range or its app is relaunched.


Background Operation

  • Use the bottom dock in portrait to visit Dashboard or other screens during a wardrive. Recording, setup, and pre-start countdowns continue while you browse.
  • Tap Wardrive to return to the live map. The map refreshes as the screen opens, and returning from another app keeps your selected screen.
  • The dock stays hidden on the Wardrive screen in landscape. Rotate back to portrait to use it.
  • BLE connections persist when the app is backgrounded
  • Active operations continue running while you use other apps
  • The app reconnects automatically if the BLE connection drops
  • Wardriving continues to log GPS and scan data in the background when Location (Always) is granted

Data Storage

  • Wardriving sessions, EAPOL captures, and counter-surveillance reports are stored as files in the app’s Documents directory
  • Settings are stored in UserDefaults
  • Exported files (PCAP, CSV) can be shared via the iOS share sheet to other apps, AirDrop, or cloud storage

Tips

  • Keep the app in the foreground during firmware updates for the most reliable experience
  • If BLE scanning doesn’t find your device, toggle Bluetooth off and on in iOS Settings
  • For wardriving, grant “Always” location permission for the best GPS tracking in the background