From f4962cc138a9aeebaa59c02ed01642b7cca4f36b Mon Sep 17 00:00:00 2001
From: bitc0de <keyvenm@gmail.com>
Date: Wed, 17 Dec 2025 13:55:57 +0100
Subject: [PATCH] first commit

---
 README.md | 161 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 161 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..66a65b2
--- /dev/null
+++ b/README.md
@@ -0,0 +1,161 @@
+# Bitify 🎵
+
+Self-hosted YouTube music streaming application built with Next.js.
+
+## 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
+- 🗂️ SQLite database for song and playlist management
+- 🐳 Easy Docker deployment
+
+## Tech Stack
+
+- **Frontend & Backend**: Next.js 15 (App Router)
+- **Styling**: Tailwind CSS v4
+- **Database**: SQLite with Prisma ORM
+- **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. **Set up the database:**
+   ```bash
+   npx prisma generate
+   npx prisma db push
+   ```
+
+3. **Install yt-dlp:**
+   ```bash
+   pip install yt-dlp
+   ```
+
+4. **Run the development server:**
+   ```bash
+   npm run dev
+   ```
+
+5. **Open your browser:**
+   Navigate to [http://localhost:3000](http://localhost:3000)
+
+## Docker Deployment
+
+1. **Build and run with Docker Compose:**
+   ```bash
+   docker-compose up -d
+   ```
+
+2. **Access the application:**
+   Navigate to [http://localhost:3000](http://localhost:3000)
+
+3. **Stop the application:**
+   ```bash
+   docker-compose down
+   ```
+
+## 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/
+│   ├── prisma.ts
+│   └── ytdlp.ts
+├── prisma/
+│   └── schema.prisma
+├── docker-compose.yml
+├── Dockerfile
+├── next.config.js
+├── package.json
+└── tsconfig.json
+```
+
+## Environment Variables
+
+The application uses SQLite by default. The database file is stored at `prisma/dev.db`.
+
+You can customize the database location by setting the `DATABASE_URL` environment variable:
+
+```env
+DATABASE_URL="file:./dev.db"
+```
+
+## 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
+- Database automatically initializes on first run
+
+## License
+
+MIT
+
+## Author
+
+Built with ❤️ using Next.js and yt-dlp