Tool to make Fediverse posts from RSS feeds
  • Python 98.7%
  • Just 1.3%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Marvin8 186db929b5
All checks were successful
/ pr-review (push) Has been skipped
/ pr-review (release) Has been skipped
/ gitleaks (push) Successful in 25s
/ gitleaks (release) Successful in 23s
/ checks (push) Successful in 4m31s
/ publish (push) Has been skipped
/ checks (release) Successful in 4m31s
/ deploy-docs (release) Has been skipped
/ publish (release) Successful in 47s
/ deploy-docs (push) Successful in 2m24s
bump: version 4.0.3 → 4.0.4
2026-08-08 09:58:12 +10:00
.forgejo/workflows ⬆️ bump dependencies via zaojun 2026-08-08 07:22:18 +10:00
docs ⬆️ bump dependencies via zaojun 2026-08-08 07:22:18 +10:00
src/feed2fedi 🔧 Replace httpx imports with httpx2 2026-08-08 09:23:16 +10:00
tests add tests for logging_config helper functions and configure_logging 2026-06-19 14:23:02 +10:00
.editorconfig Enabling scheduled posting of status 2025-10-26 14:53:10 +10:00
.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 ✏️ drop redundant advisory comment, align constraint comments 2026-08-08 08:22:20 +10:00
.python-version feat(deps): replace minimal-activitypub with longwei, add Python 3.14 2026-04-03 08:35:59 +10:00
AGENTS.md 📝 address PR review: clean up AGENTS.md, fix fediverse-post reset 2026-07-19 12:30:23 +10:00
CHANGELOG.md docs: update changelog for 4.0.4 2026-08-08 09:58:07 +10:00
CLAUDE.md 🔒 pin click/soupsieve floors; bump cyclopts, longwei, and dev deps 2026-07-19 09:32:02 +10:00
docs_hooks.py 📝 add llms.txt and llms-full.txt to documentation build 2026-06-12 21:29:51 +10:00
justfile ⬆️ bump dependencies via zaojun 2026-08-08 07:22:18 +10:00
LICENSE.md Release 0.2.1 2023-02-27 10:36:27 +10:00
logging-config.toml feat: introduce loguru with TOML-based logging configuration 2026-03-24 13:57:04 +10:00
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 httpx with httpx2 in pyproject.toml 2026-08-08 09:22:15 +10:00
pyproject.toml bump: version 4.0.3 → 4.0.4 2026-08-08 09:58:12 +10:00
README.md ⬆️ bump dependencies via zaojun 2026-08-08 07:22:18 +10:00
Release-Notes.md bump: version 4.0.3 → 4.0.4 2026-08-08 09:58:12 +10:00
Release-Notes.md.template 🔧 align release/fediverse workflow with cang: commit list in changelog, template reset, fediverse-post recipe 2026-07-19 12:05:42 +10:00
ruff.toml Modernize type hints: 2025-07-27 16:47:15 +10:00
uv.lock bump: version 4.0.3 → 4.0.4 2026-08-08 09:58:12 +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