# Spotify Clone 🎵

A fully functional Spotify-like web player built with **React (Vite)**, **Rust (Axum)**, and **TailwindCSS**. Features include real-time lyrics, custom playlists, and YouTube Music integration.

---

## 🚀 Quick Start (Docker)

### Option 1: Pull from Forgejo Registry
```bash
docker run -p 3110:8080 git.khoavo.myds.me/vndangkhoa/spotify-clone:v3
```
Open **[http://localhost:3110](http://localhost:3110)**.

### Option 2: Build Locally
```bash
docker build -t spotify-clone:v3 .
docker run -p 3110:8080 spotify-clone:v3
```

---

## 🐳 Docker Deployment

### Image Details
- **Registry**: `git.khoavo.myds.me/vndangkhoa/spotify-clone`
- **Tag**: `v3`
- **Architecture**: `linux/amd64`
- **Ports**: 
  - `8080` (Backend API)

### docker-compose.yml
```yaml
services:
  spotify-clone:
    image: git.khoavo.myds.me/vndangkhoa/spotify-clone:v3
    container_name: spotify-clone
    restart: unless-stopped
    ports:
      - "3110:8080"
    environment:
      - PORT=8080
    volumes:
      - ./data:/tmp/spotify-clone-downloads
      - ./cache:/tmp/spotify-clone-cache
    logging:
      driver: "json-file"
      options:
        max-size: "10m"
        max-file: "3"
```

---

## 🖥️ Synology NAS Deployment (Container Manager)

### Method A: Using Container Manager UI

1. Open **Container Manager** (or Docker on older DSM).
2. Go to **Registry** → **Add** → Enter:
   - Registry: `git.khoavo.myds.me`
3. Search for `spotify-clone` and download the `v3` tag.
4. Go to **Image** → Select the image → **Run**.
5. Configure:
   - **Container Name**: `spotify-clone`
   - **Network**: Bridge
   - **Port Settings**: Local Port `3110` → Container Port `8080`
   - **Volume Settings**:
     - Create folder `/docker/spotify-clone/data` → `/tmp/spotify-clone-downloads`
     - Create folder `/docker/spotify-clone/cache` → `/tmp/spotify-clone-cache`
6. Click **Run**.

### Method B: Using Docker Compose

1. Create folder: `/volume1/docker/spotify-clone`
2. Save the `docker-compose.yml` above to that folder.
3. Open Container Manager → **Project** → **Create**.
4. Select the folder path.
5. The container will start automatically.
6. Access at `http://YOUR_NAS_IP:3110`

---

## 🔄 Auto-Refresh

The backend automatically fetches trending content from YouTube Music every 5 minutes. No additional setup required.

---

## 🛠️ Local Development

### Prerequisites
- Node.js 20+
- Rust 1.75+
- Python 3.11+
- ffmpeg

### Backend (Rust)
```bash
cd backend-rust
cargo run
```

### Frontend
```bash
cd frontend-vite
npm install
npm run dev
```

---

## ✨ Features

- **YouTube Music Integration**: Search and play from YouTube Music
- **Trending Auto-Fetch**: 15+ categories updated every 5 minutes
- **Real-Time Lyrics**: Sync lyrics from multiple sources
- **Custom Playlists**: Create, save, and manage playlists (IndexedDB)
- **PWA Support**: Works offline with cached content
- **Responsive Design**: Mobile-first with dark theme

---

## 📝 License

MIT License