Post Now Playing to Discord with Webhooks

Introduction

Want your Discord community to see what you're playing in real-time? Song Overlays Pro can automatically post song updates to any Discord channel using webhooks — no bot required, no coding needed.

What you'll achieve:

• Automatic song posts to your Discord channel
• Album artwork displayed in embeds
• Apple Music links for listeners to find the track
• Customizable message format
• Works with any Discord server you can manage

Prerequisites

Before starting, make sure you have:

• macOS 13.0 (Ventura) or later
• Song Overlays Pro installed from the Mac App Store
• Discord account with a server you manage (or webhook permissions)
• Manage Webhooks permission in the target channel

How Discord Webhooks Work

Webhooks are a simple way to send automated messages to Discord without creating a full bot. You create a webhook URL for a channel, and any application can post messages to that URL.

Song Overlays Pro uses this to send rich embed messages whenever a new song is detected, including:

• Song title and artist
• Album name
• Album artwork (as embed image)
• Apple Music link
• Timestamp

Step 1: Create a Discord Webhook

First, create a webhook in your Discord server.

1. Open Discord and go to your server
2. Right-click the channel where you want song updates
3. Click Edit Channel (or the gear icon)
4. In the left sidebar, click Integrations
5. Click Webhooks
6. Click New Webhook

Step 2: Configure the Webhook

Set up how the webhook will appear in your channel.

1. Name — Give it a descriptive name like "Now Playing" or "Music Bot"
2. Avatar — Upload an icon (optional, but looks professional)
3. Channel — Confirm it's posting to the correct channel
4. Click Copy Webhook URL — you'll need this next
5. Click Save Changes

Security Note: Keep your webhook URL private. Anyone with this URL can post to your channel.

Step 3: Add the Webhook to Song Overlays Pro

Now connect Song Overlays Pro to your Discord webhook.

1. Open Song Overlays Pro
2. Click Discord in the sidebar
3. Paste your webhook URL in the Webhook URL field
4. Toggle Enable Discord Integration to on
5. Click Test to send a test message

If successful, you'll see a test message appear in your Discord channel.

Step 4: Customize Your Messages

Personalize how song updates appear in Discord.

Message Template

Customize the message format using these placeholders:

Placeholder	Description
{title}	Song title
{artist}	Artist name
{album}	Album name
{artwork}	Album artwork URL
{appleMusicUrl}	Link to Apple Music
{isrc}	International Standard Recording Code

Example Templates

Simple:

Now Playing: {title} by {artist}

Detailed:

🎵 **{title}**
Artist: {artist}
Album: {album}

With Link:

Now spinning: **{title}** by {artist}
Listen on Apple Music: {appleMusicUrl}

Embed Settings

Configure the rich embed appearance:

• Embed Color — Match your brand or server theme
• Include Artwork — Show album art as embed image
• Include Apple Music Link — Add clickable link to track
• Footer Text — Add custom footer (e.g., "Powered by Song Overlays Pro")

Step 5: Test Your Setup

Verify everything works before going live.

1. Ensure song detection is running (Server tab → Start)
2. Play a song on your Mac
3. Watch your Discord channel for the post
4. Check that all information displays correctly

Troubleshooting test failures:

• Verify the webhook URL is correct (no extra spaces)
• Check that the webhook still exists in Discord
• Ensure Song Overlays Pro has internet access
• Confirm song detection is working (check the main display)

Step 6: Configure Posting Frequency

Control how often songs are posted to avoid spam.

Options

• Every song — Post every detected song (can be chatty)
• Minimum interval — Wait X seconds between posts
• Manual only — Only post when you click a button
• On song request played — Only post when playing requested songs

Recommendations by Use Case

Live DJ Sets:

• Post every song for engaged audiences
• Use minimum 30-second interval to avoid spam during quick transitions

Background Music:

• Use 2-3 minute minimum interval
• Keeps channel active without overwhelming

Streaming:

• Post every song so viewers can identify tracks
• Include Apple Music links for discovery

Advanced Configuration

Multiple Webhooks

Send to multiple Discord channels or servers:

1. Create webhooks in each target channel
2. In Song Overlays Pro, click Add Webhook
3. Paste additional webhook URLs
4. Each webhook can have different settings

Conditional Posting

Control when posts happen:

• Only when streaming — Detect OBS/streaming software
• Scheduled hours — Only post during certain times
• Genre filtering — Post only certain types of music

Rate Limiting

Discord has rate limits on webhooks. Song Overlays Pro handles this automatically:

• Queues messages if rate limited
• Retries failed posts
• Warns you if limits are frequently hit

Use Cases

For Streamers

Keep your Discord community engaged while you stream:

• Post what's playing during stream
• Viewers can discuss music in channel
• Build a community music taste profile

For DJs

Let fans follow your sets remotely:

• Post your live set to a dedicated channel
• Fans can tune in on Apple Music
• Create a record of past sets

For Music Communities

Share discoveries with your server:

• Dedicated "now-playing" channel
• Members see each other's music taste
• Spark conversations about songs

For Venues/Bars

Digital signage integration:

• Post to a channel that displays on screens
• Show customers what's playing
• Integrate with other venue systems

Troubleshooting

Messages Not Posting

1. Check webhook URL — Ensure it's copied correctly
2. Verify Discord integration is enabled — Check the toggle
3. Test the webhook — Use the Test button
4. Check song detection — Ensure songs are being detected

Delayed Posts

1. Check your posting frequency settings
2. Verify internet connection is stable
3. Discord may be experiencing issues — check status.discord.com

Webhook Deleted

If you delete the webhook in Discord:

1. The URL becomes invalid
2. Song Overlays Pro will show errors
3. Create a new webhook and update the URL

Wrong Channel

1. Edit the webhook in Discord
2. Change the channel in webhook settings
3. Or create a new webhook in the correct channel

Rate Limited

If you're hitting rate limits:

1. Increase the minimum interval between posts
2. Reduce the number of webhooks
3. Consider posting only key moments

Privacy Considerations

What's Shared

When you enable Discord integration, these are sent to Discord:

• Song title, artist, album
• Album artwork URL (from Apple Music CDN)
• Apple Music link
• Timestamp

What's Not Shared

• Your listening history (beyond real-time posts)
• Personal information
• App settings or configuration

Channel Visibility

Remember that anyone with access to the Discord channel can see posts. Choose your channel's visibility accordingly:

• Public channels — Anyone on the server sees updates
• Private channels — Only members with access
• Role-restricted — Only certain roles can view

Next Steps

Your Discord is now connected. Explore these related features:

Display in OBS

Add a visual overlay to your stream showing what's playing.

Set up OBS overlays

Accept Song Requests

Let your Discord community request songs via QR code.

Set up Song Requests

Join the Community

Connect with other users for tips and support.

Join Discord

---

You're connected! Your Discord community will now see what you're playing in real-time. Whether you're streaming, DJing, or just sharing music with friends, Discord integration keeps everyone in the loop.