Skip to main content

Deletes old posts from fediverse accounts. Confirmed working with Mastodon, Pleroma (and Forks), and Takahe

Project description

Repo at Codeberg.org CI / Woodpecker Download count

Checked against Safety DB Checked with pip-audit

Code Style: Black PyPI - Python Version PyPI - Wheel

AGLP 3 or later

*!!! 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 ease 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 `config.json file in the current directory.

Podman / Docker Container

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

podman run \                                                                                                                                                                                                                                                          nixos Wednesday @ 11:37:45
   --env AUDIT_LOG_FILE=/logging/audit.log \
   --env PAUSE_IN_SECONDS=300 \
   --replace \
   --volume ./config:/config \
   --volume ./logging:/logging \
   --name fedinesia \
   codeberg.org/marvinsmastodontools/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, eg 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, eg 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 file name 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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

fedinesia-3.3.0.tar.gz (13.8 kB view details)

Uploaded Source

Built Distribution

fedinesia-3.3.0-py3-none-any.whl (13.7 kB view details)

Uploaded Python 3

File details

Details for the file fedinesia-3.3.0.tar.gz.

File metadata

  • Download URL: fedinesia-3.3.0.tar.gz
  • Upload date:
  • Size: 13.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: python-httpx/0.27.2

File hashes

Hashes for fedinesia-3.3.0.tar.gz
Algorithm Hash digest
SHA256 1a17a09cbca48de2360f78a78481ca044571bafed1d52b00ebe0879a75c5a575
MD5 f82cf101dd505c64923005146e06edac
BLAKE2b-256 d60162d64b4f45ac8a194046c94343d7b08c294b7332088786b3afeb11d10271

See more details on using hashes here.

File details

Details for the file fedinesia-3.3.0-py3-none-any.whl.

File metadata

  • Download URL: fedinesia-3.3.0-py3-none-any.whl
  • Upload date:
  • Size: 13.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: python-httpx/0.27.2

File hashes

Hashes for fedinesia-3.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 11f1790133f4a1fa613b3ec984a700a36b665eb33452e8301a0fd14fd1815967
MD5 f5ee7c8332e8ced526fbba4b8c27fae4
BLAKE2b-256 e0cf2904a1961a02ced35a57c879ad8f25d6345e1e7d60f7640b370897648776

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page