FeedCord is a dead-simple RSS Reader designed to integrate seamlessly with Discord. With just a few configuration steps, you can have a news feed text channel up and running in your server.
Due to work and relocating, I will be taking a brief pause in development for this software. I plan to pick development back up in late June/beginning of July this year. Feel free to open issues, but know that I myself won't be getting to them for some time. I will gladly take pull requests in the meantime. Thanks for the support!
- Discord Integration: Directly send your RSS feed updates to a Discord channel via a webhook.
- Ease of Setup: Configuration is a breeze with a simple JSON file. Just add your Webhook URL & RSS Feeds.
- Docker Support: Deploying with Docker makes your life easier and is highly recommended.
If you wish to show your support to help development
Your appsettings.json is a collection of instances:
{
"Instances": [],
}Each webhook gets one instance. Here's an example of a single instance:
{
"Id": "Gaming News Channel",
"RssUrls": [
"https://examplesrssfeed1.com/rss",
"https://examplesrssfeed2.com/rss",
"https://examplesrssfeed3.com/rss",
],
"YoutubeUrls": [ "" ],
"DiscordWebhookUrl": "https://discord.com/api/webhooks/...",
"RssCheckIntervalMinutes": 3,
"EnableAutoRemove": true,
"Color": 8411391,
"DescriptionLimit": 200,
"Forum": true
}Here is an appsettings.json example of running two webhooks for two different channels:
{
"Instances": [
{
"Id": "Gaming News Channel",
"Username": "Gaming News",
"RssUrls": [
"https://examplesrssfeed1.com/rss",
"https://examplesrssfeed2.com/rss",
"https://examplesrssfeed3.com/rss"
],
"YoutubeUrls": [ "" ],
"DiscordWebhookUrl": "https://discord.com/api/webhooks/...",
"RssCheckIntervalMinutes": 3,
"EnableAutoRemove": true,
"Color": 8411391,
"DescriptionLimit": 200,
"Forum": true
},
{
"Id": "Tech News Channel",
"Username": "Tech News",
"RssUrls": [
"https://examplesrssfeed4.com/rss",
"https://examplesrssfeed5.com/rss",
"https://examplesrssfeed6.com/rss"
],
"YoutubeUrls": [ "" ],
"DiscordWebhookUrl": "https://discord.com/api/webhooks/...",
"RssCheckIntervalMinutes": 3,
"EnableAutoRemove": true,
"Color": 8411391,
"DescriptionLimit": 200,
"Forum": true
}
]
}There are more optional properties to configure. You can view all properties and their purpose here
Your docker-compose.yaml will look be set up like this:
version: "3.9"
services:
myfeedcord:
image: qolors/feedcord:latest # for amd64 architecture
# image: qolors/feedcord:latest-arm64 # For arm64 architecture (Uncomment this line and comment the above if using arm64)
container_name: FeedCord
restart: unless-stopped
volumes:
- ./PATH/TO/MY/JSON/FILE/appsettings.json:/app/config/appsettings.jsonReplace ./PATH/TO/MY/JSON/FILE/ with the actual path to your appsettings.json.
Note: Depending on your architecture, use qolors/feedcord:latest for amd64 architecture, or qolors/feedcord:latest-arm64 for arm64 architecture. Ensure to uncomment the appropriate line in the docker-compose.yml as per your system's architecture. If you need a different please open a request.
In the folder you created, run the following command from your terminal:
docker-compose up -d
This will pull the latest FeedCord image from Docker Hub and start the service.
If you want to update your current image to latest it's quite simple. In your FeedCord directory run:
docker-compose pull
followed by
docker-compose up -d
This will pull the latest image and restart your current container with it
With the above steps completed, FeedCord should now be running and posting updates from your RSS feeds directly to your Discord channel.
All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
[2.1.0] - 2024-02-28
- Added Support for grabbing multiple new posts if the feed has multiple new posts since the last check.
- Improved Documentation for easier setup and understanding
- Improved Logging for better readability
- Posting now has a hard-coded 10 second buffer so large feeds respect Discord's rate limits
[2.0.0] - 2024-01-30
- Added Support for Multiple Webhook Urls & Configurations
- Added Support for Discord's Forum Channels
- Configuration File formatting has changed to support multiple Webhook URLs
- Slight improvements to Logging
- Some Configuration properties are now optional rather than required
[1.3.0] - 2024-01-20
- Added Description Length Configuration
- Improved RSS & ATOM Parsing with implementing FeedReader library
- RSS/ATOM Feeds returning errors because of parsing issues
[1.2.0] - 2023-10-25
- Added Support for Youtube Channel Feeds in configuration file.
- Added an optional Auto Remove option in configuration file for bad URL Feeds to get booted out of the list after multiple failed attempts.
- Improved container logging messages for better readability.
- Color setting in configuration now properly works for the embed message
- Fixed the handling of errors and removed from logging to reduce spam.
- Fixed a known logging index error.
[1.1.0] - 2023-10-16
- Broke up
RssProcessorServiceclass to follow SOLID principles, adding a new service classOpenGraphServiceto handle meta tags. - Added
Helpernamespace &StringHelperclass, which includes theStripTagsmethod for potential reuse and improved organization.
- Enhanced the RSS feed background service for more efficient feed checks, reducing chances of delays.
- Customized the
HttpClientto set default request headers, ensuring better compatibility with certain RSS feeds. - Refined feed processing logic to include concurrent processing, beneficial for users with a large number of RSS feeds.
- ReadMe to show this change log and multiple OS images.
- Improved RSS feed initialization, ensuring only valid feeds are added to the tracking list.
- Overhauled logs to not contain as much spam and allow for better readability.
