Wrapped

Wrapped is a simple local iMessage Wrapped for macOS written in Go. It reads your Messages database, lets you choose a timeframe in the terminal, then opens a Spotify-style wrapped website to view your stats. All data is local and nothing is uploaded anywhere

Use

Paste and run

bash <(curl -fsSL https://raw.githubusercontent.com/advayc/wrapped/main/imsgwrap.sh)

Golang installed

./imsgwrap.sh

Golang not installed

curl -fsSL https://raw.githubusercontent.com/advayc/wrapped/main/imsgwrap.sh -o imsgwrap.sh
chmod +x imsgwrap.sh
./imsgwrap.sh

If Go is installed and working in a cloned repo, the script runs go run ./cmd/imsgwrap. Otherwise it downloads the prebuilt macOS binary into your cache and reuses it.

For local development in this repo:

go run ./cmd/imsgwrap

Notes

• Requires macOS Messages data and Full Disk Access for your terminal.
• Output is written to imsgwrap-output/ and opened automatically.
• Nothing is uploaded; index.html and data.json are local files.
• Tapbacks are counted as reactions, not normal messages.

Flags

./imsgwrap --year 2025
./imsgwrap --years 2022,2023,2024,2025
./imsgwrap --last 90d
./imsgwrap --from 2024-01-01 --to 2024-06-01
./imsgwrap --all
./imsgwrap --redact
./imsgwrap --no-open