### Panel

##

###

Up Next
0:00
0:00
Lyrics appear here.

### Create Playlist

Import from CSV

Please use Exportify to export your Spotify playlist into a .csv.

Please use TuneMyMusic to export your Apple Music playlist into a .csv.
(Apple Music imports are prone to errors)

Paste a YouTube Music Playlist URL.

Make sure its headers are in English.

Strict Album Matching Album name should strictly match CSV metadata. Disable for better discovery.

Import from JSPF

JSPF (JSON Shareable Playlist Format) is supported by many media players. Import playlists with rich metadata including MusicBrainz identifiers.

Import from XSPF

XSPF (XML Shareable Playlist Format) is a standard XML playlist format supported by many media players including VLC, Audacious, and Clementine.

Import from XML

Import playlists from generic XML formats including iTunes XML playlists, Winamp XML, and other custom XML playlist formats.

Import from M3U/M3U8

M3U is the most widely supported playlist format. Import from any M3U or M3U8 playlist file. Track information is extracted from the extended M3U format.

Warning: This feature isn't perfect and is prone to errors! Please check your playlist after to remove any unwanted songs that were added by the system.

Public Playlist Visible to anyone with the link.

### Edit Profile

Username

Display Name
Avatar URL
Banner URL
Status (Listening to...)
Favorite Albums (Max 5)
About Me
Website
Last.fm Username

Integrating Last.fm enables recent activity and top stats on your profile. Authorize it in Settings > Scrobbling. Note: Last.fm authorization is stored locally and must be repeated on each device.

#### Privacy

Public Playlists
Show Last.fm Link & Stats

### Create Folder

### Email Authentication

### Add to Playlist

### Go to Playlist

### Keyboard Shortcuts

`Space` Play / Pause
`→`Seek forward 10s
`←`Seek backward 10s
`Shift` + `→`Next track
`Shift` + `←`Previous track
`↑`Volume up
`↓`Volume down
`M` Mute / Unmute
`S` Toggle shuffle
`R` Toggle repeat
`Q` Open queue
`L` Toggle lyrics
`/`Focus search
`Esc` Close modals
`[`Previous visualizer preset
`]`Next visualizer preset
`\`Toggle visualizer auto-cycle

### Customize Shortcuts

Click on a shortcut to rebind it. Press the new key combination.

### Note

Unfortunately, some songs weren't able to be added. This could be an issue with our import system - try searching for the song and adding it. It could also be due to Monochrome not having the song :(

#### Missing Tracks:

### Sleep Timer

### Download Discography

Select which releases to download for :

Albums (0) EPs (0) Singles (0)

### Custom Database/Auth

Configure custom PocketBase and Appwrite instances. Leave empty to use defaults.
A Guide To Set This Up Can Be Found Here.

PocketBase URL
Appwrite Endpoint
Appwrite Project ID

### Theme Store

##

Created: - Updated:
Installs: 0

### Description

You need to be logged in to upload themes.

Theme Name
Description
Author Website (Optional)

It is recommended to create a Monochrome profile instead.

CSS

Define your CSS variables or custom styles here. Read the Theme Guide.

# Title Duration Menu

### Photosensitivity Warning

The visualizer contains flashing lights and rapidly moving patterns that may trigger seizures for people with photosensitive epilepsy.

Viewer discretion is advised.

### Update Available

A new version of Monochrome is available.

`ESC`

#### Importing Tracks from CSV

This can take a while depending on your playlist size. Please be patient.

Preparing import...
0 / 0 tracks processed

## Welcome to Monochrome

You haven't listened to anything yet. Search for your favorite songs to get started!

## Editor's Picks

## Recommended Songs

## Recommended Albums

## Recommended Artists

## Jump Back In

## Editor's Picks

## Listening Parties

Listen to music together with your friends in real-time. Host controls the music, everyone enjoys it.

You need an account to host a listening party.

Listening Party

# Party Name

Host: ...

## Currently Playing

## Participants (0)

## Song Requests

## Search Results

## My Playlists

## Favorites

Please use Google Chrome or Microsoft Edge to play local files.

Select a folder on your device to play local files.
Note: Metadata reading is basic (FLAC/MP3 tags).

### Local Files

## Recently played

Podcast

#

## Episodes

## Browse Podcasts

Unreleased Artist

#

#

## from Artist

## EPs and Singles

## Similar Artists

## Similar Albums

#

## Recommended Songs

Suggested Songs From Your Playlist

#

#

#

## Popular Tracks

##

## Albums

## Videos

## EPs and Singles

## Unreleased Music

## Similar Artists

Song

#

• •

## More from Album

## Similar Tracks

# User

@username
Website Last.fm

## Public Playlists

## Favorite Albums of All Time

## Recent Scrobbling

Powered by Last.fm

## Top Artists

## Top Albums

## Top Tracks

## Settings

Theme Choose your preferred color scheme
System
Black
White
Dark
Ocean
Purple
Forest
Mocha
Machiatto
Frappé
Latte
Custom

#### Custom Theme

Community Themes Browse and apply themes created by the community
Font Choose from presets, Google Fonts, URLs, or upload your own
Font Size Adjust the base font size (50% - 200%)
%
Waveform Seekbar Show a visual waveform of the track in the progress bar (Experimental)
Album Cover Background Use the album cover as a blurred background on album pages and as primary color
Dynamic Colors Automatically change the app accent color based on the currently playing track's album art
No Round Album Cover Do not round the album cover in fullscreen view
Vanilla Tilt Album Cover Enable 3D tilt effect on the album cover in fullscreen view
Tilt Distance Max tilt distance (default: 10)
Tilt Speed Tilt animation speed in ms (default: 240)
Full-screen Visualizer Enable the visualizer in full-screen mode
Visualizer Style Select the visualization style
Visualizer Mode Choose how the visualizer is displayed in full-screen
Smart Intensity Switching Automatically adjust visualizer intensity based on song energy
Visualizer Sensitivity Adjust the intensity of the visualizer effects. Warning: High sensitivity may cause flashing lights and rapid motion, which can trigger seizures in people with photosensitive epilepsy.
60%
Visualizer Brightness Adjust the brightness of the visualizer. Lower this if the visualizer is too bright for you.
100%
Cycle Presets Automatically change visualizer presets
Current Preset Select a specific Butterchurn preset
Cycle Duration Seconds between preset changes
Randomize Presets Select next preset randomly instead of sequentially
Show Recommended Songs Display recommended songs on the home page
Show Recommended Albums Display recommended albums on the home page
Show Recommended Artists Display recommended artists on the home page
Show Jump Back In Display recent albums, playlists, and mixes on the home page
Show Editor's Picks Display curated album selections on the home page
Shuffle Editor's Picks Randomize the order of editor's picks on each load
Editor's Picks Source Choose which editor's picks file to display
Compact Artists Show artist cards in a compact, horizontal layout
Compact Albums Show album cards in a compact, horizontal layout
Close Modals on Navigation Close open modals and panels (like lyrics, queue) when navigating back or to a new page
Intercept Back to Close Modals When pressing back, close open modals/panels first without navigating. Press back again to actually go back.
Now Playing View Mode Choose what shows when you click the album art
Fullscreen Cover Click Action Choose what happens when you click the cover in fullscreen mode
Scrobble Threshold Percentage of track to play before scrobbling (1-100%)
%
Last.fm Scrobbling Connect your Last.fm account to scrobble tracks

Enter your Last.fm credentials:

Enable Scrobbling Automatically scrobble played tracks
Love on Like Automatically 'love' tracks on Last.fm when you like them
Use Custom API Credentials Use your own Last.fm API key and secret
Custom API Credentials
Libre.fm Scrobbling Connect your Libre.fm account to scrobble tracks
Enable Scrobbling Automatically scrobble played tracks
Love on Like Automatically 'love' tracks on Libre.fm when you like them
ListenBrainz Scrobbling Submit listens to ListenBrainz (requires User Token)
User Token Found on your ListenBrainz profile page
Custom API URL (Optional) Leave empty to use official ListenBrainz server
Love on Like Automatically 'love' tracks on ListenBrainz when you like them
Maloja Scrobbling Submit listens to a self-hosted Maloja server
API Key Found in your Maloja settings
Maloja Server URL Your Maloja instance URL
Streaming Quality Default playback quality for streams
Show Quality Badges Display "HD" badge for Hi-Res tracks
Album release year Show original album year instead of track/remaster date
Gapless Playback Play audio without interruption between tracks
ReplayGain Mode Normalize volume across tracks
ReplayGain Pre-Amp Adjust gain manually (dB)
Mono Audio Combine left and right channels into mono
Exponential Volume Use logarithmic volume curve for finer low-volume control
Playback Speed Adjust playback speed (0.01x - 100x)
x
Preserve Pitch Keep original pitch when changing speed
AutoEQ Precision headphone correction & parametric equalizer

#### AutoEQ - Headphone Correction

1. Select your headphone from the dropdown or search the database below.
2. Pick a target curve - Harman is the most popular. You can also import a custom target.
3. Adjust filter bands (more = finer correction, 10 is a good default).
4. Click AutoEQ - the algorithm generates parametric filters that shape your headphone's response toward the target.
5. The pink corrected curve on the graph shows the predicted result.
6. Double-click an empty area on the graph to add a new filter band at that frequency. Double-click an existing node to remove it.
7. Save the profile so you can switch between headphones instantly.

Tip: Use "Auto Preamp Compensation" to prevent clipping from positive EQ gains.

#### Parametric EQ - Manual Control

1. Each band supports peaking, low-shelf, and high-shelf filter types with frequency, gain, and Q (width).
2. Drag nodes on the graph to adjust frequency and gain visually.
3. Double-click an empty area on the graph to add a new band at that exact frequency and gain. Double-click an existing node to delete it.
4. Use + Add Band / - Remove Band to change the number of filters.
5. Pick a preset (Bass Boost, Vocal, etc.) as a starting point, then fine-tune.
6. Import/Export settings in EqualizerAPO format for use in other apps.
7. Save profiles with custom names to keep your favorite EQ curves.

Tip: Lower Q = wider curve. Higher Q = narrower surgical cut.

#### Speaker EQ - Room Correction

1. Select your speaker config (2.0, 5.1, or 7.1).
2. Click a channel tab (FL, FR, etc.) to work on one speaker at a time.
3. Measure: click the mic button - pink noise plays for 5 seconds while your microphone captures the room response. Or import a measurement file from REW or similar.
4. Pick a target - Harman In-Room is recommended for speakers.
5. Set Bass Limit (don't EQ below this) and Room Limit (don't EQ above this) - the colored lines on the graph show the active range.
6. Click AutoEQ to generate correction filters for that channel.
7. Double-click an empty area on the graph to add a filter band at that frequency. Double-click an existing node to remove it.
8. Repeat for each channel, then Export JSON with all channels.

Tip: Place your mic at the listening position. Measure each speaker separately for best results.

Preset
Preamp 0 dB
Frequency Response
Original Target (Primary) Corrected
Preamp 0 dB
Auto Preamp Compensation

#### Database

AutoEq Repo
HEADPHONE MODEL
TARGET · import custom ↑
FILTER BANDS
MAX HZ
SAMPLE RATE
SAVED PROFILES 0
MEASUREMENT
No measurement
TARGET
BANDS
BASS LIMIT
40 Hz
ROOM LIMIT
500 Hz
PREAMP
0 dB
SPEAKER PROFILES 0
PARAMETRIC EQ FILTERS
PRESET
SAVED PROFILES 0
Download Quality Quality for track downloads
24-bit downloads may crash the browser on some devices, or be missing metadata.
Dolby Atmos Prefer Dolby Atmos tracks when available
Lossless Container Container format for lossless downloads
Bulk Download Method Choose how multiple tracks are downloaded together
Remember Last Folder Re-use the last chosen directory for Folder Picker downloads
Reset Saved Folder Clear the remembered Folder Picker directory
Single Downloads to Folder Save individual track downloads directly to the configured folder instead of triggering a browser download
Force ZIP as Blob Download ZIP in memory instead of streaming to disk (use if ZIP streaming causes issues)
Write Artists Separately Write artists separately to metadata. Requires player support.
Download Lyrics Include .lrc files when downloading tracks/albums
Romaji Lyrics Convert Japanese lyrics to Romaji (Latin characters)
Cover Art Size Size for downloaded/embedded cover art
Filename Template Customize download filenames. Available: {discNumber}, {trackNumber}, {artist}, {title}, {album}
Folder Template Customize album folder names. Use `/` for nested folders. Available: {albumTitle}, {albumArtist}, {year}
Generate M3U Include M3U playlist files in downloads
Generate M3U8 Include extended M3U8 playlist files in downloads
Generate CUE Include CUE sheets for gapless playback in downloads
Generate NFO Include NFO files for media center compatibility
Generate JSON Include JSON files with rich metadata
Relative Paths Use relative paths in playlist files
Separate Discs Put tracks in Disc folders when a release has multiple discs
Include Cover File Include cover.jpg in downloads
ADVANCED: Custom Database/Auth Configure custom PocketBase and Appwrite instances
API Instances Manage and prioritize API instances.

Keyboard Shortcuts View and customize keyboard shortcuts
Cache Stores API responses to reduce requests
Auto-Update App Automatically reload when a new version is available
Analytics Send anonymous usage data to help improve the app
Reset Local Data Clear all local storage and cached data (does not affect cloud sync)
Clear Cloud Data Delete all your data from the cloud (cannot be undone)
Backup & Restore Export or import your library and history as JSON
Export All Settings Export all app settings as JSON
Blocked Content Manage artists, albums, and tracks you've blocked from recommendations

Nothing blocked yet.

#### Artists

#### Albums

#### Tracks

## About Monochrome

Monochrome is a lightweight, privacy-focused music streaming client designed for high-fidelity audio playback. Built with modern web technologies, it provides a clean, distraction-free listening experience.

## Support Monochrome

If Monochrome has been useful to you and you're able to, consider making a donation.
It helps pay for the server and domain, and you get to support us :)

If you cannot financially support us, please consider starring the project on GitHub and sharing with friends!

Donate to Monochrome Star on GitHub

made with ‪‪❤︎‬ by Edideaur & Samidy

### Contributors List:

## Sign Up / Sign In

Make an account to allow syncing your library between devices.

Sync your library across devices

We only store music data and a randomized ID to find out which Google/Email account is which.
All data is anonymous. We do not store anything like emails, usernames, or anything sensitive.

However, if you want complete control over your data, we allow you to use your own Database Configuration.

Advanced: Custom Configuration

## Support Monochrome

If Monochrome has been useful to you and you're able to, consider making a donation. It helps pay for the server and domain, and you get to support us :)

Donate on Ko-fi

If you cannot financially support us, please consider starring the project on GitHub and sharing with friends!

Star on GitHub