VideoSpeed 1.0.5__tar.gz → 1.0.9__tar.gz

videospeed-1.0.9/PKG-INFO

@@ -0,0 +1,203 @@
+Metadata-Version: 2.4
+Name: VideoSpeed
+Version: 1.0.9
+Summary: A command-line video editing tool built in Python for cutting, speeding up, and applying a boomerang effect to MP4 videos.
+Author-email: Wilgat Wong <wilgat.wong@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/Wilgat/VideoSpeed
+Project-URL: Repository, https://github.com/Wilgat/VideoSpeed
+Project-URL: Issues, https://github.com/Wilgat/VideoSpeed/issues
+Keywords: Video Editing,Multimeida
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE.md
+Requires-Dist: opencv-python-headless>=5.0.0.93
+Requires-Dist: ChronicleLogger>=1.3.1
+Dynamic: license-file
+
+# VideoSpeed - Cut, speed, and boomerang MP4 clips from the CLI
+
+![Version](https://img.shields.io/badge/Version-1.0.9-blue?style=flat-square)
+![License](https://img.shields.io/badge/License-MIT-green?style=flat-square)
+[![CIAO](https://img.shields.io/badge/Philosophy-CIAO%20(Caution%20%E2%80%A2%20Intentional%20%E2%80%A2%20Anti--fragile%20%E2%80%A2%20Over--engineered)-purple.svg)](https://github.com/cloudgen/ciao)
+[![Stars](https://img.shields.io/github/stars/Wilgat/VideoSpeed?style=flat-square)](https://github.com/Wilgat/VideoSpeed)
+[![Python](https://img.shields.io/badge/Python-3.11%2B-blue?style=flat-square)]()
+[![PyPI](https://img.shields.io/pypi/v/VideoSpeed?style=flat-square)](https://pypi.org/project/VideoSpeed/)
+
+VideoSpeed cuts a time range from an MP4, changes that clip’s length (percent), and can append a reverse pass (boomerang). On a terminal, no arguments opens a text menu (edit, hello, about, Exit). Choosing edit walks through the prompts. Scripts pass `--file` / `--start` / `--end`. Encoding uses **FFmpeg**; duration probing uses **OpenCV**. The menu screen uses the default text-menu style: aligned number, verb, and note, and a rounded box along the bottom.
+
+| You | The other role | Not this |
+|-----|----------------|----------|
+| Editor at a terminal or a script | FFmpeg on `PATH` (does the encode) | A website, installer, or root/sudo tool |
+
+Package version SSOT: `src/VideoSpeed/__init__.py` (`MAJOR_VERSION`, `MINOR_VERSION`, `PATCH_VERSION` → **1.0.9**). `pyproject.toml` copies that string. Console entrypoint: `video-speed`.
+
+## Features
+
+- Recursive **MP4** discovery under a chosen folder
+- Interactive **cut** (start/end seconds) with invalid-range re-prompt
+- **Length/speed** change (**20–200%**) with A/V tempo kept in sync
+- Optional **boomerang** (forward then reverse)
+- **USB-safe** intermediate files (staged next to the output) and final publish via `shutil.move`
+- **Text menu** on a terminal (`edit`, `hello`, `about`, `Exit`): columns line up, and a three-row rounded input box sits on the bottom with a status line under it
+- **Product verbs** `help`, `about`, `hello`, `edit`, and `list-mp4`. `help` prints the same usage as `--help`. `about` and `hello` print a page and do not ask for a folder or a file. `edit` on a terminal asks for the folder, then the file. `list-mp4` lists MP4 files and does not encode. `Exit` stays on the menu. `./build.sh` verbs such as `setup` are not `video-speed` verbs
+- **`--help`** / **`--version`**; no arguments in a terminal opens that menu
+- Non-interactive job: `--file`, `--start`, `--end`, optional `--percent` / `--boomerang`, with or without `edit`. Any of those selectors with no product verb skips the menu
+- Fail-closed when **FFmpeg** is missing from `PATH`, when prompts are needed without a terminal, or when `--percent` or `--boomerang` is passed without a job
+
+## Quick Installation
+
+### Prerequisites (system)
+
+- **FFmpeg** on `PATH` (`ffmpeg -version`)
+- A supported **Python** environment (see `requires-python` in `pyproject.toml`)
+
+### From PyPI (registry channel)
+
+Package name SSOT: **`VideoSpeed`** (`pyproject.toml` `[project].name`). Maintainer verbs are on `./build.sh`: `help`, `version`, `setup`, `clean`, `build`, `test`, `test-install`, `upload`, `git`, `tag`, `release` (`all` is the same chain as `release`). `test` runs `tests/run.sh`. `test-install` reads `[project].name`, removes that pip install when present, and installs this checkout. Empty `./build.sh` prints help and does not upload.
+
+```bash
+pip install VideoSpeed
+```
+
+If the index is behind a local release, install from a checkout or wheel instead (below). Live index version is shown by the PyPI badge above.
+
+### From a git checkout (development)
+
+```bash
+git clone git@github.com:Wilgat/VideoSpeed.git
+cd VideoSpeed
+pip install -e .
+```
+
+This installs the console script **`video-speed`** and pulls Python deps (`opencv-python-headless>=5.0.0.93`, `ChronicleLogger>=1.3.1`).
+
+### Local pyenv install (testing)
+
+```sh
+./setup.sh
+pyenv shell 3.14
+video-speed --version
+```
+
+`setup.sh` runs `pyenv shell 3.14` and installs this checkout with pip into that interpreter. Install CPython 3.14 first when it is missing (`pyenv install 3.14`). Run `./setup.sh` again after source changes. In the shell where you want the command:
+
+```sh
+pyenv shell 3.14
+video-speed --help
+```
+
+The console script is installed on the pyenv 3.14 prefix. `./setup.sh` changes that interpreter only. It does not install FFmpeg and it does not use root.
+
+### From a local wheel / sdist
+
+```bash
+# after: python -m build   (or ./build.sh build)
+pip install dist/VideoSpeed-1.0.9-py3-none-any.whl
+# or
+pip install dist/VideoSpeed-1.0.9.tar.gz
+```
+
+### Verify
+
+```bash
+video-speed --version
+# or
+python -m VideoSpeed --version
+```
+
+## Usage
+
+Text menu (no arguments, in a terminal):
+
+```bash
+video-speed
+# or
+python -m VideoSpeed
+```
+
+The screen shows a numbered menu and a rounded input box along the bottom, as wide as the terminal, with one line to type on and a status line under the box. **edit** continues the prompts. **hello** (7) shows `Hello.`. **about** shows the product. **Exit** leaves.
+
+The same actions are verbs. `edit` starts at the folder question. `list-mp4` asks for the folder when it is omitted, prints the numbered list, and stops.
+
+```bash
+video-speed help
+video-speed about
+video-speed hello
+video-speed edit
+video-speed edit --folder ./clips
+video-speed edit --file clip.mp4 --start 1 --end 5 --percent 100
+video-speed list-mp4
+video-speed list-mp4 --folder ./clips
+```
+
+1. Folder containing MP4s (Enter = current directory)
+2. Choose a video by number
+3. Cut start/end seconds
+4. New length percent (default 100; allowed 20–200)
+5. Optional boomerang (y/n)
+6. Output is written **next to the source** with a descriptive name
+
+Non-interactive job (scripts / CI):
+
+```bash
+video-speed --file clip.mp4 --start 1 --end 5 --percent 100
+video-speed --file clip.mp4 --start 1 --end 5 --percent 50 --boomerang
+```
+
+Other:
+
+```bash
+video-speed --help
+video-speed --version
+```
+
+Without a terminal and without a job, the program exits with an error instead of hanging on prompts. `--percent` or `--boomerang` alone does the same and names `--file`, `--start`, and `--end`. `--folder` checks the directory. It does not pick a file.
+
+`--json` keeps that same choice, closes the text menu, and prints one JSON object on standard output. On a terminal with no job flags, the questions are written to the error stream. Progress is not mixed into the object.
+
+## Examples
+
+```bash
+# Install editable, then run interactive session in a folder of clips
+cd /path/to/videos
+video-speed
+
+# Check identity without starting prompts
+video-speed --version
+
+# One-shot job (no prompts)
+video-speed --file clip.mp4 --start 1.0 --end 5.0 --percent 100
+```
+
+Example output name shape:
+
+```text
+clip_cut1.0-5.0s_100pct.mp4
+clip_cut1.0-5.0s_50pct_BOOMERANG.mp4
+```
+
+## Platform Compatibility
+
+| Platform | Status |
+|----------|--------|
+| Linux | Primary (tested in development) |
+| macOS / Windows | Expected to work when Python, FFmpeg, and OpenCV are available |
+| Filesystems | Local disk and removable/USB volumes supported for output (temps staged beside final path) |
+
+## Related Projects
+
+- [VideoSpeed on GitHub](https://github.com/Wilgat/VideoSpeed)
+- [VideoSpeed on PyPI](https://pypi.org/project/VideoSpeed/)
+
+## Contributing
+
+Fork the repository, use a checkout install (`pip install -e .` or `./setup.sh`), and open a pull request. Prefer small, tested changes. Do not strip defensive temp/publish behavior (cross-filesystem `shutil.move`) without an explicit redesign.
+
+## License
+
+MIT License — see [`LICENSE.md`](LICENSE.md).
+
+## Last Update
+
+2026-10-01 — **1.0.9**: a non-TUI, non-JSON run shows `debug mode` when `DEBUG` is already on, and each class logs `instantiated` on the one ChronicleLogger. `def main` stays in `src/VideoSpeed/cli.py`.

videospeed-1.0.9/README.md

@@ -0,0 +1,186 @@
+# VideoSpeed - Cut, speed, and boomerang MP4 clips from the CLI
+
+![Version](https://img.shields.io/badge/Version-1.0.9-blue?style=flat-square)
+![License](https://img.shields.io/badge/License-MIT-green?style=flat-square)
+[![CIAO](https://img.shields.io/badge/Philosophy-CIAO%20(Caution%20%E2%80%A2%20Intentional%20%E2%80%A2%20Anti--fragile%20%E2%80%A2%20Over--engineered)-purple.svg)](https://github.com/cloudgen/ciao)
+[![Stars](https://img.shields.io/github/stars/Wilgat/VideoSpeed?style=flat-square)](https://github.com/Wilgat/VideoSpeed)
+[![Python](https://img.shields.io/badge/Python-3.11%2B-blue?style=flat-square)]()
+[![PyPI](https://img.shields.io/pypi/v/VideoSpeed?style=flat-square)](https://pypi.org/project/VideoSpeed/)
+
+VideoSpeed cuts a time range from an MP4, changes that clip’s length (percent), and can append a reverse pass (boomerang). On a terminal, no arguments opens a text menu (edit, hello, about, Exit). Choosing edit walks through the prompts. Scripts pass `--file` / `--start` / `--end`. Encoding uses **FFmpeg**; duration probing uses **OpenCV**. The menu screen uses the default text-menu style: aligned number, verb, and note, and a rounded box along the bottom.
+
+| You | The other role | Not this |
+|-----|----------------|----------|
+| Editor at a terminal or a script | FFmpeg on `PATH` (does the encode) | A website, installer, or root/sudo tool |
+
+Package version SSOT: `src/VideoSpeed/__init__.py` (`MAJOR_VERSION`, `MINOR_VERSION`, `PATCH_VERSION` → **1.0.9**). `pyproject.toml` copies that string. Console entrypoint: `video-speed`.
+
+## Features
+
+- Recursive **MP4** discovery under a chosen folder
+- Interactive **cut** (start/end seconds) with invalid-range re-prompt
+- **Length/speed** change (**20–200%**) with A/V tempo kept in sync
+- Optional **boomerang** (forward then reverse)
+- **USB-safe** intermediate files (staged next to the output) and final publish via `shutil.move`
+- **Text menu** on a terminal (`edit`, `hello`, `about`, `Exit`): columns line up, and a three-row rounded input box sits on the bottom with a status line under it
+- **Product verbs** `help`, `about`, `hello`, `edit`, and `list-mp4`. `help` prints the same usage as `--help`. `about` and `hello` print a page and do not ask for a folder or a file. `edit` on a terminal asks for the folder, then the file. `list-mp4` lists MP4 files and does not encode. `Exit` stays on the menu. `./build.sh` verbs such as `setup` are not `video-speed` verbs
+- **`--help`** / **`--version`**; no arguments in a terminal opens that menu
+- Non-interactive job: `--file`, `--start`, `--end`, optional `--percent` / `--boomerang`, with or without `edit`. Any of those selectors with no product verb skips the menu
+- Fail-closed when **FFmpeg** is missing from `PATH`, when prompts are needed without a terminal, or when `--percent` or `--boomerang` is passed without a job
+
+## Quick Installation
+
+### Prerequisites (system)
+
+- **FFmpeg** on `PATH` (`ffmpeg -version`)
+- A supported **Python** environment (see `requires-python` in `pyproject.toml`)
+
+### From PyPI (registry channel)
+
+Package name SSOT: **`VideoSpeed`** (`pyproject.toml` `[project].name`). Maintainer verbs are on `./build.sh`: `help`, `version`, `setup`, `clean`, `build`, `test`, `test-install`, `upload`, `git`, `tag`, `release` (`all` is the same chain as `release`). `test` runs `tests/run.sh`. `test-install` reads `[project].name`, removes that pip install when present, and installs this checkout. Empty `./build.sh` prints help and does not upload.
+
+```bash
+pip install VideoSpeed
+```
+
+If the index is behind a local release, install from a checkout or wheel instead (below). Live index version is shown by the PyPI badge above.
+
+### From a git checkout (development)
+
+```bash
+git clone git@github.com:Wilgat/VideoSpeed.git
+cd VideoSpeed
+pip install -e .
+```
+
+This installs the console script **`video-speed`** and pulls Python deps (`opencv-python-headless>=5.0.0.93`, `ChronicleLogger>=1.3.1`).
+
+### Local pyenv install (testing)
+
+```sh
+./setup.sh
+pyenv shell 3.14
+video-speed --version
+```
+
+`setup.sh` runs `pyenv shell 3.14` and installs this checkout with pip into that interpreter. Install CPython 3.14 first when it is missing (`pyenv install 3.14`). Run `./setup.sh` again after source changes. In the shell where you want the command:
+
+```sh
+pyenv shell 3.14
+video-speed --help
+```
+
+The console script is installed on the pyenv 3.14 prefix. `./setup.sh` changes that interpreter only. It does not install FFmpeg and it does not use root.
+
+### From a local wheel / sdist
+
+```bash
+# after: python -m build   (or ./build.sh build)
+pip install dist/VideoSpeed-1.0.9-py3-none-any.whl
+# or
+pip install dist/VideoSpeed-1.0.9.tar.gz
+```
+
+### Verify
+
+```bash
+video-speed --version
+# or
+python -m VideoSpeed --version
+```
+
+## Usage
+
+Text menu (no arguments, in a terminal):
+
+```bash
+video-speed
+# or
+python -m VideoSpeed
+```
+
+The screen shows a numbered menu and a rounded input box along the bottom, as wide as the terminal, with one line to type on and a status line under the box. **edit** continues the prompts. **hello** (7) shows `Hello.`. **about** shows the product. **Exit** leaves.
+
+The same actions are verbs. `edit` starts at the folder question. `list-mp4` asks for the folder when it is omitted, prints the numbered list, and stops.
+
+```bash
+video-speed help
+video-speed about
+video-speed hello
+video-speed edit
+video-speed edit --folder ./clips
+video-speed edit --file clip.mp4 --start 1 --end 5 --percent 100
+video-speed list-mp4
+video-speed list-mp4 --folder ./clips
+```
+
+1. Folder containing MP4s (Enter = current directory)
+2. Choose a video by number
+3. Cut start/end seconds
+4. New length percent (default 100; allowed 20–200)
+5. Optional boomerang (y/n)
+6. Output is written **next to the source** with a descriptive name
+
+Non-interactive job (scripts / CI):
+
+```bash
+video-speed --file clip.mp4 --start 1 --end 5 --percent 100
+video-speed --file clip.mp4 --start 1 --end 5 --percent 50 --boomerang
+```
+
+Other:
+
+```bash
+video-speed --help
+video-speed --version
+```
+
+Without a terminal and without a job, the program exits with an error instead of hanging on prompts. `--percent` or `--boomerang` alone does the same and names `--file`, `--start`, and `--end`. `--folder` checks the directory. It does not pick a file.
+
+`--json` keeps that same choice, closes the text menu, and prints one JSON object on standard output. On a terminal with no job flags, the questions are written to the error stream. Progress is not mixed into the object.
+
+## Examples
+
+```bash
+# Install editable, then run interactive session in a folder of clips
+cd /path/to/videos
+video-speed
+
+# Check identity without starting prompts
+video-speed --version
+
+# One-shot job (no prompts)
+video-speed --file clip.mp4 --start 1.0 --end 5.0 --percent 100
+```
+
+Example output name shape:
+
+```text
+clip_cut1.0-5.0s_100pct.mp4
+clip_cut1.0-5.0s_50pct_BOOMERANG.mp4
+```
+
+## Platform Compatibility
+
+| Platform | Status |
+|----------|--------|
+| Linux | Primary (tested in development) |
+| macOS / Windows | Expected to work when Python, FFmpeg, and OpenCV are available |
+| Filesystems | Local disk and removable/USB volumes supported for output (temps staged beside final path) |
+
+## Related Projects
+
+- [VideoSpeed on GitHub](https://github.com/Wilgat/VideoSpeed)
+- [VideoSpeed on PyPI](https://pypi.org/project/VideoSpeed/)
+
+## Contributing
+
+Fork the repository, use a checkout install (`pip install -e .` or `./setup.sh`), and open a pull request. Prefer small, tested changes. Do not strip defensive temp/publish behavior (cross-filesystem `shutil.move`) without an explicit redesign.
+
+## License
+
+MIT License — see [`LICENSE.md`](LICENSE.md).
+
+## Last Update
+
+2026-10-01 — **1.0.9**: a non-TUI, non-JSON run shows `debug mode` when `DEBUG` is already on, and each class logs `instantiated` on the one ChronicleLogger. `def main` stays in `src/VideoSpeed/cli.py`.

{videospeed-1.0.5 → videospeed-1.0.9}/pyproject.toml

@@ -4,10 +4,10 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "VideoSpeed"
-version = "1.0.5"
+version = "1.0.9"
 description = "A command-line video editing tool built in Python for cutting, speeding up, and applying a boomerang effect to MP4 videos."
 readme = "README.md"
-requires-python = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*"
+requires-python = ">=3.11"
 license = {text = "MIT"}
 authors = [
     {name = "Wilgat Wong", email = "wilgat.wong@gmail.com"}
@@ -15,8 +15,8 @@ authors = [
 keywords = ["Video Editing", "Multimeida"]
 
 dependencies = [
-    "ChronicleLogger>=1.2.3",
-    "opencv-python"
+    "opencv-python-headless>=5.0.0.93",
+    "ChronicleLogger>=1.3.1",
 ]
 
 # Official project links (this is what shows on PyPI!)

videospeed-1.0.9/src/VideoSpeed/__init__.py

@@ -0,0 +1,6 @@
+# Version SSOT (requirement-python-version). Do not import the CLI from here.
+MAJOR_VERSION = 1
+MINOR_VERSION = 0
+PATCH_VERSION = 9
+__version__ = "{0}.{1}.{2}".format(MAJOR_VERSION, MINOR_VERSION, PATCH_VERSION)
+__all__ = ["MAJOR_VERSION", "MINOR_VERSION", "PATCH_VERSION", "__version__"]

{videospeed-1.0.5 → videospeed-1.0.9}/src/VideoSpeed/__main__.py

@@ -1,4 +1,6 @@
+import sys
+
 from .cli import main
 
 if __name__ == "__main__":
-    main()
+    sys.exit(main() or 0)

videospeed-1.0.9/src/VideoSpeed/about_page.py

@@ -0,0 +1,201 @@
+# =============================================================================
+# About page composer.
+# requirement-python-oop — class AboutPage. Line text stays on requirement-python-about.
+# =============================================================================
+from __future__ import print_function, unicode_literals
+
+import os
+
+from .check_system import CheckSystem
+from .run_output import log_instantiated
+
+
+class AboutPage:
+    """Identity lines, install sentence, and the star box. One class, one module.
+
+    The host check is CheckSystem. This class calls that object.
+    """
+
+    def __init__(
+        self,
+        check,
+        app_name,
+        version,
+        major,
+        minor,
+        patch,
+        author,
+        updated,
+        homepage,
+        download_url,
+        usage,
+        console_name,
+        logger=None,
+    ):
+        self.logger = logger
+        log_instantiated(logger, "AboutPage")
+        self.check = check if check is not None else CheckSystem(logger=logger)
+        self.app_name = app_name
+        self.version = version
+        self.major = major
+        self.minor = minor
+        self.patch = patch
+        self.author = author
+        self.updated = updated
+        self.homepage = homepage
+        self.download_url = download_url
+        self.usage = usage
+        self.console_name = console_name
+
+    def _is_source_checkout(self, path):
+        """True when path is this package inside a source tree that has pyproject.toml."""
+        marker = "{}src{}VideoSpeed{}".format(os.sep, os.sep, os.sep)
+        if marker not in path:
+            return False
+        cursor = os.path.dirname(path)
+        for _ in range(8):
+            if os.path.isfile(os.path.join(cursor, "pyproject.toml")):
+                return True
+            parent = os.path.dirname(cursor)
+            if parent == cursor:
+                return False
+            cursor = parent
+        return False
+
+    def install_kind(self, path):
+        """
+        General Purpose: global, local, or uninstalled for an about location.
+        A source checkout is uninstalled. A copy under the home directory is local.
+        """
+        path = os.path.realpath(path)
+        parts = path.split(os.sep)
+        packaged = "site-packages" in parts or "dist-packages" in parts
+        if not packaged and self._is_source_checkout(path):
+            return "uninstalled"
+        home = os.path.realpath(os.path.expanduser("~"))
+        in_home = path == home or path.startswith(home + os.sep)
+        base = os.path.basename(path)
+        if in_home and (packaged or base in (self.console_name, self.app_name)):
+            return "local"
+        if path.startswith("/usr/") or path.startswith("/opt/") or path.startswith("/bin/"):
+            return "global"
+        if packaged and not in_home:
+            return "global"
+        return "uninstalled"
+
+    def install_sentence(self, kind):
+        """General Purpose: The location sentence inside the about box."""
+        if kind == "global":
+            return "You are using the GLOBAL INSTALLED version, location:"
+        if kind == "local":
+            return "You are using the LOCAL INSTALLED version, location:"
+        return "You are using an UNINSTALLED version, location:"
+
+    def about_box_lines(
+        self,
+        usage=None,
+        location=None,
+        kind=None,
+        homepage=None,
+        download_url=None,
+        author=None,
+        updated=None,
+    ):
+        """
+        General Purpose: Star-bordered about box.
+        An empty download URL omits the install line.
+        """
+        if usage is None:
+            usage = self.usage
+        if location is None:
+            location = self.check.self_location()
+        if kind is None:
+            kind = self.install_kind(location)
+        if homepage is None:
+            homepage = self.homepage
+        if download_url is None:
+            download_url = self.download_url
+        if author is None:
+            author = self.author
+        if updated is None:
+            updated = self.updated
+        app = self.install_sentence(kind)
+        python_exe = self.check.python_executable_name() or "python3"
+        msg1 = "{} ({}.{}.{}) by {} on {}".format(
+            self.app_name, self.major, self.minor, self.patch, author, updated
+        )
+        if download_url == "":
+            msg = [
+                msg1,
+                "",
+                app,
+                "    {}".format(location),
+                "",
+                "Basic Usage:",
+                "    {}".format(usage),
+                "",
+                "Please visit our homepage: ",
+                '    "{}"'.format(homepage),
+                "",
+                "",
+                "",
+                "",
+            ]
+        else:
+            msg = [
+                msg1,
+                "",
+                app,
+                "    {}".format(location),
+                "",
+                "Basic Usage:",
+                "    {}".format(usage),
+                "",
+                "Please visit our homepage: ",
+                '    "{}"'.format(homepage),
+                "",
+                "Installation command:",
+                "    curl -fsSL {} | {}".format(download_url, python_exe),
+                "",
+            ]
+        if download_url == "":
+            if homepage == "":
+                max_line = len(msg) - 3
+            else:
+                max_line = len(msg) - 2
+        else:
+            max_line = len(msg) - 1
+        if max_line < 1:
+            max_line = len(msg)
+        max_len = 0
+        for index in range(0, max_line):
+            if len(msg[index]) > max_len:
+                max_len = len(msg[index])
+        boxed = []
+        for index in range(0, max_line):
+            boxed.append(msg[index] + (" " * (max_len - len(msg[index]))))
+        star = "*" * (max_len + 4)
+        blank = " " * max_len
+        lines = [star, "* {} *".format(blank)]
+        for row in boxed:
+            lines.append("* {} *".format(row))
+        lines.append("* {} *".format(blank))
+        lines.append(star)
+        return lines
+
+    def framework_about(self):
+        """
+        General Purpose: About text for the menu result page.
+        requirement-python-about: identity, host check, and the install box.
+        """
+        lines = [
+            "{} {}".format(self.app_name, self.version),
+            "Domain: Cut → speed/length → optional boomerang for MP4",
+            "Runtime tools: FFmpeg (encode), OpenCV (duration probe)",
+            "Entry points: video-speed, python -m VideoSpeed",
+            "",
+        ]
+        lines.extend(self.check.check_system_lines())
+        lines.append("")
+        lines.extend(self.about_box_lines())
+        return "\n".join(lines)