Skip to main content

FluxMedia - Cross-platform Command-Line Media Downloader

Project description

🌊 FluxMedia

FluxMedia is a powerful, open-source, and cross-platform command-line media downloader designed for simplicity, robustness, and speed. Built on top of yt-dlp and rich, it provides a beautiful terminal user interface (TUI) to download videos, audio streams, playlists, channel uploads, and subtitles from thousands of supported websites.


🚀 Quick Start

1. Installation

Install FluxMedia globally on any system running Python 3.10+ directly via pip:

pip install fluxmedia

2. Execution

Run the interface from any terminal or command prompt:

fluxmedia

✨ Key Features

  • Dynamic Console TUI: Renders rich tables, panels, and live progress bars for download speeds, ETA, and file sizes.
  • Smart Audio Extraction: Automatically extract and convert media into high-quality MP3 (192kbps) with embedded cover art and metadata (requires FFmpeg).
  • Metadata & Cover Art Embedding: Automatically write video thumbnails and details (description, uploader, dates) directly into your downloads.
  • Batch Downloads: Save entire playlists or recent uploads from content creator channels.
  • Subtitles Capturing: Download caption files directly for specified language codes.
  • Global Settings: Customize download folders, default formats, filename structures, and UI themes inside the app.

🛠️ Requirements & Setup

  • Python: Version 3.10 or higher.
  • FFmpeg (Highly Recommended): Required for merging high-definition video formats and converting audio to MP3.
    • Windows: winget install Gyan.FFmpeg
    • macOS: brew install ffmpeg
    • Linux: sudo apt install ffmpeg

👑 Credits & Support

This project was created and is fully maintained by Priyanshu Chauhan (@pdev-labs). I am a student in India (Standard 11, PCM with CS) and I spent a couple of weeks designing, coding, and perfecting FluxMedia alone.

If you find this tool helpful, please support my work by giving it a star on GitHub! ⭐


🐛 Bugs, Errors & Feedback

Got an issue, bug, or feature request? I would love to hear from you! Please file reports directly at: 👉 FluxMedia Issue Tracker

To help me resolve errors quickly, please:

  1. Search active issues first to avoid duplicate bug tickets.
  2. Provide details about your Operating System and whether FFmpeg is installed.
  3. Paste logs or stderr dumps. (Local execution logs are saved inside your home directory under ~/.fluxmedia/fluxmedia.log).

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

fluxmedia-1.3.5.tar.gz (33.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

fluxmedia-1.3.5-py3-none-any.whl (32.8 kB view details)

Uploaded Python 3

File details

Details for the file fluxmedia-1.3.5.tar.gz.

File metadata

  • Download URL: fluxmedia-1.3.5.tar.gz
  • Upload date:
  • Size: 33.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.6

File hashes

Hashes for fluxmedia-1.3.5.tar.gz
Algorithm Hash digest
SHA256 86f8131411d8c3f30a1f9295f3de8f9c0a520d398f2cd1da7ebc3c484e838a57
MD5 5f9775b2d7046d9eefecc26c19d03b29
BLAKE2b-256 7c9660d99904b76113f9d4d1519fecbc17a0b721cb648e110095b4a47614b262

See more details on using hashes here.

File details

Details for the file fluxmedia-1.3.5-py3-none-any.whl.

File metadata

  • Download URL: fluxmedia-1.3.5-py3-none-any.whl
  • Upload date:
  • Size: 32.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.6

File hashes

Hashes for fluxmedia-1.3.5-py3-none-any.whl
Algorithm Hash digest
SHA256 6f22a8d2779530e47a25d556806879c100da6c1ddc3e5ded316e7e1ef01229fe
MD5 1ca61cc96e6fca97a1f7349402c2c602
BLAKE2b-256 b7ef7c561c557bfebb69cc464c41177eb41a20051691375b55b6f1fe236dccfa

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page