Generate a personal year-in-review style summary of your iMessage activity entirely on your own Mac.
Compare texting stats across several past years using the --years flag.
Look at message activity for just the last 90 days or a custom date range.
Produce a redacted version of the stats to share without exposing sensitive message content.
| advayc/wrapped | aegrail/aegrail-engine | aeneasr/form | |
|---|---|---|---|
| Stars | 1 | 1 | 1 |
| Language | Go | Go | Go |
| Last pushed | — | — | 2019-03-08 |
| Maintenance | — | — | Dormant |
| Setup difficulty | easy | hard | easy |
| Complexity | 2/5 | 5/5 | 2/5 |
| Audience | general | ops devops | developer |
Figures from each repo's GitHub metadata at analysis time.
Requires macOS with Full Disk Access granted to the terminal so it can read the local Messages database.
Wrapped is a small command line tool for macOS, written in Go, that gives a person a Spotify Wrapped style summary of their own iMessage history. It reads directly from the local Messages database on the Mac, lets the user pick a time period in the terminal, and then opens a locally generated website showing statistics about their texting habits over that period. Everything happens on the user's own machine and nothing is sent anywhere else. Getting started can be as simple as pasting a single curl command into Terminal, which downloads and runs a setup script without needing Go installed or the repository cloned first. That script normally looks for a prebuilt macOS program and downloads it into a local cache if it is not already present. Someone who prefers working from the Go source directly can opt into that path instead, either by setting an environment variable before running the script or by running the Go command directly from a cloned copy of the repository. Using the tool requires macOS to grant the terminal Full Disk Access, since reading the Messages database needs that permission. Once it runs, Wrapped writes its results into a local output folder as an HTML page and a JSON data file, then opens that page automatically in the browser. Reactions like tapbacks are counted separately from regular messages rather than being treated as normal texts. The tool supports several command line flags to control which messages are included in the summary: choosing a specific year, several years at once, the last set number of days, a custom date range, or all available history. There is also a flag to redact sensitive details from the output and one to stop the results page from opening automatically. The README does not mention a software license.
Wrapped is a macOS command line tool that reads your local iMessage history and generates a Spotify Wrapped style summary website of your texting stats.
Mainly Go. The stack also includes Go, macOS, HTML.
No license is stated in the README, so usage rights are unclear.
Setup difficulty is rated easy, with roughly 5min to a first successful run.
Mainly general.
This repo across BitVibe Labs
Verify against the repo before relying on details.