FMUS-VID Documentation
=====================

Welcome to FMUS-VID, a human-centric, comprehensive Python video processing library.

.. toctree::
   :maxdepth: 2
   :caption: Contents:

   tutorials/quickstart
   tutorials/basic_operations
   api/core
   api/operations
   api/backends
   api/ai
   api/capture
   api/stream
   api/utils

Overview
--------

FMUS-VID is designed to make video processing enjoyable, intuitive, and powerful.
It provides a clean, terse API while handling complex operations behind the scenes.

Installation
------------

.. code-block:: bash

   # Install basic package
   pip install fmusvid

   # Install with AI features
   pip install fmusvid[ai]

   # Install all features
   pip install fmusvid[all]

Quick Example
-------------

.. code-block:: python

   import fmusvid

   # Load and process a video
   video = fmusvid.load("input.mp4")
   video.trim(0, 10).resize(720).grayscale().save("output.mp4")

   # Concatenate videos
   combined = fmusvid.concat([video1, video2, video3])

   # Create grid layout
   grid = fmusvid.grid([video1, video2, video3, video4], rows=2, cols=2)

Features
--------

* **Multi-backend support**: FFmpeg, VLC, MoviePy, PyAV, GStreamer
* **Screen and camera capture**: Record screen regions, webcam
* **Basic operations**: Trim, resize, rotate, crop, scale, grayscale
* **Composition**: Concat, grid, side-by-side, overlay
* **Transitions**: Fade, wipe, slide, zoom effects
* **Text and subtitles**: Add text overlays and subtitles
* **Audio operations**: Extract audio, adjust volume
* **AI features**: Object detection, tracking, speech recognition
* **Streaming**: RTMP streaming support

Links
-----

* `GitHub Repository <https://github.com/mexyusef/fmusvid>`_
* `PyPI Package <https://pypi.org/project/fmusvid/>`_
* `Issue Tracker <https://github.com/mexyusef/fmusvid/issues>`_

Indices and tables
==================

* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`