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.
- Introduction
- Why VideoAlchemy?
- VideoAlchemy Command
- Viddo Compose Tutorial
- Contributing
- Upcoming Enhancements and Support
- License
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 a 8E20 void common mistakes, making it ideal for both beginners and seasoned professionals.
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.
The videoalchemy command is a binary written in Go that processes a series of FFmpeg tasks defined in a YAML configuration file. The configuration file is easy to read and write, and it allows you to execute FFmpeg commands sequentially without manually chaining them.
videoalchemy compose -f viddo-compose.yamlversion: 1 # Schema version of viddo-compose
generate_path: "./generated" # Directory of log and command files
tasks:
- name: Convert to AVI
command: ffmpeg
inputs:
- id: input_video
source: 'input.mp4'
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
codecs:
- codec_name:
audio: copy
video_none: true
outputs:
- id: audio_only
source: 'output_audio.mp3'
overwrite: true - Readable and Organized: Rather than memorizing FFmpeg's complex flags and options, you can clearly define inputs, outputs, codecs, 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.
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.
We are continuously working to enhance VideoAlchemy. Here are some exciting features we plan to introduce in the future:
-
Support MPEG-DASH: Extend the toolkit to support MPEG-DASH, enabling adaptive streaming for high-quality video delivery over the internet.
-
Complete FFmpeg Parameters: Expand the YAML schema to support all FFmpeg parameters, providing users with the full range of FFmpeg's capabilities directly within the
viddo-compose.yamlfile. -
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.
Your support keeps this project growing. Consider donating to help us continue developing VideoAlchemy.
VideoAlchemy is licensed under the MIT License. Contributions are licensed under the same terms.