Movix

Le 1er site de streaming open source made in France et 100% vibecodé.

React | Vite | TypeScript | Node.js | MySQL | Redis | Socket.IO | Python | Rust

Licence : Creative Commons Attribution-NonCommercial 4.0 International (CC BY-NC 4.0) · LICENSE

Movix est un monorepo produit pour une plateforme de streaming communautaire. Le frontend, l'API principale, la WatchParty, les proxies, les outils navigateur et plusieurs briques d'infra vivent dans le même dépôt parce qu'ils évoluent ensemble.

Ce n'est pas un simple duo "frontend + backend". Une feature peut très vite traverser plusieurs couches à la fois : interface React, persistance locale, sync backend, extraction vidéo, proxy Python et parfois extension navigateur.

Ce que contient le repo

Zone	Rôle	Documentation
src/	Frontend Vite + React + TypeScript	Frontend
API/Mainapi/	Backend principal clusterisé	Main API
API/watchpartyAPI/	Service temps réel WatchParty	WatchParty API
API/proxiesembed/	Proxy aiohttp pour embeds, flux et DRM	Proxies Embed
API/miscs/	Micro-service Flask pour certains 403	bypass403
extension/ + userscript/	Outils navigateur Movix	Movix OS
app/	App mobile React Native (Android OK, iOS non testé)	App mobile
wasm/watchparty-sync/	Moteur Rust/WASM de la Sync Pro	WatchParty Sync WASM
cloudflareproxy/	Worker Cloudflare CORS/proxy	Cloudflare Proxy

Architecture du monorepo

movix-main/
|-- src/                        # Frontend principal
|-- public/                     # Assets statiques et artefacts WASM publiés
|-- API/
|   |-- Mainapi/                # Backend actif
|   |-- watchpartyAPI/          # Temps réel WatchParty
|   |-- proxiesembed/           # Proxy Python haute charge
|   `-- miscs/                  # Micro-services annexes
|-- extension/                  # Extension Chrome / Firefox
|-- userscript/                 # Variante Tampermonkey
|-- app/                        # App mobile React Native (Android/iOS)
|-- wasm/watchparty-sync/       # Sync Pro en Rust/WASM
|-- cloudflareproxy/            # Worker Cloudflare
|-- functions/                  # Handlers serverless annexes
|-- PreMid/                     # Présence PreMiD
`-- RivestreamCloudflareProxy/  # Variante de worker pour Rivestream

Démarrage rapide

Prérequis

• Node.js 18+ et npm
• Python 3.10+ pour les services Python
• MySQL et Redis pour API/Mainapi
• Rust + wasm-bindgen seulement si tu touches la Sync Pro WASM
• React Native CLI + Android Studio (et Xcode + CocoaPods sur Mac) seulement si tu touches l'app mobile app/ — iOS n'a pas été testé, voir app/README.md

Installer les dépendances utiles

npm install
cd API/Mainapi
npm install

API/watchpartyAPI/ n'a pas son propre package.json : il consomme les dépendances du node_modules racine.

Configurer les .env avant de lancer quoi que ce soit

Ne saute pas cette étape. Une bonne partie du monorepo dépend des variables d'environnement pour les URLs, la base de données, Redis, les proxys, TMDB, Turnstile et plusieurs intégrations de lecture.

# Frontend
cp .env.example .env

# API principale
cp API/Mainapi/.env.example API/Mainapi/.env

# WatchParty
cp API/watchpartyAPI/.env.example API/watchpartyAPI/.env

# Proxy embed
cp API/proxiesembed/.env.example API/proxiesembed/.env

# bypass403
cp API/miscs/.env.example API/miscs/.env

Lancer le minimum utile en local

# Frontend - http://localhost:3000
npm run dev

# Backend principal - http://localhost:25565
cd API/Mainapi
npm run dev

# WatchParty - http://localhost:25566
node API/watchpartyAPI/watchparty.js

Services optionnels selon la zone que tu touches :

# Proxy embed
cd API/proxiesembed
pip install -r requirements.txt
python server.py

# bypass403
cd API/miscs
pip install flask requests python-dotenv
python bypass403.py

Configuration

Les fichiers d'exemple ou de config existants sont déjà dans le repo :

• Frontend : .env.example
• API principale : API/Mainapi/.env.example
• WatchParty : API/watchpartyAPI/.env.example
• Proxy embed : API/proxiesembed/.env.example
• bypass403 : API/miscs/.env.example

Les variables frontend les plus importantes sont VITE_MAIN_API, VITE_WATCHPARTY_API, VITE_PROXY_BASE_URL, VITE_API_PROXY_BASE_URL, VITE_PROXIES_EMBED_API et VITE_SITE_URL.

Pour un premier lancement local, configure au minimum :

• /.env
• API/Mainapi/.env
• API/watchpartyAPI/.env

Comment s'orienter vite

• Feature frontend : commence par src/App.tsx, puis la page cible dans src/pages/.
• Auth, profils, persistance : regarde src/context/, src/App.tsx, API/Mainapi/routes/authRoutes.js et API/Mainapi/routes/sync.js.
• Lecture vidéo et proxies : recoupe src/pages/Watch/, les composants player, API/Mainapi/liveTvRoutes.js, API/proxiesembed/ et parfois extension/.
• WatchParty : vérifie à la fois API/watchpartyAPI/watchparty.js, src/pages/WatchParty*.tsx, src/hooks/useWatchParty.ts, src/utils/watchparty*.ts et src/workers/watchpartySync.worker.ts.
• Browser tooling : si tu modifies l'extension, compare toujours extension/Chrome/ et extension/Firefox/, puis vérifie si le userscript doit suivre.
• Sync Rust/WASM : modifie wasm/watchparty-sync/, puis rebuild public/wasm/watchparty-sync/.

Points importants avant de contribuer

• Le backend actif est API/Mainapi/. Le vieux contenu directement sous API/ n'est plus la référence.
• Ce monorepo n'utilise pas de workspace tooling : chaque sous-projet garde ses scripts.
• Une partie importante de l'état produit vit dans localStorage et dans la sync backend. Ne raisonne pas "base de données only".
• Le lint frontend se lance à la racine avec npm run lint.
• Il n'y a pas de suite de tests globale fiable pour tout le repo. Vérifie au minimum les scripts touchés et le comportement manuel.

Documentation par module

• Frontend
• Services backend
• Main API
• WatchParty API
• Proxies Embed
• bypass403
• Movix OS
• Extension navigateur
• Userscript Tampermonkey
• App mobile React Native — Android fonctionnel, iOS non testé (aide recherchée)
• WatchParty Sync WASM
• Cloudflare Proxy

Licence

Ce projet est distribué sous licence Creative Commons Attribution-NonCommercial 4.0 International (CC BY-NC 4.0). Le texte complet est disponible dans LICENSE.

Avertissement

Ce projet est fourni uniquement à des fins éducatives, de recherche et de démonstration. Il n'encourage ni ne cautionne une utilisation illégale, le contournement de droits, ou toute violation des lois applicables. Chaque utilisateur est seul responsable de l'usage qu'il en fait.