Your Own Keycards

How it works

Librescoot uses NFC keycards to unlock and lock the scooter. Hold a card to the reader on the dashboard, and the scooter unlocks. Any NFC card with a UID works.

With the stock firmware, keycards were hardcoded to the scooter and couldn't be changed by the user. With unu GmbH gone, there's no one to do it either. Librescoot puts you in control:

• Add any NFC card as a keycard
• No limit on the number of keycards
• Master keycards can teach in new cards without CLI access
• Export and import keycard lists for backup

Setting up keycards

On a fresh installation with the recommended Installer, you teach in your cards before leaving the Installer – see Handbook: Getting started. On the scooter itself, a master card can teach in additional user cards without any tools. The lsc commands below are the fallback for setups without a master card or the Installer.

Managing keycards

Use the lsc CLI to manage your keycards:

lsc keycard list               # List all authorized keycards
lsc keycard add <uid>          # Add a keycard
lsc keycard remove <uid>       # Remove a keycard
lsc keycard add-master <uid>   # Add a master keycard
lsc keycard export cards.json  # Export for backup
lsc keycard import cards.json  # Import from backup

You can also teach in new keycards directly via a master keycard at the dashboard, without needing SSH access.