213 lines
5.5 KiB
Markdown
213 lines
5.5 KiB
Markdown

|
|
|
|
Self-hosted YouTube music streaming application built with Next.js.
|
|
|
|
## Preview
|
|
#### Desktop
|
|

|
|
|
|
#### Mobile
|
|

|
|
|
|
#### Playlist
|
|

|
|
|
|
## Features
|
|
|
|
- 🎵 Stream music from YouTube without downloading files
|
|
- 🎨 Beautiful dark mode interface
|
|
- 📱 Fully responsive design (mobile & desktop)
|
|
- 🎮 Full playback controls (play, pause, next, previous, shuffle)
|
|
- 🔊 Volume control with visual feedback
|
|
- 📊 Progress bar with seeking and time display
|
|
- 🎼 Create and manage playlists
|
|
- 🌐 Global player - music continues playing across page navigation
|
|
- 🔔 Toast notifications for user feedback
|
|
- � Simple JSON file storage - no database setup required
|
|
- 🐳 Easy Docker deployment
|
|
|
|
## Tech Stack
|
|
|
|
- **Frontend & Backend**: Next.js 15 (App Router)
|
|
- **Styling**: Tailwind CSS v4
|
|
- **Storage**: JSON file-based database
|
|
- **Audio Streaming**: yt-dlp
|
|
- **Icons**: Lucide React
|
|
- **Containerization**: Docker
|
|
|
|
## Prerequisites
|
|
|
|
- Node.js 20+ (for local development)
|
|
- Docker & Docker Compose (for deployment)
|
|
- Python 3 & yt-dlp (installed automatically in Docker)
|
|
|
|
## Local Development
|
|
|
|
1. **Install dependencies:**
|
|
```bash
|
|
npm install
|
|
```
|
|
|
|
2. **Install yt-dlp:**
|
|
```bash
|
|
pip install yt-dlp
|
|
```
|
|
|
|
3. **Run the development server:**
|
|
```bash
|
|
npm run dev
|
|
```
|
|
|
|
4. **Open your browser:**
|
|
Navigate to [http://localhost:3000](http://localhost:3000)
|
|
|
|
The database file (`data/db.json`) will be created automatically on first run.
|
|
|
|
## Quick Start with Docker (Recommended)
|
|
|
|
1. **Download the docker-compose.yml file:**
|
|
```bash
|
|
wget https://raw.githubusercontent.com/bitc0de/bitify/main/docker-compose.yml
|
|
```
|
|
Or on Windows PowerShell:
|
|
```powershell
|
|
Invoke-WebRequest -Uri https://raw.githubusercontent.com/bitc0de/bitify/main/docker-compose.yml -OutFile docker-compose.yml
|
|
```
|
|
|
|
2. **Start the application:**
|
|
```bash
|
|
docker-compose up -d
|
|
```
|
|
|
|
3. **Access the application:**
|
|
Navigate to [http://localhost:3000](http://localhost:3000)
|
|
|
|
Your music library will be stored in `./data/db.json` and persists across container restarts.
|
|
|
|
### Updating to Latest Version
|
|
|
|
```bash
|
|
docker-compose down
|
|
docker-compose pull
|
|
docker-compose up -d
|
|
```
|
|
|
|
### Complete Cleanup (removes all data)
|
|
|
|
```bash
|
|
docker-compose down -v
|
|
docker rmi ghcr.io/bitc0de/bitify:latest
|
|
rm -rf data/
|
|
```
|
|
|
|
The Docker image is automatically built and published to GitHub Container Registry on each release.
|
|
|
|
## Build from Source
|
|
|
|
If you prefer to build the Docker image yourself:
|
|
|
|
1. **Clone the repository:**
|
|
```bash
|
|
git clone https://github.com/bitc0de/bitify.git
|
|
cd bitify
|
|
```
|
|
|
|
2. **Build and run:**
|
|
```bash
|
|
docker build -t bitify .
|
|
docker-compose up -d
|
|
```
|
|
|
|
## Usage
|
|
|
|
1. **Add a song**: Paste a YouTube URL in the input field and click "Add"
|
|
2. **Play a song**: Click the play button on any song card
|
|
3. **Control playback**: Use the player controls at the bottom of the page
|
|
4. **Create playlists**: Navigate to Playlists and create your custom collections
|
|
5. **Shuffle mode**: Toggle shuffle to randomize playback order
|
|
6. **Navigate freely**: Music continues playing as you browse different pages
|
|
|
|
## API Endpoints
|
|
|
|
- `POST /api/songs` - Add a new song from YouTube URL
|
|
- `GET /api/songs` - Get all songs from library
|
|
- `DELETE /api/songs` - Remove a song from library
|
|
- `GET /api/stream/[id]` - Get streaming URL for a song
|
|
- `GET /api/playlists` - Get all playlists
|
|
- `POST /api/playlists` - Create a new playlist
|
|
- `GET /api/playlists/[id]` - Get a specific playlist with songs
|
|
- `PUT /api/playlists/[id]` - Update playlist name
|
|
- `DELETE /api/playlists/[id]` - Delete a playlist
|
|
- `POST /api/playlists/[id]/songs` - Add a song to playlist
|
|
- `DELETE /api/playlists/[id]/songs` - Remove a song from playlist
|
|
- `POST /api/admin/update` - Update yt-dlp to the latest version
|
|
|
|
## Project Structure
|
|
|
|
```
|
|
bitify/
|
|
├── app/
|
|
│ ├── api/
|
|
│ │ ├── admin/update/
|
|
│ │ ├── playlists/
|
|
│ │ │ └── [id]/
|
|
│ │ ├── songs/
|
|
│ │ └── stream/[id]/
|
|
│ ├── playlists/
|
|
│ │ ├── [id]/
|
|
│ │ └── page.tsx
|
|
│ ├── globals.css
|
|
│ ├── icon.svg
|
|
│ ├── layout.tsx
|
|
│ ├── page.tsx
|
|
│ └── slider.css
|
|
├── components/
|
|
│ ├── GlobalPlayer.tsx
|
|
│ ├── Header.tsx
|
|
│ ├── Navbar.tsx
|
|
│ ├── PlayerBar.tsx
|
|
│ ├── PlayerContext.tsx
|
|
│ ├── SongCard.tsx
|
|
│ └── Toast.tsx
|
|
├── lib/
|
|
│ ├── db.ts
|
|
│ └── ytdlp.ts
|
|
├── data/
|
|
│ └── db.json (created automatically)
|
|
├── docker-compose.yml
|
|
├── Dockerfile
|
|
├── next.config.js
|
|
├── package.json
|
|
└── tsconfig.json
|
|
```
|
|
|
|
## Data Storage
|
|
|
|
All data is stored in a simple JSON file at `data/db.json`:
|
|
|
|
```json
|
|
{
|
|
"songs": [],
|
|
"playlists": [],
|
|
"playlistSongs": []
|
|
}
|
|
```
|
|
|
|
The file is created automatically on first run. To backup your library, simply copy the `data/` folder.
|
|
|
|
## Notes
|
|
|
|
- Audio files are **never downloaded** to the server
|
|
- Streaming URLs are dynamically generated using `yt-dlp -g -f bestaudio`
|
|
- The application requires `yt-dlp` and `ffmpeg` to be installed (included in Docker)
|
|
- All data is stored in a simple JSON file that's created automatically on first run
|
|
- Your music library persists in the `./data` folder
|
|
|
|
## License
|
|
|
|
MIT
|
|
|
|
## Author
|
|
|
|
Built with ❤️ using Next.js and yt-dlp
|