GitHub - ahmedhosssam/vd: TUI Password Manager and 2FA/OTP Authenticator · GitHub

/" data-turbo-transient="true" />

Skip to content

Type / to search

Sign in<br>Sign upAppearance settings

You signed in with another tab or window. Reload to refresh your session.<br>You signed out in another tab or window. Reload to refresh your session.<br>You switched accounts on another tab or window. Reload to refresh your session.

Dismiss alert

{{ message }}

ahmedhosssam

vd

Public

Notifications<br>You must be signed in to change notification settings

Fork

Star

main

BranchesTags

Go to file

CodeOpen more actions menu

Folders and files<br>NameNameLast commit message<br>Last commit date<br>Latest commit

History<br>101 Commits<br>101 Commits

assets

assets

cmd/vd

cmd/vd

internal

internal

LICENSE

LICENSE

README.md

README.md

go.mod

go.mod

go.sum

go.sum

View all files

Repository files navigation

vd

vd is TUI password manager and OTP authenticator for Unix systems (Linux and MacOS).

Features

Encrypting the credentials using GPG.

2FA/OTP Authentication, you can finally get your OTP codes from your computer without reaching your phone.

Import your existing OTP secrets from Google Authenticator.

Scriptability with cli arguments (see Usage).

Built-in random password generator.

Export credentials to csv.

Installation

For Linux and MacOS, you can download a binary from here.

Build from source:

git clone https://github.com/ahmedhosssam/vd.git<br>cd vd<br>go mod tidy<br>go build cmd/vd/main.go<br>mkdir -p ~/.local/bin && mv main ~/.local/bin/vd

Usage

You can open the TUI by:

vd

Or use it from the cli:

Commands:<br>add Add a new password [--name password_name --password password]<br>get Copy a password to clipboard<br>delete Delete a stored password [-f|--force]<br>change Change a stored password<br>otp Add an OTP or copy its code [add|get otp_name]<br>register Register a new GPG key<br>ls List stored passwords<br>gen Generate a random password to clipboard<br>export Export passwords to a CSV file in the home directory [password_name]<br>import Import OTP secrets from a Google Authenticator export QR image [otp google path/to/img.jpg]

How Does vd Work?

vd relies on gpg keys for encryption, so we don't implement any encryption algorithms ourselves, we use GPG for encrypting/decrypting the credentials on the disk.

vd creates its own gpg key by default when you first register by $ vd register or through the TUI by /register. But if you want to use your already existing gpg key for encryption, you can just type the email that's registered for your key in ~/.local/share/vd/gpg_email.txt.

NOTE: Once the credential is encrypted with a specifc GPG key, it will be decrypted only with the same key, even if you changed ~/.local/share/vd/gpg_email.txt. That's how GPG works.

~/.local/share/vd/gpg_email.txt only affects encryption, that's why we encourage you not to change the first-created gpg key to keep all credentials decryptable with the same key.

vd stores the encrypted passwords in ~/.local/share/vd/passwords/ so be careful and don't delete this directory because vd doesn't have backups by default yet.

About<br>TUI Password Manager and 2FA/OTP Authenticator<br>Resources<br>Readme<br>MIT license<br>Activity<br>Stars<br>2 stars<br>Watchers<br>0 watching<br>Forks<br>0 forks<br>Report repository

Releases

Packages

Contributors

Languages

You can’t perform that action at this time.