ARBITRON(8)

📦
version 3.12.3 · 6 versions
, in ubuntu stonking

✨ ARBITRON — the arbitron(8) glow-up ✨

okay bestie, gather round, because this is the Cyrus IMAP manual page for arbitron(8) and she is serving readership statistics 💅

🌸 NAME 🌸

arbitron — Cyrus IMAP documentation, and also the girl who counts who's been reading your mailboxes 📬

She reports readership statistics for mailboxes on the server. periodt.

🎀 SYNOPSIS 🎀

arbitron [ -C config-file ] [ -o ] [ -u ] [ -l ] [ -p months ]
         [ -d days | -D mmddyyyy[:mmddyyyy] ] mailbox...

🦋 DESCRIPTION 🦋

so arbitron collects and reports readership statistics for mailboxes on the server, no cap. she also optionally prunes the mailboxes of \Seen state for dormant users — like, politely clearing out the vibes of people who ghosted 👻

arbitron produces one line of output per mailbox, and that line goes: the mailbox name, then a space, then the number of readers (and if -u is specified, then a colon and a comma-separated list of the reader's user IDs), and if -o is not specified, another space and the number of subscribers (and if -u is specified, then a colon and a comma-separated list of the subscribers userids).

IMPORTANT: This format is subject to change in future versions. it's giving "we might change this on you," so don't @ us 🔥

Every "reader" is a distinct authorization identity which has the s right to the mailbox and which has SELECTed the mailbox within either the past -d days or the specified -D date[:range].

Users are not counted as reading their own personal mail‐boxes. Personal mailboxes are not reported unless there is at least one reader other than the mailbox's owner. like, you don't get a follower count for reading your own posts, bestie 🙈

arbitron reads its configuration options out of the imapd.conf(5) file unless specified otherwise by -C.

💖 OPTIONS 💖

  • -C config-file — use the specified configuration file config-file rather than the default imapd.conf(5). basically "not that config, this config" ✨
  • -D mmddyyyy[:mmddyyyy], --date=mmddyyyy[:mmddyyyy] — count as a reader an authorization identity which has used the mailbox within the given date range.

The start date and optionally the end date are specified as 2-digit month of the year, 2-digit day of the month, and 4-digit year.

If the end date is not specified, the current system time will be used as the end time.

NOTE: Please note that the date notation is American [mmddyyyy] not [ddmmyyyy]. so months come first, we do not make the rules 😭
  • -d days, --days=days — count as a reader an authorization identity which has used the mailbox within the past days days ⏳
  • -l, --detailed — enable long reporting (comma delimited table consisting of mbox, userid, r/s, start time, end time). it's the "give me the whole spreadsheet" option 📊
  • -o, --no-subscribers — report "the old way" -- not including subscribers. retro core 👑
  • -p months, --prune-seen=months — prune \Seen state for users who have not used the mailbox within the past months months. The default is infinity. yeah, infinity. she never prunes unless you tell her to 🧚
  • -u, --include-userids — include userids of mailbox readers in the report. If the report will contain mailbox subscribers (see --no-subscribers), also include userids of the subscribers. names attached, no anonymity 🫶

🌈 EXAMPLES 🌈

arbitron -l

Long-format list.

arbitron -o

Old format (no subscribers) short list.

arbitron

Normal short list.

arbitron -d 14

Normal short list format for the past 14 days.

arbitron -D 04012015:04152015

Normal short list Within date range of 12 - 15 April, 2015.

🍓 FILES 🍓

  • /etc/imapd.conf

💜 SEE ALSO 💜

⭐ AUTHOR ⭐

The Cyrus Team, Nic Bernstein (Onlight), Jeroen van Meeuwen (Kolab Systems) — legends, honestly 🌟

1993–2026, The Cyrus Team

and that's the whole page, bestie 💖 this was ARBITRON(8) from Cyrus IMAP version 3.12.3, dated Jul 15, 2026 — slay, go count some readers, ily 🎀🦋💅

📦 where this page comes from