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.7.12
- Brand Update: Added newly designed app logo across the README, Local Share Portal, and React Web UI.
📢 Previous Release: v1.7.11
- Instagram 403 Forbidden Fix: Fixed an issue where the Instagram Profile Downloader would fail with a
403 Forbiddenerror because it was not loading the authenticatedinstaloadersession. The session is now properly loaded when fetching profiles or posts.
📢 Previous Release: v1.7.10
- Installer Silent Exit on Sub-Menu Selection: Fixed a critical bug in
install.shwhere selecting any submenu option other than the first (such as "Uninstall") would cause the entire script to instantly exit and return to the prompt. This occurred due to theshow_menufunction returning non-zero exit codes for downstream options whileset -ewas active. - Arch Linux Installer: Fixed the package name for
pipx(python-pipx) and added-Syto sync databases before downloading during thepacmandependency installation step on Arch Linux.
🌟 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 one-liner
install.shscript automatically resolves dependencies across macOS (brew), Android Termux (pkg), and virtually all Linux package managers (apt,pacman,dnf,apk,zypper,xbps).
💻 Visual Preview
FluxMedia CLI showing QR Share Gateway active on the local network.
🚀 Quick Start
1. Installation
Linux / macOS (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 MIT 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
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file fluxmedia-1.7.12.tar.gz.
File metadata
- Download URL: fluxmedia-1.7.12.tar.gz
- Upload date:
- Size: 1.3 MB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e051185c751b4cdc5e3fc2c391c11c3fd71e89a5d22f26300ea70f7f60560276
|
|
| MD5 |
89b34b369c94acaabe1682a017a06d85
|
|
| BLAKE2b-256 |
5e77acd3cc4dc7458190d53083aec3796328821e1d7d42a60c14fe6afdb1fcdb
|
Provenance
The following attestation bundles were made for fluxmedia-1.7.12.tar.gz:
Publisher:
publish.yml on pdev-labs/FluxMedia
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
fluxmedia-1.7.12.tar.gz -
Subject digest:
e051185c751b4cdc5e3fc2c391c11c3fd71e89a5d22f26300ea70f7f60560276 - Sigstore transparency entry: 2279220976
- Sigstore integration time:
-
Permalink:
pdev-labs/FluxMedia@800984e2b42cc6b274a7f4ccac0cae0263c69972 -
Branch / Tag:
refs/tags/v1.7.12 - Owner: https://github.com/pdev-labs
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@800984e2b42cc6b274a7f4ccac0cae0263c69972 -
Trigger Event:
release
-
Statement type:
File details
Details for the file fluxmedia-1.7.12-py3-none-any.whl.
File metadata
- Download URL: fluxmedia-1.7.12-py3-none-any.whl
- Upload date:
- Size: 1.3 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d39b828383a0e30bdb0afc80749425b65c503a26a389d3e75c2250f8313624e8
|
|
| MD5 |
ae8f175e04789f5ef5c19f8fe558b750
|
|
| BLAKE2b-256 |
7fd71a03d9ac8cdcf6e403adffd4f7cb4c7faaaf9aae5e8f89118b60941f895c
|
Provenance
The following attestation bundles were made for fluxmedia-1.7.12-py3-none-any.whl:
Publisher:
publish.yml on pdev-labs/FluxMedia
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
fluxmedia-1.7.12-py3-none-any.whl -
Subject digest:
d39b828383a0e30bdb0afc80749425b65c503a26a389d3e75c2250f8313624e8 - Sigstore transparency entry: 2279220990
- Sigstore integration time:
-
Permalink:
pdev-labs/FluxMedia@800984e2b42cc6b274a7f4ccac0cae0263c69972 -
Branch / Tag:
refs/tags/v1.7.12 - Owner: https://github.com/pdev-labs
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@800984e2b42cc6b274a7f4ccac0cae0263c69972 -
Trigger Event:
release
-
Statement type:
