Extensions

Aria2 Manager

Control your downloads directly from Vicinae using Aria2 and yt-dlp. This extension acts as a powerful GUI wrapper, allowing you to manage downloads without opening a terminal.

Features (v1.1)

  • Download Manager: View Active, Waiting, and Completed tasks with real-time status updates.
  • Smart Add: Paste any URL or Magnet link into the search bar.
  • Video Downloader: Automatically detects YouTube/Video URLs and uses yt-dlp to extract media.
  • High Quality Support:
    • Best Quality: Downloads separate video (1080p/4K) and audio streams and merges them automatically (Requires FFmpeg).
    • Quality Selection: Choose between Best, 1080p, 720p, or Audio Only directly from the UI.
    • Lazy Merge: Merging happens in the background so you can continue using the app.
  • Task Control: Pause, Resume, and Remove tasks. "Open File" action for completed downloads.
  • Security: Sandboxed execution with strict filename sanitization to prevent command injection.

Requirements

1. Aria2 (Required)

The core download engine.

  • Ubuntu/Debian: sudo apt install aria2
  • Arch Linux: sudo pacman -S aria2

2. yt-dlp (Recommended)

Required for downloading videos from YouTube, Vimeo, Twitch, and 1000+ other sites.

  • Linux: sudo curl -L https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -o /usr/local/bin/yt-dlp && sudo chmod a+rx /usr/local/bin/yt-dlp

3. FFmpeg (Recommended)

Required for High Quality (1080p+) downloads. High-quality streams are often split into separate video/audio files; FFmpeg is used to merge them. Without FFmpeg, downloads will fallback to 720p (single file) to ensure playability.

  • Ubuntu/Debian: sudo apt install ffmpeg
  • Arch Linux: sudo pacman -S ffmpeg

Configuration

The extension uses sensible defaults but respects the standard Aria2 environment variables if set globally:

  • Download Directory: Defaults to ~/Downloads.
  • RPC Port: Internal daemon runs on port 6800.
  • Security: Internal daemon enforces strict security settings (custom tokens, cross-origin checks) by default.

Troubleshooting

  • "Video downloaded as two files (.video.mp4 / .audio.m4a)": This happens if FFmpeg is missing or the merge process was interrupted. Ensure FFmpeg is installed. The extension periodically scans to attempt re-merging valid pairs.
  • "Download Failed": Check if the URL is accessible. For YouTube, ensure yt-dlp is up to date (sudo yt-dlp -U).

Development

To run this extension locally:

npm install
npm run dev