FEED2TOOT(1)

🌸 NAME 🌸

feed2toot — take an rss feed and send it to Mastodon 💖

Like, you have an RSS feed, right? And you have a Mastodon. feed2toot is the little bestie that smooshes them together. It lives in the User Commands section of the manual (that's section 1, iykyk). 🦋

✨ USAGE ✨

okay so here's the literal invocation, copy-paste girlies rise:

usage: feed2toot [-h] [--version] [-c FILE [FILE ...]] [-a]
[--ignore-ssl]

       [-l LIMIT] [-t LOCKTIMEOUT] [--cachefile CACHEFILE] [--lockfile
       LOCKFILE] [-n] [-v] [-d] [--syslog
       [{CRITICAL,FATAL,ERROR,WARN,WARNING,INFO,DEBUG}]] [--hashtaglist
       HASHTAGLIST] [-p] [-r http://...]  [--rss-sections]

and again, just so you know the whole vibe: take rss feed and send it to Mastodon 🫶

🎀 optional arguments 🎀

the way that there are so many of these… but bestie we're going through every single one, no skips 💅

• -h, --help — show this help message and exit. the classic. the icon. the "wait what does this do again" button 👑
• --version — show program's version number and exit. for when you gotta know exactly which era of feed2toot you're in 🕰️
• -c FILE [FILE ...], --config FILE [FILE ...] — Location of config file (default: ['~/.config/feed2toot.ini']). yes it can take a whole LIST of files, not just one, main character energy fr fr 🗂️
• -a, --all — tweet all RSS items, regardless of cache. like, forget what you already posted, we're doing EVERYTHING 😤
• --ignore-ssl — ignore ssl errors while fetching rss feeds. 🚩 okay so it's right there in the name, you're telling it to ignore SSL errors, proceed with the awareness that this is a "trust me bro" flag 🔥
• -l LIMIT, --limit LIMIT — tweet only LIMIT items (default: 10). ten is the default, ten is the vibe 💜
• -t LOCKTIMEOUT, --lock-timeout LOCKTIMEOUT — lock timeout in seconds after which feed2toot can removes the lock itself. yes the manual really says "removes", we're quoting it exactly, it's giving grammar moment but the meaning is clear: after that many seconds feed2toot yeets its own lock 🔓
• --cachefile CACHEFILE — location of the cache file (default: None). no cache file unless you say so 🍓
• --lockfile LOCKFILE — location of the lock file (default: ~/.config/feed2toot.lock). note that tilde, bestie, it's home directory coded 🏠
• -n, --dry-run — Do not actually post tweets. a little dress rehearsal, a little pretend, nothing hits the timeline 🙈
• -v, --verbose, --info — enable informative (verbose) output, work on log level INFO. yes it's got two long names AND a short one, it's versatile like that 📢
• -d, --debug — enable debug output, work on log level DEBUG. when things are weird and you need the tea 🐛
• --syslog [{CRITICAL,FATAL,ERROR,WARN,WARNING,INFO,DEBUG}] — log to syslog facility, default: no logging, INFO if --syslog is specified without argument. so you can hand it a level, or hand it nothing and get INFO 💌
• --hashtaglist HASHTAGLIST — a list of hashtags to match. matching era 🏷️
• -p, --populate-cache — populate RSS entries in cache without actually posting them to Mastodon. it fills the little memory box and posts NOTHING. sneaky, clever, iconic 🧚
• -r http://..., --rss http://... — the RSS feed URL to fetch items from. the whole point honestly 🎯
• --rss-sections — print the available sections of the rss feed to be used in the tweet template. super useful for figuring out what you can reference in your template, ngl 🔍

For more information: https://feed2toot.readthedocs.io 🌈

tiny heads up bestie: --ignore-ssl literally means SSL errors get ignored while fetching. if you don't know why you'd want that, you probably don't want that. 💀

okay that's the whole page!! this is feed2toot (man page name FEED2TOOT(1)), and the page footer says it's dated November 2020 — yeah, it's a bit vintage, but the vibes are timeless 💖. slay, go post your feed, periodt ✨🎀🦋