https://github.com/thelovinator1/discord-rss-bot
A RSS bot for Discord
https://github.com/thelovinator1/discord-rss-bot
discord discord-bot discord-webhooks hacktoberfest rss
Last synced: about 1 year ago
JSON representation
A RSS bot for Discord
- Host: GitHub
- URL: https://github.com/thelovinator1/discord-rss-bot
- Owner: TheLovinator1
- License: gpl-3.0
- Created: 2021-12-11T22:32:39.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2025-04-03T14:49:18.000Z (about 1 year ago)
- Last Synced: 2025-04-14T06:55:16.721Z (about 1 year ago)
- Topics: discord, discord-bot, discord-webhooks, hacktoberfest, rss
- Language: Python
- Homepage:
- Size: 1.5 MB
- Stars: 5
- Watchers: 2
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# discord-rss-bot
Subscribe to RSS feeds and get updates to a Discord webhook.
> [!NOTE]
> You should look at [MonitoRSS](https://github.com/synzen/monitorss) for a more feature-rich project.
## Installation
You have two choices, using [Docker](#docker)
or [install directly on your computer](#install-directly-on-your-computer).
### Docker
- Open a terminal in the repository folder.
- Windows 10: Shift + right-click in the folder and select `Open PowerShell window here`
- Windows 11: Shift + right-click in the folder and Show more options
and `Open PowerShell window here`
- Run the Docker Compose file:
- `docker-compose up`
- You can stop the bot with Ctrl + c.
- If you want to run the bot in the background, you can run `docker-compose up -d`.
- You should run this bot behind a reverse proxy like [Caddy](https://caddyserver.com/)
or [Nginx](https://www.nginx.com/).
- 5000 is the port the bot listens on.
- You can update the container with `docker-compose pull`
- You can automate this with [Watchtower](https://github.com/containrrr/watchtower)
or [Diun](https://github.com/crazy-max/diun)
### Install directly on your computer
This is not recommended if you don't have an init system (e.g., systemd)
- Install the latest version of needed software:
- [Python](https://www.python.org/)
- You should use the latest version.
- You want to add Python to your PATH.
- Windows: Find `App execution aliases` and disable python.exe and python3.exe
- [Poetry](https://python-poetry.org/docs/master/#installation)
- Windows: You have to add `%appdata%\Python\Scripts` to your PATH for Poetry to work.
- Download the project from GitHub with Git or download
the [ZIP](https://github.com/TheLovinator1/discord-rss-bot/archive/refs/heads/master.zip).
- If you want to update the bot, you can run `git pull` in the project folder or download the ZIP again.
- Open a terminal in the repository folder.
- Windows 10: Shift + right-click in the folder and select `Open PowerShell window here`
- Windows 11: Shift + right-click in the folder and Show more options
and `Open PowerShell window here`
- Install requirements:
- Type `poetry install` into the PowerShell window. Make sure you are
in the repository folder where the [pyproject.toml](pyproject.toml) file is located.
- (You may have to restart your terminal if it can't find the `poetry` command. Also double check it is in
your PATH.)
- Start the bot:
- Type `poetry run python discord_rss_bot/main.py` into the PowerShell window.
- You can stop the bot with Ctrl + c.
Note: You will need to run `poetry install` again if [poetry.lock](poetry.lock) has been modified.
## Contact
Email: [mailto:tlovinator@gmail.com](tlovinator@gmail.com)
Discord: TheLovinator#9276