Transcoder Suite

Modular, playbook-driven video transcoding for high-quality archival and batch processing (PowerShell 7 + FFmpeg).

Explore the docs »

Report Bug · Request Feature

Table of Contents

1. About The Project
   • Built With
2. Getting Started
3. Usage
4. Contributing
5. License
6. Contact

About The Project

Transcoder Suite automates complex transcoding with reusable profiles and playbooks, session-based resumable jobs, and a focus on high-efficiency codecs like AV1 and Opus.

Project Goals

• Quality: Focus on high-bitrate, high-efficiency codecs like AV1 and Opus.
• Consistency: Ensure all media in a collection follows the same encoding standards.
• Resilience: Session-based processing that can be resumed after interruptions.
• Automation: Minimize manual configuration through reusable profiles and playbooks.

Features

• Modular Profiles: Separate video and audio settings into reusable JSON components.
• Playbook Orchestration: Combine profiles into named "Playbooks" for different use cases (e.g., Deep Archival, Mobile Sync).
• Session Management: Resumable jobs stored in app/convert_jobs/. Never lose progress on a 100-file batch.
• Smart Audio Handling: Automatically detects and handles stereo vs. surround sound with appropriate bitrates.
• SVT-AV1 Optimized: Pre-configured for high-efficiency 10-bit AV1 encoding.
• Atomic Writes: Encodes to .tmp files to prevent file corruption on interruption.

(back to top)

Built With

• Pipeline — PowerShell 7
  • / FFprobe
• Docs —

(back to top)

Getting Started

Prerequisites

• Install FFmpeg and FFprobe and ensure they are in your PATH.
• PowerShell 7+.

Installation / run

Clone the repository, then run the converter from the app/ directory:

.\app\convert.ps1

Select a Playbook from app/playbooks/.

Documentation

Published docs: amdphreak.github.io/transcoder-suite/.

Local docs site:

cd docs
pnpm install
pnpm dev

(back to top)

Usage

• app/profiles/: Individual encoder settings (Video/Audio).
• app/playbooks/: Orchestration recipes.
• app/convert_jobs/: Session progress and failure logs (ignored by git).
• app/convert.ps1: The main entry point script.

Docs are available in English, Spanish, and French under docs/.

(back to top)

Contributing

Fork, branch, and open a pull request. Bug reports and feature requests welcome via GitHub Issues.

Top contributors

For per-person profile links, prefer all-contributors.

(back to top)

License

GNU General Public License v3.0 — see LICENSE.

(back to top)

Contact

Ryan Johnson — @amdphreak

Project Link: https://github.com/AMDphreak/transcoder-suite

Docs: https://amdphreak.github.io/transcoder-suite/

Site: https://ryanjohnson.dev

(back to top)