Skip to main content
Freesona can monitor any RSS or Atom feed and automatically post new articles to a Discord channel every 5 minutes. It tracks up to 500 recently seen article links to avoid duplicate posts. You can also browse any configured feed’s latest headlines on demand without waiting for the auto-post cycle. The RSS feature lives in the news module. Make sure it is enabled before using these commands:

​
Browsing Feeds on Demand

Anyone in your server can read feed headlines at any time:
  • /rss latest <feed> — Show the latest items from a named feed (up to 10 at once)
  • /rss list — Show all configured feeds and the current auto-post channel
Feed names support autocomplete. Start typing and the bot suggests matching feed names.

​
Managing Feeds

Administrators can add, update, and remove feeds:
  • /rss add <name> <url> — Add a new feed or update the URL for an existing feed name
  • /rss remove <name> — Remove a feed
Feed names are short lowercase labels you choose. Keep them simple for easy autocomplete:

​
Auto-Posting Setup

Set a channel once and Freesona handles the rest. It polls every 5 minutes and posts only articles it has not seen before.
1

Set a channel

Run /rss setchannel #announcements (or any channel you want articles posted to). This saves the channel ID per guild in config.json.
2

Add your feeds

Run /rss add <name> <url> for each feed you want to monitor. You can add as many as you need.
3

Verify the configuration

Run /rss list to confirm all feeds are saved and the auto-post channel is set correctly.
To stop auto-posting without removing your feeds, run /rss clearchannel. Your configured feeds remain intact and /rss latest continues to work. You are only clearing the channel assignment.

​
Default Feeds

Freesona ships with four feeds pre-configured: These appear immediately in /rss list and /rss latest autocomplete without any setup.

​
Source Logos

Set LOGOKIT_TOKEN in your .env to display publication logos as footer icons in RSS embeds. Without it, embeds show the feed name in the footer as plain text.

​
Command Reference