https://github.com/bst27/shazam-webhook
Webhook notifications when shazam.com charts are updated.
https://github.com/bst27/shazam-webhook
go golang ifttt monitor shazam shazam-charts shazam-webhook spotify tracklist webhook webhooks zapier
Last synced: 10 months ago
JSON representation
Webhook notifications when shazam.com charts are updated.
- Host: GitHub
- URL: https://github.com/bst27/shazam-webhook
- Owner: bst27
- License: mit
- Created: 2020-05-27T12:59:14.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2020-08-16T18:23:27.000Z (almost 6 years ago)
- Last Synced: 2025-08-12T08:50:35.120Z (10 months ago)
- Topics: go, golang, ifttt, monitor, shazam, shazam-charts, shazam-webhook, spotify, tracklist, webhook, webhooks, zapier
- Language: Go
- Homepage:
- Size: 527 KB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
shazam-webhook
======
This application allows to monitor Shazam charts available at shazam.com and
sending webhooks holding artist and title when new tracks are added. E.g. if
you want to **add Shazam charts to a Spotify playlist** you can do this using
this application and a 3rd party service to receive webhooks like
[IFTTT](https://ifttt.com/) or [Zapier](https://zapier.com/).
# Usage
At first you have to customize the **app-config.json**: Add some Shazam charts
you want to monitor. Also add tracklists to receive tracks from monitored
Shazam charts and define some webhooks.
Below is an example configuration. By disabling initial hooks no webhooks
are triggered when tracks are added to a tracklist during the first iteration. The polling
interval is set to fetch Shazam charts every 10800 seconds (= 3 hours). Two
Shazam charts are defined to be monitored: Berlin (81310) and Paris (80321).
A single tracklist is defined. By watching two charts the tracks of both
Shazam charts will be added to the tracklist. When a track is added the defined webhook
will receive artist and title as a POST request.
```
{
"SendInitialHooks": false,
"PollingInterval": 10800,
"MonitoredShazamCharts": [
"81310",
"80321"
],
"Tracklists": [
{
"WatchedShazamCharts": [
"81310",
"80321"
],
"WebhookTargets": [
{
"URL": "http://localhost:8080/72A4E"
}
]
}
]
}
```
You can find a list of available Shazam city IDs to be monitored at [bst27/shazam](https://github.com/bst27/shazam/blob/24cdf23c38ce845e2b0333368bba697888bb0412/cities.go).
After customizing the configuration you can build and run the application:
```
go build; ./shazam-webhook
```
# TODO
This section holds some ideas:
## Config file path
Allow to set path to config file via command line argument.
## Config Creator
Create a command line tool to generate an **app-config.json** file. This file will hold the app configuration.
## Tests
As always there could be more tests.