diff --git a/README.md b/README.md
index a295ad4..d94c0f6 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,9 @@
 # Clocks
+
+A StreamController plugin that provides multiple time and date display options for your Stream Deck.
+
+## Actions
+
+- **Analog Clock**: Displays a traditional analog clock face with hour, minute, and second hands that updates in real-time.
+- **Digital Clock**: Shows the current time in digital format with options for 12/24-hour display, seconds visibility, and customizable label positioning.
+- **Date**: Displays the current date using a customizable format string with configurable label positioning.