Canto-daemon(1)

💖 CANTO-DAEMON(1) — the girlies' guide 💖

okay so real talk, this is a page from the General Commands Manual for Canto-daemon, and bestie, we're gonna get through it together. pull up a chair, grab a strawberry 🍓, and let's go.

✨ NAME ✨

Canto-daemon — an extensible RSS aggregation daemon. yes. it daemonizes. it aggregates. it's extensible. it's giving main character energy for your feeds 🌈

🎀 COMMAND LINE USAGE 🎀

canto-daemon (options)

that's it. that's the whole vibe. options go in, daemon comes out. 💅

👑 OPTIONS 👑

okay this is the part where everyone scrolls to, so let's do it properly, one by one, no skips, no cap:

• -V, --version — prints version info and dips out. pouf. gone. ✨
• -h, --help — prints usage help, so you can feel a little less lost 🫶
• -v — turns on verbose logging (debug mode). think of it as the daemon oversharing, but like, helpfully 📢
• -D, --dir [directory] — changes the base directory for canto-daemon. the default is $XDG_CONFIG_HOME/canto 💖
• -n, --nofetch — do not fetch new content while running (debug). lowkey the laziest mode and honestly relatable 😭
• --noplugins — disables all plugins. no plugins. none. zero. ghosted 💀
• --enableplugins 'plugin1 plugin2...' — enable these plugins (and yes, this overrides --noplugins, the drama 🔥)
• --disableplugins 'plugin1 plugin2...' — disable these plugins 🙈
• -a, --address [IP] — listen on this address in addition to the local Unix socket. use "" for all interfaces. defaults to loopback (127.0.0.1) 🌸
• -p, --port [port] — use this port when listening with -a 🎀

ngl, -v and -n are both marked debug, so treat them like the experimental eyeliner of the daemon world — iconic, but you know what you're getting into 👀

🦋 CONFIGURATION 🦋

so this daemon manages its own configuration, like a girl who handles her own business 💅 — which means you should manipulate it through canto-remote or a client, like canto-curses. don't go poking at it directly, it's not that kind of relationship.

🧚 PLUGINS 🧚

okay so plugins are packaged in <prefix>/canto/plugins (i.e. /usr/lib/canto/plugins, iykyk), and you can enable them by copying them into your configuration directory (i.e. $XDG_CONFIG_HOME/canto/plugins). copy. not move. we don't destroy the originals, bestie.

many of them have configuration inside them, so you may want to open the files to make changes. yes, actually open them. read them. be nosy. 🔍

here are a few example plugins included with the canto-daemon source:

• reddit.py — adds content to reddit items. also includes a sort called reddit_score_sort that will automatically order items by upvotes. the algorithm, but make it reddit 🔥
• sync-rsync.py — an rsync based sync plugin. see the header for configuration. can be used to sync with a remote server via SSH, or with another local filesystem (for NFS/sshfs/Dropbox/gdrive etc.). she travels 🌍
• sync-inoreader.py — synchronizes (most) content with inoreader.com, a service with support for RSS on the web as well as various mobile devices. cross-platform queen 👑

⭐ FILES ⭐

• $XDG_CONFIG_HOME/canto/daemon-log — the Canto-daemon log file. this is where the receipts live 🧾
• $XDG_CONFIG_HOME/canto/plugins/ — the Canto-daemon plugins directory. drop your plugin copies here 💌
• /usr/lib/canto/plugins — the default packaged plugin directory. the mothership 🛸

🌈 HOMEPAGE 🌈

http://codezen.org/canto-ng

go visit. she's got lore.

💜 AUTHOR 💜

Jack Miller <jack@codezen.org> — thank you for your service, king 🫡

🔥 SEE ALSO 🔥

canto-remote(1) — the other half of this duo, go read it too, fr fr 💖

---

and that's the whole page, bestie! this was the Canto-daemon page, rendered from the source/version at the bottom as Canto-daemon Canto-daemon(1), dated with that footer date. mwah 💋 go aggregate your lil heart out 🎀✨