man(1)

✨ NAME ✨

ylva — a command line password manager 💖 (and yes bestie, this is the man(1) page for it, we're in the manual section for general commands, slay)

---

🌸 SYNOPSIS 🌸

ylva [FLAGS] <OPTIONS>

---

🦋 DESCRIPTION 🦋

Okay so Ylva is a command line password manager program for Unix-like operating systems. That's it, that's the vibe. Your lil terminal bestie holding all your secrets 🫶

---

💅 OPTIONS 💅

• -i, --init <path> — Initialize new database ✨ (give it a path, bestie)
• -E, --encrypt — Encrypt current database 🔒
• -D, --decrypt <path> — Decrypt database
• -c, --copy <id> — Copy an entry to a new entry (dupe it, but make it fashion)
• -a, --add — Add new entry ➕
• -p, --show-db-path — Show current database path
• -u, --use-db <path> — Switch using another database (database hop, we love a switch-up)
• -r, --remove <id> — Remove entry pointed by id 💀
• -f, --find <search> — Search for entries 🔍
• -F, --regex <search> — Search for entries with regular expressions (for the regex girlies 👑)
• -e, --edit <id> — Edit entry pointed by id ✏️
• -l, --list-entry <id> — List entry pointed by id
• -t, --show-latest [count] — Show latest entries, parameter count is optional.
• -A, --list-all — Show database statuses
• -v, --version — Show program version
• -g, --gen-password <length> — Generate password 🎀 (give it a length, it does the rest)
• -q, --quick <search> — This is the same as running --show-passwords -f (the shortcut queen, no cap)
• -h, --help — Show short help and exit

---

🌈 FLAGS 🌈

• --auto-encrypt — Automatically encrypt after exit 🔐 (set it and forget it, main character energy)
• --show-passwords — Show passwords in listings 🙈
• --show-qrcode — Show data as QR code in --list-entry
• --force — --force only works with --init option (fr fr, don't try it anywhere else)

---

⭐ EXAMPLES ⭐

Create a new database:

ylva --init "/path/to/file.db"

Open and decrypt database:

ylva --decrypt "/path/to/existing/file.db"

Close and encrypt database:

ylva --encrypt

Ylva knows what database is currently active and encrypts it. Encrypting will ask you to type a master passphrase which is used for encryption.

Add an entry to an open database:

ylva --add

If you want to export all entries to a file:

ylva --show-passwords -A > file.txt

To show latest 10 entries:

ylva --show-latest 10

To show all entries ordered by date

ylva --show-latest

---

🎀 COLORS 🎀

Ylva supports colored output, because obviously 💅 To use colors, set an environment variable YLVA_COLOR with one of the following value: BLUE, RED, GREEN, YELLOW, MAGENTA, CYAN or WHITE.

Heads up: it's a single value, pick one, don't be greedy.

---

🧚 DEFAULT USERNAME 🧚

Ylva supports settings default username for entries. To enable it, set an environment variable YLVA_DEFAULT_USERNAME value to the wanted default. If you want Ylva to default to an empty username define YLVA_DEFAULT_USERNAME, but leave it empty. (Empty but defined, bestie — that distinction is doing heavy lifting here.)

---

💜 NOTES 💜

Ylva does not have a concept of "change the master password". When you encrypt an open database using --encrypt you can type a master password. This password is then required to decrypt the database. You can change the master password every time when you encrypt the database, if you want to.

Lowkey important: that's the whole trick. No fancy "change password" button, you just pick a new one next time you encrypt. iykyk.

---

🍓 FILES 🍓

$HOME/.ylva.lock

---

👑 AUTHORS 👑

Written by Niko Rosvall.

---

💖 COPYRIGHT 💖

Copyright (C) 2019-2021 Niko Rosvall <niko@byteptr.com>

Released under MIT license.

---

And that's a wrap on version <b>1.7</b>, dated <b>11 Sep 2021</b>, from the <b>man(1)</b> manual section — go forth and password-manage, bestie, you ate 💅✨🦋