VideoJoin 1.0.0__tar.gz

videojoin-1.0.0/PKG-INFO

@@ -0,0 +1,193 @@
+Metadata-Version: 2.4
+Name: VideoJoin
+Version: 1.0.0
+Summary: A logging example application with sudo detection and log rotation
+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: logging,sudo,chronicle,example
+Requires-Python: !=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,!=3.4.*,>=2.7
+Description-Content-Type: text/markdown
+Requires-Dist: ChronicleLogger>=1.0.0
+
+# VideoJoin
+
+## Overview
+
+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. It supports fast stream copying for compatible files and falls back to re-encoding for mismatches, making it ideal for quick edits without quality loss. As a Cython-optimized project, it leverages compiled extensions for efficient file scanning and subprocess handling, suitable for developers and users in media workflows .
+
+This project follows a modular structure with source code in `src/VideoJoin/`, documentation in `docs/`, and build automation via `pyproject.toml` and `build.sh` for cross-platform compatibility (Linux, macOS, Windows with adjustments)   .
+
+## Features
+
+- Interactive selection of video files from the current directory.
+- Automatic sorting and listing of eligible videos by name (case-insensitive).
+- Lossless joining via FFmpeg concat (no re-encoding when possible).
+- Fallback to high-quality re-encoding (libx264 CRF 18, AAC 192k) for incompatible formats.
+- Temporary file handling with cleanup.
+- FFmpeg dependency check on startup.
+- Cython compilation for performance boosts in I/O operations  .
+
+## Prerequisites
+
+- Python 3.6+ (recommend 3.12 for Cython compatibility; use pyenv for isolation: `curl https://pyenv.run | bash`, then `pyenv install 3.12.0` and `pyenv shell 3.12.0`) .
+- FFmpeg installed and in your PATH (download from https://ffmpeg.org/download.html).
+- C compiler (e.g., gcc on Linux/macOS, Visual Studio on Windows) for Cython builds.
+- Git for version control (recommended to initialize a repository and use `.gitignore` to exclude `__pycache__/`, `build/`, `*.so`, `.env`)    .
+
+No additional pip packages are required beyond the standard library, but for development, consider `cython` via `pip install cython` in an isolated environment  .
+
+## Installation
+
+### From Source (Recommended for Development)
+
+1. Clone or download the repository:
+   ```
+   git clone <repo-url>
+   cd VideoJoin
+   ```
+
+2. Initialize Git if starting fresh (optional but recommended):
+   ```
+   git init
+   ```
+
+3. Set up `.gitignore` to exclude build artifacts and caches:
+   ```
+   # .gitignore content
+   .env
+   __pycache__/
+   *.pyc
+   *.pyo
+   *.so
+   build/
+   ```
+       .
+
+4. Build and install in editable mode (handles Cython compilation):
+   ```
+   # Ensure pyenv or virtualenv for isolation
+   python3 -m venv venv
+   source venv/bin/activate  # On Windows: venv\Scripts\activate
+
+   # Install Cython if needed
+   pip install cython
+
+   # Build extensions
+   chmod +x build.sh
+   ./build.sh  # Or python setup.py build_ext --inplace if using setup.py
+
+   # Editable install
+   pip install -e .
+   ```
+   This compiles Cython files (e.g., `cli.pyx` if converted) into `.so` binaries in `build/lib/` and makes the package available as `VideoJoin`  .
+
+### Via pip (Packaged Release)
+
+Once published to PyPI (future), install directly:
+```
+pip3 install VideoJoin
+```
+This pulls from PyPI, installs dependencies (none beyond stdlib), and sets up the entry point for `videojoin` command or `python -m VideoJoin`  .
+
+For requirements management, create `requirements.txt` with any dev tools:
+```
+cython
+pytest  # For tests
+```
+Then `pip3 install -r requirements.txt` .
+
+## Usage
+
+### Command-Line Execution
+
+Run the tool directly from the source directory:
+```
+python -m src.VideoJoin
+```
+Or after installation:
+```
+python -m VideoJoin
+```
+(If entry point is configured in `pyproject.toml`, use `videojoin` as a script.)
+
+The tool will:
+1. Scan the current folder for video files.
+2. Prompt for selection of first and second video (prevents duplicates).
+3. Ask for output filename (defaults to `{file1} + {file2}.mp4`).
+4. Execute FFmpeg and report success/failure.
+
+Example session:
+```
+Video Joiner – WITH ORIGINAL AUDIO (using ffmpeg)
+
+Found video files:
+  1. clip1.mp4
+  2. clip2.mkv
+
+Choose FIRST video → 1
+
+Found video files:
+  1. clip2.mkv
+
+Choose SECOND video → 1
+
+Output filename [clip1 + clip2.mp4]: joined.mp4
+
+Joining with perfect audio sync:
+   clip1.mp4
+ + clip2.mkv
+ → joined.mp4
+
+Running ffmpeg (stream copy – no quality loss)…
+SUCCESS! Perfectly joined with original sound → joined.mp4
+```
+
+For batch or advanced use, extend via importing `from VideoJoin.cli import main` in scripts .
+
+### Building for Distribution
+
+- Use `python -m build` to create wheels/sdists (configured in `pyproject.toml`).
+- Cython outputs like `VideoJoin.cpython-312-x86_64-linux-gnu.so` go to `build/lib/` (gitignore them for clean repos)  .
+
+## Project Structure
+
+```
+VideoJoin/
+├── build.sh                  # POSIX build script for Cython
+├── docs/                     # Documentation
+│   ├── CHANGELOG.md
+│   ├── folder-structure.md
+│   └── VideoClip-spec.md
+├── pyproject.toml            # Build config (setuptools/Cython)
+├── README.md                 # This file
+└── src/
+    └── VideoJoin/
+        ├── cli.py            # Core logic (Cython-compatible)
+        ├── __init__.py       # Package init and version
+        └── __main__.py       # Entry point
+```
+Add `tests/` for unit tests (e.g., `test_cli.py`) and `requirements-dev.txt` for tools like pytest   .
+
+## Development
+
+- **Folder Creation**: Use `mkdir -p src/VideoJoin docs tests` for extensions .
+- **Logging/History**: The CLI uses print statements; extend with `inspect` for traceable calls if needed .
+- **Testing**: Run `pytest tests/` after setup.
+- **Versioning**: Update `__version__` in `__init__.py` and `CHANGELOG.md` per semantic rules .
+- **License**: Add `LICENSE` (e.g., MIT) for open-source use .
+
+## Troubleshooting
+
+- **FFmpeg Not Found**: Install via package manager (e.g., `apt install ffmpeg` on Ubuntu) or download binaries.
+- **Cython Build Errors**: Verify Python version with `which python3` and ensure C compiler; use `language_level=3` in directives .
+- **Permission Issues**: On Unix, `chmod +x` scripts; use virtualenv to avoid global installs.
+- **Cross-Platform**: Test paths with `pathlib`; avoid OS-specific assumptions .
+
+For issues, check `CHANGELOG.md` or open a Git issue. Contributions welcome via pull requests after Git setup   .
+
+## License
+
+MIT License (add `LICENSE` file with standard text) .

videojoin-1.0.0/README.md

@@ -0,0 +1,179 @@
+# VideoJoin
+
+## Overview
+
+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. It supports fast stream copying for compatible files and falls back to re-encoding for mismatches, making it ideal for quick edits without quality loss. As a Cython-optimized project, it leverages compiled extensions for efficient file scanning and subprocess handling, suitable for developers and users in media workflows .
+
+This project follows a modular structure with source code in `src/VideoJoin/`, documentation in `docs/`, and build automation via `pyproject.toml` and `build.sh` for cross-platform compatibility (Linux, macOS, Windows with adjustments)   .
+
+## Features
+
+- Interactive selection of video files from the current directory.
+- Automatic sorting and listing of eligible videos by name (case-insensitive).
+- Lossless joining via FFmpeg concat (no re-encoding when possible).
+- Fallback to high-quality re-encoding (libx264 CRF 18, AAC 192k) for incompatible formats.
+- Temporary file handling with cleanup.
+- FFmpeg dependency check on startup.
+- Cython compilation for performance boosts in I/O operations  .
+
+## Prerequisites
+
+- Python 3.6+ (recommend 3.12 for Cython compatibility; use pyenv for isolation: `curl https://pyenv.run | bash`, then `pyenv install 3.12.0` and `pyenv shell 3.12.0`) .
+- FFmpeg installed and in your PATH (download from https://ffmpeg.org/download.html).
+- C compiler (e.g., gcc on Linux/macOS, Visual Studio on Windows) for Cython builds.
+- Git for version control (recommended to initialize a repository and use `.gitignore` to exclude `__pycache__/`, `build/`, `*.so`, `.env`)    .
+
+No additional pip packages are required beyond the standard library, but for development, consider `cython` via `pip install cython` in an isolated environment  .
+
+## Installation
+
+### From Source (Recommended for Development)
+
+1. Clone or download the repository:
+   ```
+   git clone <repo-url>
+   cd VideoJoin
+   ```
+
+2. Initialize Git if starting fresh (optional but recommended):
+   ```
+   git init
+   ```
+
+3. Set up `.gitignore` to exclude build artifacts and caches:
+   ```
+   # .gitignore content
+   .env
+   __pycache__/
+   *.pyc
+   *.pyo
+   *.so
+   build/
+   ```
+       .
+
+4. Build and install in editable mode (handles Cython compilation):
+   ```
+   # Ensure pyenv or virtualenv for isolation
+   python3 -m venv venv
+   source venv/bin/activate  # On Windows: venv\Scripts\activate
+
+   # Install Cython if needed
+   pip install cython
+
+   # Build extensions
+   chmod +x build.sh
+   ./build.sh  # Or python setup.py build_ext --inplace if using setup.py
+
+   # Editable install
+   pip install -e .
+   ```
+   This compiles Cython files (e.g., `cli.pyx` if converted) into `.so` binaries in `build/lib/` and makes the package available as `VideoJoin`  .
+
+### Via pip (Packaged Release)
+
+Once published to PyPI (future), install directly:
+```
+pip3 install VideoJoin
+```
+This pulls from PyPI, installs dependencies (none beyond stdlib), and sets up the entry point for `videojoin` command or `python -m VideoJoin`  .
+
+For requirements management, create `requirements.txt` with any dev tools:
+```
+cython
+pytest  # For tests
+```
+Then `pip3 install -r requirements.txt` .
+
+## Usage
+
+### Command-Line Execution
+
+Run the tool directly from the source directory:
+```
+python -m src.VideoJoin
+```
+Or after installation:
+```
+python -m VideoJoin
+```
+(If entry point is configured in `pyproject.toml`, use `videojoin` as a script.)
+
+The tool will:
+1. Scan the current folder for video files.
+2. Prompt for selection of first and second video (prevents duplicates).
+3. Ask for output filename (defaults to `{file1} + {file2}.mp4`).
+4. Execute FFmpeg and report success/failure.
+
+Example session:
+```
+Video Joiner – WITH ORIGINAL AUDIO (using ffmpeg)
+
+Found video files:
+  1. clip1.mp4
+  2. clip2.mkv
+
+Choose FIRST video → 1
+
+Found video files:
+  1. clip2.mkv
+
+Choose SECOND video → 1
+
+Output filename [clip1 + clip2.mp4]: joined.mp4
+
+Joining with perfect audio sync:
+   clip1.mp4
+ + clip2.mkv
+ → joined.mp4
+
+Running ffmpeg (stream copy – no quality loss)…
+SUCCESS! Perfectly joined with original sound → joined.mp4
+```
+
+For batch or advanced use, extend via importing `from VideoJoin.cli import main` in scripts .
+
+### Building for Distribution
+
+- Use `python -m build` to create wheels/sdists (configured in `pyproject.toml`).
+- Cython outputs like `VideoJoin.cpython-312-x86_64-linux-gnu.so` go to `build/lib/` (gitignore them for clean repos)  .
+
+## Project Structure
+
+```
+VideoJoin/
+├── build.sh                  # POSIX build script for Cython
+├── docs/                     # Documentation
+│   ├── CHANGELOG.md
+│   ├── folder-structure.md
+│   └── VideoClip-spec.md
+├── pyproject.toml            # Build config (setuptools/Cython)
+├── README.md                 # This file
+└── src/
+    └── VideoJoin/
+        ├── cli.py            # Core logic (Cython-compatible)
+        ├── __init__.py       # Package init and version
+        └── __main__.py       # Entry point
+```
+Add `tests/` for unit tests (e.g., `test_cli.py`) and `requirements-dev.txt` for tools like pytest   .
+
+## Development
+
+- **Folder Creation**: Use `mkdir -p src/VideoJoin docs tests` for extensions .
+- **Logging/History**: The CLI uses print statements; extend with `inspect` for traceable calls if needed .
+- **Testing**: Run `pytest tests/` after setup.
+- **Versioning**: Update `__version__` in `__init__.py` and `CHANGELOG.md` per semantic rules .
+- **License**: Add `LICENSE` (e.g., MIT) for open-source use .
+
+## Troubleshooting
+
+- **FFmpeg Not Found**: Install via package manager (e.g., `apt install ffmpeg` on Ubuntu) or download binaries.
+- **Cython Build Errors**: Verify Python version with `which python3` and ensure C compiler; use `language_level=3` in directives .
+- **Permission Issues**: On Unix, `chmod +x` scripts; use virtualenv to avoid global installs.
+- **Cross-Platform**: Test paths with `pathlib`; avoid OS-specific assumptions .
+
+For issues, check `CHANGELOG.md` or open a Git issue. Contributions welcome via pull requests after Git setup   .
+
+## License
+
+MIT License (add `LICENSE` file with standard text) .

videojoin-1.0.0/pyproject.toml

@@ -0,0 +1,29 @@
+[build-system]
+requires = ["setuptools>=61", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "VideoJoin"
+version = "1.0.0"
+description = "A logging example application with sudo detection and log rotation"
+readme = "README.md"
+requires-python = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*"
+license = {text = "MIT"}
+authors = [
+    {name = "Wilgat Wong", email = "wilgat.wong@gmail.com"}
+]
+keywords = ["logging", "sudo", "chronicle", "example"]
+
+dependencies = [
+    "ChronicleLogger>=1.0.0",
+]
+
+# Official project links (this is what shows on PyPI!)
+[project.urls]
+Homepage = "https://github.com/Wilgat/VideoJoin"
+Repository = "https://github.com/Wilgat/VideoJoin"
+Issues = "https://github.com/Wilgat/VideoJoin/issues"
+
+# This makes `video-join` command available after pip install
+[project.scripts]
+video-join = "VideoJoin.cli:main"

videojoin-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

videojoin-1.0.0/src/VideoJoin/__init__.py

@@ -0,0 +1,4 @@
+from .cli import ChronicleLogger
+
+__version__ = "1.0.0"
+__all__ = ["ChronicleLogger"]

videojoin-1.0.0/src/VideoJoin/__main__.py

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

videojoin-1.0.0/src/VideoJoin/cli.py

@@ -0,0 +1,113 @@
+#!/usr/bin/env python
+from __future__ import print_function, unicode_literals
+# VideoJoin_with_Audio_FIXED.py – Actually keeps the sound! (2025 version)
+
+import os
+import sys
+from pathlib import Path
+import subprocess
+
+def get_mp4_files():
+    return sorted([f for f in Path('.').iterdir()
+                   if f.is_file() and f.suffix.lower() in {'.mp4', '.mov', '.mkv', '.avi', '.m4v'}],
+                  key=lambda x: x.name.lower())
+
+def show_list(files):
+    print("\nFound video files:")
+    for i, f in enumerate(files, 1):
+        print(f"  {i:2d}. {f.name}")
+    print()
+
+def choose(files, prompt):
+    while True:
+        try:
+            idx = int(input(prompt)) - 1
+            if 0 <= idx < len(files):
+                return files[idx]
+            print(f"   → Enter 1–{len(files)}")
+        except ValueError:
+            print("   → Please type a number")
+
+def create_file_list(file1, file2, list_path="filelist.txt"):
+    with open(list_path, "w", encoding="utf-8") as f:
+        f.write(f"file '{file1}'\n")
+        f.write(f"file '{file2}'\n")
+
+def main():
+    print("Video Joiner – WITH ORIGINAL AUDIO (using ffmpeg)\n")
+
+    files = get_mp4_files()
+    if len(files) < 2:
+        print("Need at least 2 video files in this folder!")
+        sys.exit(1)
+
+    show_list(files)
+    vid1 = choose(files, "Choose FIRST video → ")
+    
+    # Remove the chosen one so user doesn't pick the same twice by mistake
+    remaining = [f for f in files if f != vid1]
+    show_list(remaining)
+    vid2 = choose(remaining, "Choose SECOND video → ")
+
+    default_name = f"{vid1.stem} + {vid2.stem}.mp4"
+    out_name = input(f"\nOutput filename [{default_name}]: ").strip()
+    if not out_name:
+        out_name = default_name
+    if not out_name.lower().endswith(('.mp4', '.mkv', '.mov')):
+        out_name += '.mp4'
+
+    print(f"\nJoining with perfect audio sync:")
+    print(f"   {vid1.name}")
+    print(f" + {vid2.name}")
+    print(f" → {out_name}\n")
+
+    # Method 1: Super fast & perfect (99.9% of cases)
+    cmd = [
+        'ffmpeg', '-y',
+        '-f', 'concat',
+        '-safe', '0',
+        '-i', 'filelist.txt',
+        '-c', 'copy',           # ← no re-encoding = pixel-perfect + original audio
+        '-map', '0:v', '-map', '0:a?',   # take video + audio if exists
+        out_name
+    ]
+
+    create_file_list(vid1, vid2)
+
+    print("Running ffmpeg (stream copy – no quality loss)…")
+    result = subprocess.run(cmd, capture_output=True, text=True)
+
+    if result.returncode == 0:
+        print(f"\nSUCCESS! Perfectly joined with original sound → {out_name}")
+        print("   Play it with any player – audio is there,")
+    else:
+        print("Fast method failed (different resolutions/codec?). Trying safe re-encode...")
+        # Method 2: Safe but slightly slower (re-encodes video only when needed)
+        cmd2 = [
+            'ffmpeg', '-y',
+            '-i', str(vid1),
+            '-i', str(vid2),
+            '-filter_complex', '[0:v][0:a][1:v][1:a]concat=n=2:v=1:a=1[v][a]',
+            '-c:v', 'libx264', '-preset', 'fast', '-crf', '18',
+            '-c:a', 'aac', '-b:a', '192k',
+            '-map', '[v]', '-map', '[a]',
+            out_name
+        ]
+        subprocess.run(cmd2)
+        print(f"\nDone (with very minor re-encode) → {out_name}")
+
+    # Clean up
+    if os.path.exists("filelist.txt"):
+        os.remove("filelist.txt")
+
+if __name__ == "__main__":
+    # Simple check if ffmpeg is available
+    try:
+        subprocess.run(['ffmpeg', '-version'], capture_output=True, check=True)
+    except (subprocess.CalledProcessError, FileNotFoundError):
+        print("ERROR: ffmpeg not found!")
+        print("   Please install ffmpeg and make sure it's in your PATH")
+        print("   → https://ffmpeg.org/download.html")
+        sys.exit(1)
+
+    main()

videojoin-1.0.0/src/VideoJoin.egg-info/PKG-INFO

@@ -0,0 +1,193 @@
+Metadata-Version: 2.4
+Name: VideoJoin
+Version: 1.0.0
+Summary: A logging example application with sudo detection and log rotation
+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: logging,sudo,chronicle,example
+Requires-Python: !=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,!=3.4.*,>=2.7
+Description-Content-Type: text/markdown
+Requires-Dist: ChronicleLogger>=1.0.0
+
+# VideoJoin
+
+## Overview
+
+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. It supports fast stream copying for compatible files and falls back to re-encoding for mismatches, making it ideal for quick edits without quality loss. As a Cython-optimized project, it leverages compiled extensions for efficient file scanning and subprocess handling, suitable for developers and users in media workflows .
+
+This project follows a modular structure with source code in `src/VideoJoin/`, documentation in `docs/`, and build automation via `pyproject.toml` and `build.sh` for cross-platform compatibility (Linux, macOS, Windows with adjustments)   .
+
+## Features
+
+- Interactive selection of video files from the current directory.
+- Automatic sorting and listing of eligible videos by name (case-insensitive).
+- Lossless joining via FFmpeg concat (no re-encoding when possible).
+- Fallback to high-quality re-encoding (libx264 CRF 18, AAC 192k) for incompatible formats.
+- Temporary file handling with cleanup.
+- FFmpeg dependency check on startup.
+- Cython compilation for performance boosts in I/O operations  .
+
+## Prerequisites
+
+- Python 3.6+ (recommend 3.12 for Cython compatibility; use pyenv for isolation: `curl https://pyenv.run | bash`, then `pyenv install 3.12.0` and `pyenv shell 3.12.0`) .
+- FFmpeg installed and in your PATH (download from https://ffmpeg.org/download.html).
+- C compiler (e.g., gcc on Linux/macOS, Visual Studio on Windows) for Cython builds.
+- Git for version control (recommended to initialize a repository and use `.gitignore` to exclude `__pycache__/`, `build/`, `*.so`, `.env`)    .
+
+No additional pip packages are required beyond the standard library, but for development, consider `cython` via `pip install cython` in an isolated environment  .
+
+## Installation
+
+### From Source (Recommended for Development)
+
+1. Clone or download the repository:
+   ```
+   git clone <repo-url>
+   cd VideoJoin
+   ```
+
+2. Initialize Git if starting fresh (optional but recommended):
+   ```
+   git init
+   ```
+
+3. Set up `.gitignore` to exclude build artifacts and caches:
+   ```
+   # .gitignore content
+   .env
+   __pycache__/
+   *.pyc
+   *.pyo
+   *.so
+   build/
+   ```
+       .
+
+4. Build and install in editable mode (handles Cython compilation):
+   ```
+   # Ensure pyenv or virtualenv for isolation
+   python3 -m venv venv
+   source venv/bin/activate  # On Windows: venv\Scripts\activate
+
+   # Install Cython if needed
+   pip install cython
+
+   # Build extensions
+   chmod +x build.sh
+   ./build.sh  # Or python setup.py build_ext --inplace if using setup.py
+
+   # Editable install
+   pip install -e .
+   ```
+   This compiles Cython files (e.g., `cli.pyx` if converted) into `.so` binaries in `build/lib/` and makes the package available as `VideoJoin`  .
+
+### Via pip (Packaged Release)
+
+Once published to PyPI (future), install directly:
+```
+pip3 install VideoJoin
+```
+This pulls from PyPI, installs dependencies (none beyond stdlib), and sets up the entry point for `videojoin` command or `python -m VideoJoin`  .
+
+For requirements management, create `requirements.txt` with any dev tools:
+```
+cython
+pytest  # For tests
+```
+Then `pip3 install -r requirements.txt` .
+
+## Usage
+
+### Command-Line Execution
+
+Run the tool directly from the source directory:
+```
+python -m src.VideoJoin
+```
+Or after installation:
+```
+python -m VideoJoin
+```
+(If entry point is configured in `pyproject.toml`, use `videojoin` as a script.)
+
+The tool will:
+1. Scan the current folder for video files.
+2. Prompt for selection of first and second video (prevents duplicates).
+3. Ask for output filename (defaults to `{file1} + {file2}.mp4`).
+4. Execute FFmpeg and report success/failure.
+
+Example session:
+```
+Video Joiner – WITH ORIGINAL AUDIO (using ffmpeg)
+
+Found video files:
+  1. clip1.mp4
+  2. clip2.mkv
+
+Choose FIRST video → 1
+
+Found video files:
+  1. clip2.mkv
+
+Choose SECOND video → 1
+
+Output filename [clip1 + clip2.mp4]: joined.mp4
+
+Joining with perfect audio sync:
+   clip1.mp4
+ + clip2.mkv
+ → joined.mp4
+
+Running ffmpeg (stream copy – no quality loss)…
+SUCCESS! Perfectly joined with original sound → joined.mp4
+```
+
+For batch or advanced use, extend via importing `from VideoJoin.cli import main` in scripts .
+
+### Building for Distribution
+
+- Use `python -m build` to create wheels/sdists (configured in `pyproject.toml`).
+- Cython outputs like `VideoJoin.cpython-312-x86_64-linux-gnu.so` go to `build/lib/` (gitignore them for clean repos)  .
+
+## Project Structure
+
+```
+VideoJoin/
+├── build.sh                  # POSIX build script for Cython
+├── docs/                     # Documentation
+│   ├── CHANGELOG.md
+│   ├── folder-structure.md
+│   └── VideoClip-spec.md
+├── pyproject.toml            # Build config (setuptools/Cython)
+├── README.md                 # This file
+└── src/
+    └── VideoJoin/
+        ├── cli.py            # Core logic (Cython-compatible)
+        ├── __init__.py       # Package init and version
+        └── __main__.py       # Entry point
+```
+Add `tests/` for unit tests (e.g., `test_cli.py`) and `requirements-dev.txt` for tools like pytest   .
+
+## Development
+
+- **Folder Creation**: Use `mkdir -p src/VideoJoin docs tests` for extensions .
+- **Logging/History**: The CLI uses print statements; extend with `inspect` for traceable calls if needed .
+- **Testing**: Run `pytest tests/` after setup.
+- **Versioning**: Update `__version__` in `__init__.py` and `CHANGELOG.md` per semantic rules .
+- **License**: Add `LICENSE` (e.g., MIT) for open-source use .
+
+## Troubleshooting
+
+- **FFmpeg Not Found**: Install via package manager (e.g., `apt install ffmpeg` on Ubuntu) or download binaries.
+- **Cython Build Errors**: Verify Python version with `which python3` and ensure C compiler; use `language_level=3` in directives .
+- **Permission Issues**: On Unix, `chmod +x` scripts; use virtualenv to avoid global installs.
+- **Cross-Platform**: Test paths with `pathlib`; avoid OS-specific assumptions .
+
+For issues, check `CHANGELOG.md` or open a Git issue. Contributions welcome via pull requests after Git setup   .
+
+## License
+
+MIT License (add `LICENSE` file with standard text) .

videojoin-1.0.0/src/VideoJoin.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+README.md
+pyproject.toml
+src/VideoJoin/__init__.py
+src/VideoJoin/__main__.py
+src/VideoJoin/cli.py
+src/VideoJoin.egg-info/PKG-INFO
+src/VideoJoin.egg-info/SOURCES.txt
+src/VideoJoin.egg-info/dependency_links.txt
+src/VideoJoin.egg-info/entry_points.txt
+src/VideoJoin.egg-info/requires.txt
+src/VideoJoin.egg-info/top_level.txt

videojoin-1.0.0/src/VideoJoin.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

videojoin-1.0.0/src/VideoJoin.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+video-join = VideoJoin.cli:main

videojoin-1.0.0/src/VideoJoin.egg-info/requires.txt

@@ -0,0 +1 @@
+ChronicleLogger>=1.0.0

videojoin-1.0.0/src/VideoJoin.egg-info/top_level.txt

@@ -0,0 +1 @@
+VideoJoin