Troubleshooting Guide

Detailed solutions to common errors and setup problems.

If your phone cannot load the link generated by the QR Share Server, it is usually a firewall issue. Follow these steps to resolve:

Step 1: Set Windows Network Profile to Private

Windows Firewall blocks incoming traffic on Public networks. Open Windows Settings ➔ Network & internetWi-Fi, click your connection properties, and change the network profile type to Private.

Step 2: Add Firewall Rule (Recommended)

Open PowerShell as Administrator and run the following command to whitelist port 8000 for FluxMedia:

New-NetFirewallRule -DisplayName "FluxMedia LAN Share" -Direction Inbound -Action Allow -Protocol TCP -LocalPort 8000-8020

Merging video/audio 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.

Install FFmpeg on Windows:

winget install Gyan.FFmpeg

Install FFmpeg on macOS:

brew install ffmpeg

Install FFmpeg on Linux (Debian/Ubuntu):

sudo apt install ffmpeg

If downloads fail with PermissionError when writing to /sdcard/Download/FluxMediaDownloads/, you need to grant storage permissions to Termux.

Run the following command and accept the prompt on your phone:

termux-setup-storage

If upgrading FluxMedia inside the app fails because the files are locked in memory (common on Windows), close the application and run the update command directly from a standard terminal window:

pip install -U fluxmedia

If downloads fail with [SSL: CERTIFICATE_VERIFY_FAILED] on macOS or other systems, you need to update your Python SSL certificates.

For macOS Users:

Go to your Applications/Python folder and double-click Install Certificates.command

For All Other Platforms:

pip install --upgrade certifi