Repository navigation
Releases
Releases · Passimoritz/spicetify-mirage
Mirage v1.25.0
Changed
- Party mode reads songs more like a person would. Drops land on the real chorus far more often, there are about five times fewer false drops, and the beat grid sits better on the downbeat. This was tested against about 5,000 real song previews across genres.
- The crowd now follows the song's parts. It gets calmer in verses and breaks and jumps on the chorus and the drop.
- Genre names from Apple Music are recognised in more languages, and tempos from Deezer no longer show up at double or half speed.
- New, clearer performance menu: the sliders are easier to read and cost the same performance.
- The visualizer styles look sharper and softer at once: colours from the cover, gradient bars, smooth curves and glowing particles. Their glow follows the song's parts and drops.
- Party sparks, light rain and moving-head beams are drawn as soft light.
- The immersive background blur is prepared once per song, which saves graphics work on every frame.
Fixed
- Song changes in party mode stay smooth. The crowd used to repaint its people for every in-between colour of the light crossfade, which halved the frame rate for about two seconds after each change. It now uses the song's calm base colours and spreads the repaint over a few frames. The power-saving 30 fps for quiet passages no longer kicks in during the first seconds of a song, and only after 3 seconds of real quiet.
- Song changes no longer briefly show "Loading" for lyrics that are already there. The background image is prepared in the background and ahead of time for the next song, and party mode looks up the next song's genre in advance.
- The visualizer ring now stays on the cover in every frame. This holds while the cover glides to a new place, pulses or shakes, and when you switch views or open a side panel. Before, the ring could sit next to the cover for up to half a second.
- The cover's shake on strong beats is now a smooth wobble instead of random jumps.
- The cover tilts towards the mouse with a smooth spring. Pulse and sway glide between frames even at 30 fps (Light, energy saver).
- The spinning vinyl and the ambient background no longer stutter, and changing songs during a fade no longer makes the background jump.
Mirage v1.24.1
Changed
- New README in English and German, written for everyone: install in a few steps, a picture tour, party with friends, the overlay app, help and privacy in plain words.
- New demo page: try the theme live (covers, colour schemes, immersive views, a party with a drop), see how guests join, and preview the overlay app's styles and how it connects to OBS and your lights.
Fixed
- Karaoke: if the singer's phone misses the details of the part to sing, it gets them again, so the score always works.
Mirage v1.24.0
Added
- Repairs without a new release: Mirage loads a small file from its repository (
remote/fixes.json) and applies matching fixes after a Spotify update: new selectors and plain CSS, never code. It can be switched off in the settings. - One broken part no longer stops the rest: if a part of Mirage fails to start, everything else keeps running, a note names the part, and it is listed in the diagnostics.
- The phone page reloads itself once when the theme speaks a newer message format, and says so clearly if that does not help.
- Overlay app repairs and updates the theme: after a Spotify update it notices that Mirage is gone (Windows) and puts it back with one click, and the tray menu offers a new theme version when there is one. Both only on a click, because Spotify restarts once.
- Nightly Spotify check: a workflow unpacks the newest Spotify client every night and opens an issue when a rule of the theme stops matching.
npm run check:selectorsdoes the same for the installed Spotify. - Karaoke game: one guest sings a 30–45 s part of the current song with synced lyrics; their phone listens and scores timing, notes and singing along (0–100, with a breakdown). Scoring runs entirely on the phone: the recording never leaves it, only four numbers are sent, and the microphone is released when the part ends. In loud rooms the phone measures the room first and weights timing more.
- Photo wall (off by default): guests send a photo from their phone; it appears only after you approve it in the side panel, then floats in as a small polaroid at the screen edge. Photos are re-encoded on the phone (orientation fixed, location and all metadata removed, max 640 px), sent end-to-end encrypted in checked chunks and kept only in memory until the party ends; one per guest every 30 s, five per guest per party.
- 318 party styles in 17 families (was 69): electronic and hip-hop sub-styles, every major rock and metal subgenre, K-pop to OPM, Latin America, Africa & Caribbean, Middle East, Europe, country and folk, jazz and blues, gospel, classical eras, calm, experimental, kids, holidays and spoken word. Detection picks the most specific match (“latin trap”, “corridos tumbados”, “melodic death metal”) and combines regional words sensibly (Apple's dance genre “Hardcore” means gabber, Spotify's “hardcore” means punk); the style list in settings is grouped by family and has a search field.
- The show follows the mood of every song and every part of it (tempo, loudness, major/minor, brightness, rhythm, held notes, optionally the lyrics): a euphoric drop, a tender break and a sad bridge each get their own colours, pace, haze, beam width and particles.
- Scenes within a song: the light show changes between looks that suit both the style and the current mood, always on a downbeat at a phrase boundary, never the same scene twice in a row; each song has its own sequence, the same every time it plays. Scenes can borrow from related styles when the feeling fits.
- Lyrics: recognised more reliably (feat. and film suffixes, “&”/“and”, several artists, other scripts and transliterated names, language versions, instrumentals); new sources Kugou (time-synced) and, for karaoke, the AMLL word-by-word collection; all sources are asked at once, the first result appears immediately and is upgraded in place without the view jumping.
- Lyrics on time: lyrics from other sources are shifted or stretched to the vocals when the audio analysis is confident; manual timing (E) and tap calibration still have the final say. If Spotify only has plain lyrics, a time-synced version of the same text is used.
- Party mode plans every song section by section (intro, verse, pre-chorus, chorus, drop, break, bridge, outro): each part has its own brightness, motion speed, colour grade and allowed effects, and every change lands on a downbeat. Builds tighten toward the drop, the last beat before it goes dark, and a light wipe and colour swap mark the start of a chorus, drop or bridge. The visualizer views follow the same structure.
- Style signatures: house pumps with the kick, techno runs long hypnotic scanners, trap hits hard on the 808 with half-time sweeps, drum & bass runs double-time, rock fires a light wall on the chorus downbeat, ballads breathe over two bars with a follow spot on held notes, latin lights up on syncopated accents, EDM gets the full build/drop drama.
- New party crowd: real silhouettes with shoulders, necks and 17 hair and headwear styles, varied builds and clothing, rim light in the song colours from the stage, rows that fade into the haze, arms with elbows, staggered reactions to the beat and a crouch before the drop. The concert hall sits in velvet seats and the living room has a few friends dancing along. It is cheaper to draw than before.
- Quick “Look & performance” menu in immersive mode (the ⋯ button, or key O): switch Full / Balanced / Light / Calm, Energy saver and No flashes without opening the settings.
npm run ui:shotsrenders Spotify's real stylesheets with Mirage in a hidden window, for visual checks without Spotify.- Five new games: Older or newer? (two clips, guess which came out first), Cover puzzle (the cover goes from blocky to sharp while the music stays off), Song duel (the room votes, the winner takes on the next song), Tournament (3 to 6 games in a row with placement points and a podium) and Music bingo (every phone gets its own card; the PC checks every claimed row).
- Teams: quizzes and races can be played in 2 to 4 even teams, with team scores next to the individual ones.
- Remote control for your phone: playback, volume, intensity, location and games behind a separate signed QR code in the party settings.
- Song wishes: paste a Spotify song link instead of searching; new rules for wishes per guest, a block list, no explicit songs and auto-queue at N votes.
- Light wave: phones can light up in turn or in colour groups instead of all at once.
- Phones that cannot vibrate (iPhone) can switch on a quiet click on the beat; guest reactions rise quietly at the screen edges and can be switched off.
- The phone page speaks all 14 Mirage languages and can be added to the home screen as a full-screen app.
- New opt-in setting Also recognise instruments from the sound: guesses piano and distorted guitar when the credits name no instrument (can be wrong).
- Overlay app: Fast Hue (Entertainment) streams 50 colour frames per second to a Hue entertainment area over the app's own encrypted connection, falling back to normal Hue control on any error (off by default; not yet tried with a real bridge). The first-start setup can find, pair and test lights.
- Guests have a name and a colour: picked once on the phone; the lobby, scores and song wishes show whose they are. The lobby on the big screen shows who is in and how many players are still needed.
- Join late, keep your points: guests can jump into a running game, and keep their points after a reload or a lost connection. The phone page shows clearly when it is offline and reconnects by itself.
- Game host on the phone: a separate host QR code (behind a button in the games panel) lets one phone start, skip and end games and correct points. Host commands are signed, guests cannot send them.
- Quiz difficulty (easy, normal, hard), an optional decade filter, and a playlist as the source of quiz songs instead of the queue.
- Play without phones: number keys answer, Space is the buzzer, Enter starts.
- After a game, save the ranking as an image.
- No flashes: a switch for photosensitive eyes removes strobe, blinders, drop flashes and the lyric burst. It is on automatically when the system asks for reduced motion. All flashes now share a hard limit of three per second.
- Lyrics are kept on your device (up to 500 songs) and song analyses for the last 300 songs, so both are there at once and offline. The next song is prepared about 20 seconds before the current one ends.
- Not the right lyrics: a button marks the result as wrong for that song and tries the next best one. Live versions and remixes no longer get the timed lyrics of a different recording.
- Romanization also covers Russian, Ukrainian, Bulgarian, Serbian, Greek and Hindi lyrics.
- DJ panel: Apply order sorts the upcoming songs by key, tempo and energy curve, with undo.
- Six more instrument moments: drum solo, bass, synthesizer, accordion, flute and harp (only when the credits confirm them).
- Settings: each section can be reset on its own, and Esc clears the search.
- Keyboard and screen readers: immersive mode and settings are usable without a mouse, every control has a name and state, and song changes are announced.
- Installer:
install.ps1installs Spicetify if missing and works as a one-line install; newinstall.shfor macOS and Linux (not yet tried on a real machine). - Overlay app: Hue and Home Assistant credentials are stored encrypted, room lights get a maximum brightness, single lights can be left out, WLED and OpenRGB return to their previous state, and each light system gets its own timing with a blink test.
npm run check:contrastchecks every accent colour pair against 2,617 synthetic covers;npm run test:phonestests the phone page with phone emulation in Chrome.
Changed
- Play, pause, skip and seek go through one small layer of Mirage's own with a direct fallback to Spotify, instead of relying on single Spicetify helpers.
Fixed
- End on the host phone closes the final screen of a game or tournament at once; the button no longer gets rebuilt under the finger when the next state arrives.
- The cover-colour wash under page headers (artist, playlist, album, podcast, concert pages) and at the top of Home fades out smoothly instead of ending in a hard line through track lists and card rows.
- Header info lines no longer show doubled dots (“2022 • • 14 songs...
Mirage v1.23.1
Removed
- The pause screen is gone completely, including its setting.
Fixed
- Muting never worked in current Spotify versions: Spicetify's mute clicks a button that no longer exists, so the start of a song stayed audible in guessing games, Keep singing never went silent, and the mute button in immersive mode did nothing. Mirage now sets the volume itself and restores it afterwards.
- A jump right after a song change could get lost and the song played from its start. It is now repeated until the song is in place.
- Guessing games no longer stop when the queue is small or holds only one artist.
- Tap race and Beat hit could show a score that was too low on the big screen when a message got lost. Phones now repeat their score.
- Empty pink box in the player bar: Spotify's new key badge next to the BPM (and a few other labels on coloured backgrounds) had invisible text.
- Lyric games reuse lines correctly across songs, and a phone can answer again when a media key changed the song during a round.
- Spotify 1.3.9: filter chips, the playing row in track lists, Spotify's own lyrics view and the sections on Spotify's settings page had lost their Mirage look after the update.
Tests
npm run test:gamesplays all 20 games end to end, silently: the real theme and phone page over a real MQTT relay, three guests joining by scanned QR code, with real mouse clicks. It also runs in CI.npm run check:spotifycompares the test's Spotify stand-in with the installed Spotify and Spicetify.
Mirage v1.23.0
Added
- 20 party games: new are Intro flash, Real or fake?, Tap race and Keep singing (the music goes silent in the middle of a song and comes back: are you still in time?).
- Drinking games (18+): Never have I ever, Sip quiz, Word alarm, Who would … (sip edition) and Sip wheel, plus an optional setting for sips in every quiz. Nobody has to drink, water counts too.
- Sound effects for the games on the big screen, with a volume setting, and quiet feedback on the phones with a 🔊 switch.
- Play again button for the guessing games, so a clip can be heard a second time.
- QR scanner on the phone page: guests who opened the page without a link can scan the code with the camera or paste the link.
- Lyric state icon next to the title in all immersive modes, with the details on hover. It replaces the "No lyrics for this song" and "Instrumental" messages.
Changed
- Songs in guessing games play only as far as needed: a clip of adjustable length, then the music stops until the answer is revealed. The reveal plays the song again.
- Players have 2 minutes to join instead of 30 seconds, adjustable from 30 seconds to 3 minutes.
- Beat hit has a display on the big screen (a ring and four lights on the real beats, BPM, race bars) and now scores the intervals between your taps. It can also be played alone.
- Game visuals: names light up once someone has answered, an equalizer shows when music plays, the time turns red at the end, and the reveal shows the cover.
- Better game rounds: Real or fake? jumps to the real line on the reveal, Fastest finger signals on the next beat, the Hot potato fuse speeds up, Word alarm runs over several songs, Who would most likely shows the crowd's hands going up, and song titles leave out additions like "Remastered" or "feat.".
- Only one menu is open at a time in immersive mode: a new one closes the previous one.
Fixed
- Song start was audible in guessing games, which could give away the artist. The song stays muted until it has reached the right spot. Intro flash starts at the beginning on purpose.
- Questions could be about the wrong song with shuffle or autoplay. The game now changes the song first and asks about the one really playing.
- Songs could be controlled during a game: next, back, play, seek, shuffle, shortcuts, Stream Deck and the overlay are locked in games with music. Media keys cannot be blocked, so the game corrects itself: a pause resumes, and a skip restarts the same round with the new song.
- Black stripe at the top of the phone page, caused by an empty note bar.
- Beat hit on the phones could miss every tap when the song had no beat data.
- The pause screen no longer appears on top of a running game.
Removed
- Cover puzzle.
- QR code on the pause screen.
Mirage v1.22.0
Added
- Six more party games, eleven in total: Name that song, Next line, Beat hit (tap along, the tightest timing wins), Fastest finger, Hot potato (a bomb travels from phone to phone) and Who would most likely …? (guests vote for each other).
- Game settings in the games panel: rounds, time per question, time to join, battle and beat length, break between rounds, bonus for fast answers, large or compact game card, which wheel fields are used, and your own wheel fields.
- Lobby for every phone game: QR code and the names of everyone who joined on the big screen, with a Start now button. Skip round is in the games panel.
Changed
- New game design on the big screen and the phones: the same coloured answer tiles A to D on both, a time bar, round dots, a podium at the end, right-or-wrong feedback with the points you won, and a real colourful wheel of fortune.
- Fewer buttons in party mode: the top row is now games, QR code, wishes, More and full screen. DJ, poll, recap, confetti, other screen, film, add to playlist, devices, timer, share and shortcuts moved into the new More menu.
- A round ends right away once everyone has answered (Who's singing?, Name that song, Who would most likely).
Fixed
- Phone taps got lost: poll buttons were rebuilt with every message (8 times a second), and every tap tried to enter full screen again. Answers, joins and taps are now sent more than once and are sent late if the phone was offline for a moment.
- Hidden songs were revealed on reload or join: a phone first showed the last message kept by the relay, which could be older than the hidden round. Kept messages now only count if nothing live arrives. Wish lists, next-song info and word effects no longer give away the answer either.
- A phone whose clock was more than a minute off could not join at all.
- Cut-off content on the phone page: game cards could not be scrolled up to their first lines, long lyrics ran into the buttons, the button rows could be wider than small screens, and landscape mode overlapped.
- Your answer and your elimination are remembered if you reload the phone page during a round.
Mirage v1.21.0
Added
- Five party games – start them with the new game button in party mode. Guests play on their phones through the live link, the big screen shows the game and the scores:
- Who's singing? The next song starts hidden (title, cover and lyrics are covered) – who names the artist first? Five rounds, fast answers score more.
- Lyric gaps An upcoming line appears with a missing word; it's solved the moment it's sung. Needs a song with time-synced lyrics.
- Music stop The music stops suddenly: tap too early or too slowly and you're out, until one is left.
- Dance battle Two teams shake their phones for 30 seconds (tapping counts too, if a phone has no motion sensor).
- Wheel of fortune Spins on the big screen and sets something off – confetti, hands up, next song, a new venue, a guest's wish … No phones needed.
Mirage v1.20.0
Added
- Four new visualizer styles: Galaxy (spiral arms of light around the cover), Mountains (three ridges made of the spectrum), Oscilloscope (a ring of light swinging in overtones) and Shattered cover (the cover breaks into tiles on the beat and pieces itself back together).
- DJ panel in party mode: shows tempo and key (Camelot) of the current song and which songs in your queue fit best next – by key, tempo and energy – with one click to play them next.
- Keep the energy (off by default): if the next song would break the mood, a better fitting one from the queue moves up, and it's skipped at its old place so nothing plays twice.
Removed
- The drop countdown and the announcements from 1.19.0 – they added more noise than fun.
Fixed
- Phone lights, lighters and camera flashes from the back rows shone through the people in front; they're now hidden behind them.
Mirage v1.19.0
Added
- Party moments: a big drop countdown on the last four beats before a drop · hands up – in the chorus the whole crowd throws both hands in the air · a camera flash storm at the first big chorus and the last big drop · floor fog drifting behind the crowd, coloured by the lights · a drone light show in open-air venues on the first big drop (heart, star, circle or wave) · a confetti cannon on key C, a button at the top or the Stream Deck. Each one can be switched off in the party settings.
- A more varied crowd: long hair, afros, ponytails, beanies, hats, short hair and three body builds.
- Key colours: major keys light a little warmer, minor keys a little cooler, with a hint of each section’s key. Tempo changes are followed – half time, double time or a different tempo in a breakdown changes how the crowd dances.
- Pause scene: when the music pauses in party mode, a calm scene with the song and the QR code for phones.
- Announcements: type a message (or pick “Food is ready!”, “Last song!” …) – it shows big on the party screen and on every phone.
- Guest vote: the guests vote on the next three songs on their phones for 45 seconds; the winner plays next.
- Reactions: guests send 🔥 ❤️ 🙌 😂 🎉 👏 from their phones – they float up over the party screen.
- Party recap: save the night as a Spotify playlist with one click, plus a guest ranking (whose wishes were played, who voted most).
- Phones: the live page now speaks all 14 languages, tells you when your wish is next (also as a notification if you allow it), and reconnects by itself – right away when you unlock the phone again.
- Library: “Remove duplicate songs” in the playlist menu (exact duplicates and songs that are probably the same) and, if you switch it on, tempo and key (Camelot) in track lists.
- Overlay app: two new styles – Mini bar and Cover bubble –, a short setup wizard on the first start, and export/import of settings (without the Hue key and the Home Assistant token).
- Report a problem: a button in the settings opens a pre-filled GitHub issue with the diagnostics; the diagnostics now include the last errors.
Changed
- Update watch: after a Spotify update Mirage checks the new version after three minutes instead of twenty and says whether everything fits.
Mirage v1.18.0
Added
- Word pictures in party mode – sung words get a fitting picture: a warm glow and sparks for “fire”, rain for “rain”, little hearts, falling stars, snow, money, petals, a crown, birds, butterflies, fireworks, balloons and about 40 more. Around 65 ideas in 45 languages and almost 20,000 word forms, from English, German and Spanish to Japanese, Korean, Chinese, Hindi (also romanized), Arabic, Turkish, Russian and Swahili. The song’s language is recognised from its lyrics; for other languages the English translation helps. The sung word glows briefly in the picture’s colour. Deliberately subtle: at most one picture per line, pauses in between, never more than two at once – and the crowd always stays clear. On by default, switch off under Party → Word pictures. Phones on the live link show the same pictures.
- Party on the TV – rendered on your PC. “On another screen” now lists TVs in your network: Chromecast, Google TV and Android TV as well as DLNA smart TVs (Samsung, LG, Sony, Philips …). The overlay app records the party in full screen with your PC’s graphics and streams the finished picture to the TV (1080p, 30 fps) – the TV only shows video, it doesn’t compute anything. Only the picture by default; “Send the sound along” puts the PC sound into the stream so picture and sound stay in time on the TV. Windows’ own wireless display (Miracast, Win + K) is one click away too – then the TV is a second screen.
Changed
- No more jumping without lyrics: when a song has no lyrics, title, artist and controls now glide under the cover – once, when it’s clear there’s no text, instead of jumping back and forth twice on every song change.
- The “On another screen” button is always there in party mode (it used to hide when Windows couldn’t list screens).
Fixed
- Korean lyrics with particles (별이, 별을 …) were missed by the word recogniser.