Command-line tool to archive your Mastodon toots to DayOne https://pypi.org/project/tootlogger/
Find a file
Renovate Bot e24c8b06bd
All checks were successful
CI / check (push) Successful in 33s
chore(deps): lock file maintenance (#22)
Reviewed-on: #22
Co-authored-by: Renovate Bot <renovate@onlyhavecans.works>
Co-committed-by: Renovate Bot <renovate@onlyhavecans.works>
2025-12-14 16:09:52 -08:00
.forgejo/workflows chore(deps): update actions/setup-uv digest to 681c641 (#21) 2025-12-13 17:40:02 -08:00
tests refactor: types and tests 2025-12-10 20:26:01 -08:00
tootlogger feat: python 3.13 2025-12-10 21:01:59 -08:00
.gitignore lint: switch to ruff & just 2025-12-10 19:45:59 -08:00
.python-version chore(deps): update python docker tag to v3.14 (#20) 2025-12-10 21:11:04 -08:00
CODEOWNERS ci: codeowners 2025-08-25 18:29:24 -07:00
justfile refactor: types and tests 2025-12-10 20:26:01 -08:00
LICENSE.txt Clean up docs and packaging 2018-09-20 19:18:54 -07:00
pyproject.toml feat: python 3.13 2025-12-10 21:01:59 -08:00
README.md lint: switch to ruff & just 2025-12-10 19:45:59 -08:00
renovate.json fix: updated renovate paths 2025-09-01 19:48:44 -07:00
tootlogger.toml.example Clean up docs and packaging 2018-09-20 19:18:54 -07:00
uv.lock chore(deps): lock file maintenance (#22) 2025-12-14 16:09:52 -08:00

tootlogger

Journal your toots to DayOne

Take all your toots and make a DayOne journal entry.

This saves the last seen toot id so subsequent runs will only show all the toots since then. If you miss a day of running this it, it will back fill up to the pagination limit.

Install

  1. Ensure you have Python 3.11+ on your Mac
    • homebrew makes this easy with brew install python
  2. Install the DayOne Command Line Interface
  3. Install tootlogger with pip install tootlogger or uv tool install tootlogger

Setup

You will need to manually generate your access token and create a config file

  1. Log into your mastodon instance
  2. go to /settings/applications and create the new app
    • read is the only checkbox needed
  3. Note down the access_token
  4. Repeat this for all accounts you want to log
  5. Create a config file like the example below (or in this repo) in one of two places
    1. $HOME/.tootlogger.toml
    2. tootlogger.toml in the local directory you run the command from

Config file

["account_name"]
instance = "https://mastodon.social"
access_token = "really big string"
["cool account @ hachyderm.io"]
instance = "https://hachyderm.io"
access_token = "different big string"

Usage

  1. run tootlogger to log all of your toots to DayOne
  2. Set up tootlogger to run daily or whenever you toot enough