iOS App
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.
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).
- 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.
Your selection is saved and applied immediately across every screen. Sasquatch, Ghost, Valley Tech Moonlight, and Black Wire Militia are fixed dark palettes; Midwest is a fixed light palette. The partner themes do not switch with the iPhone’s light/dark setting.
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
- Automatically starts when you begin a scan, attack, or wardrive
- Updates in real-time with live stats
- 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 + Flock, 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
- 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 anti-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