cast-studio 0.1.0__tar.gz

cast_studio-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Avi Zaguri
+
+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.

cast_studio-0.1.0/MANIFEST.in

@@ -0,0 +1,4 @@
+pyproject.toml
+include requirements.txt
+include README.md
+include LICENSE

cast_studio-0.1.0/PKG-INFO

@@ -0,0 +1,208 @@
+Metadata-Version: 2.4
+Name: cast-studio
+Version: 0.1.0
+Summary: Convert asciinema .cast files to GIF and MP4, with a generic demo-recording engine
+Author: Avi Zaguri
+License: MIT
+Project-URL: Homepage, https://github.com/aviz92/cast-studio
+Project-URL: Repository, https://github.com/aviz92/cast-studio
+Project-URL: Issues, https://github.com/aviz92/cast-studio/issues
+Keywords: asciinema,cast,gif,mp4,terminal,demo,recording
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Multimedia :: Video :: Conversion
+Classifier: Topic :: Software Development :: Documentation
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: custom-python-logger>=2.0.13
+Requires-Dist: pillow>=12.1.1
+Requires-Dist: pre-commit>=4.5.0
+Requires-Dist: pytest>=9.0.1
+Requires-Dist: pytest-plugins>=2.0.0
+Requires-Dist: python-base-command>=0.1.3
+Requires-Dist: python-base-toolkit>=0.0.17
+Requires-Dist: setuptools>=80.9.0
+Requires-Dist: tenacity>=9.1.2
+Requires-Dist: wheel>=0.45.1
+Dynamic: license-file
+
+![PyPI version](https://img.shields.io/pypi/v/cast-studio)
+![Python](https://img.shields.io/badge/python->=3.9-blue)
+![Development Status](https://img.shields.io/badge/status-alpha-orange)
+![Maintenance](https://img.shields.io/maintenance/yes/2026)
+![PyPI](https://img.shields.io/pypi/dm/cast-studio)
+![License](https://img.shields.io/pypi/l/cast-studio)
+
+---
+
+# 🎬 cast-studio
+
+Convert [asciinema](https://asciinema.org/) `.cast` recordings into **GIF** and **MP4** — and scaffold a generic demo-recording engine for any Python project.
+
+---
+
+## 📦 Installation
+
+```bash
+uv add cast-studio
+```
+
+> **System requirement:** `ffmpeg` must be installed.
+> ```bash
+> brew install ffmpeg        # macOS
+> apt-get install ffmpeg     # Ubuntu / Debian
+> ```
+
+---
+
+## 🚀 Features
+
+- ✅ **cast → GIF** — High-quality 256-colour GIF via ffmpeg palette pass
+- ✅ **cast → MP4** — H.264/x264 CRF-18 MP4 ready for GitHub Releases
+- ✅ **Catppuccin Mocha theme** — Beautiful dark terminal rendering with Pillow
+- ✅ **Generic demo engine** — `cast-run` + `demo.cfg` for any project
+- ✅ **Any shell command** — Record pytest runs, scripts, CLIs — not just pytest
+- ✅ **Multi-line descriptions** — Pipe-separated description lines per run
+- ✅ **`python-base-command` CLI** — Structured, loggable CLI with `cast` / `cast-render` / `cast-init`
+
+---
+
+## ⚙️ Configuration
+
+No `.env` needed. All config lives in `demo.cfg`:
+
+```bash
+PROJECT="my-library"
+SUBTITLE="A short description"
+INSTALL_CMD="pip install my-library"
+REPO_URL="github.com/you/my-library"
+PYPI_URL="pypi.org/project/my-library"
+
+PYTEST=".venv/bin/pytest"
+TESTS="tests/"
+
+PAUSE_INTRO=2       # seconds after intro screen
+PAUSE_BETWEEN=2     # seconds between runs
+PAUSE_OUTRO=3       # seconds on outro screen
+
+define_runs() {
+  add_run "RUN 1 — feature A" "Short description." "$PYTEST $TESTS --flag"
+  add_run "RUN 2 — script"   "Another feature."    "python scripts/my_script.py"
+}
+```
+
+> `add_run "Title" "Line 1|Line 2" "any shell command"` — use `|` for multi-line descriptions.
+
+---
+
+## 🛠️ How to Use
+
+1. **Install** — `uv add cast-studio` (and `brew install ffmpeg asciinema`)
+3. **Create .cfg** — customise `demo.cfg` with your project's runs
+4. **Record** — `asciinema rec -c "cast-run demo/demo.cfg" demo.cast`
+5. **Render** — `cast-render demo.cast assets/demo --gif-only --title "my demo"` → `assets/demo.gif`
+6. **Embed** — add `![demo](assets/demo.gif)` to your README
+
+---
+
+## 🚀 Quick Start
+
+```bash
+# 1. Install
+uv add cast-studio
+brew install ffmpeg asciinema   # macOS
+
+# 2. Create demo/demo.cfg — set PROJECT, SUBTITLE, INSTALL_CMD, define_runs()
+```
+
+`demo/demo.cfg` structure:
+```bash
+PROJECT="my-library"
+SUBTITLE="A short description"
+INSTALL_CMD="uv add my-library"
+REPO_URL="github.com/you/my-library"
+PYPI_URL="pypi.org/project/my-library"
+
+define_runs() {
+  add_run "RUN 1 — feature A" "Short description." "pytest tests/ --flag"
+  add_run "RUN 2 — script"   "Another feature."    "python scripts/my_script.py"
+}
+```
+
+```bash
+# 3. Record
+asciinema rec -c "bash cast-run demo/demo.cfg" assets/demo/demo.cast
+
+# 4. Render to GIF and MP4
+cast-render assets/demo/demo.cast assets/demo/demo --gif-only --title "my-library demo"  # -> `assets/demo/demo.gif`
+cast-render assets/demo/demo.cast assets/demo/demo --mp4-only --title "my-library demo"  # -> `assets/demo/demo.mp4`
+
+# 5. Embed in README
+# ![demo](assets/demo.gif)
+```
+
+---
+
+## 🎥 Demo
+
+[//]: # ([![Watch demo](assets/demo/demo.gif)](https://your-video-url.mp4))
+![Watch demo](assets/demo/demo.gif)
+
+---
+
+## CLI Reference
+
+### `cast-render`
+
+| Flag | Default | Description |
+|------|---------|-------------|
+| `cast_file` | — | Path to `.cast` file |
+| `output_base` | — | Output path without extension |
+| `--title` | `""` | Title bar text |
+| `--gif-only` | — | Produce GIF only |
+| `--mp4-only` | — | Produce MP4 only |
+| `--render-fps` | `30` | Internal PNG frame rate |
+| `--gif-fps` | `10` | GIF output FPS |
+| `--mp4-fps` | `30` | MP4 output FPS |
+| `--hold` | `3.0` | Seconds to hold last frame |
+| `--keep-frames` | — | Keep temporary PNG frames |
+
+### `cast-init`
+
+| Flag | Default | Description |
+|------|---------|-------------|
+| `--dest` | `scripts/record_demo` | Directory to scaffold into |
+| `--force` | — | Overwrite existing files |
+
+---
+
+## 🤝 Contributing
+
+If you have a helpful pattern or improvement to suggest:
+Fork the repo
+Create a new branch
+Submit a pull request
+I welcome additions that promote clean, productive, and maintainable development.
+
+---
+
+## 📄 License
+
+MIT License — see [LICENSE](LICENSE) for details.
+
+---
+
+## 🙏 Thanks
+
+Thanks for exploring this repository! <br>
+Happy coding!
+
+[![GitHub](https://img.shields.io/badge/GitHub-aviz92-181717?logo=github)](https://github.com/aviz92)
+&nbsp; [![PyPI](https://img.shields.io/badge/PyPI-aviz-3775A9?logo=pypi)](https://pypi.org/user/aviz/)
+&nbsp; [![Blog](https://img.shields.io/badge/Blog-aviz92.github.io-0066CC?logo=googlechrome)](https://aviz92.github.io/)
+&nbsp; [![LinkedIn](https://img.shields.io/badge/LinkedIn-avi--zaguri-0A66C2?logo=linkedin)](https://www.linkedin.com/in/avi-zaguri-41869b11b)

cast_studio-0.1.0/README.md

@@ -0,0 +1,175 @@
+![PyPI version](https://img.shields.io/pypi/v/cast-studio)
+![Python](https://img.shields.io/badge/python->=3.9-blue)
+![Development Status](https://img.shields.io/badge/status-alpha-orange)
+![Maintenance](https://img.shields.io/maintenance/yes/2026)
+![PyPI](https://img.shields.io/pypi/dm/cast-studio)
+![License](https://img.shields.io/pypi/l/cast-studio)
+
+---
+
+# 🎬 cast-studio
+
+Convert [asciinema](https://asciinema.org/) `.cast` recordings into **GIF** and **MP4** — and scaffold a generic demo-recording engine for any Python project.
+
+---
+
+## 📦 Installation
+
+```bash
+uv add cast-studio
+```
+
+> **System requirement:** `ffmpeg` must be installed.
+> ```bash
+> brew install ffmpeg        # macOS
+> apt-get install ffmpeg     # Ubuntu / Debian
+> ```
+
+---
+
+## 🚀 Features
+
+- ✅ **cast → GIF** — High-quality 256-colour GIF via ffmpeg palette pass
+- ✅ **cast → MP4** — H.264/x264 CRF-18 MP4 ready for GitHub Releases
+- ✅ **Catppuccin Mocha theme** — Beautiful dark terminal rendering with Pillow
+- ✅ **Generic demo engine** — `cast-run` + `demo.cfg` for any project
+- ✅ **Any shell command** — Record pytest runs, scripts, CLIs — not just pytest
+- ✅ **Multi-line descriptions** — Pipe-separated description lines per run
+- ✅ **`python-base-command` CLI** — Structured, loggable CLI with `cast` / `cast-render` / `cast-init`
+
+---
+
+## ⚙️ Configuration
+
+No `.env` needed. All config lives in `demo.cfg`:
+
+```bash
+PROJECT="my-library"
+SUBTITLE="A short description"
+INSTALL_CMD="pip install my-library"
+REPO_URL="github.com/you/my-library"
+PYPI_URL="pypi.org/project/my-library"
+
+PYTEST=".venv/bin/pytest"
+TESTS="tests/"
+
+PAUSE_INTRO=2       # seconds after intro screen
+PAUSE_BETWEEN=2     # seconds between runs
+PAUSE_OUTRO=3       # seconds on outro screen
+
+define_runs() {
+  add_run "RUN 1 — feature A" "Short description." "$PYTEST $TESTS --flag"
+  add_run "RUN 2 — script"   "Another feature."    "python scripts/my_script.py"
+}
+```
+
+> `add_run "Title" "Line 1|Line 2" "any shell command"` — use `|` for multi-line descriptions.
+
+---
+
+## 🛠️ How to Use
+
+1. **Install** — `uv add cast-studio` (and `brew install ffmpeg asciinema`)
+3. **Create .cfg** — customise `demo.cfg` with your project's runs
+4. **Record** — `asciinema rec -c "cast-run demo/demo.cfg" demo.cast`
+5. **Render** — `cast-render demo.cast assets/demo --gif-only --title "my demo"` → `assets/demo.gif`
+6. **Embed** — add `![demo](assets/demo.gif)` to your README
+
+---
+
+## 🚀 Quick Start
+
+```bash
+# 1. Install
+uv add cast-studio
+brew install ffmpeg asciinema   # macOS
+
+# 2. Create demo/demo.cfg — set PROJECT, SUBTITLE, INSTALL_CMD, define_runs()
+```
+
+`demo/demo.cfg` structure:
+```bash
+PROJECT="my-library"
+SUBTITLE="A short description"
+INSTALL_CMD="uv add my-library"
+REPO_URL="github.com/you/my-library"
+PYPI_URL="pypi.org/project/my-library"
+
+define_runs() {
+  add_run "RUN 1 — feature A" "Short description." "pytest tests/ --flag"
+  add_run "RUN 2 — script"   "Another feature."    "python scripts/my_script.py"
+}
+```
+
+```bash
+# 3. Record
+asciinema rec -c "bash cast-run demo/demo.cfg" assets/demo/demo.cast
+
+# 4. Render to GIF and MP4
+cast-render assets/demo/demo.cast assets/demo/demo --gif-only --title "my-library demo"  # -> `assets/demo/demo.gif`
+cast-render assets/demo/demo.cast assets/demo/demo --mp4-only --title "my-library demo"  # -> `assets/demo/demo.mp4`
+
+# 5. Embed in README
+# ![demo](assets/demo.gif)
+```
+
+---
+
+## 🎥 Demo
+
+[//]: # ([![Watch demo](assets/demo/demo.gif)](https://your-video-url.mp4))
+![Watch demo](assets/demo/demo.gif)
+
+---
+
+## CLI Reference
+
+### `cast-render`
+
+| Flag | Default | Description |
+|------|---------|-------------|
+| `cast_file` | — | Path to `.cast` file |
+| `output_base` | — | Output path without extension |
+| `--title` | `""` | Title bar text |
+| `--gif-only` | — | Produce GIF only |
+| `--mp4-only` | — | Produce MP4 only |
+| `--render-fps` | `30` | Internal PNG frame rate |
+| `--gif-fps` | `10` | GIF output FPS |
+| `--mp4-fps` | `30` | MP4 output FPS |
+| `--hold` | `3.0` | Seconds to hold last frame |
+| `--keep-frames` | — | Keep temporary PNG frames |
+
+### `cast-init`
+
+| Flag | Default | Description |
+|------|---------|-------------|
+| `--dest` | `scripts/record_demo` | Directory to scaffold into |
+| `--force` | — | Overwrite existing files |
+
+---
+
+## 🤝 Contributing
+
+If you have a helpful pattern or improvement to suggest:
+Fork the repo
+Create a new branch
+Submit a pull request
+I welcome additions that promote clean, productive, and maintainable development.
+
+---
+
+## 📄 License
+
+MIT License — see [LICENSE](LICENSE) for details.
+
+---
+
+## 🙏 Thanks
+
+Thanks for exploring this repository! <br>
+Happy coding!
+
+[![GitHub](https://img.shields.io/badge/GitHub-aviz92-181717?logo=github)](https://github.com/aviz92)
+&nbsp; [![PyPI](https://img.shields.io/badge/PyPI-aviz-3775A9?logo=pypi)](https://pypi.org/user/aviz/)
+&nbsp; [![Blog](https://img.shields.io/badge/Blog-aviz92.github.io-0066CC?logo=googlechrome)](https://aviz92.github.io/)
+&nbsp; [![LinkedIn](https://img.shields.io/badge/LinkedIn-avi--zaguri-0A66C2?logo=linkedin)](https://www.linkedin.com/in/avi-zaguri-41869b11b)

cast_studio-0.1.0/cast_studio/cli.py

@@ -0,0 +1,20 @@
+"""
+cast — main entry point, auto-discovers all commands.
+
+Usage:
+    cast render demo.cast assets/demo
+    cast init
+    cast --help
+"""
+
+from pathlib import Path
+
+from python_base_command import Runner
+
+
+def main():
+    Runner(commands_dir=str(Path(__file__).parent / "commands")).run()
+
+
+if __name__ == "__main__":
+    main()

cast_studio-0.1.0/cast_studio/cli_render.py

@@ -0,0 +1,24 @@
+"""
+cast-render — convenience alias for `cast render`.
+
+Usage:
+    cast-render demo.cast assets/demo
+    cast-render demo.cast assets/demo --gif-only
+"""
+
+import sys
+
+from python_base_command import CommandRegistry
+
+from cast_studio.commands.render import Command
+
+
+def main():
+    registry = CommandRegistry()
+    registry.register("render")(Command)
+    sys.argv.insert(1, "render")
+    registry.run()
+
+
+if __name__ == "__main__":
+    main()

cast_studio-0.1.0/cast_studio/cli_run.py

@@ -0,0 +1,14 @@
+"""Entry point for `cast-run` — alias for the run command."""
+
+import sys
+
+from python_base_command import CommandRegistry
+
+from cast_studio.commands.cast import Command
+
+
+def main():
+    registry = CommandRegistry()
+    registry.register("run")(Command)
+    sys.argv.insert(1, "run")
+    registry.run()

cast_studio-0.1.0/cast_studio/commands/cast.py

@@ -0,0 +1,40 @@
+"""cast-run — execute run_demo.sh with a user-supplied demo.cfg."""
+
+import subprocess
+from pathlib import Path
+
+from python_base_command import BaseCommand, CommandError
+
+TEMPLATES_DIR = Path(__file__).parent.parent / "templates"
+
+
+class Command(BaseCommand):
+    help = "Run the demo engine (run_demo.sh) with your demo.cfg"
+    version = "0.1.0"
+
+    def add_arguments(self, parser):
+        parser.add_argument(
+            "cfg",
+            nargs="?",
+            default="demo/demo.cfg",
+            help="Path to demo.cfg (default: demo/demo.cfg)",
+        )
+
+    def handle(self, **kwargs):
+        cfg = Path(kwargs["cfg"])
+        run_demo = TEMPLATES_DIR / "run_demo.sh"
+
+        if not run_demo.exists():
+            raise CommandError(f"run_demo.sh not found in package: {run_demo}")
+
+        if not cfg.exists():
+            raise CommandError(
+                f"Config file not found: {cfg}\n"
+                f"  Run: cast-init --dest {cfg.parent}"
+            )
+
+        self.logger.step(f"Running demo engine with config: {cfg}")
+        result = subprocess.run(["bash", str(run_demo), str(cfg)])
+
+        if result.returncode != 0:
+            raise CommandError(f"run_demo.sh exited with code {result.returncode}")

cast_studio-0.1.0/cast_studio/commands/init.py

@@ -0,0 +1,65 @@
+import shutil
+from pathlib import Path
+
+from python_base_command import BaseCommand, CommandError
+
+TEMPLATES_DIR = Path(__file__).parent.parent / "templates"
+
+
+class Command(BaseCommand):
+    help = "Scaffold cast-studio demo scripts into your project"
+    version = "0.1.0"
+
+    def add_arguments(self, parser):
+        parser.add_argument(
+            "--dest",
+            default="scripts/record_demo",
+            help="Destination directory (default: scripts/record_demo)",
+        )
+        parser.add_argument(
+            "--force",
+            action="store_true",
+            help="Overwrite existing files",
+        )
+
+    def handle(self, **kwargs):
+        dest = Path(kwargs["dest"])
+        dest.mkdir(parents=True, exist_ok=True)
+
+        files = {
+            TEMPLATES_DIR / "run_demo.sh":      dest / "run_demo.sh",
+            TEMPLATES_DIR / "demo.cfg.example": dest / "demo.cfg",
+        }
+
+        created = []
+        skipped = []
+
+        for src, dst in files.items():
+            if not src.exists():
+                raise CommandError(f"Template not found: {src}")
+            if dst.exists() and not kwargs["force"]:
+                skipped.append(str(dst))
+                continue
+            shutil.copy(src, dst)
+            dst.chmod(dst.stat().st_mode | 0o755)
+            created.append(str(dst))
+
+        if created:
+            self.logger.info("Created:")
+            for f in created:
+                self.logger.info(f"  {f}")
+
+        if skipped:
+            self.logger.warning("Already exists (use --force to overwrite):")
+            for f in skipped:
+                self.logger.warning(f"  {f}")
+
+        if not created and not skipped:
+            raise CommandError("No template files found.")
+
+        self.logger.step(f"Next steps:")
+        self.logger.info(f"  1. Edit  {dest}/demo.cfg")
+        self.logger.info(f"  2. Record:")
+        self.logger.info(f"       asciinema rec -c \"bash {dest}/run_demo.sh {dest}/demo.cfg\" demo.cast")
+        self.logger.info(f"  3. Render:")
+        self.logger.info(f"       cast-render demo.cast assets/demo")

cast_studio-0.1.0/cast_studio/commands/render.py

@@ -0,0 +1,114 @@
+import shutil
+from pathlib import Path
+
+from python_base_command import BaseCommand, CommandError
+
+from cast_studio.encoder import render_frames, encode_gif, encode_mp4
+
+
+class Command(BaseCommand):
+    help = "Convert an asciinema .cast file to GIF and/or MP4"
+    version = "0.1.0"
+
+    def add_arguments(self, parser):
+        parser.add_argument(
+            "cast_file",
+            help="Path to the .cast input file",
+        )
+        parser.add_argument(
+            "output_base",
+            help="Output base path, e.g. assets/demo → demo.gif + demo.mp4",
+        )
+        parser.add_argument(
+            "--title",
+            default="",
+            help="Window title bar text (default: empty)",
+        )
+        parser.add_argument(
+            "--gif-only",
+            action="store_true",
+            help="Produce GIF only (skip MP4)",
+        )
+        parser.add_argument(
+            "--mp4-only",
+            action="store_true",
+            help="Produce MP4 only (skip GIF)",
+        )
+        parser.add_argument(
+            "--render-fps",
+            type=int,
+            default=30,
+            metavar="N",
+            help="Internal render FPS used for PNG frames (default: 30)",
+        )
+        parser.add_argument(
+            "--gif-fps",
+            type=int,
+            default=10,
+            metavar="N",
+            help="GIF output FPS (default: 10)",
+        )
+        parser.add_argument(
+            "--mp4-fps",
+            type=int,
+            default=30,
+            metavar="N",
+            help="MP4 output FPS (default: 30)",
+        )
+        parser.add_argument(
+            "--hold",
+            type=float,
+            default=3.0,
+            metavar="SEC",
+            help="Seconds to hold the last frame (default: 3.0)",
+        )
+        parser.add_argument(
+            "--keep-frames",
+            action="store_true",
+            help="Keep temporary PNG frames after encoding (useful for debugging)",
+        )
+
+    def handle(self, **kwargs):
+        cast_file = kwargs["cast_file"]
+        output_base = kwargs["output_base"]
+
+        if not Path(cast_file).exists():
+            raise CommandError(f"Cast file not found: {cast_file}")
+
+        if kwargs["gif_only"] and kwargs["mp4_only"]:
+            raise CommandError("Cannot use --gif-only and --mp4-only together.")
+
+        Path(output_base).parent.mkdir(parents=True, exist_ok=True)
+
+        do_gif = not kwargs["mp4_only"]
+        do_mp4 = not kwargs["gif_only"]
+
+        frames_dir = Path("/tmp/_cast_studio_frames")
+        if frames_dir.exists():
+            shutil.rmtree(frames_dir)
+
+        self.logger.step("Rendering PNG frames...")
+        render_frames(
+            cast_file=cast_file,
+            frames_dir=frames_dir,
+            title=kwargs["title"],
+            render_fps=kwargs["render_fps"],
+            hold_secs=kwargs["hold"],
+        )
+
+        if do_gif:
+            self.logger.step("Encoding GIF...")
+            encode_gif(frames_dir, output_base + ".gif", kwargs["render_fps"], kwargs["gif_fps"])
+
+        if do_mp4:
+            self.logger.step("Encoding MP4...")
+            encode_mp4(frames_dir, output_base + ".mp4", kwargs["render_fps"], kwargs["mp4_fps"])
+
+        if not kwargs["keep_frames"]:
+            shutil.rmtree(frames_dir)
+
+        self.logger.info("Done.")
+        if do_gif:
+            self.logger.info(f"  GIF → {output_base}.gif")
+        if do_mp4:
+            self.logger.info(f"  MP4 → {output_base}.mp4")