reshoot 0.3.0__tar.gz

reshoot-0.3.0/.claude-plugin/marketplace.json

@@ -0,0 +1,15 @@
+{
+  "name": "reshoot",
+  "description": "Agent skills and recording tools for repeatable software demo videos.",
+  "owner": {
+    "name": "Mumit Khan",
+    "url": "https://github.com/mumit"
+  },
+  "plugins": [
+    {
+      "name": "reshoot",
+      "source": "./",
+      "description": "Give your coding agent a task. Create a demo video, refresh it after UI changes, and review the result with reshoot."
+    }
+  ]
+}

reshoot-0.3.0/.claude-plugin/plugin.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://anthropic.com/claude-code/plugin.schema.json",
+  "name": "reshoot",
+  "version": "0.3.0",
+  "description": "Agent skills to create, refresh and review software demo videos. Use the reshoot CLI to record the app, export an MP4 and README GIF, and keep the demo source beside the code.",
+  "author": { "name": "Mumit Khan", "url": "https://github.com/mumit" },
+  "homepage": "https://github.com/mumit/reshoot",
+  "repository": "https://github.com/mumit/reshoot",
+  "license": "MIT",
+  "keywords": ["agent-skills", "demo", "video", "readme", "storyboard", "vhs", "ffmpeg"]
+}

reshoot-0.3.0/.gitignore

@@ -0,0 +1,12 @@
+takes/
+review/
+.venv/
+__pycache__/
+*.egg-info/
+.pytest_cache/
+.DS_Store
+
+dist/
+
+# Local social-post drafts
+/docs/sharing.md

reshoot-0.3.0/CHANGELOG.md

@@ -0,0 +1,35 @@
+# Changelog
+
+Each release names what changed for people making demos. Versions follow
+[semantic versioning](https://semver.org/); before 1.0, a minor version may
+change project files or commands.
+
+## 0.3.0 (2026-10-23)
+
+The first release on PyPI. Install it with `uv tool install 'reshoot[browser]'`.
+
+### Added
+
+- Published to PyPI, with a release workflow that builds, checks and publishes
+  each tagged version.
+- An agent-first entry point: a first-demo prompt in the README, the agent
+  quickstart and a skill catalog.
+- Guides for each stage after the first recording: features, customizing,
+  fuller demos and tutorials, publishing, CI and faster shoots.
+
+### Fixed
+
+- Review pages show baseline GIFs as images; MP4s keep their video players.
+- Joined title cards no longer vanish or freeze in GIF exports.
+- Clip joins keep an exact frame rate.
+- Captions stay visible across same-origin page loads.
+- Previews that mix web and VHS takes keep matching dimensions.
+- Runs leave incomplete expectations unverified instead of passing them.
+- `doctor` rejects a `RESHOOT_CHROME` that does not name a usable browser.
+
+## 0.2.0
+
+Repeatable demo projects: `reshoot.toml`, TOML storyboards with checked
+expectations, `init`, `doctor`, `preview`, isolated versioned runs, `compare`,
+`review` with bound decisions, `export`, and shared Claude Code and Codex skills
+installed by `reshoot skills`. Installed from Git only.

reshoot-0.3.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mumit Khan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

reshoot-0.3.0/PKG-INFO

@@ -0,0 +1,268 @@
+Metadata-Version: 2.5
+Name: reshoot
+Version: 0.3.0
+Summary: Agent skills and recording tools for repeatable software demo videos
+Project-URL: Homepage, https://github.com/mumit/reshoot
+Project-URL: Documentation, https://github.com/mumit/reshoot/tree/main/guide
+Project-URL: Changelog, https://github.com/mumit/reshoot/blob/main/CHANGELOG.md
+Project-URL: Issues, https://github.com/mumit/reshoot/issues
+Author: Mumit Khan
+License-Expression: MIT
+License-File: LICENSE
+Keywords: agent-skills,demo,gif,playwright,readme,screencast,video
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Multimedia :: Video
+Classifier: Topic :: Software Development :: Documentation
+Requires-Python: >=3.11
+Requires-Dist: pillow>=10.1
+Requires-Dist: pyobjc-framework-quartz>=10; sys_platform == 'darwin'
+Requires-Dist: pyobjc-framework-vision>=10; sys_platform == 'darwin'
+Requires-Dist: websockets>=12
+Provides-Extra: browser
+Requires-Dist: playwright==1.58.0; extra == 'browser'
+Description-Content-Type: text/markdown
+
+# reshoot
+
+**Give your agent a task. Get a demo you can run again.**
+
+An agent-first toolkit for software demos: open source skills and recording
+tools for Codex and Claude Code. Turn a task in your app into a captioned MP4,
+a README GIF, and source files that keep the demo repeatable as the app changes.
+
+![The same notes task recorded before and after a UI update, using one reshoot storyboard](https://raw.githubusercontent.com/mumit/reshoot/main/docs/demo/reshoot.gif)
+
+The UI changed. The same story still saves and finds the same note.
+[Watch the 21-second demo](https://github.com/mumit/reshoot/blob/main/docs/demo/reshoot.mp4) ·
+[Make a demo of your app](https://github.com/mumit/reshoot/blob/main/guide/agent-quickstart.md) ·
+[Explore the skills](https://github.com/mumit/reshoot/blob/main/skills/README.md) · [Use the CLI](https://github.com/mumit/reshoot/blob/main/guide/step-by-step.md)
+
+## Make a demo of your app
+
+Open **Codex or Claude Code** in your app's repository, or an empty demo folder
+if you only have a running app. Paste this prompt. Change `Target:` to your
+web app's URL or the name of a macOS app and its demo window when needed.
+
+```text
+Make a short demo with reshoot.
+Read https://github.com/mumit/reshoot/blob/main/guide/agent-quickstart.md
+and follow its setup and creation workflow.
+
+Target: the app in this repository.
+Choose one useful task with a clear visible result. Use synthetic demo data.
+Produce a short captioned MP4 and a README GIF. Keep the recording source in
+demo/ so it can be updated later.
+
+Inspect a preview, then record a fresh final and open both exports for review.
+Ask only for permissions or missing details needed to proceed.
+```
+
+Add a task if you have one: “Show creating a project and finding it by search.”
+Otherwise, let the agent inspect the app and propose a useful task. Source code
+is optional. Browser recording runs on macOS or Linux; native window capture
+requires macOS and app-specific automation or your interaction during capture.
+The agent needs a local session with a shell and access to the target.
+
+The agent handles setup, reads the app's controls, writes the story, records a
+preview and prepares the final exports. You watch the result, request changes
+and decide whether to share it. Initial setup may need installation permissions
+or an isolated demo login.
+
+**You get a video, a GIF, and their source.** Keep the `demo/` recipe beside the
+app's code or in its own folder. Browser projects retain each attempt in a
+versioned run folder. Native recipes retain standalone takes and edit scripts.
+
+Already installed the skills? Start with `$reshoot-demo` in Codex or
+`/reshoot-demo` in Claude Code, followed by the task.
+
+## Three skills, one workflow
+
+A skill gives the coding agent a reusable workflow: how to choose the task,
+record it, check the result and present it for review. Reshoot's CLI performs
+the recording and editing. The agent uses available source code or the running
+app's controls to adapt that workflow to the product.
+
+| When | Skill | What to ask for |
+|---|---|---|
+| Make the first demo | [reshoot-demo](https://github.com/mumit/reshoot/blob/main/skills/reshoot-demo/SKILL.md) | “Show a customer saving a search and seeing its results.” |
+| The app changed | [reshoot-refresh](https://github.com/mumit/reshoot/blob/main/skills/reshoot-refresh/SKILL.md) | “Record that task again with the updated UI. Keep the old take for comparison.” |
+| Check before sharing | [reshoot-review](https://github.com/mumit/reshoot/blob/main/skills/reshoot-review/SKILL.md) | “Inspect the final video and GIF, compare the previous run, and report anything that needs attention.” |
+
+For a refresh or review, include the demo's configuration and the exact previous
+run, or the native capture recipe and previous media. See the
+[copyable follow-up prompts](https://github.com/mumit/reshoot/blob/main/guide/agent-quickstart.md#update-the-demo-when-the-app-changes).
+
+Browser projects keep actions, captions and expected results in editable files.
+Result checks can verify that a saved item appears or that a search returns one
+match. When a control moves or a label changes, the agent can repair the story
+and record a new candidate. Watch and approve the new exports before sharing.
+
+## Install the skills
+
+Use the first-demo prompt above to let the agent handle setup, or install the
+tools and skills yourself. The skills need the reshoot CLI, Python 3.11+, Git,
+ffmpeg and, for browser recording, Chrome or Chromium. Linux text scanning also
+needs Tesseract. Follow the [platform setup](https://github.com/mumit/reshoot/blob/main/guide/install.md), then choose one
+installation route.
+
+### Codex
+
+Run this in the app repository or demo work folder:
+
+```bash
+reshoot skills codex --directory .
+```
+
+This installs `reshoot-demo`, `reshoot-refresh` and `reshoot-review` into
+`.agents/skills/`. In Codex, invoke a skill and describe the task:
+
+```text
+$reshoot-demo
+Create a short demo of saving a task and finding it by search.
+Produce an MP4 and a README GIF using synthetic data.
+```
+
+### Claude Code
+
+Run this in the app repository or demo work folder:
+
+```bash
+reshoot skills claude --directory .
+```
+
+This installs the same three skills into `.claude/skills/`. In Claude Code:
+
+```text
+/reshoot-demo
+Create a short demo of saving a task and finding it by search.
+Produce an MP4 and a README GIF using synthetic data.
+```
+
+### Claude Code plugin
+
+To install all ten skills through Claude Code's plugin system, run these
+commands inside Claude Code and follow its installation prompts:
+
+```text
+/plugin marketplace add mumit/reshoot
+/plugin install reshoot@reshoot
+```
+
+Use `/reshoot:reshoot-demo`, `/reshoot:reshoot-refresh` or
+`/reshoot:reshoot-review`, followed by the task. The plugin includes seven
+supporting skills for planning, individual recordings, editing, privacy checks
+and CI. Install the CLI and recording dependencies as well.
+
+The [agent quickstart](https://github.com/mumit/reshoot/blob/main/guide/agent-quickstart.md#install-the-skills-yourself)
+covers skill discovery and the differences between these routes. The CLI
+installer preserves existing skill folders; compare updates before replacing
+local changes.
+
+## Keep the demo with the code
+
+Reshoot records real interactions with the app. The demo project describes
+what to do, what should happen, how long the result should remain visible and
+which formats to export.
+
+| Keep in a browser project | Purpose |
+|---|---|
+| `BRIEF.md` | Audience, task, visible result and destination |
+| `storyboard.toml` | Actions, captions and expected results |
+| `edit.toml` | Cuts, result holds and output formats |
+| `reshoot.toml` | App startup, recording and check settings |
+
+Each versioned browser or terminal candidate retains its report, video, GIF and
+review evidence under `takes/runs/ID/`. Keep the recording source in version control and generated
+takes outside it. Select an explicit baseline when comparing updates.
+
+Native demos keep their capture instructions and edit script separately; see
+the [macOS window workflow](https://github.com/mumit/reshoot/blob/main/guide/macos-window.md).
+Use the [CI workflow](https://github.com/mumit/reshoot/blob/main/guide/ci.md) to record browser and terminal candidates after
+app changes. Review the outputs before updating published demo media.
+
+## Choose the recording for the task
+
+| Show | Tools |
+|---|---|
+| A web app | Headless Chrome, native browser actions, cursor, typing and captions |
+| A CLI or an agent at work | [VHS](https://github.com/charmbracelet/vhs) terminal recordings |
+| A native app on macOS | One window captured by its ID; app-specific automation or manual interaction |
+| The result in different formats | MP4 and GIF exports, custom edits and intentional portrait crops |
+| A narrated explanation | Optional voiceover, music and subtitles |
+
+Use synthetic demo data. Capture a browser page, a terminal or one app window.
+Watch the finished exports and inspect the scan sheets. Automatic checks flag
+potential problems; you make the final review decisions. Reshoot keeps
+publication manual.
+
+Browser workflows are tested on macOS and Linux. Native window capture and
+Vision face/person detection require macOS; Linux uses Tesseract for text.
+See [platforms and tested limits](https://github.com/mumit/reshoot/blob/main/guide/README.md#platforms).
+
+## Use the CLI directly
+
+Start with the bundled notes app to try the tools without a coding agent:
+
+```bash
+reshoot init demo
+reshoot doctor --config demo/reshoot.toml
+reshoot preview demo/reshoot.toml
+reshoot run demo/reshoot.toml
+```
+
+The [CLI tutorial](https://github.com/mumit/reshoot/blob/main/guide/step-by-step.md) covers the complete first recording,
+an app change, a deliberate failure, repair, comparison, review and export.
+For your own app, `reshoot init demo --url http://localhost:3000/` creates a
+project draft. Replace its placeholder story with actions and result checks
+using the [own-app walkthrough](https://github.com/mumit/reshoot/blob/main/guide/your-app.md).
+
+## Grow the demo at your own pace
+
+| Stage | Start here |
+|---|---|
+| 1. Get a first recording | [One agent prompt](https://github.com/mumit/reshoot/blob/main/guide/agent-quickstart.md), or the [CLI notes tutorial](https://github.com/mumit/reshoot/blob/main/guide/step-by-step.md) |
+| 2. See what else is possible | [Explore features and examples](https://github.com/mumit/reshoot/blob/main/guide/features.md) |
+| 3. Change something small | [Edit a caption, timing and GIF size](https://github.com/mumit/reshoot/blob/main/guide/customize.md) |
+| 4. Make a fuller demo or tutorial | [Build the story and edit](https://github.com/mumit/reshoot/blob/main/guide/make-demo.md) |
+| 5. Keep it current and share it | [Updates and publishing](https://github.com/mumit/reshoot/blob/main/guide/publish.md), then [GitHub Actions](https://github.com/mumit/reshoot/blob/main/guide/ci.md) |
+
+Start from [source code](https://github.com/mumit/reshoot/blob/main/guide/your-app.md), a [running web URL](https://github.com/mumit/reshoot/blob/main/guide/running-web-app.md)
+or a [macOS app window](https://github.com/mumit/reshoot/blob/main/guide/macos-window.md). Skip directly to the stage you need.
+
+## Find the right guide
+
+| Task | Start here |
+|---|---|
+| Get a first demo with an agent | [Agent quickstart](https://github.com/mumit/reshoot/blob/main/guide/agent-quickstart.md) |
+| Browse the skill package | [Skill catalog](https://github.com/mumit/reshoot/blob/main/skills/README.md) |
+| Install or upgrade the tools | [Installation](https://github.com/mumit/reshoot/blob/main/guide/install.md) |
+| Learn the CLI workflow from scratch | [Notes tutorial](https://github.com/mumit/reshoot/blob/main/guide/step-by-step.md) |
+| Write a story for an existing app | [Own-app walkthrough](https://github.com/mumit/reshoot/blob/main/guide/your-app.md) |
+| Look up actions, captions, edits and exports | [Project reference](https://github.com/mumit/reshoot/blob/main/guide/projects.md) |
+| Find a command or fix a failed step | [Command map](https://github.com/mumit/reshoot/blob/main/guide/commands.md) · [Troubleshooting](https://github.com/mumit/reshoot/blob/main/guide/troubleshooting.md) |
+| Record a terminal or native window | [Manual workflow](https://github.com/mumit/reshoot/blob/main/guide/manual.md) |
+| Reproduce the README demo | [Before-and-after recipe](https://github.com/mumit/reshoot/blob/main/examples/promo/README.md) |
+
+## Why reshoot exists
+
+I made the launch video for [photosearch](https://github.com/mumit/photosearch)
+this way, and pulled the tools and what I learned into reshoot. A demo takes
+work to make. Keeping its story beside the app makes that work useful again
+when the product changes.
+
+The [original notes recording](https://github.com/mumit/reshoot/blob/main/docs/demo/notes.mp4) and its
+[source files](https://github.com/mumit/reshoot/blob/main/examples/notes/) remain available.
+
+## Contributing
+
+New pitfalls, skills and fixes are welcome. See [CONTRIBUTING.md](https://github.com/mumit/reshoot/blob/main/CONTRIBUTING.md)
+for contribution instructions and [ROADMAP.md](https://github.com/mumit/reshoot/blob/main/ROADMAP.md) for planned work.
+
+## License
+
+MIT. See [LICENSE](https://github.com/mumit/reshoot/blob/main/LICENSE).

reshoot-0.3.0/README.md

@@ -0,0 +1,239 @@
+# reshoot
+
+**Give your agent a task. Get a demo you can run again.**
+
+An agent-first toolkit for software demos: open source skills and recording
+tools for Codex and Claude Code. Turn a task in your app into a captioned MP4,
+a README GIF, and source files that keep the demo repeatable as the app changes.
+
+![The same notes task recorded before and after a UI update, using one reshoot storyboard](docs/demo/reshoot.gif)
+
+The UI changed. The same story still saves and finds the same note.
+[Watch the 21-second demo](docs/demo/reshoot.mp4) ·
+[Make a demo of your app](guide/agent-quickstart.md) ·
+[Explore the skills](skills/README.md) · [Use the CLI](guide/step-by-step.md)
+
+## Make a demo of your app
+
+Open **Codex or Claude Code** in your app's repository, or an empty demo folder
+if you only have a running app. Paste this prompt. Change `Target:` to your
+web app's URL or the name of a macOS app and its demo window when needed.
+
+```text
+Make a short demo with reshoot.
+Read https://github.com/mumit/reshoot/blob/main/guide/agent-quickstart.md
+and follow its setup and creation workflow.
+
+Target: the app in this repository.
+Choose one useful task with a clear visible result. Use synthetic demo data.
+Produce a short captioned MP4 and a README GIF. Keep the recording source in
+demo/ so it can be updated later.
+
+Inspect a preview, then record a fresh final and open both exports for review.
+Ask only for permissions or missing details needed to proceed.
+```
+
+Add a task if you have one: “Show creating a project and finding it by search.”
+Otherwise, let the agent inspect the app and propose a useful task. Source code
+is optional. Browser recording runs on macOS or Linux; native window capture
+requires macOS and app-specific automation or your interaction during capture.
+The agent needs a local session with a shell and access to the target.
+
+The agent handles setup, reads the app's controls, writes the story, records a
+preview and prepares the final exports. You watch the result, request changes
+and decide whether to share it. Initial setup may need installation permissions
+or an isolated demo login.
+
+**You get a video, a GIF, and their source.** Keep the `demo/` recipe beside the
+app's code or in its own folder. Browser projects retain each attempt in a
+versioned run folder. Native recipes retain standalone takes and edit scripts.
+
+Already installed the skills? Start with `$reshoot-demo` in Codex or
+`/reshoot-demo` in Claude Code, followed by the task.
+
+## Three skills, one workflow
+
+A skill gives the coding agent a reusable workflow: how to choose the task,
+record it, check the result and present it for review. Reshoot's CLI performs
+the recording and editing. The agent uses available source code or the running
+app's controls to adapt that workflow to the product.
+
+| When | Skill | What to ask for |
+|---|---|---|
+| Make the first demo | [reshoot-demo](skills/reshoot-demo/SKILL.md) | “Show a customer saving a search and seeing its results.” |
+| The app changed | [reshoot-refresh](skills/reshoot-refresh/SKILL.md) | “Record that task again with the updated UI. Keep the old take for comparison.” |
+| Check before sharing | [reshoot-review](skills/reshoot-review/SKILL.md) | “Inspect the final video and GIF, compare the previous run, and report anything that needs attention.” |
+
+For a refresh or review, include the demo's configuration and the exact previous
+run, or the native capture recipe and previous media. See the
+[copyable follow-up prompts](guide/agent-quickstart.md#update-the-demo-when-the-app-changes).
+
+Browser projects keep actions, captions and expected results in editable files.
+Result checks can verify that a saved item appears or that a search returns one
+match. When a control moves or a label changes, the agent can repair the story
+and record a new candidate. Watch and approve the new exports before sharing.
+
+## Install the skills
+
+Use the first-demo prompt above to let the agent handle setup, or install the
+tools and skills yourself. The skills need the reshoot CLI, Python 3.11+, Git,
+ffmpeg and, for browser recording, Chrome or Chromium. Linux text scanning also
+needs Tesseract. Follow the [platform setup](guide/install.md), then choose one
+installation route.
+
+### Codex
+
+Run this in the app repository or demo work folder:
+
+```bash
+reshoot skills codex --directory .
+```
+
+This installs `reshoot-demo`, `reshoot-refresh` and `reshoot-review` into
+`.agents/skills/`. In Codex, invoke a skill and describe the task:
+
+```text
+$reshoot-demo
+Create a short demo of saving a task and finding it by search.
+Produce an MP4 and a README GIF using synthetic data.
+```
+
+### Claude Code
+
+Run this in the app repository or demo work folder:
+
+```bash
+reshoot skills claude --directory .
+```
+
+This installs the same three skills into `.claude/skills/`. In Claude Code:
+
+```text
+/reshoot-demo
+Create a short demo of saving a task and finding it by search.
+Produce an MP4 and a README GIF using synthetic data.
+```
+
+### Claude Code plugin
+
+To install all ten skills through Claude Code's plugin system, run these
+commands inside Claude Code and follow its installation prompts:
+
+```text
+/plugin marketplace add mumit/reshoot
+/plugin install reshoot@reshoot
+```
+
+Use `/reshoot:reshoot-demo`, `/reshoot:reshoot-refresh` or
+`/reshoot:reshoot-review`, followed by the task. The plugin includes seven
+supporting skills for planning, individual recordings, editing, privacy checks
+and CI. Install the CLI and recording dependencies as well.
+
+The [agent quickstart](guide/agent-quickstart.md#install-the-skills-yourself)
+covers skill discovery and the differences between these routes. The CLI
+installer preserves existing skill folders; compare updates before replacing
+local changes.
+
+## Keep the demo with the code
+
+Reshoot records real interactions with the app. The demo project describes
+what to do, what should happen, how long the result should remain visible and
+which formats to export.
+
+| Keep in a browser project | Purpose |
+|---|---|
+| `BRIEF.md` | Audience, task, visible result and destination |
+| `storyboard.toml` | Actions, captions and expected results |
+| `edit.toml` | Cuts, result holds and output formats |
+| `reshoot.toml` | App startup, recording and check settings |
+
+Each versioned browser or terminal candidate retains its report, video, GIF and
+review evidence under `takes/runs/ID/`. Keep the recording source in version control and generated
+takes outside it. Select an explicit baseline when comparing updates.
+
+Native demos keep their capture instructions and edit script separately; see
+the [macOS window workflow](guide/macos-window.md).
+Use the [CI workflow](guide/ci.md) to record browser and terminal candidates after
+app changes. Review the outputs before updating published demo media.
+
+## Choose the recording for the task
+
+| Show | Tools |
+|---|---|
+| A web app | Headless Chrome, native browser actions, cursor, typing and captions |
+| A CLI or an agent at work | [VHS](https://github.com/charmbracelet/vhs) terminal recordings |
+| A native app on macOS | One window captured by its ID; app-specific automation or manual interaction |
+| The result in different formats | MP4 and GIF exports, custom edits and intentional portrait crops |
+| A narrated explanation | Optional voiceover, music and subtitles |
+
+Use synthetic demo data. Capture a browser page, a terminal or one app window.
+Watch the finished exports and inspect the scan sheets. Automatic checks flag
+potential problems; you make the final review decisions. Reshoot keeps
+publication manual.
+
+Browser workflows are tested on macOS and Linux. Native window capture and
+Vision face/person detection require macOS; Linux uses Tesseract for text.
+See [platforms and tested limits](guide/README.md#platforms).
+
+## Use the CLI directly
+
+Start with the bundled notes app to try the tools without a coding agent:
+
+```bash
+reshoot init demo
+reshoot doctor --config demo/reshoot.toml
+reshoot preview demo/reshoot.toml
+reshoot run demo/reshoot.toml
+```
+
+The [CLI tutorial](guide/step-by-step.md) covers the complete first recording,
+an app change, a deliberate failure, repair, comparison, review and export.
+For your own app, `reshoot init demo --url http://localhost:3000/` creates a
+project draft. Replace its placeholder story with actions and result checks
+using the [own-app walkthrough](guide/your-app.md).
+
+## Grow the demo at your own pace
+
+| Stage | Start here |
+|---|---|
+| 1. Get a first recording | [One agent prompt](guide/agent-quickstart.md), or the [CLI notes tutorial](guide/step-by-step.md) |
+| 2. See what else is possible | [Explore features and examples](guide/features.md) |
+| 3. Change something small | [Edit a caption, timing and GIF size](guide/customize.md) |
+| 4. Make a fuller demo or tutorial | [Build the story and edit](guide/make-demo.md) |
+| 5. Keep it current and share it | [Updates and publishing](guide/publish.md), then [GitHub Actions](guide/ci.md) |
+
+Start from [source code](guide/your-app.md), a [running web URL](guide/running-web-app.md)
+or a [macOS app window](guide/macos-window.md). Skip directly to the stage you need.
+
+## Find the right guide
+
+| Task | Start here |
+|---|---|
+| Get a first demo with an agent | [Agent quickstart](guide/agent-quickstart.md) |
+| Browse the skill package | [Skill catalog](skills/README.md) |
+| Install or upgrade the tools | [Installation](guide/install.md) |
+| Learn the CLI workflow from scratch | [Notes tutorial](guide/step-by-step.md) |
+| Write a story for an existing app | [Own-app walkthrough](guide/your-app.md) |
+| Look up actions, captions, edits and exports | [Project reference](guide/projects.md) |
+| Find a command or fix a failed step | [Command map](guide/commands.md) · [Troubleshooting](guide/troubleshooting.md) |
+| Record a terminal or native window | [Manual workflow](guide/manual.md) |
+| Reproduce the README demo | [Before-and-after recipe](examples/promo/README.md) |
+
+## Why reshoot exists
+
+I made the launch video for [photosearch](https://github.com/mumit/photosearch)
+this way, and pulled the tools and what I learned into reshoot. A demo takes
+work to make. Keeping its story beside the app makes that work useful again
+when the product changes.
+
+The [original notes recording](docs/demo/notes.mp4) and its
+[source files](examples/notes/) remain available.
+
+## Contributing
+
+New pitfalls, skills and fixes are welcome. See [CONTRIBUTING.md](CONTRIBUTING.md)
+for contribution instructions and [ROADMAP.md](ROADMAP.md) for planned work.
+
+## License
+
+MIT. See [LICENSE](LICENSE).

reshoot-0.3.0/examples/notes/about.html

@@ -0,0 +1,23 @@
+<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>About Notes</title>
+<style>
+  :root { color-scheme: light dark; --bg: #f6f4f0; --fg: #1d1b18; --muted: #77716a; --accent: #c8641e; }
+  @media (prefers-color-scheme: dark) { :root { --bg: #0e0d0c; --fg: #f1ede7; --muted: #a39b91; --accent: #f5b43c; } }
+  body { margin: 0; background: var(--bg); color: var(--fg); font: 17px/1.45 -apple-system, system-ui, sans-serif; }
+  main { max-width: 760px; margin: 0 auto; padding: 48px 16px; }
+  h1 { margin: 0 0 16px; font-size: 34px; letter-spacing: -.02em; }
+  a { color: var(--accent); }
+</style>
+</head>
+<body>
+<main>
+  <h1>About Notes</h1>
+  <p>A made-up app for trying reshoot. This second page is here so a storyboard can follow a link to a new page.</p>
+  <p><a id="back" href="index.html">Back to notes</a></p>
+</main>
+</body>
+</html>