From 32e43db062e7c15d2d1a13b6daa0a136df5adc19 Mon Sep 17 00:00:00 2001
From: Felitendo <felitendoyt@gmail.com>
Date: Mon, 21 Sep 2026 16:24:52 +0200
Subject: [PATCH] docs: add icon and centered readme header

---
 README.md              | 18 ++++++++++++++++--
 res/bt-volume-step.svg | 30 ++++++++++++++++++++++++++++++
 2 files changed, 46 insertions(+), 2 deletions(-)
 create mode 100644 res/bt-volume-step.svg

diff --git a/README.md b/README.md
index 46c7cfd..872cb3e 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,20 @@
-# bt-volume-step
+<p align="center">
+  <img width="200" src="res/bt-volume-step.svg" alt="bt-volume-step">
+</p>
 
-Fixed volume steps for Bluetooth audio devices on PipeWire.
+<h1 align="center">bt-volume-step</h1>
+
+<h3 align="center">Fixed volume steps for Bluetooth audio devices on PipeWire.</h3>
+
+<p align="center">
+  One press or swipe on your earbuds or speaker becomes one clean step on your volume slider.
+</p>
+
+<h5 align="center">
+  <a href="#usage">How to use</a> |
+  <a href="#installation">Install</a> |
+  <a href="https://ko-fi.com/felitendo">Ko-Fi</a>
+</h5>
 
 ## The problem
 
diff --git a/res/bt-volume-step.svg b/res/bt-volume-step.svg
new file mode 100644
index 0000000..64ff1ff
--- /dev/null
+++ b/res/bt-volume-step.svg
@@ -0,0 +1,30 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="13.0 67.5 486.1 486.1" width="512" height="512">
+  <defs>
+    <linearGradient id="bo-cup" x1="0" y1="0" x2="1" y2="1"><stop offset="0" stop-color="#5fd0ff"/><stop offset="1" stop-color="#0c62a0"/></linearGradient>
+    <linearGradient id="bo-bar" x1="0" y1="0" x2="0" y2="1"><stop offset="0" stop-color="#5fd0ff"/><stop offset="1" stop-color="#1383bd"/></linearGradient>
+    <linearGradient id="bo-band" x1="0" y1="0" x2="0" y2="1"><stop offset="0" stop-color="#a9bcd0"/><stop offset="1" stop-color="#56697e"/></linearGradient>
+    <linearGradient id="bo-pad" x1="0" y1="0" x2="1" y2="0"><stop offset="0" stop-color="#1f2c3b"/><stop offset="1" stop-color="#3a4b5e"/></linearGradient>
+    <linearGradient id="bo-paper" x1="0" y1="0" x2="1" y2="1"><stop offset="0" stop-color="#ffffff"/><stop offset="1" stop-color="#dfe7f0"/></linearGradient>
+    <filter id="bo-soft" x="-20%" y="-20%" width="140%" height="150%"><feDropShadow dx="0" dy="10" stdDeviation="12" flood-color="#04213a" flood-opacity=".35"/></filter>
+  </defs>
+  <g filter="url(#bo-soft)">
+    <!-- headband -->
+    <path d="M118 292 C 118 150, 394 150, 394 292" fill="none" stroke="url(#bo-band)" stroke-width="36" stroke-linecap="round"/>
+    
+    
+    
+    <!-- ear pads, facing inwards -->
+    <rect x="150" y="286" width="40" height="132" rx="20" fill="url(#bo-pad)"/>
+    <rect x="322" y="286" width="40" height="132" rx="20" fill="url(#bo-pad)"/>
+    <!-- cups -->
+    <rect x="66" y="270" width="104" height="164" rx="46" fill="url(#bo-cup)"/>
+    <rect x="342" y="270" width="104" height="164" rx="46" fill="url(#bo-cup)"/>
+    <path d="M88 312 C 88 298, 94 288, 106 284" fill="none" stroke="#fff" stroke-opacity=".28" stroke-width="7" stroke-linecap="round"/>
+    <path d="M364 312 C 364 298, 370 288, 382 284" fill="none" stroke="#fff" stroke-opacity=".28" stroke-width="7" stroke-linecap="round"/>
+    <path d="M98.8 337.6 L135.6 366.4 L118.0 380.8 L118.0 323.2 L135.6 337.6 L98.8 366.4" fill="none" stroke="#fff" stroke-width="11" stroke-linecap="round" stroke-linejoin="round"/>
+    <!-- fixed steps -->
+    <rect x="212" y="366" width="24" height="44" rx="8" fill="url(#bo-bar)"/>
+    <rect x="244" y="340" width="24" height="70" rx="8" fill="url(#bo-bar)"/>
+    <rect x="276" y="314" width="24" height="96" rx="8" fill="url(#bo-bar)"/>
+  </g>
+</svg>