FluxMedia
A premium, cross-platform media portal and processing toolkit.
FluxMedia is a production-ready media manager, automated downloader, and local streaming gateway wrapped in a responsive terminal application and web interface.
📢 Latest Release: v1.15.1
- Feature: Table-driven plugin manager — numbered pick-from-table enable/disable and run flows, bulk toggles, and search across name/description/author.
- Feature: Configurable update-check interval (daily/weekly/monthly/never) with "Ignore This Version" on every update prompt.
- Fix: Quality-filtered downloads gracefully fall back to best instead of failing when a bucket has no streams.
🌟 Key Features
- Universal Extraction Core: Seamlessly download high-quality videos, playlists, audio streams, channel collections, and subtitles powered by a robust wrapper around
yt-dlp. - Sync Play (Watch Party) [Beta]: Synchronize media playback across all connected devices on your local network, perfect for hosting local watch parties.
- FluxMedia Web UI: A beautiful, responsive React-based web dashboard to remotely control your downloads, manage files, and host Watch Parties directly from your browser.
- Built-in LAN Sharing Gateway: Share downloaded files instantly to any device on your local network using a built-in password-protected HTTP server with QR code access.
- Instagram Profile Downloader [Beta]: Batch download media directly from Instagram profiles with our new custom extraction module.
- Advanced Post-Processing: Automatically extract audio (MP3/M4A/FLAC), merge separate audio/video formats, inject descriptions and tags, and embed album artwork via FFmpeg.
- Universal OS Support: The cross-platform
install.pyscript automatically resolves dependencies across Windows (winget), macOS (brew), Android Termux (pkg), and virtually all Linux package managers (apt,pacman,dnf,apk,zypper,xbps).
💻 Visual Preview
FluxMedia CLI Main Dashboard
Initial Setup & Disclaimer
FluxMedia Web Downloader
🚀 Quick Start
1. Installation
Cross-Platform (Python):
Ensure Python 3 is installed, then you can install directly via pip:
pip install fluxmedia
Alternatively, download and run the installer:
wget https://raw.githubusercontent.com/pdev-labs/FluxMedia/main/install.py
python3 install.py
Linux / macOS / Termux (Bash):
curl -sL https://raw.githubusercontent.com/pdev-labs/FluxMedia/main/install.sh | bash
Windows (PowerShell):
iex (irm https://raw.githubusercontent.com/pdev-labs/FluxMedia/main/install.ps1)
Alternatively, you can install directly via pip:
pip install fluxmedia
(Android/Termux Users: Pydantic-core requires compilation. See the Installation Guide for the correct pip command.)
For detailed, OS-specific manual installation instructions, please check the Installation Guide.
2. Usage
Launch the interactive console portal:
fluxmedia
Launch the newly added Web UI dashboard (also accessible by pressing W in the main menu):
fluxmedia --web
Or open the Textual TUI dashboard directly:
fluxmedia --tui
📚 Documentation
Detailed user guides and developer docs are organized in the docs/ folder:
- 📥 Installation Guide — Step-by-step setup guides for Windows, macOS, Linux, and Android (Termux).
- ⚙️ Configuration Guide — Explanations of config options, directories, and customization schemas.
- 📦 Downloader Engine — Internals on formatting flags, post-processors, and download strategies.
- 📶 LAN QR Share Portal — Guide to local HTTP streaming, REST API endpoints, and authentication tokens.
- 🛠️ Troubleshooting Guide — Common solutions for SSL issues, Windows Defender configurations, and storage permissions.
- 📖 Frequently Asked Questions — Answers to common developer and user questions.
- 🏗️ Architecture Overview — Codebase directory layout, dynamic imports, and module dependencies.
🗺️ Roadmap
We are constantly improving the platform. Here are our high-level goals:
- Milestone 1: Parallel multi-threaded downloading and expanded website extractors.
- Milestone 2: In-terminal visual video trimming and custom TUI styling themes.
- Milestone 3: Multi-user permissions on the share portal and upgraded web player seeking.
Check out ROADMAP.md for our complete milestones plan.
🤝 Contributing
We welcome all contributions! Whether you are fixing type errors, adding new feature modules, or enhancing the documentation:
- Review the Contributing Guide.
- Ensure you adhere to the Code of Conduct.
- If you modify any frontend web assets, remember to run the repack builder:
python repack.py
📜 License & Credits
FluxMedia is open-source software licensed under the GPL v3 License.
Credits
- Core extraction engine powered by yt-dlp.
- Terminal styling and layouts powered by rich and textual.
- Audio tagging powered by mutagen.
1 maintainer
Metadata
1 maintainer
Release files for fluxmedia 1.18.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| fluxmedia-1.18.0.tar.gz | 557.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| fluxmedia-1.18.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.1 MB
Release files / fluxmedia-1.18.0.tar.gz
| Download URL | fluxmedia-1.18.0.tar.gz |
|---|---|
| Size | 557.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
51de345a04073c058e6812b2078489c0448a15aae76289dfc301a85109766d14
|
|
BLAKE2b-256 checksum How to use checksums |
9e39521e637c99ab19a6a89f58d776002043a8ce34cda18ef6e6e39d196d7465
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 7, 2026.
Transparency logRelease files / fluxmedia-1.18.0-py3-none-any.whl
| Download URL | fluxmedia-1.18.0-py3-none-any.whl |
|---|---|
| Size | 558.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c5fb38e94f93ea407e272575b952ea053721b558290fa8a37e23d8d90c55acf6
|
|
BLAKE2b-256 checksum How to use checksums |
7fcf94bfc60e8994b35043caeff6646c43455c0ff8c908ba44887426f5d33a85
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 7, 2026.
Transparency log
