Skip to content

Getting Started

Installation

pip install fedinesia

uv tool install fedinesia

uv tool upgrade fedinesia

First Run

Run fedinesia from the command line. On the first run it will launch a configuration wizard that asks for:

  • Your instance URL (e.g. mastodon.social)
  • Your access token (generate one in your instance's developer settings under Preferences → Development → New Application)
  • How many days to keep posts (posts older than this are deleted)
  • Any additional filters (pinned posts, boosts, replies, etc.)

The answers are saved to config.json in the current directory. On all subsequent runs fedinesia reads that file directly and starts deleting without prompting.

Tip

Run with DRY_RUN=true fedinesia to preview which posts would be deleted before committing to any changes.

Access Token Permissions

The access token needs the following OAuth scopes:

  • read:statuses — to fetch your timeline
  • write:statuses — to delete statuses
  • read:accounts — to read your account details

What Gets Deleted

By default fedinesia deletes all statuses older than the configured retention period. The following can be excluded via configuration:

  • Pinned posts
  • Boosts (reblogs)
  • Replies
  • Posts with a minimum number of favourites or boosts