Skip to main content

Fedinesia

Repo Docs CI Downloads

Checked with pysentry Secrets checked by gitleaks ty complexipy

Code style: ruff Version Wheel

AI-DECLARATION: copilot

AGPL

⚠️ BEWARE, THIS TOOL WILL DELETE SOME OF YOUR POSTS ON THE FEDIVERSE ⚠️

Fedinesia is a command line (CLI) tool to delete old statuses from Mastodon or Pleroma instances. It respects rate limits imposed by servers.

Install and run from PyPI

It's easy to install Fedinesia from PyPI using the following command:

pip install fedinesia

Once installed, Fedinesia can be started by typing fedinesia into the command line.

Configuration / First Run

Fedinesia will ask for all necessary parameters when run for the first time and store them in a config.json file in the current directory.

Podman / Docker Container

Fedinesia can also be run using Podman or Docker as follows:

podman run \
  --env AUDIT_LOG_FILE=/logging/audit.log \
  --env PAUSE_IN_SECONDS=300 \
  --replace \
  --volume ./config:/config \
  --volume ./logging:/logging \
  --name fedinesia \
  forge.marvin8.zone/marvin8/fedinesia

Podman / Docker Environment Variables

  • PAUSE_IN_SECONDS (mandatory) This must be set to a positive integer. This value is the number of seconds to wait between successive runs of fedinesia.

  • AUDIT_LOG_FILE (optional) Full path to where audit log file should be written to. It is intended that logfiles will be written to /logging directory. No audit log file will be generated / updated if this value has not been set.

  • AUDIT_STYLE (optional) What style of audit log file to write. Possible options are PLAIN or CSV. Defaults to PLAIN. Has no effect if AUDIT_LOG_FILE has not been set.

  • LIMIT (optional) If set to a positive integer, will make fedinesia stop processing any further deletions once this number of statuses have been deleted in the current execution.

  • DRY_RUN (optional) If set to any value, e.g. DRY_RUN=true, will make fedinesia not actually delete any status. Statuses that would be deleted are shown instead.

  • PROGRESS_FILE (optional) If set to a filename, will store the progress of deleted statuses to that file. This is intended to be used together with the CONTINUE_PROGRESS variable. This allows fedinesia to process a large number of status deletions over multiple executions while keeping track of progress.

  • CONTINUE_PROGRESS (optional) If set to any value, e.g. CONTINUE_PROGRESS=true, will make fedinesia continue with deleting statuses from last successfully deleted status in reverse historical order. Setting this variable implies that PROGRESS_FILE has been set as well.

  • LOGGING_CONFIG (optional) Can be set to a filename containing logging configuration definition. Below is a sample of the logging config file I use during development:

  [[handlers]]
  sink = "sys.stdout"
  format = "{message}"
  level = "INFO"

  [[handlers]]
  sink = "/logging/dev-fedinesia-debug.log"
  rotation = "1 day"
  retention = 3
  level = "DEBUG"
  format = "{time} - {level} - {name} - {function}({line}) - {message}"
  colorize = "none"

Licensing

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

Supporting Fedinesia

There are a number of ways you can support Fedinesia:

  • Create an issue with problems or ideas you have with/for Fedinesia
  • Create a pull request if you are more of a hands-on person
  • You can buy me a coffee
  • You can send me small change in Monero to the address below:

Monero donation address

86ZnRsiFqiDaP2aE3MPHCEhFGTeiFixeQGJZ1FNnjCb7s9Gax6ZNgKTyUPmb21WmT1tk8FgM7cQSD5K7kRtSAt1y7G3Vp98nT

Metadata

Release files for fedinesia 3.7.10

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for fedinesia 3.7.10
File Size Uploaded
fedinesia-3.7.10.tar.gz 12.4 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for fedinesia 3.7.10
File Interpreter ABI Platform
fedinesia-3.7.10-py3-none-any.whl Python 3 none any Details

Total release size: 28.4 kB

Release files / fedinesia-3.7.10.tar.gz

Download URL fedinesia-3.7.10.tar.gz
Size 12.4 kB
Tags Source
SHA-256 checksum
How to use checksums
90603d3bedb508c0d14980487fef3cee6ebb0f49908703ac44fb7cb9846b52b0
BLAKE2b-256 checksum
How to use checksums
e790237a776d28434f2bab1eb43e3dbfb419b16a54ed0f5e5f1b064915348137
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"22.04","id":"jammy","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / fedinesia-3.7.10-py3-none-any.whl

Download URL fedinesia-3.7.10-py3-none-any.whl
Size 15.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f1e5af70b061edb22d4c65254a76faa7ed6daabf310edb8146d9f292588d4a96
BLAKE2b-256 checksum
How to use checksums
a14b7c58a9f25f4e9f54e55b8f217d44323051b3ac5fac24ba9ee6b47c660327
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"22.04","id":"jammy","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release history Release notifications | RSS feed

3.7.14

2 release files

3.7.13

2 release files

3.7.12

2 release files

3.7.11

2 release files

This release

3.7.10 This release

2 release files

3.7.9

2 release files

3.7.8

2 release files

3.7.7

2 release files

3.7.6

2 release files

3.7.5

2 release files

3.7.4

2 release files

3.7.3

2 release files

3.7.2

2 release files

3.7.1

2 release files

3.7.0

2 release files

3.6.2

2 release files

3.6.1

2 release files

3.6.0

2 release files

3.5.2

2 release files

3.5.1

2 release files

3.5.0

2 release files

3.4.20

2 release files

3.4.19

2 release files

3.4.17

2 release files

3.4.16

2 release files

3.4.15

2 release files

3.4.14

2 release files

3.4.13

2 release files

3.4.11

2 release files

3.4.10

2 release files

3.4.9

2 release files

3.4.8

2 release files

3.4.7

2 release files

3.4.6

2 release files

3.4.5

2 release files

3.4.4

2 release files

3.4.3

2 release files

3.4.2

2 release files

3.4.1

2 release files

3.4.0

2 release files

3.3.4

2 release files

3.3.3

2 release files

3.3.2

2 release files

3.3.1

2 release files

3.3.0

2 release files

3.2.3

2 release files

3.2.2

2 release files

3.2.1

2 release files

3.2.0

2 release files

3.1.1

2 release files

3.1.0

2 release files

3.0.0

2 release files

2.5.8

2 release files

2.5.7

2 release files

2.5.6

2 release files

2.5.5

2 release files

2.5.4

2 release files

2.5.3

2 release files

2.5.2

2 release files

2.5.1

2 release files

2.5.0

2 release files

2.4.1

2 release files

2.4.0

2 release files

2.3.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page