feat: add discover, following, recordings, settings, watch pages + CI release

- Add Discover page with gender/tag/search filters
- Add Following page with Chaturbate account sync
- Add Recordings page with built-in video player
- Add Settings page for account, FlareSolverr, tag blacklist
- Add Watch page for live stream viewing
- Add Chaturbate authentication (login/session/cookies)
- Add FlareSolverr integration for Cloudflare bypass
- Update CI workflow to build Docker + create GitHub Release from version.json changelog
- Rewrite README in English with screenshots

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: raccommode

.env.example

@@ -9,3 +9,14 @@ CB_RESOLVER_ENABLED=true
 # CB_COOKIE="session=...; other=..."
 # Optionnel: mot de passe pour protéger l'accès
 # PASSWORD=your_secure_password
+
+# Chaturbate Authentication (optional - enables Following page and better stream quality)
+# CHATURBATE_USERNAME=your_chaturbate_username
+# CHATURBATE_PASSWORD=your_chaturbate_password
+
+# FlareSolverr (optional - Cloudflare bypass, auto-configured with docker-compose)
+# FLARESOLVERR_URL=http://flaresolverr:8191
+# FLARESOLVERR_MAX_TIMEOUT=60000
+
+# Chaturbate request delay in seconds (rate limiting)
+# CB_REQUEST_DELAY=1.0

.github/workflows/docker-publish.yml

@@ -1,33 +1,31 @@
-name: Build and Push Docker Image
+name: Build, Push & Release
 
 on:
   push:
     tags:
       - '*'
-  release:
-    types: [published]
 
 jobs:
   build-and-push:
     runs-on: ubuntu-latest
     permissions:
-      contents: read
+      contents: write
       packages: write
-    
+
     steps:
       - name: Checkout
         uses: actions/checkout@v4
-      
+
       - name: Set up Docker Buildx
         uses: docker/setup-buildx-action@v3
-      
+
       - name: Log in to GitHub Container Registry
         uses: docker/login-action@v3
         with:
           registry: ghcr.io
           username: ${{ github.actor }}
           password: ${{ secrets.GITHUB_TOKEN }}
-      
+
       - name: Extract metadata
         id: meta
         uses: docker/metadata-action@v5
@@ -36,7 +34,7 @@ jobs:
           tags: |
             type=ref,event=tag
             type=raw,value=latest
-      
+
       - name: Build and push
         uses: docker/build-push-action@v5
         with:
@@ -46,3 +44,27 @@ jobs:
           labels: ${{ steps.meta.outputs.labels }}
           cache-from: type=gha
           cache-to: type=gha,mode=max
+
+      - name: Generate release notes from version.json
+        id: notes
+        run: |
+          VERSION=$(jq -r '.version' version.json)
+          BODY=$(jq -r '.changelog | map("- " + .) | join("\n")' version.json)
+          echo "version=$VERSION" >> "$GITHUB_OUTPUT"
+          {
+            echo "body<<EOF"
+            echo "## Changelog"
+            echo ""
+            echo "$BODY"
+            echo ""
+            echo "---"
+            echo "Docker image: \`ghcr.io/raccommode/p-streamrec:${GITHUB_REF_NAME}\`"
+            echo "EOF"
+          } >> "$GITHUB_OUTPUT"
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          name: ${{ steps.notes.outputs.version }}
+          body: ${{ steps.notes.outputs.body }}
+          generate_release_notes: false

.gitignore

@@ -9,4 +9,4 @@ __pycache__/
 .vscode/
 .idea/
 .windsurf
-.gitignore
+.claude/

README.md

@@ -4,132 +4,119 @@
 [![Docker](https://img.shields.io/badge/Docker-Ready-blue.svg)](https://www.docker.com/)
 [![Open Source](https://img.shields.io/badge/Open%20Source-Yes-green.svg)](https://github.com/raccommode/P-StreamRec)
 
-**Automatic recording of Chaturbate and m3u8 streams with a modern web interface**
+**Automatic Chaturbate & m3u8 stream recorder with a modern web interface.**
 
-![P-StreamRec Interface](screen.png)
+## Features
 
-## ✨ Features
+- **24/7 automatic recording** — monitors models and records when they go live
+- **Auto MP4 conversion** — converts TS to compressed MP4 in background (50-70% smaller)
+- **Discover** — browse live Chaturbate models with gender, tag, and search filters
+- **Following** — sync and view your followed models from your Chaturbate account
+- **Recordings** — manage all recordings with built-in video player
+- **Live Watch** — watch streams directly in the browser with HLS player
+- **Chaturbate auth** — login for better stream quality and followed models sync
+- **FlareSolverr** — automatic Cloudflare bypass via dedicated container
+- **Settings** — manage account, FlareSolverr status, tag blacklist
+- **Password protection** — optional login to secure the interface
+- **GitOps updates** — update the app directly from the UI
+- **Docker ready** — one command to get started
 
-- 🎥 **24/7 automatic recording** - Monitors and records when users go live
-- 🎬 **Auto MP4 conversion** - Automatically converts recordings to compressed MP4 after stream ends
-- 🌐 **Web interface** - Manage recordings and watch replays in browser
-- 📦 **Docker ready** - One command to get started
-- 🔄 **GitOps updates** - Update directly from the interface
-- 🎯 **Chaturbate + m3u8 support** - Works with any HLS stream
-- 💾 **Smart storage** - Unique ID per recording, automatic compression
-- 📊 **Size display** - Shows file sizes in MB or GB (>1000 MB)
+## Screenshots
 
-## ⚙️ Configuration (Environment Variables)
+| Discover | Following | Recordings |
+|----------|-----------|------------|
+| ![Discover](discover.png) | ![Following](following.png) | ![Recordings](recordings.png) |
 
-| Variable | Default | Description |
-|----------|---------|-------------|
-| `OUTPUT_DIR` | `/data` | Recordings folder (Docker volume) |
-| `PORT` | `8080` | Web interface port |
-| `FFMPEG_PATH` | `ffmpeg` | Path to ffmpeg |
-| `HLS_TIME` | `4` | HLS segment duration (seconds) |
-| `HLS_LIST_SIZE` | `6` | Number of segments in playlist |
-| `CB_RESOLVER_ENABLED` | `true` | **Enable Chaturbate support** |
-| `CB_COOKIE` | - | Chaturbate session cookie (optional) |
-| `PASSWORD` | - | **Password to protect access** (optional) |
-| `AUTO_RECORD_USERS` | - | Comma-separated list of users to auto-record |
-| `TZ` | `UTC` | Timezone (e.g., `America/New_York`) |
-
-## 🚀 Quick Start
-
-### Docker Run
-```bash
-docker run -d \
-  --name p-streamrec \
-  -p 8080:8080 \
-  -v ./data:/data \
-  -e CB_RESOLVER_ENABLED=true \
-  ghcr.io/raccommode/p-streamrec:latest
-```
+## Quick Start
+
+### Docker Compose (recommended, includes FlareSolverr)
 
-### Docker Compose
 ```yaml
 version: "3.8"
 services:
+  flaresolverr:
+    image: ghcr.io/flaresolverr/flaresolverr:latest
+    environment:
+      - LOG_LEVEL=info
+    ports:
+      - "8191:8191"
+    restart: unless-stopped
+
   p-streamrec:
     image: ghcr.io/raccommode/p-streamrec:latest
+    depends_on:
+      - flaresolverr
+    environment:
+      - CB_RESOLVER_ENABLED=true
+      - FLARESOLVERR_URL=http://flaresolverr:8191
     ports:
       - "8080:8080"
     volumes:
       - ./data:/data
-    environment:
-      - CB_RESOLVER_ENABLED=true
     restart: unless-stopped
 ```
 
-**Access:** `http://localhost:8080`
-
-## 🔐 Password Protection (Optional)
-
-Pour protéger l'accès à l'interface avec un mot de passe, définissez la variable `PASSWORD`:
+### Docker Run (simple)
 
-```yaml
-environment:
-  - PASSWORD=votre_mot_de_passe_securise
+```bash
+docker run -d --name p-streamrec \
+  -p 8080:8080 -v ./data:/data \
+  -e CB_RESOLVER_ENABLED=true \
+  ghcr.io/raccommode/p-streamrec:latest
 ```
 
-**Comportement:**
-- **Sans PASSWORD**: Accès direct à l'interface (comportement par défaut)
-- **Avec PASSWORD**: Redirection vers `/login` pour authentification
-- Les sessions sont conservées pendant 30 jours
-- Bouton de déconnexion 🚪 disponible dans l'interface
-
-## 📖 Usage
+**Access:** `http://localhost:8080`
 
-1. **Add a model**: Click **+** → Enter Chaturbate username or m3u8 URL
-2. **Auto-record**: System checks every 2 minutes and records when live
-3. **Auto-convert**: When stream ends, system converts TS to MP4 (50-70% smaller)
-4. **Watch replays**: Click model card → **Replays** tab (TS or MP4 available)
-5. **Update**: Click **GitOps** button in header to update app (Git deployment only)
+## Configuration
 
-**Recording Format:**
-- Original: `/data/records/<username>/YYYYMMDD_HHMMSS_ID.ts` (MPEG-TS)
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `OUTPUT_DIR` | `/data` | Recordings folder |
+| `PORT` | `8080` | Web interface port |
+| `FFMPEG_PATH` | `ffmpeg` | Path to FFmpeg |
+| `CB_RESOLVER_ENABLED` | `true` | Enable Chaturbate support |
+| `CB_REQUEST_DELAY` | `1.0` | Delay between Chaturbate requests (seconds) |
+| `PASSWORD` | — | Password to protect the interface (optional) |
+| `AUTO_RECORD_USERS` | — | Comma-separated usernames to auto-record |
+| `CHATURBATE_USERNAME` | — | Chaturbate login (optional, enables Following + better quality) |
+| `CHATURBATE_PASSWORD` | — | Chaturbate password (optional) |
+| `FLARESOLVERR_URL` | — | FlareSolverr URL (e.g. `http://flaresolverr:8191`) |
+| `TZ` | `UTC` | Timezone (e.g. `America/Toronto`) |
+
+## Usage
+
+1. **Add a model** — click **+**, enter a Chaturbate username or m3u8 URL
+2. **Auto-record** — the system checks every 2 minutes and records when live
+3. **Auto-convert** — when the stream ends, TS is converted to MP4 automatically
+4. **Watch live** — click a model card to open the live player
+5. **Browse replays** — go to the Recordings page to watch or delete recordings
+
+### Recording format
+
+- Original: `/data/records/<username>/YYYYMMDD_HHMMSS_ID.ts` (MPEG-TS, lossless)
 - Converted: `/data/records/<username>/YYYYMMDD_HHMMSS_ID.mp4` (H.264, auto-generated)
-- Each recording has unique ID: `username_YYYYMMDD_HHMMSS_sessionID`
 
-## 💻 Development
+### Storage estimates
+
+| Format | Size per hour |
+|--------|---------------|
+| TS (original) | ~2–4 GB |
+| MP4 (converted) | ~600 MB–1.2 GB |
+
+## Development
 
 ```bash
+git clone https://github.com/raccommode/P-StreamRec.git
+cd P-StreamRec
 python -m venv .venv && source .venv/bin/activate
 pip install -r requirements.txt
 uvicorn app.main:app --reload
 ```
 
-## 📂 File Management
-
-**Automatic Conversion:**
-- System automatically converts TS → MP4 when stream ends
-- MP4 files are 50-70% smaller (H.264 codec, CRF 23)
-- Conversion runs in background, no user action needed
-- Both TS and MP4 available in Replays tab
-
-**Play recordings:**
-- **Browser**: Use Replays tab (supports TS and MP4)
-- **VLC/MPV**: Open files directly from `/data/records/<username>/`
-- **MP4**: Better for streaming, smaller file size
-- **TS**: Original quality, no re-encoding
-
-**Manual conversion (if needed):**
-```bash
-ffmpeg -i input.ts -c:v libx264 -crf 23 -c:a aac output.mp4
-```
-
-## ⚠️ Notes
-
-- **Storage**: TS ~2-4 GB/hour, MP4 ~600 MB-1.2 GB/hour (after conversion)
-- **Sizes displayed**: MB for files < 1000 MB, GB for larger files
-- **Unique IDs**: Each recording has timestamp + session ID for easy identification
-- Use only for public, legally accessible content
+**Stack:** FastAPI, SQLite (aiosqlite), HLS.js, FFmpeg, Docker
 
-## 📜 License
+## License
 
-**Non-Commercial Open Source License** - See [LICENSE](LICENSE)
+**Non-Commercial Open Source License** — See [LICENSE](LICENSE)
 
-✅ Free to use, modify, and distribute  
-❌ **No commercial use or revenue generation**  
-🔄 Share modifications under same license  
-📝 Attribution required
+Free to use, modify, and distribute — **no commercial use** — share modifications under same license — attribution required

app/api/auth.py

@@ -0,0 +1,80 @@
+"""
+API Router: Chaturbate Authentication
+"""
+
+from fastapi import APIRouter, HTTPException
+from pydantic import BaseModel
+from typing import Optional
+
+router = APIRouter(prefix="/api/chaturbate", tags=["chaturbate-auth"])
+
+# These will be set by main.py at startup
+_auth_service = None
+_flaresolverr = None
+
+
+def init(auth_service, flaresolverr=None):
+    global _auth_service, _flaresolverr
+    _auth_service = auth_service
+    _flaresolverr = flaresolverr
+
+
+class LoginRequest(BaseModel):
+    username: str
+    password: str
+
+
+@router.post("/login")
+async def chaturbate_login(req: LoginRequest):
+    """Login to Chaturbate"""
+    if not _auth_service:
+        raise HTTPException(status_code=503, detail="Auth service not initialized")
+
+    result = await _auth_service.login(req.username, req.password)
+    if not result.get("success"):
+        raise HTTPException(status_code=401, detail=result.get("error", "Login failed"))
+
+    return result
+
+
+@router.get("/status")
+async def chaturbate_status():
+    """Get Chaturbate auth status"""
+    status = {}
+    if _auth_service:
+        status = _auth_service.get_status()
+
+    flaresolverr_available = False
+    if _flaresolverr:
+        flaresolverr_available = await _flaresolverr.is_available()
+
+    status["flaresolverrAvailable"] = flaresolverr_available
+    return status
+
+
+@router.post("/logout")
+async def chaturbate_logout():
+    """Clear Chaturbate session"""
+    if not _auth_service:
+        raise HTTPException(status_code=503, detail="Auth service not initialized")
+
+    await _auth_service.logout()
+    return {"success": True}
+
+
+@router.post("/refresh")
+async def chaturbate_refresh():
+    """Force re-login using saved credentials"""
+    if not _auth_service:
+        raise HTTPException(status_code=503, detail="Auth service not initialized")
+
+    # Get saved credentials from DB
+    auth_state = await _auth_service.db.get_auth_state()
+    if not auth_state or not auth_state.get("username"):
+        raise HTTPException(status_code=400, detail="No saved credentials")
+
+    # We can't re-login without the password (only hash is stored)
+    raise HTTPException(
+        status_code=400,
+        detail="Please login again with your credentials"
+    )