Tool to make Fediverse posts from RSS feeds
Find a file
2026-03-15 07:56:37 +10:00
.woodpecker Release 3.3.1 2025-11-03 06:18:42 +10:00
changelog.d Update CHANGELOG.rst 2025-12-18 10:21:13 +10:00
docs Cleanup of documentation and unit tests. 2026-02-14 15:01:55 +10:00
src/feed2fedi Add conditional template syntax with {[prefix]var[suffix]} 2026-02-13 19:32:47 +10:00
tests/unit Test: Add more tests to improve test coverage 2026-03-15 07:54:32 +10:00
.editorconfig Enabling scheduled posting of status 2025-10-26 14:53:10 +10:00
.gitignore Update dependencies versions. 2026-02-08 06:56:33 +10:00
.pre-commit-config.yaml Chore: Update dependencies versions. 2026-03-15 07:42:24 +10:00
.python-version Updated pre-commit, CI and dependencies versions. 2025-04-22 18:49:53 +10:00
.safety-policy.yml Reading feeds and reading/establishing configuration. 2023-02-25 08:05:49 +10:00
.secrets.baseline Release 3.3.1 2025-11-03 06:18:42 +10:00
CHANGELOG.md new version 3.5.2 → 3.5.3 2026-03-15 07:56:37 +10:00
LICENSE.md Release 0.2.1 2023-02-27 10:36:27 +10:00
mkdocs.yml Add new docs file to mkdoc.yml nav section 2026-02-14 16:12:38 +10:00
noxfile.py Test: Add more tests to improve test coverage 2026-03-15 07:54:32 +10:00
pyproject.toml new version 3.5.2 → 3.5.3 2026-03-15 07:56:37 +10:00
README.md Reformat CHANGELOG and README in markdown. 2026-01-11 14:37:21 +10:00
ruff.toml Modernize type hints: 2025-07-27 16:47:15 +10:00
uv.lock new version 3.5.2 → 3.5.3 2026-03-15 07:56:37 +10:00

Feed2Fedi

Repo CI - Woodpecker Downloads Checked against Checked with Code style PyPI - Python Version PyPI - Wheel AGPL

Feed2Fedi is a Python bot that reads RSS feeds and automatically posts them to a Fediverse instance. It supports instances running Mastodon, Takahe, and Pleroma. Feed2Fedi has been inspired by feed2toot.

Features

  • Posts to Fediverse instances.
  • Attaches a picture if the feed item contains a media_thumbnail.
  • Monitors multiple RSS/Atom feeds at once.
  • Fully open-source—no need to give external services full access to your social-media accounts.

Documentation is available here. To delete older posts from your Fediverse account, try Fedinesia.

Disclaimer The developers of Feed2Fedi hold no liability for what you do with this script or what happens to you by using it. Abusing this script can get you banned from Fediverse instances, so read each sites usage rules carefully.

Setup and usage Install with pipx:

pipx install feed2fedi

Once installed you can start it by issuing the feed2fedi command.

During the first run it will prompt for some values and create a config.ini file with sensible starting settings. Then edit the config.ini file and add the RSS/ATOM feed in the feeds section and remove the sample feed. Detailed information about config options is available in the documentation.

Support Feed2Fedi

A big thank you to the good folk over at CharCha who have allowed me to test Feed2Fedi against their instance that is based on Rebased and Soapbox.

There are a number of ways you can support Feed2Fedi:

  • Create an issue with problems or ideas you have with/for Feed2Fedi
  • You can buy me a coffee.
  • You can send me small change in Monero to the address below:

Monero donation address: 84oC6aUX4yyRoEk6pMVVdZYZP4JGJZk4KKJq1p7n9ZqLPK8zH3W1vpFAnSxDQGbwmZAeXrE4w4ct6HqAXdM1K9LfCAxZx4u

Changelog

See the Changelog for any changes introduced with each version.

License

Feed2Fedi is licensed under the GNU Affero General Public License v3.0