Home

agaetr User Manual

A modular system to take a list of RSS feeds (or user input of a single url!), process them, and send them to social media with images, content warnings, and sensitive image flags when available. Also includes an example of a daily post creator (such as for Postie and WordPress), bookmarking utility for newsboat, and a GUI poster, hooty.

What is agaetr?

agaetr is a modular system made up of several small programs designed to take input (particularly RSS feeds) and then share them to various social media outputs. The system is designed for single user use, as API keys are required. Setting up multiple posters is a significant initial effort, but the idea is that once you've done that once, you can use it for agaetr, mutt, GUI tools, a bookmarker for newsboat, etc., without further configuration.

agaetr is an anglicization of ágætr, meaning "famous".

Key Features

• RSS Feed Processing: Automatically processes RSS feeds from various sources
• Multi-platform Posting: Send to multiple social media platforms simultaneously
• Content Warnings: Advanced content warning system with keyword matching
• Image Handling: Automatic image detection, alt-text generation, and sensitive content flagging
• URL Processing: Link deobfuscation and optional shortening
• Preprocessing: Custom preprocessing scripts for non-standard RSS feeds
• Modular Architecture: Easy to add new services and customize behavior
• Archival Support: Integration with Wayback Machine for link preservation

Recent Reliability Notes

• Queue rows that end with an empty description field are now handled correctly during --push.
• --push --loud works regardless of whether --loud appears before or after --push.
• If URL cleanup or archive lookup fails, agaetr now keeps the original article URL instead of posting without one.
• Mastodon and Bluesky sender wrappers now avoid eval and use safer command construction.
• A parsed tag that exactly matches a CW keyword, such as uspol, now directly triggers that content warning for future queued items.

Example Input Sources

• dlvr.it
• Shaarli instances
• WordPress
• TT-RSS
• Trakt.tv
• DeviantArt
• YouTube (particularly public playlists)
• UPI and other standard RSS feeds
• Single URLs via command line

Output Destinations

• Social Media: Mastodon, Bluesky, Pixelfed, Tumblr
• Bookmarking: Shaarli, Wallabag
• Archives: Wayback Machine, local captures (JPG/PNG/PDF)
• Communication: Email, RSS generation
• Content Management: Daily post creation, local file storage

URL Services

• YOURLS for link shortening
• muna for link deobfuscation

Quick Navigation

Getting Started

1. Installation Guide - Prerequisites and setup
2. Services Setup - Configure your social media accounts and services
3. Setting Up Feeds - Configure RSS feeds and content options
4. Usage - Running agaetr and command-line options

Core Concepts

• Flow and Philosophy - How agaetr works internally
• Feed Options - Detailed feed configuration
• Advanced Content Warning - Content moderation system

Additional Tools

• Hooty - Interactive GUI posting tool
• Bookmarker - Integration with newsboat for bookmarking
• Muna and Utilities - Supporting utilities and scripts

Architecture Philosophy

This was created because pay services are expensive, and other options are either limited or subject to frequent bitrot. The modular structure is specifically designed so that it should be easy to create a new module for additional services, as it relies on other programs to do most of the posting. Therefore, if one posting tool dies, another can be found and relatively easily swapped in without changing your whole setup.

One of the reasons there are multiple different example service wrappers (and that they are written in straightforward BASH scripting) is so that future users (including yourself) can use them as templates or examples for other tools or new services with as little fuss as possible and without requiring extensive knowledge.

Special thanks to Alvin Alexander, whose post got me on the right track.