🔑 Key Decoding

A Bruce app for hackers, tinkerers and lock nerds.
Decode and randomly generate key bitting patterns for a bunch of lock brands.
Visualize the cuts, tweak the pins, and save/load your keys.

📟 Supported Devices

This app is designed for Bruce Interpreter compatible devices with screen 170x320:

• LILYGO T-Embed CC1101
• LILYGO T-Embed CC1101 Plus
• Bruce PCB V2 by Smoochiees

🏴‍☠️ Supported Keys

⚡ Install

Option 1: Bruce App Store

1. Open Bruce App Store via JS Interpreter → Tools → App Store
2. if App Store is not present, go to Config → Install App Store
3. Navigate to Tools
4. Download and install Key Decoding

Option 2: Manual Install

1. Drop KeyDecoding.js onto your Bruce device
2. Fire up the Bruce Interpreter
3. Have fun

🕹️ Usage

Navigation

• SEL (Select): Move to next pin, or to Save/Load (in Decode mode)
• NEXT: Increase pin depth / Save (when "Save" is highlighted) / Load (when "Load" is highlighted)
• PREV: Decrease pin depth
• ESC: Back to main menu

⚙️ Workflow

1. Pick a Brand: Choose your target lock or load a saved key
2. Pin Count: Select how many pins (brand-dependent)
3. Mode:
   • Random: Get a random bitting (good for challenge keys)
   • Decode: Set each pin yourself (for real-world decoding)
4. Tweak Pins: Use NEXT/PREV to set each pin's depth
5. Save: SEL to "Save", then NEXT to write your key JSON
6. Load: SEL to "Load", then NEXT to pick a saved key

📂 Key File Format

Keys are saved as JSON in /keys/:

{
  "type": "Titan",
  "outline": "5 pins",
  "pins": [ 3, 5, 2, 7, 4 ]
}

Key Configuration

KeyExample: {
    displayName: "Key Example",     // display name shown in menu
    isDiskDetainer: false,          // whether the key is a disk detainer type (default false)
    bladeHeight: 45,                // blade height for disk detainer keys (default 45)
    outlines: ["5 pins", "6 pins"], // number of pins
    pinSpacing: 31,                 // distance between pins (default 31)
    maxKeyCut: 9,                   // number of cuts (default 9)
    flatSpotWidth: 5,               // width of flat spot of the cut (default 5)
    cutDepthOffset: 5,              // depth offset of each cut (default 5)
    zeroCutOffset: 0,               // depth offset of zero cut (default 0)
    edgeOffsetX: 0,                 // x offset of the bottom-right diagonal (default 0)
    edgeOffsetY: 0,                 // y offset of the bottom line (default 0)
    pinsStartAtZero: false,         // whether pin numbers start at 0 or 1 (default false)
    pinNumbersOffset: 0             // x offset for pin numbers with underline (default 0)
}

🔗 Links

• Bruce Interpreter
• Deviant Ollam: Key-and-Pin-Decoding
• Flipper Zero: KeyCopier
• LILYGO T-Embed CC1101
• ASSA Mow

⭐ Contributors

• @Phred_Phlintstoner for testing the Bruce PCB V2 by Smoochiees
• @argtime for PR Add delay to KeyDecoding.js loop

☠️ Disclaimer

For educational, CTF and red team use only.
Don't break the law. Don't be a jerk.