PickTrack

1. Introduction to the PickTrack

The PickTrack is a specialized device designed to track and time lock picking practice. It attaches to the shackle of a padlock and detects when the lock has been successfully picked by sensing when the shackle opens.

The device works through a limit switch on its bottom surface that makes contact with the top of the lock case when the shackle is closed. When you successfully pick the lock and the shackle opens, the switch is released, signaling completion to the device.

The PickTrack has a USB-C port to use for updating the device and to power it up. It has an RGB LED to use for visual cues. The OLED is a 128x32 pixel screen that is used to interface with the device.

2. Navigation Basics

The PickTrack features three buttons on the face of the device, arranged vertically:

• Up button (Top): Navigate upward through menu options
• Select button (Middle): Choose the highlighted option (short press) or return to Main Menu (long press, 2 seconds)
• Down button (Bottom): Navigate downward through menu options

RGB LED Status Indicators:

• Yellow: Countdown in progress
• Red: Race/Picking in progress
• Green: Race/Pick completed successfully
• Blue: Bluetooth connected (in bluetooth menu)
• Blinking Blue: Bluetooth enabled but not connected

When you turn on the device, you'll see the main menu with four options:

• Timer
• Multiplayer LAN
• Multiplayer App
• Settings

Use the Up/Down buttons to navigate and the Select button to choose an option.

3. Timer Mode

Timer mode allows you to track your individual lock picking time, with options to save progress and load previous sessions.

3.1 Starting a Timer

1. From the Main Menu, select "Timer"
2. Choose "Start Timer"
3. You'll see a screen that says "Press Select to Start"
4. Press Select to initiate the countdown
5. The device will start the countdown (RGB LED turns yellow)
6. After countdown, timing begins (LED turns red)
7. Begin picking the lock
8. When the lock opens, your final time is displayed (LED turns green)
9. Press Select to start another attempt

3.2 Pausing and Saving

During an active timer, press Select to pause. The timer will stop and display two options: "Resume" or "Save". The LED will flash red to indicate the paused state.

• Resume: Continues timing from where you left off after the countdown
• Save: Store your time in one of three save slots (overwrites existing times)

3.3 Loading a Saved Time

1. From the Timer menu, select "Load Time"
2. Select a slot that contains a saved time
3. Choose "Load" to resume from saved point or "Delete" to remove the saved time
4. When you complete a loaded pick, the save is automatically deleted

4. Multiplayer LAN Mode

Multiplayer LAN mode allows up to four PickTrack devices to connect directly to each other for local events without requiring a mobile app. One device serves as the host, creating a WiFi network that other devices can join.

4.1 Host Setup

1. Select "Multiplayer LAN" → "Host"
2. Enter a 3-digit code (000-999)
3. The device creates a WiFi network named "PickTrack-XXXX"
4. The lobby screen displays your code and connected users

4.2 Joining a Lobby

1. Select "Multiplayer LAN" → "Join"
2. Scan for available PickTrack networks
3. Select a network and enter the host's 3-digit code
4. Join the lobby if the code is correct

4.3 Lobby Management

The lobby screen shows all connected players with status indicators:

• Your username has "(Y)" suffix
• Host username has "*" suffix
• "R" for Ready, "NR" for Not Ready

Host can kick players, all players can toggle ready status. Race starts when all players are ready.

5. Multiplayer App Mode

Multiplayer App mode connects your PickTrack to the mobile application via Bluetooth for enhanced multiplayer features and tracking.

5.1 Connecting to the App

1. Ensure Bluetooth is enabled in Settings
2. Select "Multiplayer App" (displays "Connect in App")
3. Open the PickTrack mobile app
4. Navigate to Devices tab and connect to your PickTrack

5.2 Mobile App Features

• Device Management: Connect via Bluetooth, modify settings
• Race Management: Create/join races (2-6 players), 6-character lobby codes
• History Tracking: View pick history, sort by time/date/lock name
• Settings: LED brightness, Bluetooth, username customization

6. Settings

6.1 Bluetooth

Enable/disable Bluetooth functionality. LED blinks blue when enabled but not connected, solid blue when connected.

6.2 Username

Customize your 4-character username (A-Z, 0-9). Default username is generated from device MAC address. Username identifies your device in multiplayer modes.

6.3 Brightness

Adjust LED brightness level (0-10). Setting to 0 turns LED off completely.

6.4 Countdown

Adjust countdown length for Timer mode (0-10 seconds). Setting to 0 starts timer immediately.

7. Tips and Shortcuts

• Quick Return: Long-press Select (2 seconds) to return to Main Menu
• Auto-Delete: Loading and completing a saved time automatically deletes the save
• Host Priority: Only the host can kick players or force-start a race
• Connection Indicators: Look for "(Y)" suffix (you), "*" suffix (host), "R/NR" status
• App Connection: Ensure Bluetooth is enabled before connecting to app
• Network Issues: Try refreshing network scan, ensure devices are close

1. Getting Started

Download the PickTrack app from the Apple App Store (iOS) or Google Play Store (Android). The app features five main sections:

• Home: Current pick time and recent history
• History: Browse and manage all picking records
• Multiplayer: Create or join races
• Devices: Connect to and manage PickTrack devices
• Settings: Configure device settings

2. Device Connection

1. Enable Bluetooth on your PickTrack device (Settings menu)
2. Navigate to Devices tab in the app
3. App automatically scans for nearby devices
4. Tap "Connect" next to your device
5. Device moves to "Connected Device" section when successful

Note: The device address shown is the Bluetooth MAC address for identification.

3. Device Settings Management

When connected, you can modify all device settings through the app:

• Bluetooth: Enable/disable (disabling disconnects from app)
• Username: 4-character username (A-Z, 0-9)
• Brightness: LED brightness (0-10)
• Countdown: Timer countdown length (0-10 seconds)

Tap "Save Changes" to apply settings or "Cancel" to revert.

4. History and Statistics

The app tracks picking statistics when connected to your device:

• History Tab: View all picks, sort by newest/fastest/lock name
• Statistics: Overview, trends, and lock-specific details
• Lock Naming: Assign names to locks for better tracking
• Data Analysis: Best times, averages, consistency, improvement trends

5. Multiplayer Racing

Compete with other PickTrack users online (requires internet connection):

Hosting a Race:

1. Tap "Host Race"
2. Select max players (2-6)
3. Share the 6-character lobby code
4. Start race when all players are ready

Joining a Race:

1. Tap "Join Race"
2. Enter the 6-character lobby code
3. Toggle ready status
4. Wait for host to start race

Note: Race timing is server-controlled with official times calculated to account for network latency.