1.1.3 • Published 3 years ago

hunter.fm v1.1.3

Weekly downloads
-
License
MIT
Repository
github
Last release
3 years ago

An unofficial wrapper for the official Hunter.FM API, dependency-free.

Installation

Node.js 14.0.0 or newer is required.

npm install hunter.fm
yarn add hunter.fm
pnpm add hunter.fm

Example Usage

const getRadioStations = require('hunter.fm');

getRadioStations()
  .then(stations => {
    console.log(stations);
  })
  .catch(console.error);

Try it yourself

Handling the return

The function getRadioStations returns an array of radio stations, each having the following structure:

PropertyTypeDescriptionExample
idStringRadio station's IDlofi
hashStringRadio station's Hashjic321Sd-de2s3d7s-S12e24s1daw2
nameStringRadio station's nameO Canal Lofi
descriptionStringRadio station's descriptionPerfeita para te auxiliar a manter o foco em casa ou no trabalho. Para relaxar enquanto se lê um livro ou espera o sono chegar.
logoStringRadio station's logohttps://cdn.hunter.fm/image/station/lo-fi.png
thumbnailObjectRadio station's thumbnail
thumbnail#lowQualityStringRadio station's low quality thumbnailhttps://cdn.hunter.fm/image/thumb/station/lo-fi-second/50x50ht.jpg
thumbnail#mediumQualityStringRadio station's medium quality thumbnailhttps://cdn.hunter.fm/image/thumb/station/lo-fi-second/100x100ht.jpg
thumbnail#highQualityStringRadio station's high quality thumbnailhttps://cdn.hunter.fm/image/thumb/station/lo-fi-second/200x200ht.jpg
thumbnail#highestQualityStringRadio station's highest quality thumbnailhttps://cdn.hunter.fm/image/thumb/station/lo-fi-second/1000x1000ht.jpg
paletteString[]Radio station's color palette "#FF3B27", "#04BAFB"
streamsObjectRadio station's streams
streams#lowQualityStringRadio station's low quality streamhttps://live.hunter.fm/lofi_low
streams#mediumQualityStringRadio station's medium quality streamhttps://live.hunter.fm/lofi_normal
streams#highQualityStringRadio station's high quality streamhttps://live.hunter.fm/lofi_high
streamsHLSObjectRadio station's HLS streams
streams#lowQualityStringRadio station's low quality HLS stream filehttps://hls.hunter.fm/lofi/32.m3u8
streams#mediumQualityStringRadio station's medium quality HLS stream filehttps://hls.hunter.fm/lofi/64.m3u8
streams#highQualityStringRadio station's high quality HLS stream filehttps://hls.hunter.fm/lofi/192.m3u8
genresString[]Radio station's music genres "Hip Hop", "Lofi", "Relax"
previousSongObjectRadio station's previous song
previousSong#nameStringSong's nameComfort
previousSong#thumbnailObjectSong's thumbnail
previousSong#thumbnail#lowQualityStringSong's low quality thumbnailhttps://cdn.hunter.fm//image/thumb/music/p4irjjm9jzyp7972xtme4mzgnhwp9m/100x100ht.jpg
previousSong#thumbnail#mediumQualityStringSong's medium quality thumbnailhttps://cdn.hunter.fm//image/thumb/music/p4irjjm9jzyp7972xtme4mzgnhwp9m/300x300ht.jpg
previousSong#thumbnail#highQualityStringSong's high quality thumbnailhttps://cdn.hunter.fm//image/thumb/music/p4irjjm9jzyp7972xtme4mzgnhwp9m/1000x1000ht.jpg
previousSong#singersString[]Song's singers "Pandrezz"
previousSong#featsString[] or nullSong's featsnull
previousSong#durationNumberSong's duration in milliseconds128000
currentSongObjectRadio station's current song
currentSong#nameStringSong's nameConey Island
currentSong#thumbnailObjectSong's thumbnail
currentSong#thumbnail#lowQualityStringSong's low quality thumbnailhttps://cdn.hunter.fm//image/thumb/music/60o79xd4jzyhad283dcnkjg431epyh/100x100ht.jpg
currentSong#thumbnail#mediumQualityStringSong's medium quality thumbnailhttps://cdn.hunter.fm//image/thumb/music/60o79xd4jzyhad283dcnkjg431epyh/300x300ht.jpg
currentSong#thumbnail#highQualityStringSong's high quality thumbnailhttps://cdn.hunter.fm//image/thumb/music/60o79xd4jzyhad283dcnkjg431epyh/1000x1000ht.jpg
currentSong#singersString[]Song's singers "Frook"
currentSong#featsString[] or nullSong's featsnull
currentSong#durationNumberSong's duration in milliseconds109000
currentSong#startedAtDateSong's start date timestamp2021-09-14T17:01:49.334Z
currentSong#endsAtDateSong's end date timestamp2021-09-14T17:04:07.334Z
nextSongObjectRadio station's next song
nextSong#nameStringSong's nameYour Favorite Place
nextSong#thumbnailObjectSong's thumbnail
nextSong#thumbnail#lowQualityStringSong's low quality thumbnailhttps://cdn.hunter.fm//image/thumb/music/uq5kif7ajzymmzvxjfrnes4o8agzyv/100x100ht.jpg
nextSong#thumbnail#mediumQualityStringSong's medium quality thumbnailhttps://cdn.hunter.fm//image/thumb/music/uq5kif7ajzymmzvxjfrnes4o8agzyv/300x300ht.jpg
nextSong#thumbnail#highQualityStringSong's high quality thumbnailhttps://cdn.hunter.fm//image/thumb/music/uq5kif7ajzymmzvxjfrnes4o8agzyv/1000x1000ht.jpg
nextSong#singersString[]Song's singers "Joey Pecoraro"
nextSong#featsString[] or nullSong's featsnull

Contributing

Before creating an issue, please ensure that it hasn't already been reported or suggested.

When submitting a new pull request, please make sure the code style/format used is the same as the one used in the original code.

License

Refer to the LICENSE file.

1.1.1

3 years ago

1.1.3

3 years ago

1.1.2

3 years ago

1.1.0

3 years ago

1.0.4

3 years ago

1.0.3

3 years ago

1.0.2

3 years ago

1.0.1

3 years ago