selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

GitHub
FeedCord logo

Self-host FeedCord

v3.1.0

Self-hosted RSS feed bot for Discord servers

ReleaseOpen SourceMIT
Updatedlast year
LanguageC
Setup difficultyEasy
Stars
320
Docker
qolors/feedcord
Install with Docker
FeedCord gallery view showing Discord forum channel with feed postsFeedCord gallery view showing another Discord forum channel with feed posts

What is FeedCord?

FeedCord is a self-hosted RSS feed reader designed to post updates from RSS/Atom feeds and YouTube channels directly to Discord servers using webhooks. It supports multiple feed instances per configuration, Discord forum channels for gallery-style display, post filtering by keywords, markdown formatting, automatic retry logic with UserAgent cycling, and persistence across restarts to catch missed posts. The application is configured via a JSON file (appsettings.json) and can be run via Docker or built from source using the .NET SDK. It requires a Discord webhook URL and at least one RSS or YouTube feed URL to operate.

Should you self-host FeedCord?

FeedCord scores 48/100 on selfhost.directory (how scoring works) and ranks #37 of 85 in Feed Reader. It has 320 GitHub stars.

There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.

Setup is easy: most people get it running in one sitting. An official Docker image is available. It is MIT-licensed and written mostly in C.

Its closest alternative on selfhost.directory is RSSHub (85/100, 46 704 stars). It scores higher overall, so compare the two before you pick. See FeedCord vs RSSHub side by side.

Features

  • Auto-remove failed feeds
  • Concurrent request control
  • Custom bot username and avatar
  • Discord Forum channel support
  • Discord webhook posting
  • Fallback image support
  • GZIP support
  • Markdown formatting
  • Multiple feed instances
  • Persistence across restarts
  • Post filtering
  • Reddit feed handling
  • RSS/Atom feed parsing
  • UserAgent cycling with retries
  • YouTube channel feed support

FeedCord README

How to install FeedCord

Install FeedCord with Docker

docker pull qolors/feedcord:latest

Be sure to update the volume path to your `appsettings.json` 

docker run --name FeedCord -v "/path/to/your/appsettings.json:/app/config/appsettings.json" qolors/feedcord:latest

Recommended installation method. Requires appsettings.json mounted as volume.

How to configure FeedCord

  • AuthorIconThe icon displayed for the Author.

    The icon displayed for the Author.

  • AuthorNameDisplay name of Author.

    Display name of Author.

  • AuthorUrlThe external link it will send users to when they click on the Author's Name.

    The external link it will send users to when they click on the Author's Name.

  • AvatarUrlThe displayed icon for the bot.

    The displayed icon for the bot.

  • ColorColor of the Post's embedded message.

    Color of the Post's embedded message.

  • ConcurrentRequestsHow many requests FeedCord can have going at once.

    How many requests FeedCord can have going at once.

  • ConcurrentRequests (Inside Instance)How many requests the instance itself can have going at once.

    How many requests the instance itself can have going at once.

  • DescriptionLimitLimits the length of the description of the post to this number.

    Limits the length of the description of the post to this number.

  • DiscordWebhookUrlThe created Webhook from your designated Discord Text Channel.

    The created Webhook from your designated Discord Text Channel.

  • EnableAutoRemoveIf set to true - FeedCord will kick a url out of the list after 3 failed attempts to parse the content.

    If set to true - FeedCord will kick a url out of the list after 3 failed attempts to parse the content.

  • FallbackImageFeedCord always attempts to grab the webpage's image from metadata. If for some reason this fails, it will display this image instead.

    FeedCord always attempts to grab the webpage's image from metadata. If for some reason this fails, it will display this image instead.

  • ForumDetermines if the post will be sent to a Forum type channel.

    Determines if the post will be sent to a Forum type channel.

  • IdThe unique name of the RSS Feed Service. Helpful for logging purposes.

    The unique name of the RSS Feed Service. Helpful for logging purposes.

  • InstancesArray of feed instances, each representing a Discord channel/webhook configuration

    Array of feed instances, each representing a Discord channel/webhook configuration

  • MarkdownFormatIf set true, will post feed item in markdown instead of an Embed.

    If set true, will post feed item in markdown instead of an Embed.

  • PersistenceOnShutdownIf set true, will store the last run date when restart or shutdown to catch missed posts.

    If set true, will store the last run date when restart or shutdown to catch missed posts.

  • PostFiltersA collection of phrases/words that are used to filter out RSS Items (filters the Title & Content).

    A collection of phrases/words that are used to filter out RSS Items (filters the Title & Content).

  • RssCheckIntervalMinutesHow often you want to check for new Posts from all of your Url feeds in minutes.

    How often you want to check for new Posts from all of your Url feeds in minutes.

  • RssUrlsThe list of RSS Feeds you want to get posts from.

    The list of RSS Feeds you want to get posts from.

  • UsernameThe name of the bot that will be sending the messages.

    The name of the bot that will be sending the messages.

  • YoutubeUrlsThe list of YouTube channel URLs to get posts from.

    The list of YouTube channel URLs to get posts from.

FeedCord releases & version history

More in Feed Reader

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…