RAVN

RAVN is a Windows-first desktop and CLI app for downloading, processing, organizing, and automating local media workflows.

Download the latest Windows build

---

• Download videos, audio, playlists, batches, magnets, and .torrent files from one interface
• Convert, extract, subtitle, filter, mix, and optimize media with FFmpeg-backed tools
• Keep a local library with history, tags, collections, and export support
• Run the same core workflows from the CLI with script-friendly JSON output
• Get clear tool-health feedback so missing dependencies do not feel like an app-wide failure

RAVN is not just a downloader — it is a local media pipeline.

Demo

Demo GIF placeholder: add an end-to-end capture here (download -> process -> library) when docs/demo.gif is available.

Use Cases

• Download playlists and filter content before committing to large batch jobs.
• Extract audio / create karaoke tracks by combining download, trim, subtitle, mixer, and replace-audio workflows around your own local media assets.
• Convert and optimize media files for archive, sharing, editing, or device playback.
• Manage a local media library with history, tags, collections, search, and export.
• Automate workflows via CLI for repeatable download, processing, and cataloging tasks.

Features

Download

• Smart source handling for URLs, playlists, batch links, magnets, and .torrent files
• Playlist review with filtering, range selection, and selective download
• Video/audio output switching, quality selection, and reusable acquisition profiles
• Naming presets/templates, subtitle preferences, metadata enrichment, and post-download automation
• Optional torrent support through aria2c

Processing

• Video and audio conversion
• Subtitle embed and subtitle-sidecar workflows
• FFmpeg-based filters and adjustments
• Audio/video mixer operations
• Utility helpers for remux, trim, preview, thumbnail, loudness, scene detection, and more

Library

• Local media library with metadata-aware registration
• Aggregated history for downloads, conversions, and other media operations
• Tags, collections, search, statistics, and export
• Background queue visibility with task status and quick actions

Automation

• CLI commands for download, convert, info, subtitle, history, torrent, mixer, library, filters, and utilities
• Shared core logic between desktop and CLI surfaces
• --json support for automation-friendly output
• Good fit for repeatable local media workflows and scripting

Quick Start

Windows release

1. Download the latest RAVN-windows-x64.zip from GitHub Releases.
2. Extract the archive.
3. Run RAVN.exe.
4. If the app reports missing tools, install the required dependencies from DEPENDENCIES.md.
5. Paste a URL, playlist, magnet link, or local file into the relevant workspace and start working.

Run from source

pip install -r requirements.txt
pip install -e .
python ravn.py
ravn --help

If the ravn command is not available on your shell yet, use:

python -m ravn_app.cli --help

CLI Examples

ravn download "https://example.com/video" --profile archive --format mp4 --quality 1080p
ravn torrent "magnet:?xt=urn:btih:..." --sequential
ravn convert input.mp4 --format mkv --quality high
ravn utilities --operation thumbnail input.mp4 --output thumb.jpg
ravn library search --query tutorial --tags archive --json

Dependencies

Required

• Python 3.9+
• FFmpeg
• FFprobe
• yt-dlp
• Python packages from requirements.txt

Optional

• aria2c for torrent and magnet workflows
• tkinterdnd2 for drag-and-drop support

Install Python dependencies:

pip install -r requirements.txt

Full setup and troubleshooting guidance lives in DEPENDENCIES.md.

Platform and Release Notes

• Windows is the primary packaged-release target.
• Linux and macOS source checkouts may work, but packaged releases are not currently maintained for those platforms.
• Packaged Windows builds support bundled FFmpeg/FFprobe lookup.
• GitHub Releases publish zip artifacts and SHA256 checksum files.
• If SmartScreen appears, download only from GitHub Releases and verify the published checksum.

Documentation

• DEPENDENCIES.md — setup, required tools, and troubleshooting
• PROGRESS.md — current release status and verified quality snapshot
• TASKS.md — public roadmap and near-term priorities
• ARCHITECTURE.md — system overview, runtime layers, and module boundaries
• docs/phase5f_windows_packaging.md — Windows packaging and release guide

Development and Testing

pytest -q
pytest -q tests/test_ui_logic.py
pytest -q tests/test_ui_components.py tests/test_app_builder.py
pytest -q tests/test_config_paths.py tests/test_database_manager.py

License

MIT