Tool to make Fediverse posts from RSS feeds
  • Python 99.2%
  • Just 0.8%
Find a file
2026-07-07 06:31:30 +10:00
.forgejo/workflows 👷 migrate CI from Woodpecker to Forgejo Actions 2026-07-06 18:17:37 +10:00
docs 👷 publish docs to grebedoc and add codeberg.page redirect 2026-07-06 18:21:13 +10:00
src/feed2fedi
tests add tests for logging_config helper functions and configure_logging 2026-06-19 14:23:02 +10:00
.editorconfig
.gitignore 🔧 bump deps and retire codelimit from CI 2026-07-06 17:56:26 +10:00
.gitleaks.toml 👷 migrate CI from Woodpecker to Forgejo Actions 2026-07-06 18:17:37 +10:00
.pre-commit-config.yaml 🔧 bump deps and retire codelimit from CI 2026-07-06 17:56:26 +10:00
.python-version
CHANGELOG.md docs: update changelog for 4.0.2 2026-07-07 06:31:26 +10:00
CLAUDE.md 🔒 bump deps and fix GHSA-4xgf-cpjx-pc3j; add security gitmoji to cliff.toml 2026-06-23 18:54:00 +10:00
docs_hooks.py
justfile 🔧 replace git-cliff with Release-Notes.md changelog extraction 2026-07-06 18:24:27 +10:00
LICENSE.md
logging-config.toml
mkdocs.yml 👷 publish docs to grebedoc and add codeberg.page redirect 2026-07-06 18:21:13 +10:00
noxfile.py 🔧 bump deps and retire codelimit from CI 2026-07-06 17:56:26 +10:00
pylock.toml 🔧 replace git-cliff with Release-Notes.md changelog extraction 2026-07-06 18:24:27 +10:00
pyproject.toml bump: version 4.0.1 → 4.0.2 2026-07-07 06:31:30 +10:00
README.md 📝 update README: Forgejo Actions badge, remove retired Code Limit badge 2026-07-06 18:32:00 +10:00
Release-Notes.md bump: version 4.0.1 → 4.0.2 2026-07-07 06:31:30 +10:00
ruff.toml
TODO.md
uv.lock bump: version 4.0.1 → 4.0.2 2026-07-07 06:31:30 +10:00

Feed2Fedi

Repo CI Downloads Ruff Checked with ty complexipy pysentry 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