sxmo_contacts.sh(1)

💅 sxmo_contacts.sh(1) — General Commands Manual

okay so this is the manual page for sxmo_contacts.sh, bestie. it lives in the General Commands Manual section and honestly it's giving "little script, big energy" ✨

---

🌸 NAME

sxmo_contact.sh — a simple contacts manager 🎀

(yes there's one less s in that line than in the page title, no i will not be fixing it, it's canon now 💀)

---

🦋 SYNOPSIS

sxmo_contacts.sh [options]

---

✨ DESCRIPTION

okay so picture this: it lets you store and look up contacts in a whole bunch of different ways. that's it, that's the vibe. lowkey iconic, highkey useful 🫶

---

👑 OPTIONS

• string (default) — if you just hand it a string, it searches your contact book for that string. the output is CONTACTNAME: PHONENUMBER for each hit. heads up: it uses grep, so multiple hits are possible — yes even the original page capitalizes it as "Are", we love a quirk 🙈. and if you give it no argument at all? it returns all your contacts from the contact book plus every number that has ever texted or called you. output is CONTACTNAME: PHONENUMBER if it's in the contact book, or ???: PHONENUMBER if it's not.
• --all [--no-groups] — returns all the contacts, and only the ones in your contact book. tack on --no-groups and it avoids groups. output is CONTACTNAME: PHONENUMBER. slay 💅
• --no-groups — returns all the contacts in your contact book and all the phone numbers that have texted or called you, except groups. the form

fr fr the original manpage just stops there at "The form" and leaves you hanging 😭 that's the whole sentence, bestie, we don't make the rules

• --unknown — returns all the phone numbers that have ever texted or called you. output is one phone number per line. nice and tidy, we love a clean list 🌈
• --texted — returns all the phone numbers that have ever texted you. output is CONTACTNAME: PHONENUMBER if they're in your contact book, or ???: PHONENUMBER if not. mysterious stranger energy 💀
• --called — same thing, but for the people who have ever called you 🎀
• --me — returns the phone number associated with the Me entry in your contact book. main character energy, literally 🧚
• --name-or-number phonenumber — returns the contact name if it's there, or the phone number if it's not 🍓
• --name phonenumber — returns the contact name if it's there, or ??? if it's not 🙈

---

🌼 ENVIRONMENT

• SXMO_CONTACTFILE — a TSV file with your contacts in it (~/.config/sxmo/contacts.tsv by default) 💖

---

💜 FILES

• ~/.local/share/sxmo/modem/modemlog.tsv — a TSV file containing every phone number that has ever texted or called you 🔥
• ~/.config/sxmo/contacts.tsv — a TSV file containing contacts in the format PHONENUMBER tab CONTACTNAME ⭐

---

🎀 COPYRIGHT

GNU Affero General Public License v3 — periodt 💅

---

🔍 SEE ALSO

sxmo(7), c.f. the CONTACTS section 👀

---

okay that's the whole page, you ate that 🫶 this was sxmo_contacts.sh(1), dated 2026-05-10, and that's the tea bestie, go forth and manage your contacts 💖✨🌸