updated README to current structure, updated .gitignore, added .gitattributes, added bin/ (lfs)

.gitattributes

@@ -0,0 +1,7 @@
+* text=auto eol=lf
+
+/.gitignore export-ignore
+/.gitattributes export-ignore
+
+*.mp3 filter=lfs diff=lfs merge=lfs -text
+assets/bin/** filter=lfs diff=lfs merge=lfs -text

.gitignore

@@ -3,6 +3,7 @@
 
 debug/
 target/
+assets/.cache
 
 Cargo.lock
 

README.md

@@ -6,17 +6,38 @@
 
 ```terminaloutput
 assets/
-    config.(json|toml)
-    songs/
-        my_song/
-            my_song.mp3
-            descriptor.(json|toml)
-            intro/
-                MrNewVegas_N.mp3 (optional)
-            outro/
-                MrNewVegas_N.mp3 (optional)
-    generic/
-        MrNewVegas_N.mp3
+   config.(json|toml)
+   bin/
+      x86_64/
+      aarch64/
+   songs/
+      my_song/
+         my_song.mp3
+         descriptor.(json|toml)
+         intro/
+            Intro_MrNewVegas_my_song.mp3 (optional)
+   generic/
+      intro/
+         Intro_MrNewVegas_N.mp3
+      news/
+         story_N/
+            story.toml (ignored, metadata)
+            Story_MrNewVegas_N.mp3
+            Story_Guest_N.mp3
+   .cache/ (automatically generated)
+      songs/
+         my_song/
+            song.pcm (f32 pcm)
+            intro.pcm (f32 pcm)
+            cache.json
+      generic/
+         intro/
+            Intro_MrNewVegas_N.pcm (f32 pcm)
+            Intro_MrNewVegas_N.cache.json
+         news/
+            story_N/
+               part_N.pcm (f32 pcm)
+               cache.json
 ```
 
 ---
@@ -33,11 +54,23 @@ assets/
   "settings": {
     "weight":    1.0,
     "volume":    1.0,
-    "crossfade": 2.0 // in seconds
+    "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", // options: "weighted", "strict_random"
-    "max_same_genre_in_row": 2
   }
 }
 
@@ -55,10 +88,17 @@ temp_directory    = "temp"
 weight    = 1.0
 volume    = 1.0
 crossfade = 2.0 # in seconds
+[settings.weights.news]
+chance = 0.2
+[settings.weights.genre]
+floor         = 0.55
+recover_after = 3.0
+[settings.weights.composite]
+floor         = 0.05
+recover_after = 5.0
 
 [rules]
-shuffle_mode          = "weighted" # "weighted", "strict_random"
-max_same_genre_in_row = 2
+shuffle_mode = "weighted" # "weighted", "strict_random"
 ```
 
 ---
@@ -70,8 +110,7 @@ max_same_genre_in_row = 2
   "artist": "Kay Kyser",
   "tags":   ["orchestra", "swing", "jazz"],
   "genre":  ["swing", "jazz"],
-  "intro":  false,
-  "outro":  false,
+  "intro":  true,
   "weight": 1.0, // optional
   "volume": 1.0, // optional
 }
@@ -83,8 +122,7 @@ title  = "[I Got Spurs That] Jingle, Jangle, Jingle"
 artist = "Kay Kyser"
 tags   = ["orchestra", "swing", "jazz"]
 genre  = ["swing", "jazz"]
-intro  = false
-outro  = false
+intro  = true
 weight = 1.0 # optional
 volume = 1.0 # optional
 ```