Dock Timelapse

Dock Timelapse

Dock は、あなたが使い続けているツールの物語を伝えます。Dock Timelapse は毎日ひそかに記録し、 その変化を Apple スタイルのタイムラプスにします。アプリが次々と登場し、ほかのアプリと場所を譲り合い、 日数カウンターが進んでいく様子を、あなた自身の壁紙の上に描きます。

 

_{9 か月分の架空の履歴を使ったデモレンダリングです。実際の出力は 60 fps の 1920×1080 および 1080×1920 H.264 です。}

アイコンの横にラベルを付けて、置き換えや追加を表示	数字で物語を伝えるエンドカード
白い背景（--background white）	縦向き — 横にラベルを添えた縦型 Dock

仕組み

• 記録 — 1 時間ごとにバックグラウンドエージェントが Dock 独自の設定（ピン留めされたアプリから「システム設定」まで）を読み取ります。Dock に変更があった日は、アプリのリスト、高解像度の各アイコン、現在の壁紙のスナップショットを保存します。必要に応じて、Dock の切り抜きスクリーンショットも保存します。
• レンダリング — 動画はこのデータから再描画されます。ぼかした壁紙に重ねたガラス風 Dock、スプリングアニメーション、変更ラベル（+ Linear、Cursor replaces Xcode）、日付と日数カウンター、実際の暦時間に合わせたプログレスバーが表示されます。
• 初日からプレビュー — preview は、実際の Dock で終わるもっともらしい過去の履歴を作成するため、すぐに動画を確認できます。

必要条件：macOS および uv。ffmpeg は同梱されています。

インストール

コマンドライン

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 past
dock-timelapse render         # later: the real timelapse → ~/Movies/Dock Timelapse/

Claude Code

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

プラグインにはスキルと MCP サーバーが含まれています。あとは、「Dock の記録を始めて」、「Dock のタイムラプスを作って」、*「6 月以降に追加したアプリはどれ？」*と頼むだけです。

Codex、Cursor、Gemini CLI、Copilot、その他のエージェント

このスキルは、オープンな Agent Skills 形式に準拠しています。

npx skills add bcldvd/dock-timelapse -y

MCP サーバー（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"]

ツール：dock_status、current_dock、dock_history、install_recording、uninstall_recording、 capture_now、render_timelapse、render_preview、render_frame。

使用方法

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

スクリーンショットには画面収録の許可が必要です。install --screenshots を実行すると、「システム設定」→「プライバシーとセキュリティ」→「画面収録とシステムオーディオ収録」に追加する Python のパスが表示されます。動画の作成に必要なのは Dock のデータだけなので、この手順は省略できます。

データは ~/Library/Application Support/dock-timelapse/（snapshots.json、アイコン、壁紙、capture.log）に保存されます。

開発

uv sync
uv run pytest

モジュール	役割
dockdata.py	Dock の設定を解析し、「システム設定」までのアプリを順序付きで取得
diff.py	2 つの Dock 間で追加／削除／置き換え／移動を検出
store.py	変更があった日ごとに 1 つ、スナップショットをディスクに保存
capture.py · visibility.py · macos.py	キャプチャ試行、Dock の表示状態、macOS の呼び出し
agent.py	launchd エージェント
timeline.py · layout.py	純粋なアニメーションモデルとジオメトリ
render.py · video.py	Pillow のフレーム → ffmpeg H.264
poc.py	プレビュー用の架空の履歴
mcp_server.py	MCP ツール

ライセンス

MIT