Example · sample numbers
iMessage Wrapped

Your year in texts.As a Wrapped video.

Who you text most, who texts first, your busiest month, who you've drifted from. A 37-second story video with music and 12 cards for Stories, made from your Mac in 2 minutes. Free. Names blurred. No message is ever read.

  1. Allow access, once

    Your Mac keeps this data locked until you allow it. Click Open Settings, then switch on the app you’ll use in step 2: Terminal, or the app your AI runs in (Claude, Codex, Cursor). If it asks, choose “Quit & Reopen”.

    Not there? System Settings → Privacy & Security → Full Disk Access. Switch it off again whenever you like.

  2. Run it with your AI or Terminal

    With AI

    Paste this into Claude Code, Codex, Cursor, or any AI that can run commands on your Mac. It reads the code and tells you what it does before it runs.

    Make my iMessage Wrapped: download https://eliotcbrown.com/imessage-wrapped/wrapped.py into ~/imessage-wrapped, read it and tell me in two lines what it reads and whether it uploads anything, then run it with python3. If macOS blocks access, tell me how to allow it.

    With Terminal

    Open Terminal: ⌘ Space, type Terminal, Return.

    Paste this with ⌘ V, then press Return.

    mkdir -p ~/imessage-wrapped && cd ~/imessage-wrapped && curl -fsSL https://eliotcbrown.com/imessage-wrapped/wrapped.py -o wrapped.py && python3 wrapped.py

    Only use ChatGPT or Claude in the browser? Ask it to read the code and check it’s safe, then use Terminal. Either way needs Apple’s developer tools; macOS offers to install them.

    In about a minute, your Wrapped opens in a new tab with your own numbers. Do step 3 there.

    What it counts

    One small Python file counts on your Mac: message times, who sent each one, and reactions. It never opens a message. Nothing is uploaded. Read the code.

    Already have wrapped_stats.json? or drop it on this page.

  3. Record your video

    In the tab that opened with your numbers, press Record video. It plays once in real time (under a minute) and then saves the video. Keep the tab in front while it plays. Download cards saves each stat as a 1080×1920 image for Stories.

    Your numbers are in. Press Record video.

  4. Share it

    Names are blurred, so it's safe to post. For Instagram, TikTok or WhatsApp Status, share the video file; for LinkedIn and X, post the video and the link.

    LinkedIn X WhatsApp Threads

  5. Get the next one

    Every week I share one build like this in The Mutuals: something you can run on your own data in 20 minutes. Optional, free.

Rather not use AI or Terminal? Download the Mac app

The same counting as a small Mac app, signed and checked by Apple. Free, 7 MB, macOS 14 or later. Chrome may say the file is uncommon, because it’s new.

Double-click iMessage Wrapped in your Downloads. The first time, it opens Settings: switch on iMessage Wrapped, then open it again.

Use Claude Code? Install it as a skill

Then say "make my iMessage wrapped".

mkdir -p ~/.claude/skills/imessage-wrapped && curl -fsSL https://eliotcbrown.com/imessage-wrapped/skill/imessage-wrapped/SKILL.md -o ~/.claude/skills/imessage-wrapped/SKILL.md

Your stats have no names and no message text in them. They reach this page in the part of the link after #, which browsers never send to a server, and the page clears it right away. Your top five are drawn as blurred placeholder names. The subscribe box is Substack's own form. Also see Phone Wrapped and Mac Wrapped. Not affiliated with Apple. Made by Eliot Brown