Deezer Overlay for Gaming

A lightweight, always-on-top overlay that displays the currently playing track from Deezer Desktop. Perfect for gamers who want to see what's playing without leaving their game.

Features

• Always-on-top overlay - Stays visible even during games (windowed/borderless mode)
• Track info display - Shows song title, artist, and album artwork
• Playback controls - Play/Pause, Next, Previous
• Auto-launch - Automatically starts when Deezer opens (optional)
• Auto-close - Automatically closes when Deezer quits
• Click-through mode - Doesn't interfere with your game by default
• No external dependencies - Works out of the box on any Mac

Installation

1. Download the latest release (Deezer Overlay.app)
2. Move it to your /Applications folder
3. Launch the app
4. Grant Accessibility permission when prompted:
   • Go to System Preferences → Privacy & Security → Accessibility
   • Add Deezer Overlay to the list

Usage

Keyboard Shortcuts

Shortcut	Action
Cmd + Shift + I	Toggle interactive mode (enable clicking on buttons)
Cmd + Q	Quit the overlay

How it Works

1. Launch Deezer Desktop and play some music
2. The overlay appears in the top-left corner of your screen
3. By default, clicks pass through the overlay (won't interfere with your game)
4. Press Cmd + Shift + I to enable interactive mode and click the controls
5. Press Cmd + Shift + I again to return to click-through mode

Auto-Launch Setup (Optional)

To make the overlay automatically start when Deezer opens, create a Launch Agent:

1. Create the file ~/Library/LaunchAgents/com.deezer-overlay-watcher.plist:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>com.deezer-overlay-watcher</string>
    <key>ProgramArguments</key>
    <array>
        <string>/bin/bash</string>
        <string>-c</string>
        <string>
        while true; do
            if pgrep -x "Deezer" > /dev/null; then
                if ! pgrep -f "Deezer Overlay" > /dev/null; then
                    open -a "Deezer Overlay"
                fi
            fi
            sleep 5
        done
        </string>
    </array>
    <key>RunAtLoad</key>
    <true/>
    <key>KeepAlive</key>
    <true/>
</dict>
</plist>

2. Load it:

launchctl load ~/Library/LaunchAgents/com.deezer-overlay-watcher.plist

3. To disable:

launchctl unload ~/Library/LaunchAgents/com.deezer-overlay-watcher.plist

Requirements

• macOS 11.0 or later
• Deezer Desktop app
• Accessibility permission
• Homebrew (the app will automatically install nowplaying-cli on first launch if needed)

Limitations

• Only works with Deezer Desktop app (not the web version)
• Overlay may not appear over games running in exclusive fullscreen mode (rare on macOS)
• Works best with games in Windowed or Borderless Windowed mode

Building from Source

git clone https://github.com/Luluri/Overlay-Musique.git
cd Overlay-Musique
npm install
npm start        # Run in dev mode
npm run pack     # Build the app

The built app will be in dist/mac-arm64/Deezer Overlay.app