Standard shuffle algorithms pick tracks randomly each time — like rolling dice. With a large library, you'll hear some tracks repeatedly while others gather dust. That's not a shuffle, that's chaos.

TrueShuffle is shuffle that works different.

Every track in your library plays exactly once before any repeats. Yes, MusicBee's AutoDJ and Auto-Playlists can do similar things with more options — this is the lite version. A learning project that became genuinely useful.

Two features make it worthwhile:

• Persistent state — Close MusicBee, reopen days later, resume exactly where you left off
• Unheard-first priority — Tracks with zero plays always come first

Could you build this with an Auto-Playlist? Absolutely. But sometimes you want a single toggle switch instead of configuring filters.

TrueShuffle treats your library like a deck of cards:

1. 'something like' AutoDJ 'lite' queues tracks — After each song, TrueShuffle adds an unplayed track to your Now Playing queue
2. Play past threshold — Uses your MusicBee play count settings to determine when a track counts as "played"
3. State persists — Progress survives restarts, updates, reboots — stored in a simple JSON file
4. Repeat — TrueShuffle keeps queueing unplayed tracks until all have been played
5. Full cycle — Once every track has played, reset manually or let it auto-reset

Skip a track early? It stays "unplayed" and comes back around. Disable the plugin? Your progress is preserved.