From 3038feb630ff767190cd74461151f2e5c2abe76e Mon Sep 17 00:00:00 2001
From: minster586 <43217359+minster586@users.noreply.github.com>
Date: Tue, 3 Mar 2026 21:10:12 -0500
Subject: [PATCH] Initial setup

---
 README.md | 27 ++++++++++++++++++++++++++-
 1 file changed, 26 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 49200ba..b50f6cc 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,27 @@
-# tinyice-docker
+# 📡 TinyIce Dockerized Stream Server
+
+This repository contains the Docker configuration for **TinyIce**, a lightweight, high-performance Shoutcast/Icecast compatible streaming server. This setup is optimized for production use behind **Nginx Proxy Manager (NPM)**.
+
+---
+
+## 🚀 Overview
+TinyIce is a minimal streaming server written in Go. This Dockerized version ensures that the application remains portable while keeping your station settings, passwords, and listener history safe in a persistent volume.
+
+### Key Features
+* **Lightweight Base**: Uses `debian-slim` to provide the necessary libraries for the TinyIce binary.
+* **Persistent Storage**: All configuration and database files are stored in a local `./config` folder.
+* **Metadata Support**: Passes ICY metadata (Artist/Title) correctly to players like VLC and Winamp.
+* **Anti-Ban Architecture**: Specifically configured to work with Reverse Proxies to prevent IP banning.
+
+---
+
+## 📂 Project Structure
+```text
+tinyice-docker/
+├── Dockerfile          # Environment setup (Debian-slim)
+├── docker-compose.yml  # Container & Volume orchestration
+├── tinyice-linux-amd64 # The application binary
+└── config/             # (Auto-generated) Persistent data
+    ├── tinyice.json    # Station settings & Admin passwords
+    └── history.db      # SQLite database for "Now Playing" history