Skip to content

SohamTilekar/vidiopy

Repository files navigation

🎬 VidioPy

PyPI version License: MIT Documentation

VidioPy is a modern, Pythonic video editing and manipulation library. Born as a robust alternative to MoviePy, it aims to provide a cleaner, highly extensible interface for developers looking to programmatically edit videos, generate dynamic content, and composite multimedia assets.

Whether you're building automated video generation tools, adding text overlays, or creating simple video effects, VidioPy gives you the reliable building blocks to do it effortlessly.


📖 Documentation

Dive right into the complete API reference and tutorials in our detailed documentation:

👉 Official VidioPy Documentation


✨ Features

  • Intuitive API: Chainable methods and straightforward class structures (VideoClip, AudioClip, TextClip, etc.).
  • Media Compositing: Overlay text, images, and other videos to build complex scenes.
  • Audio & Video Integration: First-class support for audio mixing and manipulation alongside your video frames.
  • Programmatic Effects: Apply mathematical transformations and lambda functions to video frames dynamically over time.
  • Familiar Tools Under the Hood: Built on top of numpy, Pillow, and ffmpegio for blazing fast frame manipulations.

🚀 Quick Start

Creating your first video with VidioPy is as simple as:

import vidiopy

# 1. Load an existing video
video = vidiopy.VideoFileClip("path/to/video.mp4")

# 2. Create a text overlay
text = vidiopy.TextClip("Hello, VidioPy!", fontsize=70, color="white")

# 3. Animate the text to move downwards over time
text = text.set_position(lambda t: (100, 50 + 10 * t))

# 4. Composite the text over the video
final_video = vidiopy.CompositeVideoClip([video, text])

# 5. Export the result
final_video.write_videofile("output.mp4")

💻 Installation

We strongly recommend installing the absolute latest version directly from GitHub for the most recent features, performance optimizations, and security patches.

Recommended: Install from GitHub

pip install git+https://github.com/SohamTilekar/vidiopy.git

Install from PyPI

Note: Due to a previously reported issue, the PyPI release might lag behind the GitHub repository.

pip install vidiopy

🤝 Contributing

VidioPy is a community-driven project and we would love your help! Whether you want to fix bugs, propose new features, or improve the documentation, all contributions are welcome.

To get started:

  1. Check out our Contribution Guidelines.
  2. Fork the repository and create your feature branch.
  3. Make your changes and test them thoroughly.
  4. Submit a Pull Request!

⚠️ Disclaimer

VidioPy is currently in the active early stages of development. While the core features work wonderfully, you might find some edge cases or missing capabilities compared to older libraries. We encourage you to use it, test it, and report any bugs or feature requests in the Issues tab!


📜 License

VidioPy is open-sourced software licensed under the MIT License.

About

A modern, Pythonic video editing and manipulation library. A robust alternative to MoviePy for compositing, dynamic effects, and automated video generation.

Topics

Resources

License

Stars

10 stars

Watchers

1 watching

Forks

Contributors