missclear

Python script to quickly delete old messages on a Misskey instance.

Usage

Before using, you'll need to install the Misskey.py pip module:

# pip3 install Misskey.py

From the built-in help:

usage: missclear.py [-h] [-d DAYS] [-q] [-r RETRIES] [-A | -N] instance

Deletes old Misskey posts.

positional arguments:
  instance              Misskey instance domain, in format domain.tld

optional arguments:
  -h, --help            show this help message and exit
  -d DAYS, --days DAYS  How many days back to start deleting from
  -q, --quiet           Suppress less urgent messages
  -r RETRIES, --retries RETRIES
                        Amount of times to retry a failed delete
  -A, --no-auth         Disable interactive authentication
  -N, --no-cache        Disable reading/saving cached tokens

Cached API Tokens

The cached API token is automatically stored in either $XDG_CACHE_DIR or $HOME/.cache if the former doesn't exist. Each instance is cached in a separate file, under <cache-dir>/missclear/instance.tld for a hypothetical instance.tld.

The --no-cache flag will disable the cache functionality, but requires interactive authentication every time.

Automated runs (e.g. crontab)

As long as you're comfortable with your API token being stored wherever your local cache folder is stored, something like the following command should work as an automatic function:

/path/to/missclear.py -Aqr 5 instance.tld

Usage of --retries X in this case is recommended, since otherwise an API issue such as rate limiting will cause the script to loop forever.