Command-line tool to archive your Mastodon toots to DayOne https://pypi.org/project/tootlogger/
Find a file
Renovate Bot 5c853d553e chore(deps): lock file maintenance (#13)
Reviewed-on: #13
Co-authored-by: Renovate Bot <renovate@onlyhavecans.works>
Co-committed-by: Renovate Bot <renovate@onlyhavecans.works>
2025-10-19 22:52:39 -07:00
tootlogger Switch to poetry and dump versioneer. 2023-01-23 21:37:59 -08:00
.gitignore Switch to a better command name 2018-09-16 01:38:14 -07:00
.tool-versions chore(deps): update dependency python to v3.14.0 (#11) 2025-10-07 15:02:58 -07:00
CODEOWNERS ci: codeowners 2025-08-25 18:29:24 -07:00
LICENSE.txt Clean up docs and packaging 2018-09-20 19:18:54 -07:00
Makefile Fix makefile 2023-01-23 21:52:41 -08:00
poetry.lock chore(deps): lock file maintenance (#13) 2025-10-19 22:52:39 -07:00
poetry.toml Switch to poetry and dump versioneer. 2023-01-23 21:37:59 -08:00
pyproject.toml Bump html2text from 2024.2.26 to 2025.4.15 2025-04-21 11:44:35 +00:00
pyrightconfig.json Switch to poetry and dump versioneer. 2023-01-23 21:37:59 -08:00
README.md Switch to poetry and dump versioneer. 2023-01-23 21:37:59 -08:00
renovate.json fix: updated renovate paths 2025-09-01 19:48:44 -07:00
setup.cfg Switch to poetry and dump versioneer. 2023-01-23 21:37:59 -08:00
tootlogger.toml.example Clean up docs and packaging 2018-09-20 19:18:54 -07: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 at least Python 3.7 on your Mac
    • homebrew makes this easy with brew install python
  2. Install the DayOne Command Line Interface
  3. Install tootlogger with python3 -m pip 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