Skip to content

Hailey-Ross/hails.Webhook-Processor

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

33 Commits
 
 
 
 
 
 

Repository files navigation

🎶 hails.Webhook-Processor

Azuracast's built-in webhook integration is limited and lacks basic customization.
hails.Webhook-Processor acts as a translation layer, giving you full control over webhook messages sent to Discord.


✨ Features at a Glance

Feature Description
🎨 Customizable Webhook Full control over Discord message formatting.
🎤 Artist & DJ Detection Displays artist and/or DJ, defaults to Unknown Artist when needed.
👥 Live Listener Stats Shows unique & total listeners with a join link.
Dynamic Timezones Automatically adjusts for Daylight Savings.
🔒 Rate Limiting Protection Prevents excessive webhook requests.

🛑 Requirements

  • Webserver
  • Azuracast Station
  • Discord Server Webhook
  • Customization
    • very minor JSON/PHP knowledge

📥 Installation

1️⃣ Clone or Download the Repository

git clone https://github.com/Hailey-Ross/hails.Webhook-Processor.git
cd hails.Webhook-Processor

2️⃣ Configure the .env File

🔒 Keep this file private! Do not share it.

Create a .env file to store API keys and webhook settings.
This file should not be accessible to anyone on the web or in your webserver.

AZURACAST_WEBHOOK_KEY=your-secure-key
DISCORD_WEBHOOK_URL=https://discord.com/api/webhooks/your-webhook-url

3️⃣ Deploy & Connect to AzuraCast

🛑 DO NOT use the default your-secure-key value, if you have. Go back to the previous step. Seriously.

Upload AzuraCast_Webhook.php to your web server. Set AzuraCast's Webhook URL to:

https://yourdomain.com/AzuraCord.php?key=your-secure-key

🎨 Webhook Message Preview

🎵 Live DJ Mode
image

🎶 Auto-DJ Mode
image


💡 Want to tweak the format?

Check out AzuraCord.php for easy adjustments.
You could further customize:

Customization Type Examples
Webhook appearance color, fields, icons
Message structure song titles, artist info
Fallback Images Album Art, Footer, User Avatar
Embed styling verbage, formatting

❤️ Support & Contributions

Contributions, feedback, and feature requests are welcome!
Feel free to submit an issue or pull request.

About

AzuraCast to Discord Webhook Processor

Topics

Resources

Stars

Watchers

Forks

Languages