VideoJoin 1.0.2__tar.gz → 1.0.5__tar.gz

videojoin-1.0.5/LICENSE.md

@@ -0,0 +1,21 @@
+# MIT License
+
+Copyright (c) 2026 Wilgat Wong <wilgat.wong@gmail.com>
+
+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.

videojoin-1.0.5/PKG-INFO

@@ -0,0 +1,412 @@
+Metadata-Version: 2.4
+Name: VideoJoin
+Version: 1.0.5
+Summary: VideoJoin is a lightweight command-line tool for concatenating two video files (MP4, MOV, MKV, AVI, M4V) while preserving original audio and video quality using FFmpeg.
+Author-email: Wilgat Wong <wilgat.wong@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/Wilgat/VideoJoin
+Project-URL: Repository, https://github.com/Wilgat/VideoJoin
+Project-URL: Issues, https://github.com/Wilgat/VideoJoin/issues
+Keywords: Video Editing,Video,Multimedia
+Requires-Python: !=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,!=3.4.*,>=2.7
+Description-Content-Type: text/markdown
+License-File: LICENSE.md
+Requires-Dist: ChronicleLogger>=1.3.1
+Dynamic: license-file
+
+# VideoJoin - Join two local videos with FFmpeg (stream-copy first)
+
+![Version](https://img.shields.io/badge/Version-1.0.5-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/VideoJoin?style=flat-square)](https://github.com/Wilgat/VideoJoin)
+[![Python](https://img.shields.io/badge/Python-2.7%2B%20(3.x%20recommended)-blue?style=flat-square)]()
+[![PyPI](https://img.shields.io/pypi/v/VideoJoin?style=flat-square)](https://pypi.org/project/VideoJoin/)
+
+VideoJoin concatenates **two** video files from the current directory using **FFmpeg**. It prefers **stream copy** (no re-encode when possible) and **fail-closed re-encode fallback** when copy fails. Intermediate files are staged next to the output path when possible and published with **`shutil.move`** for multi-mount safety (for example USB).
+
+On a terminal, starting it with no arguments opens a text menu. You pick **join** when you want to choose the two files. The menu does not start that job by itself, and it does not call pip.
+
+## Features
+
+- Text menu on a terminal: **join**, **system-log**, **language**, **self-management**, and **Exit**
+- The first row shows the current folder and a local clock (`HH:MM:SS`) when the row has room
+- Numbered rows line up. A rounded input box sits along the bottom, as wide as the terminal, with the name and version on the status line under the box
+- **system-log** (3) opens view-log, clear-log, and log-folder. **language** (4) picks the menu language. **self-management** (8) opens version, about, and the pip lifecycle rows
+- Interactive pick of first and second video (same file cannot be chosen twice)
+- Discovers `.mp4`, `.mov`, `.mkv`, `.avi`, `.m4v` in the **current working directory** (sorted case-insensitively)
+- Stream-copy join first (`ffmpeg` concat demuxer); re-encode fallback (`libx264` CRF 18, AAC 192k)
+- Fail-closed: no success message if both paths fail
+- Unique temp list + media intermediates; cleanup on success and failure
+- Publish intermediates with `shutil.move` (same FS rename; cross-mount copy+delete)
+- FFmpeg on `PATH` checked before joining
+- Console script `video-join` and module entry `python -m VideoJoin`
+- Typed verbs: `help`, `version`, `about`, `hello`, `join`, `list-videos`, `self-install`, `version-check`, `self-update`, `self-uninstall`
+
+## Advantages
+
+1. **Dual-mode interface.** The menu asks for two indexes and an output name. A typed `join` asks the same questions. The person does not write an FFmpeg concat graph. The program tries stream copy, then re-encodes if copy fails. There is no length percent, no boomerang, and no `--json`. With no arguments on a terminal, the text menu opens. With no terminal and no verb, the program prints help and returns 0. Direct `join` with no terminal exits non-zero.
+2. **Built-in languages.** Row **4** lists thirteen languages: English, Simplified Chinese, Traditional Chinese, Spanish, Arabic, French, Portuguese, Russian, German, Japanese, Korean, Dutch, and Greek. The choice is saved for the next run.
+3. **USB-safe staging.** Intermediate files are written beside the output when that folder can be written, including on a removable drive. The finished file is published with `shutil.move`. When that folder cannot be written, the stage uses the system temporary directory.
+4. **Lifecycle and diagnostics.** `version-check`, `self-update`, `self-install`, and `self-uninstall` are menu rows **84**–**87** and typed verbs. `self-uninstall` on the command line needs `--force`. They call pip and do not use root. **system-log** (**3**) views a log, clears a log, and shows the log folder. **about** (**83**) stays in English.
+
+| Feature | Raw FFmpeg CLI | Typical Python wrappers (moviepy) | VideoJoin |
+|---------|----------------|-----------------------------------|-----------|
+| Learning curve | A concat graph the person writes | A Python script | Text menu, or two file numbers and an output name |
+| Non-interactive | Native command line | A custom script | Typed verbs. No terminal and no verb: help, return 0. Direct `join` with no terminal: non-zero. No `--json` |
+| Menu languages | None | None | Thirteen, kept for the next run |
+| Temporary files | You choose the paths | Often the system temporary directory | Beside the output when that folder can be written. Otherwise the system temporary directory. Publish with `shutil.move` |
+| Self-management | The system package manager | pip from outside the tool | Built-in version-check, self-update, self-install, and self-uninstall |
+| Diagnostics and logs | The encode stream | A logging setup in the script | system-log (row 3) and about (83), in English |
+
+## Quick Installation
+
+**System requirement:** [FFmpeg](https://ffmpeg.org/download.html) must be installed and available as `ffmpeg` on your `PATH`. The package does **not** install FFmpeg via pip.
+
+**Python dependency:** `ChronicleLogger>=1.3.1` (required). Pip installs it with VideoJoin.
+
+### PyPI (registry)
+
+```bash
+pip install VideoJoin
+```
+
+This installs the console entry **`video-join`** and the package **`VideoJoin`**. Packaging name SSOT is `pyproject.toml` `[project].name` = `VideoJoin`. This tree is **1.0.5**. A registry probe on 2026-08-19 reported **1.0.3**. The PyPI badge above shows the live index.
+
+### Local install (checkout)
+
+From a checkout (editable / unreleased work):
+
+```bash
+git clone https://github.com/Wilgat/VideoJoin.git
+cd VideoJoin
+python3 -m venv venv
+source venv/bin/activate   # Windows: venv\Scripts\activate
+pip install -e .
+```
+
+### Main menu
+
+After install, on a terminal, `video-join` with no arguments prints this screen. The verb is bold and the note after the colon is italic. `9` leaves. `0` on a submenu goes back. After a command finishes, the main menu is shown again. A number that is not on the list prints an error and lets you choose again.
+
+Picture of the English menu. Current directory `/tmp/clips`. The rows are the text the menu paints. The frame is the 80-column box.
+
+```text
+$ video-join
+Path: /tmp/clips                                                       12:06:45
+
+1. **join**           : *pick two videos in this folder and concatenate*
+3. **system-log**     : *view, clear, and the log folder*
+4. **language**       : *display language for this menu*
+8. **self-management**: *version, about, and pip lifecycle*
+9. **Exit**           : *leave*
+
+
+
+
+╭─────────────────────────────────────────────────────────────────────────────╮
+│ >                                                                           │
+╰─────────────────────────────────────────────────────────────────────────────╯
+  VideoJoin 1.0.4  │  main menu  │  Up/Down  •  Enter
+```
+
+**system-log** (3):
+
+```text
+Path: /tmp/clips                                                       12:06:45
+
+31. **view-log**  : *list a log file and show it*
+32. **clear-log** : *empty one log file*
+33. **log-folder**: *show the log folder*
+ 0. **Back**      : *return to the main menu*
+
+
+
+
+╭─────────────────────────────────────────────────────────────────────────────╮
+│ >                                                                           │
+╰─────────────────────────────────────────────────────────────────────────────╯
+  VideoJoin 1.0.4  │  system-log  │  Up/Down  •  Enter
+```
+
+**language** (4). The short on each language row is that language’s own name. Numbers 40 and 54–59 are not printed. `0` goes back and does not save.
+
+```text
+Path: /tmp/clips                                                       12:06:46
+
+41. **English**   : *use English for this menu*
+42. **简体中文**      : *use 简体中文 for this menu*
+43. **繁體中文**      : *use 繁體中文 for this menu*
+44. **Español**   : *use Español for this menu*
+45. **العربية**   : *use العربية for this menu*
+46. **Français**  : *use Français for this menu*
+47. **Português** : *use Português for this menu*
+48. **Русский**   : *use Русский for this menu*
+49. **Deutsch**   : *use Deutsch for this menu*
+50. **日本語**       : *use 日本語 for this menu*
+51. **한국어**       : *use 한국어 for this menu*
+52. **Nederlands**: *use Nederlands for this menu*
+53. **Ελληνικά**  : *use Ελληνικά for this menu*
+ 0. **Back**      : *return to the main menu*
+
+╭─────────────────────────────────────────────────────────────────────────────╮
+│ >                                                                           │
+╰─────────────────────────────────────────────────────────────────────────────╯
+  VideoJoin 1.0.4  │  language  │  Up/Down  •  Enter
+```
+
+**self-management** (8):
+
+```text
+Path: /tmp/clips                                                       14:05:09
+
+82. **version**       : *show the installed version*
+83. **about**         : *version, FFmpeg, and this computer*
+84. **version-check** : *compare this install with pip*
+85. **self-update**   : *upgrade this package with pip*
+86. **self-uninstall**: *remove this package with pip*
+87. **self-install**  : *install this package with pip*
+ 0. **Back**          : *return to the main menu*
+
+╭─────────────────────────────────────────────────────────────────────────────╮
+│ >                                                                           │
+╰─────────────────────────────────────────────────────────────────────────────╯
+  VideoJoin 1.0.5  │  self-management  │  Up/Down  •  Enter
+```
+
+Choose a number, or type the command name in the box. The block caret appears in that box while it is focused.
+
+## Usage
+
+```bash
+video-join
+# or
+python -m VideoJoin
+```
+
+On a terminal, that opens the main menu above. It does not ask for videos yet, and it does not call pip. With no terminal, the same command prints help and returns 0.
+
+**join** (1), or `video-join join` on a terminal, stays on the screen and asks in the bottom box:
+
+1. First video number
+2. Second video number from the remaining list
+3. Output name (Enter uses `{stem1} + {stem2}.mp4`)
+
+Esc returns to the main menu and does not join. Fewer than two eligible videos fails closed: FFmpeg does not run. `video-join join` with no terminal exits non-zero and tells you to use a terminal.
+
+```bash
+video-join help
+video-join version
+video-join about
+video-join hello
+video-join list-videos
+video-join version-check
+video-join self-update
+video-join self-install
+video-join self-uninstall --force
+```
+
+`version` prints `VideoJoin 1.0.5` and does not call pip. `about` shows one English page: the product identity, a host check of this computer, and a star box. It does not install FFmpeg and it does not call pip. `hello` prints a one-line greeting and does not draw the menu. `list-videos` lists eligible names and does not join. `help` prints usage.
+
+`version-check` runs `python -m pip index versions VideoJoin`. `self-update` runs `python -m pip install --upgrade VideoJoin`. `self-install` runs `python -m pip install VideoJoin`. `self-uninstall` runs `python -m pip uninstall -y VideoJoin` and needs `--force` on the command line. Those pip verbs do not use sudo. Empty arguments do not install or update.
+
+Exit codes: non-zero if join is started with no terminal, fewer than two videos, FFmpeg is missing, or the join fails. Menu **Exit** (9) returns 0.
+
+Import for scripts (thin entry):
+
+```python
+from VideoJoin import main
+# interactive session; a terminal opens the text menu
+```
+
+## Screenshots
+
+Each heading is the file name. The paragraph is what that picture shows: the words on the screen, the characters in the input box, or the scene. Package **1.0.5**. Menu pictures captured before the about page still show **1.0.4** where the paragraph says so. The package index can fetch a picture only after that file is on the public `main` branch.
+
+### `language-menu.png`
+
+Row **4** has opened the language list. **41 English** is highlighted, with the note "use English for this menu." The other rows are **42 简体中文**, **43 繁體中文**, **44 Español**, **45 العربية**, **46 Français**, **47 Português**, **48 Русский**, **49 Deutsch**, **50 日本語**, **51 한국어**, **52 Nederlands**, and **53 Ελληνικά**. Each note says to use that language for this menu. **0 Back** says "return to the main menu." The path label is `Path`. The clock is on the right of that row. The status line says `language`. VideoJoin 1.0.4.
+
+![Language list, 41 English highlighted](https://raw.githubusercontent.com/Wilgat/VideoJoin/main/screenshots/language-menu.png)
+
+### `main-menu-en.png`
+
+English main menu. There is no saved-language line above the box. The path label is `Path`. The clock is on the right of that row. **1 join** is highlighted: "pick two videos in this folder and concatenate." Then **3 system-log** "view, clear, and the log folder," **4 language** "display language for this menu," **8 self-management** "version, about, and pip lifecycle," and **9 Exit** "leave." The status line says `main menu`.
+
+![English main menu](https://raw.githubusercontent.com/Wilgat/VideoJoin/main/screenshots/main-menu-en.png)
+
+### `main-menu-zh-hans.png`
+
+Simplified Chinese main menu. The line above the box says `菜单语言是简体中文`. The path label is `路径`. The clock is on the right of that row. **1 join** is highlighted and stays `join`. **3** is `系统日志`, **4** is `语言`, **8** is `自我管理`, and **9** is `离开`. The status line says `主菜单`.
+
+![Simplified Chinese main menu](https://raw.githubusercontent.com/Wilgat/VideoJoin/main/screenshots/main-menu-zh-hans.png)
+
+### `main-menu-zh-hant.png`
+
+Traditional Chinese main menu. The line above the box says `選單語言是繁體中文`. The path label is `路徑`. The clock is on the right of that row. **1 join** is highlighted and stays `join`. **3** is `系統日誌`, **4** is `語言`, **8** is `自我管理`, and **9** is `離開`. The status line says `主選單`.
+
+![Traditional Chinese main menu](https://raw.githubusercontent.com/Wilgat/VideoJoin/main/screenshots/main-menu-zh-hant.png)
+
+### `main-menu-es.png`
+
+Spanish main menu. The line above the box says `El idioma del menú es español`. The path label is `Ruta`. The clock is on the right of that row. **1 join** is highlighted and stays `join`. **3** is `registro`, **4** is `idioma`, **8** is `autogestión`, and **9** is `Salir`. The status line says `menú principal`.
+
+![Spanish main menu](https://raw.githubusercontent.com/Wilgat/VideoJoin/main/screenshots/main-menu-es.png)
+
+### `main-menu-ar.png`
+
+Arabic main menu. The line above the box says `لغة القائمة هي العربية`. The path label is `المسار`. The clock is on the right of that row. The numbers stay on the left. Arabic words on each row are shaped and read right to left. **1 join** is highlighted and stays `join`. **3** is `سجل النظام`, **4** is `لغة`, **8** is `إدارة ذاتية`, and **9** is `خروج`. The status line says `القائمة الرئيسية`.
+
+![Arabic main menu](https://raw.githubusercontent.com/Wilgat/VideoJoin/main/screenshots/main-menu-ar.png)
+
+### `main-menu-fr.png`
+
+French main menu. The line above the box says `La langue du menu est le français`. The path label is `Chemin`. The clock is on the right of that row. **1 join** is highlighted and stays `join`. **3** is `journal`, **4** is `langue`, **8** is `autogestion`, and **9** is `Quitter`. The status line says `menu principal`.
+
+![French main menu](https://raw.githubusercontent.com/Wilgat/VideoJoin/main/screenshots/main-menu-fr.png)
+
+### `main-menu-pt.png`
+
+Portuguese main menu. The line above the box says `O idioma do menu é português`. The path label is `Caminho`. The clock is on the right of that row. **1 join** is highlighted and stays `join`. **3** is `registo`, **4** is `idioma`, **8** is `autogestão`, and **9** is `Sair`. The status line says `menu principal`.
+
+![Portuguese main menu](https://raw.githubusercontent.com/Wilgat/VideoJoin/main/screenshots/main-menu-pt.png)
+
+### `main-menu-ru.png`
+
+Russian main menu. The line above the box says `Язык меню — русский`. The path label is `Путь`. The clock is on the right of that row. **1 join** is highlighted and stays `join`. **3** is `системный журнал`, **4** is `язык`, **8** is `самоуправление`, and **9** is `Выход`. The status line says `главное меню`.
+
+![Russian main menu](https://raw.githubusercontent.com/Wilgat/VideoJoin/main/screenshots/main-menu-ru.png)
+
+### `main-menu-de.png`
+
+German main menu. The line above the box says `Die Menüsprache ist Deutsch`. The path label is `Pfad`. The clock is on the right of that row. **1 join** is highlighted and stays `join`. **3** is `Systemprotokoll`, **4** is `Sprache`, **8** is `Selbstverwaltung`, and **9** is `Beenden`. The status line says `Hauptmenü`.
+
+![German main menu](https://raw.githubusercontent.com/Wilgat/VideoJoin/main/screenshots/main-menu-de.png)
+
+### `main-menu-ja.png`
+
+Japanese main menu. The line above the box says `メニューの言語は日本語`. The path label is `パス`. The clock is on the right of that row. **1 join** is highlighted and stays `join`. **3** is `システムログ`, **4** is `言語`, **8** is `自己管理`, and **9** is `終了`. The status line says `メインメニュー`.
+
+![Japanese main menu](https://raw.githubusercontent.com/Wilgat/VideoJoin/main/screenshots/main-menu-ja.png)
+
+### `main-menu-ko.png`
+
+Korean main menu. The line above the box says `메뉴 언어는 한국어`. The path label is `경로`. The clock is on the right of that row. **1 join** is highlighted and stays `join`. **3** is `시스템 로그`, **4** is `언어`, **8** is `자기관리`, and **9** is `종료`. The status line says `주 메뉴`.
+
+![Korean main menu](https://raw.githubusercontent.com/Wilgat/VideoJoin/main/screenshots/main-menu-ko.png)
+
+### `main-menu-nl.png`
+
+Dutch main menu. The line above the box says `De menutaal is Nederlands`. The path label is `Pad`. The clock is on the right of that row. **1 join** is highlighted and stays `join`. **3** is `systeemlog`, **4** is `taal`, **8** is `zelfbeheer`, and **9** is `Afsluiten`. The status line says `hoofdmenu`.
+
+![Dutch main menu](https://raw.githubusercontent.com/Wilgat/VideoJoin/main/screenshots/main-menu-nl.png)
+
+### `main-menu-el.png`
+
+Greek main menu. The line above the box says `Η γλώσσα του μενού είναι ελληνικά`. The path label is `Διαδρομή`. The clock is on the right of that row. **1 join** is highlighted and stays `join`. **3** is `αρχείο καταγραφής`, **4** is `γλώσσα`, **8** is `αυτοδιαχείριση`, and **9** is `Έξοδος`. The status line says `κύριο μενού`.
+
+![Greek main menu](https://raw.githubusercontent.com/Wilgat/VideoJoin/main/screenshots/main-menu-el.png)
+
+### `join-first.png`
+
+Join, first question. The title is `VideoJoin (1.0.4) — join`. The page says "Join two videos in this folder." and "Esc returns to the menu." The list is `1. clip-a.mp4` and `2. clip-b.mp4`. The prompt is "Choose FIRST video →". The input box contains `1` and the block caret. The status line says `join`. There is no clock on this page.
+
+![Choose the first video, 1 typed](https://raw.githubusercontent.com/Wilgat/VideoJoin/main/screenshots/join-first.png)
+
+### `join-second.png`
+
+Join, second question. The title is `VideoJoin (1.0.4) — join`. The remaining list is `1. clip-b.mp4`. The prompt is "Choose SECOND video →". The input box contains `1` and the block caret. The status line says `join`.
+
+![Choose the second video, 1 typed for clip-b.mp4](https://raw.githubusercontent.com/Wilgat/VideoJoin/main/screenshots/join-second.png)
+
+### `join-output.png`
+
+Join, output name. The page says "Joining:", then `clip-a.mp4`, then `+ clip-b.mp4`, then "Output filename [clip-a + clip-b.mp4]:". The input box is empty except for the block caret, so the bracketed default stands. The status line says `join`.
+
+![Output name, default clip-a + clip-b.mp4, box empty](https://raw.githubusercontent.com/Wilgat/VideoJoin/main/screenshots/join-output.png)
+
+### `join-done.png`
+
+The join has finished by stream copy. The page says "Joining with perfect audio sync:", lists `clip-a.mp4` and `clip-b.mp4`, then "→ clip-a + clip-b.mp4", then "Staging dir → .", then "Running ffmpeg (stream copy – no quality loss)…", then "SUCCESS! Perfectly joined with original sound → clip-a + clip-b.mp4". The footer says "Press a key to return to the main menu." The input box is empty. The status line says `join`.
+
+![Stream-copy join of clip-a.mp4 and clip-b.mp4 succeeded](https://raw.githubusercontent.com/Wilgat/VideoJoin/main/screenshots/join-done.png)
+
+### `self-management.png`
+
+Row **8** has opened self-management. **82 version** is highlighted: "show the installed version." Then **83 about** "version, FFmpeg, and this computer", **84 version-check** "compare this install with pip", **85 self-update** "upgrade this package with pip", **86 self-uninstall** "remove this package with pip", **87 self-install** "install this package with pip", and **0 Back** "return to the main menu." The path label is `Path`. The path is `/tmp/clips`. The clock is `14:05:09` on the right of that row. The status line says `VideoJoin 1.0.5` and `self-management`.
+
+![Self-management, 82 version highlighted](https://raw.githubusercontent.com/Wilgat/VideoJoin/main/screenshots/self-management.png)
+
+### `tui-about.png`
+
+**about** (83) on the result page. The title is `VideoJoin (1.0.5) — result`. The page prints `VideoJoin 1.0.5`, `Domain: Concatenate two local videos with FFmpeg (copy, then fallback)`, `Runtime tools: FFmpeg (copy, then re-encode)`, and `Entry points: video-join, python -m VideoJoin`. The host check is stamped `2026-10-04 21:14:59.669782` and headed `[CHECK SYSTEM]:`. Visible lines include Python 3.12.11, C Library GCC 13.3.0, Ubuntu 24.04.5 LTS, amd64, the current user, the shell, the Python executable, python2 location, python3 location, conda location, pyenv location, `Inside docker container: False`, and `Cython String: cpython-312-x86_64-linux-gnu`. The footer says `Up/Down scrolls this page.` and `Press a key to return to the main menu.` There is no input box and no clock. The page stays in English.
+
+![About host check, English](https://raw.githubusercontent.com/Wilgat/VideoJoin/main/screenshots/tui-about.png)
+
+### `system-log.png`
+
+Row **3** has opened system-log. **31 view-log** is highlighted: "list a log file and show it." Then **32 clear-log** "empty one log file", **33 log-folder** "show the log folder", and **0 Back** "return to the main menu." The path label is `Path`. The clock is on the right of that row. The status line says `system-log`.
+
+![System log, 31 view-log highlighted](https://raw.githubusercontent.com/Wilgat/VideoJoin/main/screenshots/system-log.png)
+
+### `video.png`
+
+A still picture, not a text-menu capture. A woman with long brown hair, in a grey shirt with a small blue mark, sits at a round wooden table and holds a white cup. An open book with a worn cover and a metal clasp lies on the table. Behind her are a beige sofa, a wide window onto trees, a potted plant, and a wooden floor in daylight.
+
+![Woman at a table with an open book and a cup](https://raw.githubusercontent.com/Wilgat/VideoJoin/main/screenshots/video.png)
+
+## Examples
+
+```bash
+cd /path/to/folder/with/clips
+video-join
+```
+
+```bash
+video-join version
+```
+
+`version` prints `VideoJoin 1.0.5` and does not call pip. A run that is not the text menu can also print ChronicleLogger status lines above that. The text menu keeps those lines off the screen.
+
+```bash
+video-join join
+```
+
+The menu pictures are in Screenshots. Join still prefers stream copy, then re-encode, and publishes the result with `shutil.move`.
+
+## Platform Compatibility
+
+| Platform | Status |
+|----------|--------|
+| Linux | Primary; tested development path |
+| macOS | Supported when Python + FFmpeg on PATH |
+| Windows | Supported when Python + FFmpeg on PATH (venv activate differs) |
+| Architectures | Any with CPython + FFmpeg binary |
+
+The text menu needs a terminal. With no terminal and no verb, the program prints help and returns 0. It does not wait.
+
+## Related Projects
+
+- [VideoJoin on GitHub](https://github.com/Wilgat/VideoJoin) — this program’s source
+- [VideoJoin on PyPI](https://pypi.org/project/VideoJoin/) — this program on PyPI
+- [AnimeDlp](https://github.com/Wilgat/AnimeDlp) — command-line downloader for anime video sites
+- [ChronicleLogger](https://github.com/Wilgat/ChronicleLogger) — status logger this program depends on (`ChronicleLogger>=1.3.1`)
+- [VideoSpeed](https://github.com/Wilgat/VideoSpeed) — cuts, changes speed, and boomerangs a clip. That program is not this one
+- [CIAO](https://github.com/cloudgen/ciao) — Caution, Intentional, Anti-fragile, Over-engineered
+- [CIAO-Lite](https://github.com/cloudgen/ciao-lite) — short agent contract
+- [safe-rm](https://github.com/cloudgen/safe-rm) — guarded `rm`
+
+## Contributing
+
+1. Keep product law under `docs/requirements/` in sync when behavior changes.
+2. Prefer small, CIAO-safe changes; do not remove Protection Zones in the join publish path (staging / `shutil.move`) without explicit design.
+3. Version dual SSOT: bump **`pyproject.toml`** and **`src/VideoJoin/__init__.__version__`** together.
+4. Open issues and pull requests on GitHub.
+
+## License
+
+MIT — see [`LICENSE.md`](./LICENSE.md). Also declared in `pyproject.toml`.
+
+## Last Update
+
+2026-10-04 — **1.0.5**: the about page names this build, this computer, and where the program is running from. Self-management row 83 says "version, FFmpeg, and this computer." Those two pictures were recaptured. The other menu pictures still show **1.0.4**. Version badge matches `pyproject.toml` and `__version__`. `ChronicleLogger>=1.3.1` is required.