🎉 Initial commit: AudiOhm - Alternative à Spotify avec streaming YouTube
Features: - Frontend Flutter avec thème néon cyberpunk - Backend FastAPI avec streaming YouTube - Base de données PostgreSQL + Redis - Authentification JWT complète - Recherche multi-source (DB + YouTube) - Playlists CRUD avec drag & drop - Queue management - Settings avec audio quality - Interface adaptative (Desktop + Mobile) Tech Stack: - Frontend: Flutter 3.2+, Riverpod - Backend: Python 3.11+, FastAPI - Database: PostgreSQL 15+ - Cache: Redis 7+ - Streaming: yt-dlp + FFmpeg 🚀 Generated with Claude Code Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
+205
@@ -0,0 +1,205 @@
|
||||
# 🚀 INSTALLATION RAPIDE - SPOTIFY LE 2
|
||||
|
||||
> **Installation automatisée en 2 minutes !**
|
||||
|
||||
---
|
||||
|
||||
## ⚡ Installation Clé en Main
|
||||
|
||||
### 🪟 Windows
|
||||
|
||||
**Double-cliquez sur:** `INSTALL_WINDOWS.bat`
|
||||
|
||||
**Ou manuellement:**
|
||||
```cmd
|
||||
1. Télécharger Docker Desktop: https://www.docker.com/products/docker-desktop/
|
||||
2. Lancer: INSTALL_WINDOWS.bat
|
||||
3. Patienter...
|
||||
4. Lancer: START_WINDOWS.bat
|
||||
```
|
||||
|
||||
### 🐧 Linux / 🍎 macOS
|
||||
|
||||
```bash
|
||||
# Lancer l'installateur
|
||||
chmod +x INSTALL.sh START.sh
|
||||
./INSTALL.sh
|
||||
|
||||
# Démarrer l'app
|
||||
./START.sh
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ✅ Prérequis
|
||||
|
||||
### Obligatoires
|
||||
- **Docker Desktop** - Pour PostgreSQL + Redis
|
||||
- **Python 3.11+** - Pour le backend
|
||||
- **Git** - Pour le versioning
|
||||
- **Flutter 3.2+** - Pour le frontend
|
||||
|
||||
### Installation des prérequis
|
||||
|
||||
**Windows:**
|
||||
1. Python: https://www.python.org/downloads/ (cocher "Add to PATH")
|
||||
2. Git: https://git-scm.com/download/win
|
||||
3. Docker: https://www.docker.com/products/docker-desktop/
|
||||
4. Flutter: https://docs.flutter.dev/get-started/install/windows
|
||||
|
||||
**Linux:**
|
||||
```bash
|
||||
# Ubuntu/Debian
|
||||
sudo apt update
|
||||
sudo apt install -y python3 python3-pip python3-venv git docker.io docker-compose
|
||||
# Flutter: voir https://docs.flutter.dev/get-started/install/linux
|
||||
```
|
||||
|
||||
**macOS:**
|
||||
```bash
|
||||
# Avec Homebrew
|
||||
brew install python3 git docker docker-compose
|
||||
# Flutter: voir https://docs.flutter.dev/get-started/install/macos
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎯 Après Installation
|
||||
|
||||
### Lancement Automatique
|
||||
|
||||
**Windows:** `START_WINDOWS.bat`
|
||||
**Linux/Mac:** `./START.sh`
|
||||
|
||||
### Lancement Manuel
|
||||
|
||||
**Terminal 1 - Backend:**
|
||||
```bash
|
||||
cd backend
|
||||
venv\Scripts\activate # Windows
|
||||
# source venv/bin/activate # Linux/Mac
|
||||
uvicorn app.main:app --reload
|
||||
```
|
||||
|
||||
**Terminal 2 - Frontend:**
|
||||
```bash
|
||||
cd frontend
|
||||
flutter run -d windows # Windows Desktop
|
||||
flutter run -d android # Android
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔧 Configuration
|
||||
|
||||
### Backend (`backend/.env`)
|
||||
|
||||
```env
|
||||
# Application
|
||||
DEBUG=true
|
||||
SECRET_KEY=change-ce-dans-.env-!!!
|
||||
|
||||
# Database (géré par Docker)
|
||||
POSTGRES_HOST=localhost
|
||||
POSTGRES_PORT=5432
|
||||
POSTGRES_USER=spotify
|
||||
POSTGRES_PASSWORD=spotify_password
|
||||
POSTGRES_DB=spotify_le_2
|
||||
|
||||
# Redis (géré par Docker)
|
||||
REDIS_HOST=localhost
|
||||
REDIS_PORT=6379
|
||||
```
|
||||
|
||||
### Frontend
|
||||
|
||||
L'URL de l'API est déjà configurée dans `frontend/lib/core/constants/api_constants.dart`:
|
||||
```dart
|
||||
const String baseUrl = 'http://localhost:8000/api/v1';
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎮 Utilisation
|
||||
|
||||
### Première Utilisation
|
||||
|
||||
1. **Lancer l'application** → Page de connexion
|
||||
2. **Créer un compte** → Email + Password
|
||||
3. **Se connecter** → Page d'accueil
|
||||
4. **Rechercher** → Tape "Daft Punk" ou autre
|
||||
5. **Écouter** → Tape un track pour le jouer !
|
||||
|
||||
### Fonctionnalités
|
||||
|
||||
- ✅ **Recherche** multi-source (DB + YouTube)
|
||||
- ✅ **Streaming** audio avec HTTP Range
|
||||
- ✅ **Playlists** complètes (CRUD, drag & drop)
|
||||
- ✅ **Queue** de lecture
|
||||
- ✅ **Library** (Playlists, Albums, Artists)
|
||||
- ✅ **Mini Player** avec contrôles
|
||||
- ✅ **Settings** (Profile, Audio Quality)
|
||||
|
||||
---
|
||||
|
||||
## 🐛 Problèmes Courants
|
||||
|
||||
### "Python n'est pas installé"
|
||||
→ Téléchargez Python 3.11+ sur python.org
|
||||
|
||||
### "Docker ne démarre pas"
|
||||
→ Vérifiez que Docker Desktop est lancé
|
||||
|
||||
### "Flutter command not found"
|
||||
→ Ajoutez Flutter au PATH:
|
||||
- **Windows:** `%LOCALAPPDATA%\Flutter\bin`
|
||||
- **Linux/Mac:** `export PATH="$PATH:`pwd`/flutter/bin"`
|
||||
|
||||
### "Le backend ne répond pas"
|
||||
→ Vérifiez que `uvicorn app.main:app --reload` tourne dans le terminal backend
|
||||
|
||||
### "Port 8000 déjà utilisé"
|
||||
→ Changez le port dans le backend: `uvicorn app.main:app --port 8001`
|
||||
|
||||
---
|
||||
|
||||
## 📱 Plateformes Supportées
|
||||
|
||||
- ✅ **Windows 10/11** - Desktop app
|
||||
- ✅ **Linux** - Desktop app
|
||||
- ✅ **macOS** - Desktop app
|
||||
- ✅ **Android** - Mobile app (6.0+)
|
||||
|
||||
---
|
||||
|
||||
## 🔗 Liens Utiles
|
||||
|
||||
- **Backend API:** http://localhost:8000/docs (Swagger UI)
|
||||
- **Frontend:** Lancé automatiquement par Flutter
|
||||
- **Docker:** http://localhost:8000 (Backend API)
|
||||
|
||||
---
|
||||
|
||||
## 🎨 Thème Néon Cyberpunk
|
||||
|
||||
L'application utilise un thème unique avec:
|
||||
- **Cyan** (#00F0FF) - Accents primaires
|
||||
- **Violet** (#BF00FF) - Accents secondaires
|
||||
- **Rose** (#FF006E) - Accents tertiaires
|
||||
- **Glow effects** - Effets de lueur néon
|
||||
|
||||
---
|
||||
|
||||
## 📚 Documentation Complète
|
||||
|
||||
Voir `README.md` pour la documentation détaillée du projet.
|
||||
|
||||
---
|
||||
|
||||
**Questions? Problèmes?**
|
||||
|
||||
1. Vérifiez les logs dans les terminaux
|
||||
2. Consultez `docs/` pour plus d'infos
|
||||
3. Vérifiez que Docker Desktop tourne
|
||||
|
||||
**Bon usage ! 🎵**
|
||||
Reference in New Issue
Block a user