vd is een Text User Interface (TUI) applicatie voor Unix-systemen waarmee gebruikers hun wachtwoorden en 2FA/OTP-codes veilig kunnen beheren. De tool leunt op GPG-sleutels voor versleuteling, waardoor er geen eigen encryptiealgoritmen hoeven te worden geïmplementeerd.
De belangrijkste functionaliteiten zijn:
- Beveiliging: Versleuteling van inloggegevens via GPG.
- OTP Support: Het genereren van 2FA-codes direct op de computer, inclusief importmogelijkheden vanuit Google Authenticator.
- Interfaces: Beschikbaar als TUI en via een uitgebreide Command Line Interface (CLI) voor scriptbaarheid.
- Extra tools: Een ingebouwde wachtwoordgenerator en exportmogelijkheden naar CSV.
De software kan worden geïnstalleerd via binaries of door de broncode in Go te compileren.
vd: TUI Wachtwoordbeheerder en 2FA/OTP Authenticator
Functies
- Versleuteling: Inloggegevens worden versleuteld met behulp van GPG.
- 2FA/OTP Authenticatie: Hiermee kun je OTP-codes direct vanaf je computer ophalen zonder dat je je telefoon nodig hebt.
- Import: Importeer bestaande OTP-geheimen vanuit Google Authenticator.
- Scriptbaarheid: Ondersteuning voor CLI-argumenten (zie Gebruik).
- Wachtwoordgenerator: Ingebouwde generator voor willekeurige wachtwoorden.
- Export: Exporteer inloggegevens naar een CSV-bestand.
Installatie
Voor Linux en MacOS kun je een binary downloaden van de repository.
Bouwen vanuit broncode:
git clone https://github.com/ahmedhosssam/vd.git
cd vd
go mod tidy
go build cmd/vd/main.go
mkdir -p ~/.local/bin && mv main ~/.local/bin/vd
Gebruik
Je kunt de TUI openen met het volgende commando:
vd
Alternatief kun je de applicatie via de command-line interface (CLI) gebruiken.
CLI Commando's:
add: Voeg een nieuw wachtwoord toe [--name wachtwoord_naam --password wachtwoord]get: Kopieer een wachtwoord naar het klemborddelete: Verwijder een opgeslagen wachtwoord [-f|--force]change: Wijzig een opgeslagen wachtwoordotp: Voeg een OTP toe of kopieer de code [add|get otp_naam]register: Registreer een nieuwe GPG-sleutells: Toon een lijst met opgeslagen wachtwoordengen: Genereer een willekeurig wachtwoord naar het klembordexport: Exporteer wachtwoorden naar een CSV-bestand in de home-directory [wachtwoord_naam]import: Importeer OTP-geheimen vanuit een Google Authenticator export QR-afbeelding [otp google pad/naar/img.jpg]
Hoe werkt vd?
vd maakt gebruik van GPG-sleutels voor versleuteling. Er zijn geen eigen encryptiealgoritmen geïmplementeerd; in plaats daarvan wordt GPG gebruikt voor het versleutelen en ontsleutelen van de inloggegevens op de schijf.
Standaard maakt vd een eigen GPG-sleutel aan bij de eerste registratie via $ vd register of via de TUI met /register. Als je echter een bestaande GPG-sleutel voor versleuteling wilt gebruiken, kun je het e-mailadres dat bij jouw sleutel is geregistreerd invoeren in ~/.local/share/vd/gpg_email.txt.
Let op: Zodra een inloggegeven met een specifieke GPG-sleutel is versleuteld, kan deze alleen worden ontsleuteld met diezelfde sleutel, zelfs als je de inhoud van ~/.local/share/vd/gpg_email.txt wijzigt. Dit is de fundamentele werking van GPG.
Het bestand ~/.local/share/vd/gpg_email.txt heeft alleen invloed op de versleuteling. Daarom wordt aangeraden om de eerst aangemaakte GPG-sleutel niet te wijzigen, zodat alle inloggegevens met dezelfde sleutel ontsleuteld kunnen blijven worden.
vd slaat de versleutelde wachtwoorden op in ~/.local/share/vd/passwords/. Wees voorzichtig en verwijder deze directory niet, aangezien vd standaard nog geen back-ups maakt.
vd: TUI Wachtwoordbeheerder en 2FA/OTP Authenticator
Functies
- Versleuteling: Inloggegevens worden versleuteld met behulp van GPG.
- 2FA/OTP Authenticatie: Hiermee kun je OTP-codes direct vanaf je computer ophalen zonder dat je je telefoon nodig hebt.
- Import: Importeer bestaande OTP-geheimen vanuit Google Authenticator.
- Scriptbaarheid: Ondersteuning voor CLI-argumenten (zie Gebruik).
- Wachtwoordgenerator: Ingebouwde generator voor willekeurige wachtwoorden.
- Export: Exporteer inloggegevens naar een CSV-bestand.
Installatie
Voor Linux en MacOS kun je een binary downloaden van de repository.
Bouwen vanuit broncode:
git clone https://github.com/ahmedhosssam/vd.git
cd vd
go mod tidy
go build cmd/vd/main.go
mkdir -p ~/.local/bin && mv main ~/.local/bin/vd
Gebruik
Je kunt de TUI openen met het volgende commando:
vd
Alternatief kun je de applicatie via de command-line interface (CLI) gebruiken.
CLI Commando's:
add: Voeg een nieuw wachtwoord toe [--name wachtwoord_naam --password wachtwoord]get: Kopieer een wachtwoord naar het klemborddelete: Verwijder een opgeslagen wachtwoord [-f|--force]change: Wijzig een opgeslagen wachtwoordotp: Voeg een OTP toe of kopieer de code [add|get otp_naam]register: Registreer een nieuwe GPG-sleutells: Toon een lijst met opgeslagen wachtwoordengen: Genereer een willekeurig wachtwoord naar het klembordexport: Exporteer wachtwoorden naar een CSV-bestand in de home-directory [wachtwoord_naam]import: Importeer OTP-geheimen vanuit een Google Authenticator export QR-afbeelding [otp google pad/naar/img.jpg]
Hoe werkt vd?
vd maakt gebruik van GPG-sleutels voor versleuteling. Er zijn geen eigen encryptiealgoritmen geïmplementeerd; in plaats daarvan wordt GPG gebruikt voor het versleutelen en ontsleutelen van de inloggegevens op de schijf.
Standaard maakt vd een eigen GPG-sleutel aan bij de eerste registratie via $ vd register of via de TUI met /register. Als je echter een bestaande GPG-sleutel voor versleuteling wilt gebruiken, kun je het e-mailadres dat bij jouw sleutel is geregistreerd invoeren in ~/.local/share/vd/gpg_email.txt.
Let op: Zodra een inloggegeven met een specifieke GPG-sleutel is versleuteld, kan deze alleen worden ontsleuteld met diezelfde sleutel, zelfs als je de inhoud van ~/.local/share/vd/gpg_email.txt wijzigt. Dit is de fundamentele werking van GPG.
Het bestand ~/.local/share/vd/gpg_email.txt heeft alleen invloed op de versleuteling. Daarom wordt aangeraden om de eerst aangemaakte GPG-sleutel niet te wijzigen, zodat alle inloggegevens met dezelfde sleutel ontsleuteld kunnen blijven worden.
vd slaat de versleutelde wachtwoorden op in ~/.local/share/vd/passwords/. Wees voorzichtig en verwijder deze directory niet, aangezien vd standaard nog geen back-ups maakt.
Groetjes,