Files
video-converter/README.md
2025-11-02 12:37:09 +01:00

36 lines
2.6 KiB
Markdown

# 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)
## 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.