diff --git a/README.md b/README.md
new file mode 100644
index 0000000..a157f7a
--- /dev/null
+++ b/README.md
@@ -0,0 +1,13 @@
+# MediaPlugin
+
+A StreamController plugin for controlling media playback via MPRIS.
+
+## Actions
+
+- **Play** - Starts media playback if the player is not currently playing.
+- **Pause** - Pauses media playback if the player is currently playing.
+- **PlayPause** - Toggles between play and pause states based on the current playback status.
+- **Next** - Skips to the next track in the media queue.
+- **Previous** - Returns to the previous track in the media queue.
+- **Info** - Displays the current media title and artist information with an optional separator.
+- **ThumbnailBackground** - Sets the current media thumbnail as the deck background image.