FluxMedia Logo

FluxMedia

A premium, cross-platform media portal and processing toolkit.

PyPI Version Supported Python Versions License Downloads Code Style

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.6.51

  • Cross-Platform Fixes: Fixed native file explorer launching specifically on Windows Subsystem for Linux (WSL) and Termux (Android). Hardened file paths throughout the system to use universally safe path joins.

🌟 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.sh script 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 Dashboard

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

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:

  1. Review the Contributing Guide.
  2. Ensure you adhere to the Code of Conduct.
  3. 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.
Made with ❤️ by pdev-labs

Project links

Data verified by PyPI on Jul 20, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (1.7.20)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for pdev-labs from gravatar.com pdev-labs

GitHub Statistics

Data verified by PyPI on Jul 20, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

MIT
View SPDX License List

Requires

Python >=3.8

Classifiers

Report project as malware

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.6.51.tar.gz (1.3 MB view details)

Uploaded Source

Built Distribution

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

fluxmedia-1.6.51-py3-none-any.whl (1.3 MB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: fluxmedia-1.6.51.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

Hashes for fluxmedia-1.6.51.tar.gz
Algorithm Hash digest
SHA256 f12fd66336efa5185d88f4017f4cdf7731c708c061940942362e10f12b9914a7
MD5 d9c69fdddc4657c78efc247a89134581
BLAKE2b-256 afaaaba4ecd333ffdf9f369cae7935ffda1617526e72dde4ad5e655ed97de67a

See more details on using hashes here.

Provenance

The following attestation bundles were made for fluxmedia-1.6.51.tar.gz:

Publisher: publish.yml on pdev-labs/FluxMedia

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

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

File metadata

  • Download URL: fluxmedia-1.6.51-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

Hashes for fluxmedia-1.6.51-py3-none-any.whl
Algorithm Hash digest
SHA256 2f91848eacf56c617e4756b4a8731d16be2f5e7d406333c18f0699f9a9e12938
MD5 d3c291c6c11ba41eadfe628a97085a06
BLAKE2b-256 78455fb067094c6e27b99763deca33073fee0658e48192c1fc64e228c50d74ca

See more details on using hashes here.

Provenance

The following attestation bundles were made for fluxmedia-1.6.51-py3-none-any.whl:

Publisher: publish.yml on pdev-labs/FluxMedia

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

1.7.20

1.7.19

1.7.18

1.7.17

1.7.16

1.7.15

1.7.14

1.7.13

1.7.12

1.7.11

1.7.10

1.7.9

1.7.8

1.7.7

1.7.6

1.7.5

1.7.4

1.7.3

1.7.2

1.7.1

1.7.0

1.6.57

1.6.56

1.6.55

1.6.54

1.6.53

1.6.52

This release

1.6.51

1.6.50

1.6.49

1.6.48

1.6.47

1.6.46

1.6.45

1.6.44

1.6.43

1.6.42

1.6.41

1.6.40

1.6.38

1.6.37

1.6.36

1.6.35

1.6.34

1.6.33

1.6.32

1.6.31

1.6.30

1.6.29

1.6.28

1.6.27

1.6.26

1.6.25

1.6.24

1.6.23

1.6.22

1.6.20

1.6.19

1.6.18

1.6.17

1.6.16

1.6.15

1.6.14

1.6.13

1.6.12

1.6.11

1.6.10

1.6.9

1.6.8

1.6.7

1.6.6

1.6.5

1.6.3

1.6.2

1.6.1

1.6.0

1.5.9

1.5.8

1.5.7

1.5.6

1.5.5

1.5.4

1.5.3

1.4.8

1.4.6

1.4.5

1.4.4

1.4.3

1.4.2

1.3.9

1.3.5

1.3.4

1.3.3

1.2.1

1.2.0

1.1.1

1.0.3

1.0.2

1.0.1

1.0.0

Supported by

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