> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fs.soquincy.qzz.io/llms.txt
> Use this file to discover all available pages before exploring further.

# RSS and Atom Feed Monitoring in Discord Channels

> Configure Freesona to auto-post RSS and Atom feed updates to a Discord channel, or browse feed headlines on demand with slash commands.

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:

```text theme={null}
/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:

```text theme={null}
/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.

<Steps>
  <Step title="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`.
  </Step>

  <Step title="Add your feeds">
    Run `/rss add <name> <url>` for each feed you want to monitor. You can add as many as you need.
  </Step>

  <Step title="Verify the configuration">
    Run `/rss list` to confirm all feeds are saved and the auto-post channel is set correctly.
  </Step>
</Steps>

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:

| Name        | Source             |
| ----------- | ------------------ |
| `bbcworld`  | BBC World News     |
| `bbctech`   | BBC Technology     |
| `nprnews`   | NPR News           |
| `aljazeera` | Al 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.

```dotenv theme={null}
LOGOKIT_TOKEN=your_logokit_token_here
```

## Command Reference

| Command                      | Permission    |
| ---------------------------- | ------------- |
| `/rss list`                  | Anyone        |
| `/rss latest <feed>`         | Anyone        |
| `/rss add <name> <url>`      | Administrator |
| `/rss remove <name>`         | Administrator |
| `/rss setchannel <#channel>` | Administrator |
| `/rss clearchannel`          | Administrator |