diff --git a/README.md b/README.md
index b14f38d..e52e667 100644
--- a/README.md
+++ b/README.md
@@ -6,14 +6,14 @@
 
 ```terminaloutput
 assets/
-   config.(json|toml)
+   config.(json|toml|ron)
    bin/
       x86_64/
       aarch64/
    songs/
       my_song/
          my_song.mp3
-         descriptor.(json|toml)
+         descriptor.(json|toml|ron)
          intro/
             Intro_MrNewVegas_my_song.mp3 (optional)
    generic/
@@ -100,6 +100,40 @@ recover_after = 5.0
 [rules]
 shuffle_mode = "weighted" # "weighted", "strict_random"
 ```
+OR
+#### `config.ron`
+```ron
+(
+    defaults: (
+        songs_directory:   "songs",
+        generic_directory: "generic",
+        log_directory:     "logs",
+        temp_directory:    "temp",
+    ),
+    settings: (
+        debug:     true,
+        weight:    1.0,
+        volume:    1.0,
+        crossfade: 2.0, // in seconds
+        weights: (
+            news: (
+                chance: 0.2,
+            ),
+            genre: (
+                floor:         0.55,
+                recover_after: 3.0,
+            ),
+            composite: (
+                floor:         0.05,
+                recover_after: 5.0,
+            ),
+        ),
+    ),
+    rules: (
+        shuffle_mode: weighted, // weighted, strict_random
+    ),
+)
+```
 
 ---
 
@@ -126,3 +160,16 @@ intro  = true
 weight = 1.0 # optional
 volume = 1.0 # optional
 ```
+OR 
+#### `descriptor.ron`
+```ron
+(
+    title:  "[I Got Spurs That] Jingle, Jangle, Jingle",
+    artist: "Kay Kyser",
+    tags:   ["orchestra", "swing", "jazz"],
+    genre:  ["swing", "jazz"],
+    intro:  true,
+    weight: 1.0, // optional
+    volume: 1.0, // optional
+)
+```