# timhutton/twitter-archive-parser

Python code to parse a Twitter archive and output in various ways

Repository: https://github.com/timhutton/twitter-archive-parser
Canonical: https://ross.abutalabs.com/products/twitter-archive-parser
Language: Python
License: GPL-3.0
License Family: copyleft
Last push: 2022-11-29T00:41:20+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 35, longevity 99
- inputs: {"age_days": 1393, "days_push": 1374, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2438, forks 109 (observed 2026-08-28T04:06:51.518674+00:00)

## What it is
A Python script that parses a downloaded Twitter archive and converts tweets and DMs into Markdown and HTML with embedded media, de-obfuscated links, and original-size images. It also outputs follower/following lists and can optionally query Twitter for missing user handles.

## Use cases
- convert my twitter archive to markdown
- export tweets to html with images embedded
- replace t.co links with original urls in my twitter export
- back up my twitter dms before deleting my account
- migrate my tweets to a blog
- download original size images from my twitter archive

## When to choose
- you downloaded your Twitter archive and want readable, portable Markdown/HTML output
- you want offline copies of your tweets, media, and DMs before deactivating your account
- you need t.co links resolved to their original destinations

## When to avoid
- you need a live Twitter API client or scheduled scraping of other accounts
- you want a GUI application rather than a command-line script
- your archive format has changed significantly and the script has not been updated

## Facets
- artifact type: cli-tool
- maturity: maintenance
- function: parser, markdown, data-science, developer-tools
- domain: social-media, files
- platform: python, cli, cross-platform
- tags: twitter-archive, data-export, tweet-conversion, self-archiving, digital-legacy, data-engineering, automation

## Member repositories
- timhutton/twitter-archive-parser (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:51.518674+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:30:59.257576+00:00, confidence not recorded.
  - readme: https://github.com/timhutton/twitter-archive-parser (fetched 2026-08-28T04:06:51.518674+00:00, sha 59083d43190e)
- Data as of 2026-08-30T08:39:29.467469+00:00.