# Video Converter for DaVinci Resolve

This project is a standalone Python application with a graphical user interface (GUI) to convert video files into formats highly compatible with DaVinci Resolve (Free edition on Linux). The goal is to provide a simple and user-friendly tool that ensures optimal video quality, aspect ratio, and audio fidelity for editing workflows.

The application allows you to:
* Convert local video files or videos from URLs.
* Select different quality profiles.
* Use browser cookies to download age-restricted or private videos from sites like YouTube.
* See the conversion progress in real-time.

For a detailed breakdown of the project's goals, technical specifications, and development roadmap, please refer to the [DEVELOPMENT_PLAN.md](DEVELOPMENT_PLAN.md) file.

## Requirements

*   **FFmpeg with DNxHR/HD support:** The project requires an `ffmpeg` build that includes support for DNxHR/HD codecs. On Arch Linux (and CachyOS), the `ffmpeg-full` package from the AUR is recommended:
    *   [ffmpeg-full (AUR)](https://aur.archlinux.org/packages/ffmpeg-full)

## Usage

For instructions on how to use the application, please refer to the [HOW-TO.md](HOW-TO.md) file.

## GUI

The application's graphical user interface has been updated to use `customtkinter` as of November 2, 2025. This provides a modern and customizable look and feel.

![Video Converter GUI](images/video_converter.png)

## Setup Notes for Arch Linux / CachyOS

When installing `ffmpeg-full` (required for DNxHR/HD codec support), users might encounter a dependency conflict with `obs-studio-browser`. `obs-studio-browser` typically requires `ffmpeg-obs`, which is incompatible with `ffmpeg-full`.

**Workaround:**
To resolve this, it is recommended to use `obs-studio-git` from the AUR, which is compatible with `ffmpeg-full`.

*   **`obs-studio-git (AUR)`**: [https://aur.archlinux.org/packages/obs-studio-git](https://aur.archlinux.org/packages/obs-studio-git)

    *   **Important Note:** Please refer to the comments section on the `obs-studio-git` AUR page, specifically those from `thotypous` and `benklett`, for detailed instructions and potential dependency management strategies. These comments provide crucial insights into managing the `ffmpeg` dependency for OBS Studio on Arch-based systems.

## Inspiration and Acknowledgments

This project draws inspiration and insights from existing open-source efforts. We gratefully acknowledge the work of the following authors and their repositories, which we have forked for easier reference during development:

*   **`xavier150/convert-video-for-Resolve`**: Original repository by [xavier150](https://github.com/xavier150).
*   **`tkmxqrdxddd/davinci-video-converter`**: Original repository by [tkmxqrdxddd](https://github.com/tkmxqrdxddd).

Their contributions to the community provide valuable examples and starting points for developing DaVinci Resolve-compatible video conversion tools.