diff --git a/README.md b/README.md
new file mode 100644
index 0000000..88a2523
--- /dev/null
+++ b/README.md
@@ -0,0 +1,11 @@
+# Audio Switcher
+
+A StreamController plugin for managing audio output devices on Linux using PulseAudio.
+
+## Actions
+
+### Set Device
+Sets the default audio output to a specific configured device and port.
+
+### Toggle Output
+Toggles between two pre-configured audio output devices with optional port selection.