Skip to main content

Alliance Auth RSS to Discord

Version License Python Django pre-commit pre-commit.ci status Code Style: black Checks codecov Badge: Translation Status Contributor Covenant Discord Alliance Auth Compatibility

ko-fi

A simple app to post selected RSS feeds to your Discord.



Installation

Important: Please make sure you meet all preconditions before you proceed:

  • Alliance Auth RSS to Discord is a plugin for Alliance Auth. If you don't have Alliance Auth running already, please install it first before proceeding. (see the official AA installation guide for details)
  • Alliance Auth RSS to Discord needs AA-Discordbot to interact with your Discord server. Make sure it is installed and configured before installing this app.

Step 0.5: Install AA-Discordbot

In order for this app to work, you need to install and configure AA-Discordbot first. Read the instructions how to do so in the README of AA-Discordbot.

Step 1: Install the Package

Make sure you're in the virtual environment (venv) of your Alliance Auth installation Then install the latest release directly from PyPi.

pip install aa-rss-to-discord==3.1.0

Step 2: Configure Alliance Auth

This is fairly simple, just add the following to the INSTALLED_APPS of your local.py

Configure your AA settings (local.py) as follows:

  • Add "aa_rss_to_discord", to INSTALLED_APPS
  • Add the scheduled task
    CELERYBEAT_SCHEDULE["aa_rss_to_discord_fetch_rss"] = {
        "task": "aa_rss_to_discord.tasks.fetch_rss",
        "schedule": crontab(minute="*/5"),
    }
    

Step 3: Finalizing the Installation

Run migrations to finalize the installation

python manage.py migrate

Finally, restart your supervisor services for AA.

Step 4: Configure your RSS Feeds

First, you need to set up the Discord Server and Channels. For this, you go in your admin backend to the Discordbot settings and enter the needed information there.

When done, you can set up your RSS feeds. This can be done in the setting of this app, still in your admin backend. Create a new RSS Feed entry, enter the name, url and select the Discord channel it should be posted to. Once done, save it.

Discord Bot Commands

The following commands are available for the Discord bot to manage RSS/Atom feeds:

Command Options What it does
/rss add <rss_url> <rss_name> rss_url - The URL of the RSS/Atom feed
rss_name - A Name for the RSS/Atom Feed
Adding a RSS/Atom feed to the current channel
/rss delete <rss_feed_id> rss_feed_id - The ID of the RSS/Atom feed you want to remove Remove a RSS/Atom feed from the current Discord channel
/rss disable <rss_feed_id> rss_feed_id - The ID of the RSS/Atom feed you want to disable Disable an enabled RSS/Atom feed for the current Discord channel
/rss enable <rss_feed_id> rss_feed_id - The ID of the RSS/Atom feed you want to enable Enable a disabled RSS/Atom feed for the current Discord channel
/rss list None List all RSS/Atom feeds for the current Discord channel

Updating

To update your existing installation of Alliance Auth RSS to Discord, first enable your virtual environment (venv) of your Alliance Auth installation.

pip install aa-rss-to-discord==3.1.0

python manage.py migrate

Finally, restart your supervisor services for AA.

Changelog

See CHANGELOG.md

Translation Status

Translation status

Do you want to help translate this app into your language or improve the existing translation? - Join our team of translators!

Contributing

Do you want to contribute to this project? That's cool!

Please make sure to read the Contribution Guidelines.
(I promise, it's not much, just some basics)

Metadata

Release files for aa-rss-to-discord 3.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for aa-rss-to-discord 3.1.0
File Size Uploaded
aa_rss_to_discord-3.1.0.tar.gz 42.4 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for aa-rss-to-discord 3.1.0
File Interpreter ABI Platform
aa_rss_to_discord-3.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 106.4 kB

Release files / aa_rss_to_discord-3.1.0.tar.gz

Download URL aa_rss_to_discord-3.1.0.tar.gz
Size 42.4 kB
Tags Source
SHA-256 checksum
How to use checksums
8728f5793af0a3ef4fc24a5ca89112e61b9854d8a59f998df3e4fd963e97c436
BLAKE2b-256 checksum
How to use checksums
57c4348a685b14250f4d9ea30b0f9d3898278a6ff2f4f7cb63af2e563efb08c4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Aug 4, 2026.

Transparency log

Release files / aa_rss_to_discord-3.1.0-py3-none-any.whl

Download URL aa_rss_to_discord-3.1.0-py3-none-any.whl
Size 64.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
8a83e795aa6dd456eb20ebf0f5b0eb047cce1c2e920e9211595870fbbd1e5463
BLAKE2b-256 checksum
How to use checksums
994a05365f253c3a390f46d3284ccc39d8dbca49106cd543c8baba2ffd90fefd
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Aug 4, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

3.1.0 This release

2 release files

3.0.1

2 release files

3.0.0

2 release files

2.6.0

2 release files

2.5.2

2 release files

2.5.1

2 release files

2.5.0

2 release files

2.4.0

2 release files

2.3.5

2 release files

2.3.4

2 release files

2.3.3

2 release files

2.3.2

2 release files

2.3.1

2 release files

2.3.0

2 release files

2.2.0

2 release files

2.1.0

2 release files

2.0.1

2 release files

2.0.0

2 release files

1.8.2

2 release files

1.8.1

2 release files

1.8.0

2 release files

1.7.0

2 release files

1.6.0

2 release files

1.5.0

2 release files

1.4.2

2 release files

1.4.1

2 release files

1.4.0

2 release files

1.3.1

2 release files

1.3.0

2 release files

1.2.1

2 release files

1.2.0

2 release files

1.1.2

2 release files

1.1.1

2 release files

1.1.0

2 release files

1.0.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page