ROLO(1)

📦 version 021, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

✨ NAME ✨

rolo — text-based contact management software. That's it, that's the whole entire vibe. 🫶

Also, fun fact, you're reading rolo(1), a local manual page, in case you were wondering where you landed. Welcome bestie, take a seat. 💖

✨ SYNOPSIS ✨

rolo [-r] [-f datafile]
rolo [-v]
rolo [-V]

✨ DESCRIPTION ✨

Okay so rolo keeps track of your contacts, and then it displays them to you through a text-based menu. That's the whole thing. No mouse, no popups, just you, your terminal, and your little address book living its best life. 💅

It strives to be a well-constructed tool for complimenting text-based email programs — such as mutt. (Yes, complimenting. It's a supportive icon. It's not here to fight your mail client, it's here to hype it up.) ✨

For storage it utilizes the vCard version 3.0 format, and it interfaces with the end-user through a NCurses front-end. So like, very retro, very cute, very functional. Iykyk. 🌸

The options are as follows:

  • -r — Open the data file in read-only mode. This essentially disables adding, editing, and deleting contacts. Nothing gets touched, nothing gets changed, it's giving museum exhibit. 🙈
  • -f — Use the specified file as the data file. Like, your file, bestie, you pick it, pass it as datafile. 🎀
  • -v — Display the version. Quick little flex, number only. ⭐
  • -V — Display the copyright and license. The legal girlies deserve their moment too. 👑

✨ ENVIRONMENT ✨

  • ROLO_EDITOR — If ROLO_EDITOR is set, its value is used as the name of the program to invoke when displaying contact entries in advanced edit. If ROLO_EDITOR is not set, then EDITOR is used. If EDITOR is also not set, the default value of /usr/bin/editor is used. It's a whole fallback chain, and honestly? Respect. 🦋

✨ FILES ✨

  • ~/.rolo/contacts.vcf — The default data file that rolo reads upon startup. Your home base, your safe space, your contact kingdom. 👑

✨ SEE ALSO ✨

✨ AUTHORS ✨

  • Andrew Hsu <ahsu@users.sf.net> 💖

✨ BUGS ✨

Okay so we have to be honest here, because that's what besties do: the read-only option does not work. And the configuration file is not used. That's it, that's the tea. Not me being devastated about it. 😭💀

And that's a wrap, my love — this page came to you from Debian, dated April 26, 2003, and it lives under the name ROLO(1). Slay, bye. 💖✨🎀

📦 where this page comes from