Vidra

Desktop-grade video download manager (Flutter interface + integrated Python backend via serious_python)

The uncompromised power of yt-dlp, accessible to everyone.
While other mobile and desktop projects rely on limited wrapper packages or imitations that restrict functionality, Vidra embeds the original yt-dlp engine. This brings its complete, raw feature set and advanced configuration capabilities directly to Android, Windows, and Linux—all wrapped in a beautifully designed, user-friendly interface.

📖 Table of Contents

• 📖 Table of Contents
• ✨ Key Features & Insights
• 🎥Video
• 📸 Screenshots
• 📥 Installation
• ⚠️ Disclaimer
• 🏗️ General Architecture
• 🚀 Quick Start for Development
• 🌐 Internationalization (i18n)
• 📚 Additional Documentation
• 🤝 Contributions and Security
• 📄 License

---

✨ Key Features & Insights

• 🔄 Always Up-to-Date (OTA): Built-in Over-The-Air updates ensure your core engines (yt-dlp and yt-dlp-ejs, including beta channels) are always running the latest versions, fetched directly from their official repositories.
• 🛡️ Zero Telemetry: Vidra is completely offline-first and private. It collects absolutely no personal data, telemetry, or usage metrics.
• 🔐 Cryptographically Verified: All binaries and OTA updates are downloaded from official sources and strictly verified using cryptographic signatures for maximum security.
• 🎨 Modern and Scalable Client: Built in Flutter under Clean Architecture principles, with full support for themes (light/dark) and internationalization.
• ⚙️ High-Performance Integrated Backend: Seamless communication via local RESTful APIs to reflect download progress in real-time using a Python isolate backend.

---

🎥Video

vidra-demo.mp4

📸 Screenshots

Linux / Windows	Mobile (Android)

---

📥 Installation

Vidra is officially distributed through the GitHub Releases (Latest Assets) section.

Platform	File / Installer
Windows	vidra-windows.exe
Linux	vidra-x86_64.AppImage vidra-linux.deb
Android	vidra-android.apk vidra-android-arm64-v8a.apk vidra-android-x86_64.apk vidra-android-armeabi-v7a.apk
macOS	Coming soon

🍫 Install via Chocolatey (Windows)

For Windows users, Vidra can be installed using our official Chocolatey package. Run the following commands in your terminal:

# Download and install Chocolatey:
powershell -c "irm https://community.chocolatey.org/install.ps1|iex"

# Download and install Vidra:
choco install vidra

📦 Install via Winget (Windows)

For Windows users, Vidra can be installed using Winget package manager. Run the following commands in your terminal:

winget install -e --id Chomusuke.Vidra

🐧 Install via APT Repository (Debian/Ubuntu)

For Linux users on Debian or Ubuntu-based distributions, Vidra can be installed and kept up-to-date automatically using our official APT repository. Run the following commands in your terminal:

# 1. Download the public security key
wget -qO- https://apt.chomusuke.dev/public.key | sudo tee /etc/apt/keyrings/chomusuke.asc > /dev/null

# 2. Add the repository to your sources list
echo "deb [signed-by=/etc/apt/keyrings/chomusuke.asc] https://apt.chomusuke.dev/ stable main" | sudo tee /etc/apt/sources.list.d/chomusuke.list

# 3. Update and install the app
sudo apt update
sudo apt install vidra

🔐 Signature Validation and Checksums

Each release includes files to verify the integrity and authenticity of the binaries:

• SHA2-256SUMS, SHA2-512SUMS: Checksums.
• SHA2-256SUMS.sig, SHA2-512SUMS.sig: GPG signatures of the checksums.

---

⚠️ Disclaimer

Warning

Vidra is a powerful tool designed to download media for offline use and archiving. Users are solely responsible for their actions and must ensure they have the legal right or permission to download the content. The developers do not endorse, promote, or support copyright infringement.

---

🏗️ General Architecture

graph TD
  A[Flutter UI Client] <-->|Local HTTP API| B[Python Isolate Backend]
  subgraph serious_python
    B <--> C[yt-dlp]
    C <--> D[FFmpeg/ffprobe]
    C --> E[quickjs]
  end

Loading

For exhaustive details, check the docs/system-architecture.md document.

---

🚀 Quick Start for Development

Note

To build Vidra locally, you will need to package the Python backend and provide the native dependencies: FFmpeg and QuickJS.

📖 Please refer to our Comprehensive Development Guide for full compilation steps, testing strategies, and CI/CD documentation.

---

🌐 Internationalization (i18n)

Vidra supports multiple languages. Localization files are pre-configured to scale using state managers.

---

📚 Additional Documentation

• docs/system-architecture.md – Technical details of the architecture and client-server integration.
• docs/client-flows.md – Lifecycle and main user interface flows.
• docs/development-guide.md – Comprehensive guide for testing, troubleshooting, and configuration.

---

🤝 Contributions and Security

• Check the CONTRIBUTING.md to know the coding standards and how to open Pull Requests.
• Check the CODE_OF_CONDUCT.md to ensure a healthy and professional community environment.
• To report vulnerabilities, follow the steps outlined in SECURITY.md.

---

📄 License

This project is distributed under the original LICENSE (GPLv3).
Third-party dependencies, which include Flutter libraries, Python runtime components, and integrated tools like yt-dlp, are exhaustively documented in THIRD_PARTY_LICENSES.md.