1 unstable release
0.1.0 | Mar 2, 2025 |
---|
#1073 in Cryptography
19KB
74 lines
QCard
QCard or qcard
is a simple CLI tool made to emulate the function of a Qwertycard (as seen on their website)
There are no build-time or run-time dependencies, other than having a Wayland or X environment on Linux.
This tool is meant to work on Linux and Windows, and has been tested on both, however it should have no issue working with macOS or any of the *BSDs provided an X or Wayland environment is present.
Configuration
There are 2 mandatory and 1 optional environment variables that you need to set to use QCard.
QCARD_DICT
- The cipher on the front of the card, all characters arranged into one string. (Q-Y, then A-L, then Z-M, all in the order they appear on your keyboard with no spacing or delimiters.)QCARD_SPACE
- The characters found on the spacebar on the front of the card.QCARD_SECRET
(Optional) - The secret to put in the middle of the password. If omitted it will be replaced with the string "<SECRET>"
Alternatively, you do not need a Qwertycard to obtain the DICT/SPACE. You can use
How it works
As explained on the website, each Qwertycard password has 3 components:
- The cipher, which is on the front of the card, each key on a QWERTY keyboard being represented by a random ASCII character.
- A secret, which you do not store anywhere and keep in your memory.
- The prefix/space, which is found on the spacebar of the QWERTY keyboard on the front of the card.
The password is then constructed as follows:
SPACE + SECRET + CIPHERED SERVICE NAME
The service name, e.g., for www.amazon.com being AMAZON.
Dependencies
~1.1–2MB
~35K SLoC