Dock Timelapse

Dock Timelapse

Your Dock tells the story of the tools you live in. Dock Timelapse records it quietly every day and turns its evolution into an Apple-style timelapse: apps springing in, others handing over their spot, a day counter ticking, all drawn over your own wallpaper.

[Landscape timelapse]   [Portrait timelapse]

_{Demo render with an invented nine-month history. The real output is 1920×1080 and 1080×1920 H.264 at 60 fps.}

How it works

• Records — an hourly background agent reads the Dock's own preferences (the pinned apps, up to and including System Settings). On each day the Dock changes it saves a snapshot: the app list, every icon in high resolution, and the current wallpaper. Optionally it keeps a cropped Dock screenshot too.
• Renders — the videos are redrawn from that data: a glass Dock over your blurred wallpaper, spring animations, change labels (+ Linear, Cursor replaces Xcode), the date and day counter, and a progress bar scaled to real calendar time.
• Previews on day one — preview invents a plausible past that ends with your real Dock, so you can see your video right away.

Requirements: macOS and uv. ffmpeg comes bundled.

Install

Command line

uv tool install dock-timelapse
dock-timelapse install        # start recording (hourly agent, one snapshot per day of change)dock-timelapse preview        # see your video now, with an invented pastdock-timelapse render         # later: the real timelapse → ~/Movies/Dock Timelapse/

Claude Code

/plugin marketplace add bcldvd/dock-timelapse/plugin install dock-timelapse@dock-timelapse

The plugin brings the skill and the MCP server. Then just ask: "start recording my Dock", "make a timelapse of my Dock", "which apps did I add since June?"

Codex, Cursor, Gemini CLI, Copilot and other agents

The skill follows the open Agent Skills format:

npx skills add bcldvd/dock-timelapse -y

MCP server (Claude Desktop, Codex, Cursor, VS Code, …)

{  "mcpServers": {    "dock-timelapse": {      "command": "uvx",      "args": ["dock-timelapse", "mcp"]    }  }}

Codex (~/.codex/config.toml):

[mcp_servers.dock-timelapse]command = "uvx"args = ["dock-timelapse", "mcp"]

Tools: dock_status, current_dock, dock_history, install_recording, uninstall_recording, capture_now, render_timelapse, render_preview, render_frame.

Usage

dock-timelapse status                                     # recording state + every snapshot and its changesdock-timelapse render --format portrait                   # landscape | portrait | both (default)dock-timelapse render --background white                  # wallpaper (default) | desktop (sharp) | whitedock-timelapse preview --demo                             # a generic demo Dockdock-timelapse still --t 2 5.5                            # single PNG framesdock-timelapse install --screenshots                      # also keep Dock screenshotsdock-timelapse uninstall                                  # stop recording, history stays

Screenshots use the Screen Recording permission: install --screenshots prints the Python path to add in System Settings → Privacy & Security → Screen & System Audio Recording. The videos only need the Dock data, so this step is optional.

Data lives in ~/Library/Application Support/dock-timelapse/ (snapshots.json, icons, wallpapers, and capture.log).

Development

uv syncuv run pytest

License

MIT