BASHCARDS(1)

✨ BASHCARDS(1) ✨

okay bestie, so you found the bashcards manual page 💅 and honestly? it's giving "study buddy but make it a bash script." it's a User Command, it's iconic, and it lives on line 1 where the header says BASHCARDS(1) — but you don't need to worry about that, I got you 🫶

---

🎀 NAME 🎀

bashcards — practice flashcards in bash, fr fr 💖

---

🌸 SYNOPSIS 🌸

like, here's every way you can call it, verbatim, no cap:

bashcards -d|--dir DIRECTORY
bashcards -h|--help
bashcards -v|--version

---

🦋 DESCRIPTION 🦋

so bashcards is literally a bash program for practicing flashcards in bash 🎴 it does the absolute most in the best way: it lists the decks (*.bcrds files) in a directory and lets you pick one. then it shows each card in a random order — one side, then the other when you press return. and the way that it's random which side comes first too?? main character energy ✨

---

💅 OPTIONS 💅

• -d, --dir DIRECTORY — the directory containing bashcard files (*.bcrds) 📁 that's where your decks live bestie
• -h, --help — see this help information 🥺 she's helpful
• -v, --version — current version 👑

---

🍓 DECK FILES 🍓

a deck is a UTF-8 text file named something.bcrds with one card per line, formatted as front=back 💖

the rules, and listen closely because this part matters:

• everything after the first = is the back of the card — so a back may contain = but a front may not ⚠️
• blank lines are ignored 🙈
• lines without an =, or with no text before or after the first =, are skipped with a warning 💀

for example, spanish.bcrds:

Te quiero.=I love you.
Hasta luego.=See you later.

periodt. that's the whole format 🎀

---

🌈 ENVIRONMENT 🌈

card borders are measured in characters, so bashcards expects a UTF-8 locale (LC_ALL, LC_CTYPE or LANG) and warns when it finds anything else 🧚 keep your locale cute or she will say something, ngl

---

⭐ EXIT STATUS ⭐

• exits 0 when you finish a deck or leave with Ctrl+d 🫶 slay
• exits 1 when given an unknown option, no directory, a directory that does not exist, or a directory without any *.bcrds files 😭 no deck no vibes

---

🔥 EXAMPLES 🔥

bashcards -d ~/flashcards

literally that's it, go study 💜

---

💀 BUGS 💀

report bugs at https://github.com/rpearce/bashcards/issues — be nice, she's trying 🙏

---

👑 AUTHOR 👑

Robert W. Pearce (me@robertwpearce.com) — the icon behind it all 🌟

---

okay that's the whole page bestie, every flag and every caveat intact 💖 and for the cute sign-off: this is bashcards 0.2.0, dated 2026-09-25, and that footer line BASHCARDS(1) is us, we're literally the manual page 🎀✨ iykyk 🦋