Initial commit: StreamFlow IPTV platform

2025-12-17 00:42:43 +00:00 · 2025-12-17 00:42:43 +00:00 · 73a8ae9ffd
commit 73a8ae9ffd
1240 changed files with 278451 additions and 0 deletions
--- a/desktop-app/QUICKSTART.md
+++ b/desktop-app/QUICKSTART.md
@ -0,0 +1,126 @@
+# StreamFlow Desktop App - Quick Start
+
+## For End Users
+
+### Download & Install
+
+1. **Download** the AppImage from releases
+2. **Make executable:**
+   ```bash
+   chmod +x StreamFlow-*.AppImage
+   ```
+3. **Run:**
+   ```bash
+   ./StreamFlow-*.AppImage
+   ```
+
+### First Time Setup
+
+1. Enter your server URL (e.g., `https://your-server.com`)
+2. Click **"Test Connection"**
+3. Enter your username and password
+4. (Optional) Check **"Remember credentials"**
+5. Click **"Connect"**
+
+### If You Have 2FA
+
+After logging in, you'll be prompted to:
+- Enter your 6-digit authenticator code
+- Or use an 8-character backup code
+
+### Changing Language
+
+Click the language button (English/Română) on the connection screen.
+
+---
+
+## For Developers
+
+### Setup
+
+```bash
+cd desktop-app
+npm install
+npm run dev
+```
+
+### Build AppImage
+
+```bash
+./build.sh
+# Or
+npm run build:appimage
+```
+
+### Project Structure
+
+- `src/main/` - Electron main process
+- `src/renderer/` - Connection UI
+- `src/preload/` - IPC bridge
+- `build/` - Build resources (icon, desktop file)
+
+### Key Features
+
+✅ Server connection management  
+✅ Secure credential storage (encrypted)  
+✅ 2FA support (TOTP & backup codes)  
+✅ Multi-language (EN, RO)  
+✅ Hardware acceleration  
+✅ Full web app feature parity  
+
+### Documentation
+
+- `README.md` - Overview & user guide
+- `INSTALLATION.md` - Detailed installation
+- `DEVELOPER_GUIDE.md` - Development docs
+- `SECURITY_AUDIT.md` - Security review
+
+---
+
+## Troubleshooting
+
+**Can't run AppImage?**
+```bash
+sudo apt install fuse libfuse2
+```
+
+**Connection fails?**
+- Check server URL includes `http://` or `https://`
+- Verify server is running
+- Check firewall settings
+
+**2FA not working?**
+```bash
+# Check system time is synchronized
+timedatectl status
+```
+
+---
+
+## Support
+
+- Check documentation in `desktop-app/` folder
+- Open an issue on GitHub
+- Contact your server administrator
+
+---
+
+## Building from Source
+
+```bash
+# Prerequisites
+node --version  # Need 18+
+npm --version
+
+# Install & build
+cd desktop-app
+npm install
+./build.sh
+
+# Output
+dist/StreamFlow-*.AppImage
+```
+
+---
+
+**That's it! Enjoy StreamFlow on your Linux desktop! 🎬📺**