# 🎵 Music Streaming API

> An HLS-based music streaming API with random playback capabilities / API phát nhạc trực tuyến với tính năng streaming HLS và phát ngẫu nhiên

<p align="center">
  <img src="docs/images/preview.png" alt="Preview" width="600"/>
</p>

## ✨ Features

### 🎧 Music Playback
- ✅ HLS (HTTP Live Streaming) support
- ✅ Auto-next track functionality
- ✅ Random playback
- ✅ Play count tracking

### 📁 File Management
- ✅ Music file upload support
- ✅ Automatic processing and segmentation
- ✅ Multiple audio format support
- ✅ Multi-quality HLS playlist generation

### 💾 Database Structure

| Table | Purpose |
|-------|---------|
| `users` | User management & authentication |
| `tracks` | Song metadata & file paths |
| `segments` | HLS segment information |
| `playlists` | HLS & user playlist data |
| `likes` | Track likes & favorites |
| `comments` | User comments & feedback |

### 🚀 Optimizations
- ⚡ Search optimization indexes
- 📊 SQLite WAL mode
- 🔄 Transaction support
- 📦 Streaming buffer & cache
- 🛡️ Comprehensive error handling

## 🛠️ Installation

```bash
# Clone repository
git clone https://github.com/vovanhau123/HTTP-STREAMING.git

# Navigate to project
cd music-streaming-api

# Install dependencies
npm install

# Initialize directories
npm run init

# Start server
npm start
```

> 🌐 Server runs at `http://localhost:3000`

## 📡 API Endpoints

### 🎵 Tracks

| Method | Endpoint | Description |
|--------|----------|-------------|
| `GET` | `/api/tracks` | Get all tracks |
| `GET` | `/api/tracks/:id/playlist` | Get track's HLS playlist |
| `GET` | `/api/tracks/random` | Get random track |
| `GET` | `/api/tracks/random/:genre` | Get random track by genre |
| `POST` | `/api/tracks/:id/play` | Update play count |

### 📤 Upload

| Method | Endpoint | Description |
|--------|----------|-------------|
| `POST` | `/upload` | Upload new music file |

## 📂 Project Structure

```
music-streaming-api/
├── data/               # SQLite database
├── public/            
│   ├── index.html     # Frontend interface
│   └── streams/       # HLS stream files
├── src/
│   ├── config/        # App configuration
│   ├── controllers/   # Request handlers
│   ├── middleware/    # Custom middleware
│   ├── models/        # Data models
│   ├── routes/        # API routes
│   ├── services/      # Business logic
│   └── server.js      # Entry point
├── uploads/           # Uploaded files
└── package.json
```

## 🛠️ Tech Stack

<p align="center">
  <img src="https://nodejs.org/static/images/logo.svg" alt="Node.js" width="60" height="60"/>
  <img src="https://expressjs.com/images/express-facebook-share.png" alt="Express.js" width="60" height="60"/>
  <img src="https://www.sqlite.org/images/sqlite370_banner.gif" alt="SQLite" width="60" height="60"/>
  <img src="https://raw.githubusercontent.com/video-dev/hls.js/master/doc/design/logo.png" alt="HLS.js" width="60" height="60"/>
</p>

- **Backend**: Node.js, Express.js
- **Database**: SQLite3
- **Streaming**: HLS.js
- **File Upload**: Multer

## 🗺️ Roadmap

- [ ] 🔐 User authentication & authorization
- [ ] 📝 Playlist management system
- [ ] ❤️ Like & comment functionality
- [ ] 🔍 Advanced search with filters
- [ ] 🎯 Personalized recommendations
- [ ] 📊 Listening statistics & analytics

## 🤝 Contributing

1. Fork the Project
2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the Branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request

## 📄 License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

## 📬 Contact

Your Name - [@yourtwitter](https://twitter.com/yourtwitter) - email@example.com

Project Link: [https://github.com/vovanhau123/HTTP-STREAMING](https://github.com/vovanhau123/HTTP-STREAMING)

---
<p align="center">
  Made with ❤️ by vovanhau123
</p>