🌊 FluxMedia
The official Python module and PyPI package for FluxMedia, featuring a customizable LAN QR share portal and rich media player.
A powerful, open-source, and cross-platform command-line media downloader designed for simplicity, robustness, and speed.
[!IMPORTANT] Disclaimer & Educational Notice: This program is developed strictly for educational and research purposes. You must obtain explicit permission from the original content creators before downloading any videos or media. The author does not assume any liability for unauthorized downloads or usage of this tool.
🚀 Quick Start
[!TIP] Looking for detailed step-by-step installation instructions for your specific OS (Windows, macOS, Linux, or Termux)? Check out the Detailed OS-Specific Setup Guide.
1. Installation
Install FluxMedia globally on any system running Python 3.10+ directly via pip:
pip install fluxmedia
If you run into an externally-managed-environment error on modern Linux systems, install using pipx instead:
pipx install fluxmedia
2. Execution
Run the interface from any terminal or command prompt:
fluxmedia
✨ Key Features
| Feature | Description |
|---|---|
| 🎨 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. |
| 🏷️ Metadata 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. |
| 🌐 LAN QR Share Portal | Easily share downloaded media over your local network using an interactive web portal. |
🛠️ 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 (Debian/Ubuntu)
sudo apt install ffmpeg
🔍 Troubleshooting
1. LAN QR Sharing Fails on Phone/Tablet
If your phone cannot load the link generated by the QR Share Server (http://<IP>:8000):
- Windows Network Profile: Windows Firewall blocks incoming traffic on Public networks. Open Windows Settings ➔ Network & internet ➔ Wi-Fi, click your connection properties, and change the network profile type to Private.
- Windows Firewall Inbound Rule: Add an inbound firewall rule in PowerShell to whitelist port 8000:
New-NetFirewallRule -DisplayName "FluxMedia LAN Share" -Direction Inbound -Action Allow -Protocol TCP -LocalPort 8000-8020
- Same Network: Ensure your phone is connected to the exact same Wi-Fi connection (or phone hotspot) as your laptop.
2. Audio Extraction or Trimming Fails
- FFmpeg Dependency: Merging streams, converting to MP3/M4A, and trimming downloads require FFmpeg. Make sure you have FFmpeg installed on your machine and added to your system's PATH.
3. Permission Denied on Android (Termux)
If downloads fail with PermissionError when writing to /sdcard/Download/FluxMediaDownloads/:
- Run the following command in Termux to grant file system storage access permissions:
termux-setup-storage
4. Locked Files on Windows Update
If upgrading FluxMedia or yt-dlp inside the app fails because the files are locked in memory:
- Close the application and run the update command directly from a standard terminal window:
pip install -U fluxmedia
5. SSL Certificate Verification Failures
If downloads fail with [SSL: CERTIFICATE_VERIFY_FAILED]:
- macOS Users: Go to your Applications/Python folder and double-click
Install Certificates.command. - All Platforms: Run:
pip install --upgrade certifi
👑 Credits & Support
This project was created and is fully maintained by 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! ⭐
- Support via UPI:
priyanshuc@fam
🐛 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
📜 Changelog
Check out the full CHANGELOG.md for detailed release history.
Latest Release: [v1.6.7]
- Media Player Updates: Added double-click to skip 10 seconds,
hours:minutes:secondsformat support for longer videos, and comprehensive YouTube-style keyboard shortcuts (k,j,l,f,m, and0-9). - Automated PyPI Publishing: Implemented GitHub Actions CI/CD workflows for secure Trusted Publishing to PyPI.
- PyPI README Fixes: Resolved 404 broken link errors on PyPI by utilizing absolute GitHub blob URLs.
- Share Portal Customization Submenu: Added a settings panel to configure profile display name, profile image (local/URL), custom website file/folder, and password configurations directly.
- Premium Material 3 Tones: Introduced 4 new theme tones (Royal Purple, Crimson Rose, Sunset Orange, Indigo Breeze) across all templates.
- Responsive Layout Optimizations: Optimized page header to stack controls cleanly on mobile viewports while preserving standard inline spacing on desktops.
- Port Overriding: Enabled running the sharing server on a custom port if the default port 8000 is occupied.
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.6.10.tar.gz.
File metadata
- Download URL: fluxmedia-1.6.10.tar.gz
- Upload date:
- Size: 90.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b723f6578312510e635c94dc48c6acb3ac705378e72ba231675955fef7731f3e
|
|
| MD5 |
be4dba0a12e54ae3f451428fbf9d3f51
|
|
| BLAKE2b-256 |
c601ce98d67488256c2a002f8279e4d4097c5d79c6a33b1295cbf72bd5208cae
|
Provenance
The following attestation bundles were made for fluxmedia-1.6.10.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.6.10.tar.gz -
Subject digest:
b723f6578312510e635c94dc48c6acb3ac705378e72ba231675955fef7731f3e - Sigstore transparency entry: 2142162302
- Sigstore integration time:
-
Permalink:
pdev-labs/FluxMedia@da301db37c34ba584f5b0a3b8452cbeb55eb5d09 -
Branch / Tag:
refs/tags/v1.6.10 - Owner: https://github.com/pdev-labs
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@da301db37c34ba584f5b0a3b8452cbeb55eb5d09 -
Trigger Event:
release
-
Statement type:
File details
Details for the file fluxmedia-1.6.10-py3-none-any.whl.
File metadata
- Download URL: fluxmedia-1.6.10-py3-none-any.whl
- Upload date:
- Size: 88.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
47641d9a81da23e868f0cb0251b850833768a961b01d9b20cf011fd8fd32b275
|
|
| MD5 |
fa7ba42e37bd9b9df18a8b9196a8b1b1
|
|
| BLAKE2b-256 |
f834d59771c32460e3713f6153ac244a550a2cc5706fbac3d0d6c7658a047ea5
|
Provenance
The following attestation bundles were made for fluxmedia-1.6.10-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.6.10-py3-none-any.whl -
Subject digest:
47641d9a81da23e868f0cb0251b850833768a961b01d9b20cf011fd8fd32b275 - Sigstore transparency entry: 2142162488
- Sigstore integration time:
-
Permalink:
pdev-labs/FluxMedia@da301db37c34ba584f5b0a3b8452cbeb55eb5d09 -
Branch / Tag:
refs/tags/v1.6.10 - Owner: https://github.com/pdev-labs
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@da301db37c34ba584f5b0a3b8452cbeb55eb5d09 -
Trigger Event:
release
-
Statement type:
