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 treats your library like a deck of cards:

1. Install and forget — TrueShuffle runs silently in the background
2. Play past threshold — Listen to 50% of a track (configurable) and it's marked "played"
3. State persists — Progress survives restarts, updates, reboots — stored in a simple JSON file
4. Shuffle skips played tracks — Only unplayed tracks appear in shuffle
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.