Back to Projects
Oct 2026

Aura Media Downloader & Archiver

View Source Code

Project Overview

Running a personal home media server requires maintaining a reliable offline library, but major platforms lack native download support. Meanwhile, public online downloaders are typically ad-ridden, privacy risks, or incapable of handling high-bitrate 4K streams and custom container muxing. Aura was engineered from the ground up to solve this—combining a native Apple-inspired desktop UI, real-time WebSocket telemetry, and a multi-threaded Python backend to archive streams directly into self-hosted storage with zero command-line friction.

Architecture & Desktop Integration

Hybrid Tauri & Python Sidecar Architecture

Separates UI rendering from heavy media I/O across isolated, synchronized processes:

  • Frontend Shell: Built with React, Tailwind CSS v4, and Framer Motion, wrapped inside a native Tauri WebView2 window for lightweight, responsive execution.
  • Python FastAPI Sidecar: A compiled backend server (`aura-engine.exe`) that handles heavy networking, stream parsing via `yt-dlp`, and media muxing.
  • Zero Console Windows: Configured with silent background execution (`CREATE_NO_WINDOW` flags and stdout/stderr stubbing) so FFmpeg and Python processes never flash black command prompt windows during operation.

Zero-Dependency Packaging

Engineered for seamless distribution as a standalone desktop application:

  • PyInstaller Binary Freezing: Packages the Python runtime, FastAPI server, and `yt-dlp` dependencies into a single isolated binary.
  • Rust Lifecycle Management: Managed by Tauri's Rust core (`main.rs`), which automatically boots the sidecar engine on application startup and safely terminates processes upon window closure.

High-Performance Parsing & Streaming Engine

Universal Stream Sniffer & Quality Profiling

Extracts media metadata and stream options across over 1,000 supported platforms:

  • Pre-Download Probing: Automatically inspects video titles, channels, durations, thumbnail previews, and available resolutions prior to committing jobs.
  • Smart Quality Selection: Automatically targets the highest native framerates (60fps/120fps) and max bitrates without manual format hunting.

Multi-Threaded Chunking & Bandwidth Management

Optimized for speed and network resource control:

  • 8x Parallel Fragment Downloads: Splits HLS and DASH streams across concurrent byte-range chunks to fully saturate local bandwidth.
  • Dynamic Speed Limiting: Optional rate-limiting sliders to prevent heavy 4K downloads from bottlenecking network performance during peak hours.

Advanced Post-Processing & Codec Options

Editor-Ready Muxing & Transcoding Presets

Tailored export pipelines for different media consumption needs:

  • MP4 Video Muxing: Merges highest-quality video and audio streams up to 2160p60 HDR.
  • Lossless Audio Extraction: Directly strips audio tracks into uncompressed FLAC format with embedded metadata tags and album art.
  • Apple ProRes 422 Conversion: Transcodes downloaded footage into ProRes (`prores_ks`) using hardware acceleration for immediate timeline integration in Premiere Pro or DaVinci Resolve.

Automated Chapter Slicing & Metadata Tagging

Keeps long-form content organized for media server libraries:

  • Chapter Splitting: Automatically detects embedded chapter markers and slices long podcasts, lectures, or videos into individual files.
  • Metadata Embedding: Injects official tags, descriptions, and studio artwork directly into the container.

Apple-Inspired UI & Real-Time Telemetry

Spring Physics & Fluid Micro-Interactions

Designed with a meticulous focus on tactile feedback and modern desktop aesthetics:

  • Spring-Damped Animations: Powered by Framer Motion using mathematical mass-spring-damping curves mimicking macOS SwiftUI behavior.
  • Dynamic Island Status Pill: A compact, interactive status bar widget that collapses live downloads into a minimal pill with circular progress rings and speed telemetry.
  • Tactile Web Audio Feedback: Synthesizes subtle, ear-comfortable UI audio cues for successful sniffing, task initiation, and queue completion.

Real-Time WebSocket Queue

Provides granular visibility over active transfers:

  • Live Telemetry Stream: Pushes byte-level progress percentages, transfer speeds (MB/s), and estimated time remaining (ETA) over a local WebSocket connection.
  • Drag-and-Drop Priority Grid: Fluid card queue supporting instant reordering and batch management of queued items.