diff --git a/README.md b/README.md
index 7d4f96a..537596b 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,63 @@
-# musicparty-binary-releases
+# 🎵 musicparty
 
-binary releases until the source code gets open sourced.
\ No newline at end of file
+**musicparty** is a self-hosted music streaming server built with Go (backend) and React (frontend). It ingests, organizes, streams, and helps you discover music from your local library, with built-in recommendations, moderation, and admin tooling.
+
+> [!NOTE]
+> This repo is only for musicparty binary releases until the source code will get open sourced. There is currently no exact date on when this will happen.
+>
+> This Readme is also not finished and will updated as we progress.
+
+## 📑 Table of Contents
+
+- [Overview](#overview)
+- [Features](#features)
+- [Quick Start](#quick-start)
+- [Build from Source](#build-from-source)
+- [Integrations](#integrations)
+- [Admin & Moderation](#admin--moderation)
+- [License](#license)
+
+## 📖 Overview
+
+...
+
+## ✨ Features
+
+### Library Ingestion & Processing
+- Scans and processes unprocessed audio files
+- Transcodes and organizes the library
+- Extracts metadata and cover art
+- Tracks pending/unprocessable files for manual fixes
+- LUFS loudness analysis and normalization workflow
+
+### Streaming & Playback
+- Authenticated audio streaming with seeking (`/api/stream/:id`)
+- Reorderable queue, shuffle, and loop/repeat modes
+- Autoplay continuation backed by recommendations
+- Desktop and mobile player UIs
+- Media Session integration (lock screen / hardware controls)
+- Sleep timer (mobile)
+- Normalization toggle + boost-quiet option
+
+### Discovery & Recommendations
+- Personalized home sections (liked, recommendations, last played, quick picks)
+- Search across songs and albums
+- Recently played and recently added views
+- Per-user recommendation tuning (familiarity, exploration, recency)
+- Listening mode presets (focus, discover, party, sleep, etc.)
+- Recommendation cache, diagnostics endpoints, and reset support (`recResetAt`)
+
+### Insights
+- Recommendation scoring and low-confidence lists
+- Skip analysis by song, artist, and genre
+- Listening history stats and recent play events with mode context
+
+### Playlists & Library Management
+- Playlists + “Liked Songs”
+- Add, remove, and reorder tracks
+- Playlist pinning and played tracking
+- Album library add/remove endpoints
+- Song-level playlist membership lookups
+
+## 🚀 Quick Start
+....
\ No newline at end of file