segmenta-archiver 0.1.2__tar.gz

segmenta_archiver-0.1.2/.github/workflows/publish.yml

@@ -0,0 +1,34 @@
+name: Publish Package
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  id-token: write
+
+jobs:
+  build-and-publish:
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/segmenta-archiver
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+
+      - name: Build distributions
+        run: uv build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

segmenta_archiver-0.1.2/.gitignore

@@ -0,0 +1,39 @@
+# Python
+__pycache__/
+*.py[cod]
+*.pyo
+*.pyd
+*.so
+
+# Packaging / build artifacts
+build/
+dist/
+*.egg-info/
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# Tooling caches
+.ruff_cache/
+.mypy_cache/
+.pytest_cache/
+
+# Editors / OS
+.vscode/
+.idea/
+.DS_Store
+Thumbs.db
+
+# Local media files (avoid accidental commits)
+*.ts
+*.mp4
+*.mkv
+*.mov
+*.avi
+*.flv
+*.webm
+
+# Temporary artifacts produced by app
+filelist.txt

segmenta_archiver-0.1.2/LICENSE

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

segmenta_archiver-0.1.2/PKG-INFO

@@ -0,0 +1,10 @@
+Metadata-Version: 2.4
+Name: segmenta-archiver
+Version: 0.1.2
+Summary: Batch merge and transcode timestamped .ts recordings into organized H.265 archives
+License-File: LICENSE
+Requires-Python: >=3.10
+Requires-Dist: av>=9.0.0
+Requires-Dist: pillow>=9.2.0
+Requires-Dist: pymediainfo>=4.3
+Requires-Dist: typer>=0.15.0

segmenta_archiver-0.1.2/README.md

@@ -0,0 +1,175 @@
+![Logo](logo.png)
+
+**Segmenta** is a high-performance media utility designed to help you turn messy stream segments into a polished personal archive. It automatically groups, merges, and transcodes timestamped `.ts` files into organized H.265 (`.mp4`) libraries.
+
+![Python >=3.10](https://img.shields.io/badge/python-3.10%2B-blue)
+![FFmpeg required](https://img.shields.io/badge/ffmpeg-required-orange)
+![Scope local files only](https://img.shields.io/badge/scope-local%20files%20only-green)
+
+---
+
+## ✨ Why Segmenta?
+
+If you record live sessions from platforms like **Twitch**, **YouTube**, or use **OBS** split recordings, you often end up with dozens of `.ts` chunks. **Segmenta** automates the tedious work:
+
+- 🧵 **Smart Merging**: Groups files by source and date, then joins them in perfect chronological order.
+- ⚡ **GPU Accelerated**: Prefers your NVIDIA (NVENC), Intel (QSV), or AMD (AMF) hardware for blazing-fast HEVC encoding.
+- 📁 **Auto-Organization**: Creates beautifully named folders and files based on your preferences.
+- 📊 **Real-time Progress**: A live ASCII progress bar keeps you updated on the transcoding status.
+- 🖼️ **Preview Sheets by Default**: After each output `.mp4`, Segmenta generates a thumbnail sheet preview with a full metadata header.
+
+---
+
+## ⚖️ Disclaimer & Scope
+
+**Segmenta is intended for legal and personal archival purposes only.**
+
+- **Local Files Only**: This tool strictly processes files already present on your local disk.
+- **No Downloading**: It does not contain functionality to record, download, or scrape streams from any platform.
+- **User Responsibility**: Users are solely responsible for ensuring they have the legal right to process, transcode, and store the media files they use with this tool. Please respect the Terms of Service of the platforms you use.
+
+---
+
+## 🚀 Quick Start
+
+### 1. Installation
+
+Install Segmenta as a global tool using [uv](https://github.com/astral-sh/uv):
+
+```bash
+uv tool install .
+```
+
+### 2. Prepare Your Files
+
+Ensure your input files follow this pattern: `<source>_YYYY-MM-DD_HH-MM-SS.ts`
+
+**Example:**
+- `shroud_2026-03-22_09-06-01.ts`
+- `shroud_2026-03-22_12-53-01.ts`
+
+### 3. Run the Archiver
+
+Simply point Segmenta to your recordings folder:
+
+```bash
+segmenta "C:\Recordings\Twitch" --source twitch
+```
+
+By default, each successful output also creates a preview image in the same folder:
+
+- Output video: `.../<folder-name>.mp4`
+- Preview sheet: `.../<folder-name>_preview.jpg`
+
+---
+
+## 🛠️ Advanced Customization
+
+### Naming Templates
+
+Fully control your archive structure with the `--name-template` option. 
+
+**Example:**
+```bash
+segmenta "E:\VODs" --name-template "[{source_label}] {source} - {date_iso} [{resolution}]"
+```
+
+Available variables:
+- `{source_label}`: The platform name (e.g., Twitch, YouTube Live).
+- `{source}`: The creator or channel name parsed from the file.
+- `{show}`: Custom session label (default: "Session").
+- `{month_abbr}`, `{day}`, `{year}`: Date components.
+- `{date_iso}`: The full date (YYYY-MM-DD).
+- `{resolution}`: The detected video height (e.g., 1080p).
+
+Run `segmenta --print-template-vars` for a full list of options.
+
+### Encoder Options
+
+Segmenta automatically detects and prefers GPU encoders. You can manually override this:
+
+```bash
+# Force CPU (high quality, slow)
+segmenta "input" --encoder cpu --crf 22
+
+# Force NVIDIA NVENC
+segmenta "input" --encoder nvenc --cq 24
+```
+
+### Preview Sheet Generation
+
+Preview generation is enabled by default and runs on the resulting `.mp4` file.
+
+- Default layout: `3 x 9` tiles
+- Tile width: `400px`
+- Styling: black background, full technical header, per-tile timestamps
+- Performance mode: fast keyframe sampling with multithreaded decode and FFmpeg scaling
+
+Disable preview generation if needed:
+
+```bash
+segmenta "input" --no-thumbnail
+```
+
+### Source File Deletion
+
+Segmenta no longer prompts interactively to delete source `.ts` files.
+
+- Source files are kept by default.
+- To delete processed source files explicitly, use:
+
+```bash
+segmenta "input" --delete-original
+```
+
+- `--keep-ts` always preserves source files, even if `--delete-original` is set.
+
+---
+
+## 🌐 Supported Source Presets
+
+Segmenta comes with built-in labels for many popular platforms:
+
+- **General**: `platform`, `obs`, `custom`
+- **Social**: `twitch`, `youtube-live`, `kick`, `tiktok-live`, `rumble`, `vimeo-livestream`
+- **Archive Compatible**: `chaturbate`, `stripchat`, `camsoda`, and many more.
+
+*Run `segmenta --help` to see the full list of supported presets. Use `--source custom --source-label "My App"` for unsupported platforms.*
+
+---
+
+## 📝 Requirements
+
+- **Python 3.10+**
+- **FFmpeg & FFprobe**: Must be installed and available in your system `PATH`.
+
+---
+
+## 📦 Publishing (PyPI + GitHub)
+
+Segmenta is published as a standard Python package and can be installed as a `uv` tool.
+
+### Install after publish
+
+```bash
+uv tool install segmenta-archiver
+```
+
+### Release flow
+
+1. Bump version in `pyproject.toml` and `src/segmenta/__init__.py`.
+2. Create and push a Git tag (for example `v0.1.2`).
+3. Create a GitHub Release from that tag.
+4. GitHub Actions will build with `uv build` and publish to PyPI automatically.
+
+### One-time PyPI setup (Trusted Publishing)
+
+In PyPI project settings, add a trusted publisher with:
+
+- **Owner**: your GitHub org/user
+- **Repository**: `segmenta` repository name
+- **PyPI Project Name**: `segmenta-archiver`
+- **Workflow**: `.github/workflows/publish.yml`
+- **Environment**: `pypi`
+
+No PyPI API token is required when using trusted publishing.

segmenta_archiver-0.1.2/pyproject.toml

@@ -0,0 +1,21 @@
+[project]
+name = "segmenta-archiver"
+version = "0.1.2"
+description = "Batch merge and transcode timestamped .ts recordings into organized H.265 archives"
+requires-python = ">=3.10"
+dependencies = [
+    "typer>=0.15.0",
+    "av>=9.0.0",
+    "pymediainfo>=4.3",
+    "Pillow>=9.2.0",
+]
+
+[project.scripts]
+segmenta = "segmenta.cli:run"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/segmenta"]

segmenta_archiver-0.1.2/src/segmenta/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.2"