From a50d7d0268c1df15eb50d73f3b0cdab449155945 Mon Sep 17 00:00:00 2001
From: SevereBrainDamage <svrbrndmg@proton.me>
Date: Sat, 10 Jan 2026 20:15:43 +0100
Subject: [PATCH] Update and revamp README

---
 README.md | 27 ++++++++++++++++++++++++---
 1 file changed, 24 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index 5c12f0f..39a7299 100644
--- a/README.md
+++ b/README.md
@@ -1,21 +1,42 @@
 <p align="center">
   <a href="https://monochrome.samidy.com">
-    <img src="https://github.com/SamidyFR/monochrome/blob/main/public/assets/512.png?raw=true" alt="Monochrome Logo">
+    <img src="https://github.com/SamidyFR/monochrome/blob/main/public/assets/512.png?raw=true" alt="Monochrome Logo" width="150px">
   </a>
 </p>
 
 
 <h1 align="center">Monochrome</h1>
 
-**Monochrome** is an open-source, privacy-respecting, ad-free [TIDAL](https://tidal.com) web UI, built on top of [Hi-Fi](https://github.com/sachinsenal0x64/hifi).
+### **Monochrome** is an open-source, privacy-respecting, ad-free [TIDAL](https://tidal.com) web UI, built on top of [Hi-Fi](https://github.com/sachinsenal0x64/hifi).
 
+<br>
 
 [<img src="https://files.catbox.moe/94f3pq.png" alt="Monochrome UI" width="800">](https://monochrome.samidy.com/#album/378149557)
+
+### Features
+<ul>
+<li>High-quality lossless audio streaming</li>
+<li>Lyrics support with karaoke mode</li>
+<li>Recently Played tracking for easy history access</li>
+<li>Comprehensive Personal Library for favorites</li>
+<li>Intelligent API caching for improved performance</li>
+<li>Offline-capable Progressive Web App (PWA)</li>
+<li>Media Session API integration for system controls</li>
+<li>Queue management with shuffle and repeat modes</li>
+<li>Track downloads with automatic metadata embedding</li>
+<li>Multiple API instance support with failover</li>
+<li>Dark, minimalist interface optimized for focus</li>
+<li>Customizable themes</li>
+<li>Keyboard shortcuts for power users</li>
+</ul>
+
   
-Check it out live at: [**monochrome.samidy.com**](https://monochrome.samidy.com)  
+### Check it out live at: [**monochrome.samidy.com**](https://monochrome.samidy.com)  
+<br>
 
 [![GitHub stars](https://img.shields.io/github/stars/SamidyFR/monochrome?style=for-the-badge&color=ffffff&labelColor=000000)](https://github.com/SamidyFR/monochrome/stargazers)
 [![GitHub forks](https://img.shields.io/github/forks/SamidyFR/monochrome?style=for-the-badge&color=ffffff&labelColor=000000)](https://github.com/SamidyFR/monochrome/forks)
 [![GitHub issues](https://img.shields.io/github/issues/SamidyFR/monochrome?style=for-the-badge&color=ffffff&labelColor=000000)](https://github.com/SamidyFR/monochrome/issues)
 
+
 [<img src="https://github.com/monochrome-music/monochrome/blob/main/assets/asseenonfmhy880x310.png?raw=true" alt="As seen on FMHY" height="50">](https://fmhy.net/audio#streaming-sites)