Troubleshooting Guide

This guide helps resolve common issues encountered while setting up or running FluxMedia.

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 Defender Firewall blocks incoming connections on Public networks. Go to Windows Settings ➔ Network & internet ➔ Wi-Fi, click your connection properties, and change the network profile type to Private.

Windows Firewall Inbound Rule: Run this command in an Administrator PowerShell window to whitelist port 8000:

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

Network Alignment: Make sure both your host PC and client devices are connected to the exact same Wi-Fi router or hotspot network.

FFmpeg Requirement: Converting streams to MP3/M4A/FLAC, merging video formats, and cutting segments require FFmpeg. Refer to the Installation Guide to install it on your OS.
Path Verification: Ensure FFmpeg is registered in your environment variables. Run ffmpeg -version in a clean terminal window to confirm.

If downloading media fails with PermissionError when writing to /sdcard/Download:

Run the following command inside Termux and accept the storage permission prompt on your device:
```
termux-setup-storage
```

If updating FluxMedia or yt-dlp inside the app fails because the files are locked in memory (WinError 32):

Close the FluxMedia application and run the update command directly from a standard CMD or PowerShell window:
```
pip install -U fluxmedia
```

If downloads fail with [SSL: CERTIFICATE_VERIFY_FAILED]:

macOS Users: Go to your Applications/Python folder and double-click Install Certificates.command to initialize certificates.
All Platforms: Upgrade the root certificates package:
```
pip install --upgrade certifi
```