Alliance Auth RSS to Discord

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

• Alliance Auth RSS to Discord
• Installation
  • Step 0.5: Install AA-Discordbot
  • Step 1: Install the Package
  • Step 2: Configure Alliance Auth
  • Step 3: Finalizing the Installation
  • Step 4: Configure your RSS Feeds
• Discord Bot Commands
• Updating
• Changelog
• Translation Status
• Contributing

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

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:

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 -U aa-rss-to-discord

python manage.py migrate

Finally, restart your supervisor services for AA.

Changelog

See CHANGELOG.md

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)

No reviews yet...

Python Requirements

• allianceauth-app-utils>=1.14.2
• allianceauth-discordbot>=3.0.5
• allianceauth<5,>=4.3.1
• feedparser
• coverage; extra == "tests-allianceauth-latest"
• django-webtest; extra == "tests-allianceauth-latest"

Required Python packages to be installed and other Python requirement.

App Dependencies

Required apps:

• Allianceauth App Utils
• allianceauth-discordbot

Used by apps:

-

Dependencies to other apps registered in this app directory.

Classifiers

• Environment :: Web Environment
• Framework :: Django
• Framework :: Django :: 4.2
• Intended Audience :: Developers
• License :: OSI Approved :: GNU General Public License v3 (GPLv3)
• Operating System :: OS Independent
• Programming Language :: Python
• Programming Language :: Python :: 3 :: Only
• Programming Language :: Python :: 3.10
• Programming Language :: Python :: 3.11
• Programming Language :: Python :: 3.12
• Topic :: Internet :: WWW/HTTP
• Topic :: Internet :: WWW/HTTP :: Dynamic Content