An open-source, privacy-respecting, ad-free music app.

Website • Donate • Features • Installation • Usage • Self-Hosting • Contributing

Monochrome is an open-source, privacy-respecting, ad-free TIDAL web UI, built on top of Hi-Fi. It provides a beautiful, minimalist interface for streaming high-quality music without the clutter of traditional streaming platforms.

• High-quality Hi-Res/lossless audio streaming
• Support for local music files
• Intelligent API caching for improved performance

• Dark, minimalist interface optimized for focus
• Customizable themes
• Accurate and unique audio visualizer
• Offline-capable Progressive Web App (PWA)
• Media Session API integration for system controls

• Recently Played tracking for easy history access
• Comprehensive Personal Library for favorites
• Queue management with shuffle and repeat modes
• Playlist import from other platforms
• Public playlists for social sharing
• Smart recommendations for new songs, albums & artists

• Lyrics support with karaoke mode
• Genius integration for lyrics
• Track downloads with automatic metadata embedding

• Account system for cross-device syncing
• Last.fm and ListenBrainz integration for scrobbling
• Unreleased music from ArtistGrid
• Dynamic Discord Embeds
• Multiple API instance support with failover

• Keyboard shortcuts for power users

Our Recommended way to use monochrome is through our official instance:

monochrome.tf

For alternative instances, check INSTANCES.md.

NOTE: Accounts wont work on self-hosted instances.

git clone https://github.com/monochrome-music/monochrome.git
cd monochrome
docker compose up -d

Visit http://localhost:3000

For PocketBase, development mode, and advanced setups, see DOCKER.md.

• Node.js (Version 20+ or 22+ recommended)
• Bun or npm

1. Clone the repository:

   git clone https://github.com/SamidyFR/monochrome.git
   cd monochrome

2. Install dependencies:

   bun install
   # or
   npm install

3. Start the development server:

   bun run dev
   # or
   npm run dev

4. Open your browser: Navigate to http://localhost:5173/

bun run build
# or
npm run build

1. Visit the Website or your local development server
2. Search for your favorite artists, albums, or tracks
3. Click play to start streaming
4. Use the media controls to manage playback, queue, and volume

To sync your library, history, and playlists across devices:

1. Click the "Accounts" Section
2. Sign in with Google or Email
3. Your data will automatically sync across all devices

We welcome contributions from the community! Please see our Contributing Guide for:

• Setting up your development environment
• Code style and linting
• Project structure
• Commit message conventions
• Deployment information

Made with ❤️ by the Monochrome team