lushapp 2.0.0

package/src/lush/constants.py

@@ -0,0 +1,686 @@
+import re
+# LUSH - Constants and Presets
+
+LOGO_LINES = [
+    " █   █ █ █▀▀ █ █   █▀▀█",
+    " █▄▄ █▄█ ▄██ █▀█  ██ ██"
+]
+
+COMPACT_LOGO = "LUSH ♫"
+
+AMBIENT_PRESETS = [
+    {
+        "id": "none",
+        "name": "Muted / Off",
+        "desc": "No ambient soundscape overlay",
+        "url": None
+    },
+    {
+        "id": "deep_rain",
+        "name": "Deep Rain & Storm",
+        "desc": "Heavy soothing rainfall with low rumble",
+        "url": "av://lavfi:anoisesrc=c=brown:r=44100:a=0.08,lowpass=f=800"
+    },
+    {
+        "id": "pink_rain",
+        "name": "Gentle Pink Rain",
+        "desc": "Soft gentle raindrops on windowpane",
+        "url": "av://lavfi:anoisesrc=c=pink:r=44100:a=0.05,lowpass=f=1200"
+    },
+    {
+        "id": "ocean_waves",
+        "name": "Calming Ocean Waves",
+        "desc": "Rhythmic ocean surf & rolling tide",
+        "url": "av://lavfi:anoisesrc=c=brown:r=44100:a=0.07,tremolo=f=0.18:d=0.8,lowpass=f=600"
+    },
+    {
+        "id": "campfire",
+        "name": "Cozy Campfire Warmth",
+        "desc": "Fireside crackle & gentle embers",
+        "url": "av://lavfi:anoisesrc=c=brown:r=44100:a=0.04,highpass=f=200,lowpass=f=2000"
+    },
+    {
+        "id": "space_drone",
+        "name": "Cosmic Space Drone",
+        "desc": "Deep subsonic interstellar hum",
+        "url": "av://lavfi:anoisesrc=c=brown:r=44100:a=0.06,tremolo=f=0.1:d=0.5,lowpass=f=350"
+    },
+    {
+        "id": "soma_drone",
+        "name": "SomaFM Drone Zone",
+        "desc": "24/7 Atmospheric dark ambient live stream",
+        "url": "https://ice1.somafm.com/dronezone-128-mp3"
+    },
+    {
+        "id": "soma_deepspace",
+        "name": "SomaFM Deep Space One",
+        "desc": "24/7 Deep space electronic ambient live stream",
+        "url": "https://ice1.somafm.com/deepspaceone-128-mp3"
+    },
+    {
+        "id": "soma_mission",
+        "name": "SomaFM Mission Control",
+        "desc": "NASA historic comms mixed with space music",
+        "url": "https://ice1.somafm.com/missioncontrol-128-mp3"
+    }
+]
+
+VISUALIZER_MODES = [
+    "shimmer_string",
+    "harmonic_strings",
+    "laser_cords",
+    "quantum_strings",
+    "aurora_ribbon",
+    "stereo_harp",
+    "shimmer_spectrum",
+    "mirrored_butterfly",
+    "matrix_rain",
+    "frequency_beams",
+    "sine_interference",
+    "braille_oscilloscope",
+    "radial_shock_burst",
+    "starlight_constellation",
+    "waveform",
+    "vu",
+    "dots",
+    "hud",
+    "off"
+]
+VISUALIZER_LABELS = {
+    "shimmer_string": "→ Shimmer Audio String (CAVA)",
+    "harmonic_strings": "→ Harmonic Resonant Strings (CAVA)",
+    "laser_cords": "→ Neon Laser Cords (CAVA)",
+    "quantum_strings": "→ Quantum String Shimmer (CAVA)",
+    "aurora_ribbon": "→ Aurora Shimmer Strings (CAVA)",
+    "stereo_harp": "→ Stereo Harp Strings (CAVA)",
+    "shimmer_spectrum": "→ Shimmer Spectrum Bars (CAVA)",
+    "mirrored_butterfly": "→ Mirrored Butterfly Wings (CAVA)",
+    "matrix_rain": "→ Cyberpunk Matrix Stream (CAVA)",
+    "frequency_beams": "→ High-Energy Spectral Beams (CAVA)",
+    "sine_interference": "→ Acoustic Wave Interference (CAVA)",
+    "braille_oscilloscope": "→ High-Res Braille Oscilloscope (CAVA)",
+    "radial_shock_burst": "→ Bass Transient Shockwave (CAVA)",
+    "starlight_constellation": "→ Harmonic Constellation (CAVA)",
+    "waveform": "→ Live Waveform Line (CAVA)",
+    "vu": "→ Live Stereo VU Meter (CAVA)",
+    "dots": "→ Live Frequency Peak Dots (CAVA)",
+    "hud": "→ Compact HUD Only",
+    "off": "→ Disabled"
+}
+
+# Fan-Favorite Ranking Orders for Sidebar Sections
+GENZ_ORDER = [
+    "sabrina carpenter",
+    "sabrina",
+    "chappell roan",
+    "charli xcx",
+    "billie eilish",
+    "taylor swift",
+    "olivia rodrigo",
+    "raye",
+    "escapism",
+    "sza",
+    "doja cat",
+    "doja",
+    "tate mcrae",
+    "gracie abrams",
+    "selena gomez",
+    "charlie puth",
+    "halsey",
+    "conan gray",
+    "troye sivan",
+    "benson boone",
+    "noah kahan",
+    "alan walker",
+    "bts",
+    "blackpink",
+    "newjeans",
+    "jung kook",
+    "jungkook",
+    "twice",
+    "stray kids",
+    "le sserafim",
+    "aespa",
+    "k-pop",
+    "bad bunny",
+    "karol g",
+    "becky g",
+    "rosalía",
+    "rosalia",
+    "rauw alejandro",
+    "j balvin",
+    "burna boy",
+    "tyla",
+    "david guetta",
+    "bebe rexha",
+    "the chainsmokers",
+    "marshmello",
+    "martin garrix",
+    "kygo",
+    "skrillex",
+    "swedish house mafia",
+    "arctic monkeys",
+    "hozier",
+    "gorillaz",
+    "tame impala",
+    "the neighbourhood",
+    "neighbourhood",
+    "cigarettes after sex",
+    "the weeknd",
+    "lana del rey",
+    "dua lipa",
+    "ariana grande",
+    "harry styles",
+    "post malone",
+    "drake",
+    "lady gaga",
+    "rihanna",
+    "bruno mars",
+    "justin bieber",
+    "miley cyrus",
+    "ed sheeran",
+    "k-pop",
+    "shawn mendes",
+    "camila cabello",
+    "charlie puth",
+    "doja",
+    "sam smith",
+    "khalid",
+    "twenty one pilots",
+    "imagine dragons",
+    "kendrick lamar",
+    "travis scott",
+    "bad bunny"
+]
+
+def get_genz_sort_rank(station):
+    name = station.get("name", "").lower()
+    for rank, token in enumerate(GENZ_ORDER):
+        if re.search(r'\b' + re.escape(token) + r'\b', name):
+            return rank
+    return len(GENZ_ORDER)
+
+LEGENDS_ORDER = [
+    "michael jackson",
+    "britney spears",
+    "britney",
+    "queen",
+    "the beatles",
+    "beatles",
+    "madonna",
+    "daft punk",
+    "eminem",
+    "whitney houston",
+    "prince",
+    "the ronettes",
+    "ronettes",
+    "be my baby",
+    "diana ross",
+    "the supremes",
+    "supremes",
+    "motown",
+    "elton john",
+    "david bowie",
+    "stevie wonder",
+    "abba",
+    "pink floyd",
+    "nirvana",
+    "led zeppelin",
+    "ac/dc",
+    "the rolling stones",
+    "rolling stones",
+    "bob marley",
+    "elvis",
+    "fleetwood mac",
+    "metallica",
+    "black sabbath",
+    "shakira",
+    "celine dion",
+    "mariah carey",
+    "george michael",
+    "kylie minogue",
+    "tina turner",
+    "cher",
+    "frank sinatra",
+    "ray charles",
+    "timbaland",
+    "usher",
+    "destiny's child",
+    "the black eyed peas",
+    "black eyed peas",
+    "nelly furtado",
+    "nelly",
+    "50 cent",
+    "gwen stefani",
+    "no doubt",
+    "alicia keys",
+    "ciara",
+    "missy elliott",
+    "missy",
+    "sean paul",
+    "kelly clarkson",
+    "backstreet boys",
+    "spice girls",
+    "avril lavigne",
+    "christina aguilera",
+    "beyonce",
+    "janet jackson",
+    "aretha franklin",
+    "bruce springsteen",
+    "billy joel",
+    "bon jovi",
+    "guns n",
+    "u2",
+    "aerosmith",
+    "bee gees",
+    "phil collins"
+]
+
+def get_legend_sort_rank(station):
+    name = station.get("name", "").lower()
+    for rank, token in enumerate(LEGENDS_ORDER):
+        if re.search(r'\b' + re.escape(token) + r'\b', name):
+            return rank
+    return len(LEGENDS_ORDER)
+
+SIDEBAR_SECTIONS = [
+    {
+        "title": "MUSIC & ARTISTS",
+        "items": [
+            {
+                "key": "top_artists",
+                "label": "Top Artists",
+                "tag": "1:TOP",
+                "match": lambda s: bool((s.get("category") == "music" or "exclusive.radio" in s.get("url", "").lower()) and (s.get("top_artist") is True or any(name in s.get("name", "").lower() for name in ["michael jackson", "billie eilish", "kanye west", "madonna", "marvin gaye", "miles davis", "abba", "justin bieber", "sia", "katy perry", "moby", "queen", "taylor swift", "beatles", "eminem", "olivia rodrigo", "lana del rey", "pink floyd", "led zeppelin"])))
+            },
+            {
+                "key": "artist_genz",
+                "label": "Trending (Gen Z)",
+                "tag": "2:GENZ",
+                "match": lambda s: bool((s.get("category") == "music" or "exclusive.radio" in s.get("url", "").lower() or "bigfm" in s.get("url", "").lower() or "181fm" in s.get("url", "").lower() or "1.fm" in s.get("url", "").lower() or "abm" in s.get("url", "").lower()) and any(name in s.get("name", "").lower() for name in GENZ_ORDER)),
+                "sort_key": get_genz_sort_rank
+            },
+            {
+                "key": "artist_legends",
+                "label": "Ever Popular",
+                "tag": "3:LEGENDS",
+                "match": lambda s: bool((s.get("category") == "music" or "exclusive.radio" in s.get("url", "").lower() or "abm" in s.get("url", "").lower() or "181fm" in s.get("url", "").lower() or "1.fm" in s.get("url", "").lower() or "uber.radio" in s.get("url", "").lower()) and any(name in s.get("name", "").lower() for name in LEGENDS_ORDER)),
+                "sort_key": get_legend_sort_rank
+            },
+            {
+                "key": "artist_newage",
+                "label": "New Age & Chill",
+                "tag": "4:NEWAGE",
+                "match": lambda s: bool((s.get("category") == "music" or "exclusive.radio" in s.get("url", "").lower() or "organlive" in s.get("url", "").lower()) and (any(name in s.get("name", "").lower() for name in ["enya", "enigma", "mike oldfield", "ludovico einaudi", "moby", "sade", "norah jones", "massive attack", "sigur ros", "brian eno", "depeche mode", "kraftwerk", "air", "thievery corporation", "zero 7", "morcheeba", "cocteau twins", "delerium", "deep forest", "café del mar", "cafe del mar", "schiller", "kitaro", "yanni", "andrea bocelli", "anna lapwood", "organlive", "pipe organ"]) or any(k in s.get("genre", "").lower() for k in ["new age", "ambient", "chill", "dream", "ethereal", "crossover", "meditation", "pipe organ", "organ"])))
+            },
+            {
+                "key": "music",
+                "label": "All Artists",
+                "tag": "5:ALL",
+                "match": lambda s: bool(s.get("category") == "music" or "exclusive.radio" in s.get("url", "").lower() or "artist" in s.get("genre", "").lower())
+            }
+        ]
+    },
+    {
+        "title": "RADIO & SOUNDSCAPES",
+        "items": [
+            {
+                "key": "all_radio",
+                "label": "All Radio",
+                "tag": "0:RADIO",
+                "match": lambda s: s.get("category") != "music" and "exclusive.radio" not in s.get("url", "").lower() and "artist" not in s.get("genre", "").lower()
+            },
+            {
+                "key": "lofi",
+                "label": "Lo-Fi & Chill",
+                "tag": "r:LOFI",
+                "match": lambda s: s.get("category") != "music" and any(k in s.get("genre", "").lower() for k in ["lofi", "lo-fi", "chillhop", "study", "cafe", "chill", "relax"])
+            },
+            {
+                "key": "synth",
+                "label": "Synthwave & Cyber",
+                "tag": "r:SYNTH",
+                "match": lambda s: s.get("category") != "music" and any(k in s.get("genre", "").lower() for k in ["synth", "synthwave", "chillsynth", "spacesynth", "vaporwave", "retrowave", "outrun", "80s", "cyber", "cyberpunk", "darksynth"])
+            },
+            {
+                "key": "ambient",
+                "label": "Ambient & Spa",
+                "tag": "r:AMB",
+                "match": lambda s: s.get("category") != "music" and any(k in s.get("genre", "").lower() for k in ["ambient", "downtempo", "space", "drone", "sleep", "meditation", "atmospheric", "spa"])
+            },
+            {
+                "key": "lush",
+                "label": "Lush & ASMR (18+)",
+                "tag": "r:LUSH",
+                "match": lambda s: s.get("category") != "music" and any(k in s.get("genre", "").lower() for k in ["lush", "asmr", "vocal", "vocals", "ethereal", "shoegaze", "dreamy", "harmonies", "whisper", "whispers", "sensual", "sleep", "velvet"])
+            }
+        ]
+    },
+    {
+        "title": "LIBRARY",
+        "items": [
+            {"key": "bookmarks", "label": "Favs", "tag": "b:FAV"},
+            {"key": "history", "label": "History", "tag": "h:HIST"},
+            {"key": "playing", "label": "Now Playing", "tag": "p:NOW"},
+            {"key": "insights", "label": "Insights", "tag": "I:STAT"}
+        ]
+    },
+    {
+        "title": "CONFIG",
+        "items": [
+            {"key": "themes", "label": "Themes", "tag": "t:THEME"},
+            {"key": "ambient_fx", "label": "Ambient FX", "tag": "e:FX"},
+            {"key": "settings", "label": "Settings", "tag": "s:CONF"}
+        ]
+    }
+]
+
+ALL_SIDEBAR_ITEMS = [item for sec in SIDEBAR_SECTIONS for item in sec["items"]]
+
+DEFAULT_THEMES = {
+    "Brat Lime": {
+        "header": [0, 154], "accent": 154, "footer": [0, 154],
+        "track": 231, "playing": 118, "highlight": [0, 154], "genre": 190,
+        "border": 154, "sub": 242, "desc": "Charli XCX Brat: Electric Acid Lime, Club White & Rave Black"
+    },
+    "Toxic Latex": {
+        "header": [0, 198], "accent": 198, "footer": [0, 198],
+        "track": 219, "playing": 196, "highlight": [0, 198], "genre": 225,
+        "border": 198, "sub": 244, "desc": "Britney Spears: High-Gloss Pop Latex Crimson & Diamond Fuchsia"
+    },
+    "Blohsh Acid": {
+        "header": [0, 46], "accent": 46, "footer": [0, 46],
+        "track": 85, "playing": 118, "highlight": [0, 46], "genre": 45,
+        "border": 46, "sub": 241, "desc": "Billie Eilish: Toxic Radioactive Slime Green & Abyss Midnight Navy"
+    },
+    "Lover Pastel": {
+        "header": [0, 218], "accent": 218, "footer": [0, 218],
+        "track": 117, "playing": 221, "highlight": [0, 218], "genre": 189,
+        "border": 218, "sub": 245, "desc": "Taylor Swift Lover: Pastel Cloud Pink, Sky Blue & Iridescent Sparkle"
+    },
+    "Guts Sour": {
+        "header": [0, 129], "accent": 129, "footer": [0, 129],
+        "track": 207, "playing": 177, "highlight": [0, 129], "genre": 141,
+        "border": 129, "sub": 243, "desc": "Olivia Rodrigo Guts: Bruised Vampire Purple, Sour Violet & Angst Black"
+    },
+    "Born to Die": {
+        "header": [0, 160], "accent": 160, "footer": [0, 160],
+        "track": 222, "playing": 174, "highlight": [0, 160], "genre": 216,
+        "border": 160, "sub": 241, "desc": "Lana Del Rey: Vintage Bordeaux Cherry, Gilded Gold & Hollywood Noir"
+    },
+    "After Hours": {
+        "header": [0, 196], "accent": 196, "footer": [0, 196],
+        "track": 51, "playing": 220, "highlight": [0, 196], "genre": 209,
+        "border": 196, "sub": 240, "desc": "The Weeknd: Blinding Crimson Red Suit, 80s Arcade Cyan & Casino Gold"
+    },
+    "Random Access": {
+        "header": [0, 220], "accent": 220, "footer": [0, 220],
+        "track": 254, "playing": 45, "highlight": [0, 220], "genre": 214,
+        "border": 220, "sub": 242, "desc": "Daft Punk: 24K Mirrored Helmet Gold, Chrome Visor & LED Prism"
+    },
+    "Short n Sweet": {
+        "header": [0, 218], "accent": 218, "footer": [0, 218],
+        "track": 172, "playing": 230, "highlight": [0, 218], "genre": 215,
+        "border": 218, "sub": 244, "desc": "Sabrina Carpenter: Iced Espresso Caramel, Whipped Cream & Kissed Pink"
+    },
+    "She Wolf": {
+        "header": [0, 214], "accent": 214, "footer": [0, 214],
+        "track": 209, "playing": 208, "highlight": [0, 214], "genre": 221,
+        "border": 214, "sub": 242, "desc": "Shakira: Wild Sun-Drenched Colombian Gold, Sunset Amber & Desert Coral"
+    },
+    "Padam Fever": {
+        "header": [0, 161], "accent": 161, "footer": [0, 161],
+        "track": 198, "playing": 231, "highlight": [0, 161], "genre": 205,
+        "border": 161, "sub": 244, "desc": "Kylie Minogue: Heartbeat Scarlet Couture, Disco Platinum & Starlight"
+    },
+    "Spice World": {
+        "header": [0, 27], "accent": 27, "footer": [0, 27],
+        "track": 201, "playing": 214, "highlight": [0, 27], "genre": 45,
+        "border": 27, "sub": 244, "desc": "Spice Girls: 90s Union Jack Electric Blue, Pop Glitter Magenta & Gold"
+    },
+    "Barbie Dreamhouse": {
+        "header": [0, 200], "accent": 200, "footer": [0, 200],
+        "track": 225, "playing": 220, "highlight": [0, 200], "genre": 213,
+        "border": 200, "sub": 245, "desc": "Barbie Dreamhouse: Radiant Pop Magenta, Hot Pink & Gold Sparkle"
+    },
+    "Cyber Lotus": {
+        "header": [0, 207], "accent": 207, "footer": [0, 207],
+        "track": 219, "playing": 48, "highlight": [0, 207], "genre": 51,
+        "border": 207, "sub": 244, "desc": "Cyber Lotus: Bioluminescent Lotus Pink, Jade & Pond Black"
+    },
+    "Moonlight": {
+        "header": [0, 105], "accent": 105, "footer": [0, 105],
+        "track": 189, "playing": 45, "highlight": [0, 105], "genre": 141,
+        "border": 105, "sub": 241, "desc": "Moonlight: Midnight Indigo, Lunar Cyan & Violet Glow"
+    },
+    "Hot Pink": {
+        "header": [0, 198], "accent": 198, "footer": [0, 198],
+        "track": 205, "playing": 201, "highlight": [0, 198], "genre": 213,
+        "border": 198, "sub": 245, "desc": "Ultra High-Voltage Hot Pink & Neon Fuchsia"
+    },
+    "Cyber Barbie": {
+        "header": [0, 201], "accent": 201, "footer": [0, 201],
+        "track": 219, "playing": 207, "highlight": [0, 201], "genre": 205,
+        "border": 201, "sub": 244, "desc": "Electric Neon Bubblegum & Magenta Glow"
+    },
+    "Pink Velvet": {
+        "header": [0, 161], "accent": 198, "footer": [0, 161],
+        "track": 206, "playing": 213, "highlight": [0, 198], "genre": 218,
+        "border": 161, "sub": 243, "desc": "Rich Midnight Velvet Pink & Coral Rose"
+    },
+    "Cotton Candy": {
+        "header": [0, 218], "accent": 218, "footer": [0, 218],
+        "track": 117, "playing": 189, "highlight": [0, 218], "genre": 117,
+        "border": 218, "sub": 245, "desc": "Pastel Baby Pink, Sky Blue & Lavender Frost"
+    },
+    "Strawberry Milk": {
+        "header": [0, 217], "accent": 217, "footer": [0, 217],
+        "track": 224, "playing": 210, "highlight": [0, 217], "genre": 224,
+        "border": 217, "sub": 245, "desc": "Creamy Strawberry Pastel Pink & Sweet Cream"
+    },
+    "Sakura Bloom": {
+        "header": [0, 218], "accent": 218, "footer": [0, 218],
+        "track": 225, "playing": 114, "highlight": [0, 218], "genre": 175,
+        "border": 218, "sub": 245, "desc": "Japanese Cherry Blossom Pastel Pink & Soft Jade"
+    },
+    "Plur1bus": {
+        "header": [0, 45], "accent": 45, "footer": [0, 45],
+        "track": 51, "playing": 48, "highlight": [0, 45], "genre": 38,
+        "border": 45, "sub": 245, "desc": "Deep Navy & Neon Electric Cyan"
+    },
+    "Synthwave": {
+        "header": [0, 198], "accent": 198, "footer": [0, 198],
+        "track": 226, "playing": 51, "highlight": [0, 198], "genre": 209,
+        "border": 198, "sub": 244, "desc": "Neon Hot Pink, Gold & Electric Outrun Cyan"
+    },
+    "Cyberpunk 2077": {
+        "header": [0, 226], "accent": 226, "footer": [0, 226],
+        "track": 51, "playing": 48, "highlight": [0, 226], "genre": 198,
+        "border": 226, "sub": 245, "desc": "Electric Neon Yellow, Cyan & Hot Magenta"
+    },
+    "Laser Purple": {
+        "header": [0, 129], "accent": 129, "footer": [0, 129],
+        "track": 198, "playing": 141, "highlight": [0, 129], "genre": 198,
+        "border": 129, "sub": 244, "desc": "High-Voltage UV Purple & Neon Fuchsia"
+    },
+    "Neon Genesis": {
+        "header": [0, 129], "accent": 129, "footer": [0, 129],
+        "track": 46, "playing": 208, "highlight": [0, 129], "genre": 46,
+        "border": 129, "sub": 244, "desc": "Evangelion Neon Purple, Toxic Green & Orange"
+    },
+    "Matrix": {
+        "header": [0, 46], "accent": 46, "footer": [0, 46],
+        "track": 118, "playing": 155, "highlight": [0, 46], "genre": 28,
+        "border": 46, "sub": 240, "desc": "Phosphor Hacker Green & Black"
+    },
+    "OLED Obsidian": {
+        "header": [0, 252], "accent": 252, "footer": [0, 252],
+        "track": 255, "playing": 231, "highlight": [0, 252], "genre": 245,
+        "border": 242, "sub": 238, "desc": "Ultra-Clean Pitch Black, Platinum & Silver"
+    },
+    "Ghost White": {
+        "header": [0, 231], "accent": 231, "footer": [0, 231],
+        "track": 254, "playing": 250, "highlight": [0, 231], "genre": 244,
+        "border": 244, "sub": 238, "desc": "Alabaster Monochrome, Ice Pearl & Mist Gray"
+    },
+    "Blood Moon": {
+        "header": [0, 196], "accent": 196, "footer": [0, 196],
+        "track": 203, "playing": 197, "highlight": [0, 196], "genre": 160,
+        "border": 196, "sub": 240, "desc": "Gothic Crimson Red, Ruby Velvet & Charcoal"
+    },
+    "Sunset Horizon": {
+        "header": [0, 208], "accent": 208, "footer": [0, 208],
+        "track": 216, "playing": 141, "highlight": [0, 208], "genre": 175,
+        "border": 208, "sub": 244, "desc": "Vaporwave Dusk: Neon Tangerine, Coral & Violet"
+    },
+    "Vapor Mint": {
+        "header": [0, 85], "accent": 85, "footer": [0, 85],
+        "track": 121, "playing": 51, "highlight": [0, 85], "genre": 121,
+        "border": 85, "sub": 244, "desc": "Iced Spearmint, Pastel Seafoam & Vapor Teal"
+    },
+    "Peach Blossom": {
+        "header": [0, 216], "accent": 216, "footer": [0, 216],
+        "track": 222, "playing": 210, "highlight": [0, 216], "genre": 222,
+        "border": 216, "sub": 244, "desc": "Warm Juicy Peach, Golden Apricot & Coral Rose"
+    },
+    "Oceanic Abyss": {
+        "header": [0, 45], "accent": 45, "footer": [0, 45],
+        "track": 80, "playing": 51, "highlight": [0, 45], "genre": 27,
+        "border": 45, "sub": 244, "desc": "Deep Sea Sapphire, Aquamarine & Turquoise"
+    },
+    "Midnight Lavender": {
+        "header": [0, 141], "accent": 141, "footer": [0, 141],
+        "track": 189, "playing": 147, "highlight": [0, 141], "genre": 183,
+        "border": 141, "sub": 243, "desc": "Dreamy Twilight Violet, Lilac & Soft Indigo"
+    },
+    "Emerald Glow": {
+        "header": [0, 48], "accent": 48, "footer": [0, 48],
+        "track": 121, "playing": 46, "highlight": [0, 48], "genre": 42,
+        "border": 48, "sub": 244, "desc": "Bioluminescent Jade, Mint & Forest Green"
+    },
+    "Amber Terminal": {
+        "header": [0, 214], "accent": 214, "footer": [0, 214],
+        "track": 220, "playing": 215, "highlight": [0, 214], "genre": 172,
+        "border": 214, "sub": 242, "desc": "Vintage 1980s CRT Warm Amber Phosphor"
+    }
+}
+
+SHIMMER_EFFECTS = [
+    "cava_hyper_fluid_plasma",
+    "cava_ballistic_shockwave",
+    "cava_quantum_flux",
+    "cava_analog_vu_sweep",
+    "cava_solar_flare",
+    "cava_neon_synapse",
+    "cava_crystal_shatter",
+    "cava_cyber_matrix_glitch",
+    "cava_supernova_inferno",
+    "cava_laser_crosshair_scan",
+    "cava_liquid_mercury_flow",
+    "cava_hyperspace_warp_tunnel",
+    "cava_tesla_lightning_arc",
+    "cava_sync",
+    "cava_equalizer",
+    "cava_bass_bloom",
+    "cava_laser_sweep",
+    "cava_treble_sparkle",
+    "cava_stereo_pulse",
+    "cava_kick_strobe",
+    "cava_vocal_aura",
+    "cava_hihat_glitter",
+    "cava_frequency_drift",
+    "cava_rms_heatwave",
+    "cava_stereo_cascade",
+    "cava_transient_spark",
+    "cava_harmonic_breath",
+    "cava_sub_earthquake",
+    "cava_aurora_wave",
+    "cava_stereo_pan",
+    "cava_vocal_ripple",
+    "cava_laser_crossfire",
+    "cava_spectrum_cascade",
+    "cava_heartbeat_sub",
+    "cava_diamond_glitter",
+    "cava_harmonic_vortex",
+    "off"
+]
+
+SHIMMER_EFFECT_LABELS = {
+    "cava_hyper_fluid_plasma": "→ CAVA Hyper-Fluid Plasma (Sub-MS Chroma Flow)",
+    "cava_ballistic_shockwave": "→ CAVA Ballistic Shockwave (Transient Impact Rings)",
+    "cava_quantum_flux": "→ CAVA Quantum Flux (Sub-Atomic Wavefunction)",
+    "cava_analog_vu_sweep": "→ CAVA Ballistic VU Sweep (Studio Dual-Needle)",
+    "cava_solar_flare": "→ CAVA Solar Corona Flare (Sub-Bass Eruption)",
+    "cava_neon_synapse": "→ CAVA Neural Synapse (Cerebral Pulse Network)",
+    "cava_crystal_shatter": "→ CAVA Crystalline Prism (Acoustic Refraction)",
+    "cava_cyber_matrix_glitch": "→ CAVA Cyber Glitch (Matrix Digital Rain)",
+    "cava_supernova_inferno": "→ CAVA Supernova Inferno (Thermal Combustion Flame)",
+    "cava_laser_crosshair_scan": "→ CAVA Laser Crosshairs (Tactical Dual Scanner)",
+    "cava_liquid_mercury_flow": "→ CAVA Liquid Mercury (Viscous Chrome Flow)",
+    "cava_hyperspace_warp_tunnel": "→ CAVA Hyperspace Warp (Interstellar Tunnel)",
+    "cava_tesla_lightning_arc": "→ CAVA Tesla Arc Discharge (High-Voltage Lightning)",
+    "cava_sync": "→ CAVA Audio Sync (Beat Reactive Flare)",
+    "cava_equalizer": "→ CAVA Equalizer (Live Frequency Bars)",
+    "cava_bass_bloom": "→ CAVA Bass Bloom (Sub-Bass Shockwave)",
+    "cava_laser_sweep": "→ CAVA Laser Sweep (Transient Burst)",
+    "cava_treble_sparkle": "→ CAVA Treble Sparkle (Vocal & Cymbal Glitter)",
+    "cava_stereo_pulse": "→ CAVA Stereo Wave (Left/Right Dialogue)",
+    "cava_kick_strobe": "→ CAVA Kick Strobe (808 Bass Flash)",
+    "cava_vocal_aura": "→ CAVA Vocal Aura (Mid-Range Siphon)",
+    "cava_hihat_glitter": "→ CAVA Hi-Hat Glitter (Percussion Shimmer)",
+    "cava_frequency_drift": "→ CAVA Spectral Drift (Chroma Mood Ring)",
+    "cava_rms_heatwave": "→ CAVA RMS Heatwave (Loudness Flare)",
+    "cava_stereo_cascade": "→ CAVA Stereo Cascade (Dual Interference)",
+    "cava_transient_spark": "→ CAVA Transient Spark (Dynamic Accent)",
+    "cava_harmonic_breath": "→ CAVA Harmonic Resonance (Chord Glow)",
+    "cava_sub_earthquake": "→ CAVA Sub-Bass Tremor (Low-End Rumble)",
+    "cava_aurora_wave": "→ CAVA Aurora Wave (Spectral Ribbon)",
+    "cava_stereo_pan": "→ CAVA Stereo Panning (Binaural Flow)",
+    "cava_vocal_ripple": "→ CAVA Vocal Resonance (Liquid Ripple)",
+    "cava_laser_crossfire": "→ CAVA Laser Crossfire (Dual Snare Lasers)",
+    "cava_spectrum_cascade": "→ CAVA Spectrum Cascade (Multi-Band Rain)",
+    "cava_heartbeat_sub": "→ CAVA Cardiac Sub-Pulse (Kick Rhythm)",
+    "cava_diamond_glitter": "→ CAVA Diamond Glitter (Hi-Hat Storm)",
+    "cava_harmonic_vortex": "→ CAVA Harmonic Vortex (Acoustic Whirlwind)",
+    "off": "→ Off (Static Clean Theme)"
+}
+
+SHIMMER_PALETTES = {
+    "Brat Lime": [231, 190, 154, 118, 46],
+    "Toxic Latex": [231, 219, 198, 196, 161],
+    "Blohsh Acid": [231, 155, 118, 46, 28],
+    "Lover Pastel": [231, 225, 218, 189, 117],
+    "Guts Sour": [231, 207, 177, 141, 129],
+    "Born to Die": [231, 222, 174, 160, 88],
+    "After Hours": [231, 220, 196, 51, 160],
+    "Random Access": [231, 254, 220, 214, 178],
+    "Short n Sweet": [231, 230, 218, 172, 130],
+    "She Wolf": [231, 221, 214, 208, 166],
+    "Padam Fever": [231, 205, 198, 161, 125],
+    "Spice World": [231, 201, 214, 45, 27],
+    "Barbie Dreamhouse": [231, 225, 213, 200, 163],
+    "Cyber Lotus": [231, 219, 207, 48, 30],
+    "Moonlight": [231, 189, 141, 105, 60],
+    "Hot Pink": [231, 225, 219, 205, 198],
+    "Cyber Barbie": [231, 225, 213, 207, 201],
+    "Pink Velvet": [231, 224, 218, 206, 161],
+    "Cotton Candy": [231, 224, 218, 189, 117],
+    "Strawberry Milk": [231, 225, 224, 217, 210],
+    "Sakura Bloom": [231, 225, 218, 211, 175],
+    "Plur1bus": [231, 159, 51, 45, 38],
+    "Synthwave": [231, 225, 205, 198, 162],
+    "Cyberpunk 2077": [231, 226, 220, 214, 198],
+    "Laser Purple": [231, 219, 198, 141, 129],
+    "Neon Genesis": [231, 226, 208, 129, 46],
+    "Matrix": [231, 157, 120, 46, 28],
+    "OLED Obsidian": [231, 255, 250, 245, 238],
+    "Ghost White": [231, 255, 254, 250, 244],
+    "Blood Moon": [231, 224, 203, 196, 124],
+    "Sunset Horizon": [231, 223, 215, 208, 168],
+    "Vapor Mint": [231, 159, 121, 85, 51],
+    "Peach Blossom": [231, 223, 222, 216, 210],
+    "Oceanic Abyss": [231, 195, 80, 45, 27],
+    "Midnight Lavender": [231, 225, 189, 141, 99],
+    "Emerald Glow": [231, 157, 120, 48, 29],
+    "Amber Terminal": [231, 229, 220, 214, 172]
+}