random-library

A Spicetify custom app that displays your saved Spotify albums and followed artists in a fast, shuffled, filterable grid. Find it in the left sidebar under the shuffle icon.

Features

• Standardized Modes
  • Albums — Instant local library view of all your saved albums.
  • Artists — Shuffled grid of all the artists you follow with instant local loading.
• Symmetric Randomization
  • In Albums mode: Click 🎲 Random Album to pick and open a random album from your saved collection.
  • In Artists mode: Click 🎲 Random Artist to pick a random followed artist and open their discography.
• On-Demand Artist Discography & Native Release Filters
  • Click any followed artist to open their complete discography right inside the app.
  • 100% native Spotify catalog categories:
    • All
    • Albums (Studio albums)
    • Singles & EPs
    • Compilations
    • Appears On (Features and appearances)
• Continuous Filter Randomization — Selected release filters (e.g. Albums or Singles & EPs) persist as you click Random Artist, allowing continuous randomized discovery within a specific category.
• Stateful Navigation History — Clicking an album and pressing Back (←) returns you right to the opened artist's discography view without losing your place.
• Persistent Shuffle — The shuffle order is preserved across app relaunches and sessions.
• Search & Sort
  • Search by album title or artist name in real time.
  • Sort by Shuffled, Album A–Z / Z–A, or Artist A–Z / Z–A.
• Play on Hover — Hover over any album or artist card and click the green play button to start playback immediately.

Requirements

• Spicetify installed and configured (spicetify backup run at least once)
• Spotify desktop app

Install

Windows (PowerShell)

iwr -useb "https://raw.githubusercontent.com/daviidpaark/random-library/main/install.ps1" | iex

macOS / Linux

curl -fsSL "https://raw.githubusercontent.com/daviidpaark/random-library/main/install.sh" | bash

The script will:

1. Verify spicetify is in your PATH and that config-xpui.ini exists
2. Copy or download index.js and manifest.json into your Spicetify CustomApps/random-library/ folder
3. Clean legacy random-albums registrations and register random-library in config-xpui.ini
4. Run spicetify apply

Restart Spotify if it was already open.

Uninstall

Windows (PowerShell)

iwr -useb "https://raw.githubusercontent.com/daviidpaark/random-library/main/uninstall.ps1" | iex

macOS / Linux

curl -fsSL "https://raw.githubusercontent.com/daviidpaark/random-library/main/uninstall.sh" | bash