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’s enabled before using these commands: 
/module enable news

​
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: 
/rss add techcrunch https://techcrunch.com/feed/
/rss latest techcrunch

​
Auto-Posting Setup

Set a channel once and Freesona handles the rest — it polls every 5 minutes and posts only articles it hasn’t 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’re just clearing the channel assignment.

​
Default Feeds

Freesona ships with four feeds pre-configured:
NameSource
bbcworldBBC World News
bbctechBBC Technology
nprnewsNPR News
aljazeeraAl Jazeera English
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. 
LOGOKIT_TOKEN=your_logokit_token_here

​
Command Reference

CommandPermission
/rss listAnyone
/rss latest <feed>Anyone
/rss add <name> <url>Administrator
/rss remove <name>Administrator
/rss setchannel <#channel>Administrator
/rss clearchannelAdministrator