VideoAlchemy: Simplified, Structured Video Processing
Welcome to VideoAlchemy, an advanced toolkit that offers a more readable and structured way to handle video processing tasks compared to traditional FFmpeg commands. VideoAlchemy enables users to define video processing workflows using a simple YAML-based configuration, enriched with built-in validation to minimize errors and streamline command execution.
Whether you're processing a single video or executing a sequence of commands, VideoAlchemy ensures a smoother and more intuitive experience.
Table of Contents
- Introduction
- Why VideoAlchemy?
- Getting Started
- Installation
- Run VideoAlchemy
- VideoAlchemy Docs
- Blog Posts
- Contributing
- Upcoming Enhancements and Support
- Features List
- Sponsors
- License
Introduction
VideoAlchemy provides a user-friendly alternative to directly writing complex FFmpeg commands. With a focus on clarity, ease of use, and sequence management, VideoAlchemy allows you to write video processing tasks using readable YAML files. These files come with built-in validation to help avoid common mistakes, making it ideal for both beginners and seasoned professionals.
Why VideoAlchemy?
VideoAlchemy enhances video processing in several ways:
-
Readable Attributes: VideoAlchemy transforms the complexity of FFmpeg command-line syntax into a clear, structured format using YAML attributes. This reduces the chance of errors and improves the legibility of the command.
-
Rich YAML Validation: The
viddo-compose.yamlfile provides real-time validation, helping you craft correct FFmpeg commands by offering clear syntax and error-checking mechanisms. Common FFmpeg pitfalls are automatically mitigated, resulting in smoother workflows. -
Command Sequencing: Need to run multiple FFmpeg commands in sequence? VideoAlchemy makes this simple by allowing you to chain commands and set dependencies between tasks within the YAML file. This is especially useful for projects requiring multiple steps, like video conversion followed by audio extraction.
Getting Started
videoalchemy currently supports Linux and macOS. Windows support is coming soon.
Installation
Run VideoAlchemy
Example viddo-compose.yaml File
generate_path: "./generated" # Directory of log and command files
tasks:
- name: Convert to AVI
command: ffmpeg
inputs:
- id: input_video
source: 'input.mp4'
streams:
- stream_from:
input_id: input_video
stream_to:
output_id: output_avi
outputs:
- id: output_avi
source: 'output.avi'
overwrite: true
- name: Extract Audio
command: ffmpeg
inputs:
- id: output_avi
output_id: output_avi # Reference from the previous task
streams:
- codec_name:
audio: copy
video_none: true
stream_from:
input_id: output_avi
stream_to:
output_id: audio_only
run_after:
- Convert to AVI
outputs:
- id: audio_only
source: 'output_audio.mp3'
overwrite: true
Key Features:
- Readable and Organized: Rather than memorizing FFmpeg's complex flags and options, you can clearly define inputs, outputs, streams, and filters in an intuitive format.
- Command Sequencing: Define dependencies between tasks using
run_afterto ensure commands run in the desired order. - Error Prevention: YAML validation ensures that FFmpeg commands are properly formed, helping to avoid errors early in the workflow.
Blog Posts
Contributing
We welcome contributions from the community to make VideoAlchemy better! Here's how you can get involved:
- Improve Readability: Suggest improvements to the way we structure attributes for video processing.
- Expand Validation: Help us enhance our YAML validation to cover more complex FFmpeg use cases.
- Create New Commands: Propose and implement new commands and workflows.
Upcoming Enhancements and Support
We are continuously working to enhance VideoAlchemy. Here are some exciting features we plan to introduce in the future:
-
Integration with AI Models/Services: Leverage AI models and services to offer advanced features like automatic video enhancement, noise reduction, and smart video editing, empowering users with AI-powered video processing tools.
-
Toolkit for Streamers and YouTubers: VideoAlchemy will further evolve into an indispensable toolkit tailored for streamers and content creators, offering specialized features such as custom overlays, real-time streaming enhancements, and optimized video formats for platforms like Twitch and YouTube.
-
Extract FFMPEG Logs for Monitoring: Implement a system to extract and visualize FFmpeg logs in real-time, enabling users to monitor and troubleshoot their video processing tasks through a detailed log dashboard.
-
Complete Support for FFmpeg Parameters: Expand the YAML schema to support all FFmpeg parameters, ensuring users have access to FFmpeg's full range of options while maintaining VideoAlchemy's simplified interface. This will be accompanied by comprehensive documentation, providing detailed guidance on each parameter.
-
Cloud Storage Integration: Add support for various cloud storage solutions such as Azure Storage, AWS S3, Minio, and more, allowing users to specify these as source files for their video processing tasks.
-
Improved Validation: Enhance the built-in validation mechanisms to cover more complex scenarios and edge cases, ensuring that all FFmpeg commands are correctly formed and executed without errors.
Features List
- FFMPEG Parameters: Input & Output
- FFMPEG Parameters: Simple Filters
- FFMPEG Parameters: Complex Filters
- FFMPEG Parameters: HLS
- FFMPEG Parameters: Codecs & VOD & Live & Streaming
- VideoAlchemy Validation: Attributes Validation
- FFMPEG parameters: Mpeg Dash
- FFMPEG Parameters: Hardware Acceleration(GPU)
- REST API: Tasks Management
- REST API: Monitoring & Logger
- AI Integration: Inference API of Hugging Face
- AI Integration: AI & Media Tasks
- AI Integration: AI Filters
- Cloud Storage Integration: Microsoft Azure
- Cloud Storage Integration: AWS S3/Minio
- Cloud Storage Integration: Google Cloud
Sponsors
Your support keeps this project growing. Consider sponsoring to help us continue developing VideoAlchemy.
License
VideoAlchemy is licensed under the MIT License. Contributions are licensed under the same terms.