Masto-DL is a script to archive your Mastodon history, toot-by-toot.
This script is in a very alpha state; it has been tested to not catch fire, but it may eat your kitten and/or /usr/bin. Use with care.
masto-dl init <directory>
will interactively configure the specified
directory, saving the configuration as JSON in masto-dl.conf
. If the
directory is not specified, it will default to the current dir.
masto-dl run <directory>
will begin downloading all your toots. Toots are
saved under the specified directory below a directory structure of
year/month/toot-id.json
, eg. 2022/11/109385308583886341.json
.
(NYI) masto-dl start <directory>
will start a live bot which will archive
your toots as they happen.
npx masto-dl init
and it will ask for your instance url and API token.npx masto-dl run
will start downloading. You can add --verbose
to get more feedback about what it's doing, or just let it goYour toots will be archived to json files under a directory structure for the year, months, and toot ID, like yyyy/mm/12345.json
- support for yaml is coming soon
oldest_id
andnewest_id
we've seen, so we can start looking in a reasonable place for