Skip to content

AIEraDev/vidralo

Repository files navigation

Vidralo

Vidralo Logo

Local-first video downloader — downloads streams directly from your own IP.

Release License Platform Downloads

FeaturesInstallationUsageDevelopmentSupport


Overview

Vidralo is a modern, privacy-focused desktop application that allows you to download videos and audio from YouTube, Vimeo, Twitter, and 1000+ supported sites directly to your computer. Unlike web-based downloaders, Vidralo runs entirely on your machine—no third-party servers, no tracking, no data collection.

Features

  • 🚀 Local-first Architecture: All downloads happen directly from your IP—no proxy servers
  • 🌐 Wide Platform Support: YouTube, Vimeo, Twitter, TikTok, Instagram, and 1000+ sites
  • 🎵 Multiple Formats: Download video (MP4, WebM) or audio (MP3, M4A, OPUS)
  • 📱 Quality Selection: Choose from available quality options (4K, 1080p, 720p, etc.)
  • 🔒 Privacy-focused: Zero telemetry, no data collection, no external API calls
  • 🎨 Native Performance: Built with Tauri and Rust for minimal resource usage
  • 🔄 Auto-updates: Seamless updates to keep the app current
  • 💻 Cross-platform: Runs on macOS (Apple Silicon & Intel), Windows, and Linux
  • 🎯 Simple Interface: Clean, intuitive UI—paste URL, select format, download

Installation

macOS

Via Homebrew (Recommended)

brew tap AIEraDev/vidralo
brew install --cask vidralo

Manual Installation

Download the .dmg file for your Mac:

  • Apple Silicon (M1/M2/M3): Vidralo_0.1.0_aarch64.dmg
  • Intel: Vidralo_0.1.0_x64.dmg

Windows

Download and run the installer:

  • MSI Installer: Vidralo_0.1.0_x64_en-US.msi
  • EXE Installer: Vidralo_0.1.0_x64-setup.exe

Linux

Debian/Ubuntu:

wget https://github.com/AIEraDev/vidralo/releases/latest/download/Vidralo_0.1.0_amd64.deb
sudo dpkg -i Vidralo_0.1.0_amd64.deb

Fedora/RHEL:

wget https://github.com/AIEraDev/vidralo/releases/latest/download/Vidralo-0.1.0-1.x86_64.rpm
sudo rpm -i Vidralo-0.1.0-1.x86_64.rpm

AppImage (Universal):

wget https://github.com/AIEraDev/vidralo/releases/latest/download/Vidralo_0.1.0_amd64.AppImage
chmod +x Vidralo_0.1.0_amd64.AppImage
./Vidralo_0.1.0_amd64.AppImage

All Platforms

📥 Download Latest Release

Note: No Python, FFmpeg, or other external dependencies required. All tools are bundled.

Usage

  1. Launch Vidralo from your Applications folder or Start Menu
  2. Paste a video URL from any supported site
  3. Select format and quality (video or audio, resolution/bitrate)
  4. Choose download location (optional—defaults to Downloads folder)
  5. Click Download and wait for completion

Supported Sites

Vidralo supports 1000+ video platforms including:

  • YouTube, YouTube Music
  • Vimeo, Dailymotion
  • Twitter (X), TikTok, Instagram
  • Facebook, Reddit
  • Twitch, Kick
  • And many more

Keyboard Shortcuts

  • Cmd/Ctrl + V — Paste URL
  • Cmd/Ctrl + D — Start download
  • Cmd/Ctrl + , — Open settings
  • Cmd/Ctrl + Q — Quit application

Development

Prerequisites

  • Node.js 18+ and npm
  • Rust 1.70+ (install via rustup)
  • System dependencies:
    • macOS: Xcode Command Line Tools
    • Windows: Microsoft C++ Build Tools
    • Linux: webkit2gtk-4.0, libayatana-appindicator3-dev

Setup

  1. Clone the repository:
git clone https://github.com/AIEraDev/vidralo.git
cd vidralo
  1. Install dependencies:
npm install
  1. Run in development mode:
npm run tauri dev
  1. Build for production:
npm run tauri build

The built application will be in src-tauri/target/release/bundle/.

Project Structure

vidralo/
├── src/                    # React frontend
│   ├── App.tsx            # Main application component
│   ├── store.ts           # State management (Zustand)
│   └── main.tsx           # Entry point
├── src-tauri/             # Rust backend
│   ├── src/
│   │   ├── main.rs        # Tauri entry point
│   │   ├── downloader.rs  # Download logic
│   │   └── updater.rs     # Auto-update logic
│   ├── binaries/          # Bundled executables (yt-dlp, bgutil-pot)
│   └── tauri.conf.json    # Tauri configuration
├── .github/workflows/     # CI/CD workflows
└── homebrew-tap/          # Homebrew Cask formula

Contributing

We welcome contributions! Please follow these steps:

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

Please ensure your code follows the existing style and includes appropriate tests.

Tech Stack

  • Frontend: React 19 + TypeScript + Vite + Tailwind CSS v4
  • Backend: Rust + Tauri 2.0
  • State Management: Zustand
  • Downloader: yt-dlp (bundled)
  • Media Processing: bgutil-pot (bundled)
  • Build System: GitHub Actions (multi-platform)

Recommended IDE Setup

Security & Privacy

  • No telemetry or analytics - Zero tracking of user behavior
  • No external API calls - All processing happens locally
  • No user data collection - Your downloads and preferences stay on your device
  • Open source - Full transparency, inspect the code yourself
  • Direct downloads - Videos download directly from source platforms to your machine

Roadmap

  • Playlist download support
  • Download queue management
  • Custom output templates
  • Subtitle/caption downloads
  • Video format conversion
  • Browser extension integration
  • Download history and bookmarks

FAQ

Q: Is this legal?
A: Vidralo is a tool. Its legality depends on how you use it. Respect copyright laws and terms of service of platforms you download from.

Q: Why does it need internet access?
A: To download videos from online platforms and check for app updates.

Q: Does it work with private/age-restricted videos?
A: No, Vidralo only downloads publicly accessible content.

Q: Can I download entire playlists?
A: Not yet, but it's on the roadmap.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

  • yt-dlp - The powerful download engine
  • Tauri - The lightweight desktop framework
  • React - The UI library

Support


Made with ❤️ by AIEraDev

⭐ Star this repo if you find it helpful!

About

Local-first video downloader — downloads streams directly from your own IP. Supports YouTube, Vimeo, Twitter, and 1000+ sites.

Topics

Resources

License

Contributing

Security policy

Stars

2 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors