diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..6605c0a
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,57 @@
+# LilyGo-T3S3-LCD-ShellyListener
+
+Simple LoRa receiver for the LilyGo T3S3 SX1262 with OLED display.
+
+## Features
+
+- Receives LoRa packets
+- Displays received message, RSSI and SNR
+- Packet counter
+- Configurable RF profiles
+- OLED status screen
+
+## Hardware
+
+- LilyGo T3S3 SX1262
+- SSD1306 OLED 128x64
+
+## RF Profiles
+
+### Shelly RF
+
+- 865.000 MHz
+- BW 125 kHz
+- SF12
+- CR 4/5
+- Sync Word 0x12
+
+### MeshCore Switzerland
+
+Available in source code as alternative profile.
+
+## Display
+
+Idle screen:
+- Frequency
+- Bandwidth
+- Spreading Factor
+- Coding Rate
+- Sync Word
+- Packet counter
+- Last message
+
+Packet screen:
+- Received text
+- RSSI
+- SNR
+- Payload length
+
+## Library
+
+- RadioLib
+- Adafruit SSD1306
+- Adafruit GFX
+
+## Platform
+
+PlatformIO / ESP32-S3
\ No newline at end of file