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

docker run -p 3110:8080 git.khoavo.myds.me/vndangkhoa/spotify-clone:v3

Open http://localhost:3110.

Option 2: Build Locally

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

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)

cd backend-rust
cargo run

Frontend

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