# shazam.js Single-file Node.js ESM — recognize lagu via Shazam. **Requirement:** `ffmpeg` di PATH (tanpa npm package). ```bash node shazam.js lagu.mp3 node shazam.js "https://example.com/audio.m4a" --offset 30 ``` ## Opsi | Flag | Default | Keterangan | |------|---------|------------| | `-o, --offset` | `0` | detik mulai | | `-d, --duration` | `12` | panjang window | | `-c, --country` | `US` | country code | ## Example output ```json { "is_matched": true, "source": "musik.mp3", "audio": { "duration_seconds": 227.24 }, "attempts": [ { "offset_seconds": 107.62, "duration_seconds": 12, "is_matched": true } ], "matches": [ { "id": "886055934", "offset": 93.26059375, "timeskew": -0.000024139881, "frequencyskew": -0.00016111135 } ], "track": { "layout": "5", "type": "MUSIC", "key": "886055934", "title": "Teh Hijau", "subtitle": "Tulus", "images": { "background": "https://is1-ssl.mzstatic.com/image/thumb/AMCArtistImages211/v4/4a/eb/9f/4aeb9fff-c06d-f16c-957c-a208b940e385/file_cropped.png/800x800cc.jpg", "coverart": "https://is1-ssl.mzstatic.com/image/thumb/Music221/v4/bb/12/3e/bb123e64-7747-78f3-ce81-8b04bfe30e73/cover.jpg/400x400cc.jpg", "coverarthq": "https://is1-ssl.mzstatic.com/image/thumb/Music221/v4/bb/12/3e/bb123e64-7747-78f3-ce81-8b04bfe30e73/cover.jpg/400x400cc.jpg", "joecolor": "b:a6a953p:010100s:060702t:21230dq:282a11" }, "display": { "actions": [ { "name": "display:updateshazam", "type": "webview", "uri": "https://www.shazam.com/inapp/updatenow/886055934" } ] }, "share": { "subject": "Teh Hijau - Tulus", "text": "Teh Hijau by Tulus", "href": "https://www.shazam.com/track/886055934/teh-hijau", "image": "https://is1-ssl.mzstatic.com/image/thumb/Music221/v4/bb/12/3e/bb123e64-7747-78f3-ce81-8b04bfe30e73/cover.jpg/400x400cc.jpg", "twitter": "I used @Shazam to discover Teh Hijau by Tulus.", "html": "https://www.shazam.com/snippets/email-share/886055934?lang=en&country=US", "avatar": "https://is1-ssl.mzstatic.com/image/thumb/AMCArtistImages211/v4/4a/eb/9f/4aeb9fff-c06d-f16c-957c-a208b940e385/file_cropped.png/800x800cc.jpg", "snapchat": "https://www.shazam.com/partner/sc/track/886055934" }, "hub": { "type": "APPLEMUSIC", "image": "https://images.shazam.com/static/icons/hub/ios/v5/applemusic_{scalefactor}.png", "actions": [ { "name": "apple", "type": "applemusicplay", "id": "6784585105" }, { "name": "apple", "type": "uri", "uri": "https://audio-ssl.itunes.apple.com/itunes-assets/AudioPreview211/v4/88/fe/74/88fe7468-da1c-ad60-2080-f88563e38040/mzaf_3893396008702662653.plus.aac.ep.m4a" } ], "providers": [ { "caption": "Open in Spotify", "images": { "overflow": "https://images.shazam.com/static/icons/hub/ios/v5/spotify-overflow_{scalefactor}.png", "default": "https://images.shazam.com/static/icons/hub/ios/v5/spotify_{scalefactor}.png" }, "actions": [ { "name": "hub:spotify:searchdeeplink", "type": "uri", "uri": "spotify:search:Teh%20Hijau%20Tulus" } ], "type": "SPOTIFY" }, { "caption": "Open in Deezer", "images": { "overflow": "https://images.shazam.com/static/icons/hub/ios/v5/deezer-overflow_{scalefactor}.png", "default": "https://images.shazam.com/static/icons/hub/ios/v5/deezer_{scalefactor}.png" }, "actions": [ { "name": "hub:deezer:searchdeeplink", "type": "uri", "uri": "deezer-query://www.deezer.com/play?query=%7Btrack%3A%27Teh+Hijau%27%20artist%3A%27Tulus%27%7D" } ], "type": "DEEZER" } ], "explicit": false, "displayname": "APPLE MUSIC", "options": [ { "caption": "OPEN", "actions": [ { "name": "hub:applemusic:deeplink", "type": "applemusicopen", "uri": "https://music.apple.com/us/album/teh-hijau/6784585100?i=6784585105&mttnagencyid=s2n&mttnsiteid=125115&mttn3pid=Apple-Shazam&mttnsub1=Shazam_ios&mttnsub2=5348615A-616D-3235-3830-44754D6D5973&itscg=30201&app=music&itsct=Shazam_ios" }, { "name": "hub:applemusic:deeplink", "type": "uri", "uri": "https://music.apple.com/us/album/teh-hijau/6784585100?i=6784585105&mttnagencyid=s2n&mttnsiteid=125115&mttn3pid=Apple-Shazam&mttnsub1=Shazam_ios&mttnsub2=5348615A-616D-3235-3830-44754D6D5973&itscg=30201&app=music&itsct=Shazam_ios" } ], "beacondata": { "type": "open", "providername": "applemusic" }, "image": "https://images.shazam.com/static/icons/hub/ios/v5/overflow-open-option_{scalefactor}.png", "type": "open", "listcaption": "Open in Apple Music", "overflowimage": "https://images.shazam.com/static/icons/hub/ios/v5/applemusic-overflow_{scalefactor}.png", "colouroverflowimage": false, "providername": "applemusic" }, { "caption": "BUY", "actions": [ { "type": "uri", "uri": "https://itunes.apple.com/us/album/teh-hijau/6784585100?i=6784585105&mttnagencyid=s2n&mttnsiteid=125115&mttn3pid=Apple-Shazam&mttnsub1=Shazam_ios&mttnsub2=5348615A-616D-3235-3830-44754D6D5973&itscg=30201&app=itunes&itsct=Shazam_ios" } ], "beacondata": { "type": "buy", "providername": "itunes" }, "image": "https://images.shazam.com/static/icons/hub/ios/v5/itunes-overflow-buy_{scalefactor}.png", "type": "buy", "listcaption": "Buy on iTunes", "overflowimage": "https://images.shazam.com/static/icons/hub/ios/v5/itunes-overflow-buy_{scalefactor}.png", "colouroverflowimage": false, "providername": "itunes" } ] }, "sections": [ { "type": "SONG", "metapages": [ { "image": "https://is1-ssl.mzstatic.com/image/thumb/AMCArtistImages211/v4/4a/eb/9f/4aeb9fff-c06d-f16c-957c-a208b940e385/file_cropped.png/800x800cc.jpg", "caption": "Tulus" }, { "image": "https://is1-ssl.mzstatic.com/image/thumb/Music221/v4/bb/12/3e/bb123e64-7747-78f3-ce81-8b04bfe30e73/cover.jpg/400x400cc.jpg", "caption": "Teh Hijau" } ], "tabname": "Song", "metadata": [ { "title": "Album", "text": "Teh Hijau - Single" }, { "title": "Label", "text": "TulusCompany" }, { "title": "Released", "text": "2026" } ] }, { "type": "RELATED", "url": "https://cdn.shazam.com/shazam/v3/en/US/iphone/-/tracks/track-similarities-id-886055934?startFrom=0&pageSize=20&connected=", "tabname": "Related" } ], "url": "https://www.shazam.com/track/886055934/teh-hijau", "artists": [ { "id": "42", "adamid": "1001681665" } ], "genres": { "primary": "Pop" }, "urlparams": { "{tracktitle}": "Teh+Hijau", "{trackartist}": "Tulus" }, "myshazam": { "apple": { "actions": [ { "name": "myshazam:apple", "type": "uri", "uri": "https://music.apple.com/us/album/teh-hijau/6784585100?i=6784585105&mttnagencyid=s2n&mttnsiteid=125115&mttn3pid=Apple-Shazam&mttnsub1=Shazam_ios&mttnsub2=5348615A-616D-3235-3830-44754D6D5973&itscg=30201&app=music&itsct=Shazam_ios" } ] } }, "highlightsurls": {}, "relatedtracksurl": "https://cdn.shazam.com/shazam/v3/en/US/iphone/-/tracks/track-similarities-id-886055934?startFrom=0&pageSize=20&connected=", "albumadamid": "6784585100", "isrc": "FRX282637095" }, "summary": { "title": "Teh Hijau", "artist": "Tulus", "key": "886055934", "isrc": "FRX282637095", "genre": "Pop", "cover": "https://is1-ssl.mzstatic.com/image/thumb/Music221/v4/bb/12/3e/bb123e64-7747-78f3-ce81-8b04bfe30e73/cover.jpg/400x400cc.jpg", "apple_music": "https://music.apple.com/us/album/teh-hijau/6784585100?i=6784585105&mttnagencyid=s2n&mttnsiteid=125115&mttn3pid=Apple-Shazam&mttnsub1=Shazam_ios&mttnsub2=5348615A-616D-3235-3830-44754D6D5973&itscg=30201&app=music&itsct=Shazam_ios", "preview": null } } ``` ## Library ```js import { recognize } from './shazam.js'; const r = await recognize('./song.mp3'); console.log(r.summary); ```