rnd-song

    1.0.2 • Public • Published

    rnd-song

    A node module that returns a random song/album/artist via the Musixmatch API.

    Installation & Usage

    via Module:

    Installation:

    $ npm i rnd-song -S
    

    Usage:

    var rndSong = require('rnd-song');
     
    var options = {
      api_key: 's3EAqFptASYO7YR2lLItZfcfOj0VCpvt',
      genre: 14,
      snippet: true,
      language: 'en'
    };
     
    rndSong(options, function(err, res) {
      if (!err) {
        console.log(`Snippet: ${res.snippet.snippet_body}`);
        console.log(`Track: ${res.track.track_name}`);
        console.log(`Album: ${res.track.album_name}`);
        console.log(`Artist: ${res.track.artist_name}`);
      } else { console.log(new Error(err)); }
    });

    via Command Line Interface:

    Installation:

    $ npm i rnd-song -g

    Usage:

    export rndSong_api_key=s3EAqFptASYO7YR2lLItZfcfOj0VCpvt
    export rndSong_language=en
    $ rnd-song genre=14 snippet=true

    Options

    • api_key - Your Musixmatch API Key. (Required)
    • genre - The Musixmatch genre ID for the music genre that you would like your random song to be. (See genres.json for a list of genre IDs)
    • snippet - Set to true to have the output include a small snippet of lyrics.
    • language - The ISO 639-1 language code for the language that you would like your random song to be. (ie. en)

    Output

    Here is an example of what the response looks like:

    {
       track: {
          track_id: 15257385,
          track_mbid: 'fa515490-6b24-4e54-9387-aed958600304',
          track_isrc: '',
          track_spotify_id: '',
          track_soundcloud_id: '',
          track_xboxmusic_id: '',
          track_name: 'Take a Bow',
          track_name_translation_list: [],
          track_rating: 100,
          track_length: 229,
          commontrack_id: 7754494,
          instrumental: 0,
          explicit: 0,
          has_lyrics: 1,
          has_subtitles: 1,
          num_favourite: 13475,
          lyrics_id: 12080868,
          subtitle_id: 13355994,
          album_id: 13638599,
          album_name: 'Good Girl Gone Bad',
          artist_id: 150259,
          artist_mbid: '73e5e69d-3554-40d8-8516-00cb38737a1c',
          artist_name: 'Rihanna',
          album_coverart_100x100: 'http://s.mxmcdn.net/images-storage/albums/nocover.png',
          album_coverart_350x350: '',
          album_coverart_500x500: '',
          album_coverart_800x800: '',
          track_share_url: 'https://www.musixmatch.com/lyrics/Rihanna/Take-a-Bow',
          track_edit_url: 'https://www.musixmatch.com/lyrics/Rihanna/Take-a-Bow/edit?utm_source=application&utm_campaign=api&utm_medium=Kodie+Grantham',
          commontrack_vanity_id: 'Rihanna/Take-a-Bow',
          restricted: 0,
          first_release_date: '2007-06-05T00: 00: 00Z',
          updated_time: '2016-03-25T05: 45: 13Z',
          primary_genres: {
             music_genre_list: [
                {
                   "music_genre_id": 14,
                   "music_genre_parent_id": 34,
                   "music_genre_name": "Pop",
                   "music_genre_name_extended": "Pop",
                   "music_genre_vanity": "Pop"
                }
             ]
          },
          secondary_genres: {
             music_genre_list: []
          }
       },
       snippet: {
          snippet_id: 12080868,
          snippet_language: 'en',
          restricted: 0,
          instrumental: 0,
          snippet_body: 'But it\'s over now (but it\'s over now)',
          script_tracking_url: 'https://tracking.musixmatch.com/t1.0/m_js/e_0/sn_1/l_12080868/su_0/tr_VwPHgxSVfuIPJvwghgndMAbVlEgTMYDOJknA-zMFpPwbqm0z66GNIaXFcEz3QQPHzjuaECu6xhQ72jSi8xQj98kpU_6dvc_IoXs-T1kO-DfeFNHQUIuRDPQLNZ3A_mPuA6yNEvPbBTpu4nwnEF-d20v4IdOu9gTVuWZrU1ivZRVtZC0fubfXnP3G27k7tNLNE1FAOQWUxFsVWwcbqzkIqt24iuno_DYnM0Isl8hgl3NqGyBkAVPUkRoXYjT1ZGE3g3hME9iZAwyg4Cf2BOjeyzFzhExbYyMx_5fMfoGNa8W4GSFq8Wp_9Lfu0ZmYGXZ-MJbij0uhYO0ypjyDBQxR-EEEydMUg1BXGodOOLmnMppzjEizX_0G01AvyATZinLa/',
          pixel_tracking_url: 'https://tracking.musixmatch.com/t1.0/m_img/e_0/sn_1/l_12080868/su_0/tr_VwPHgxSVfuIPJvwghgndMAbVlEgTMYDOJknA-zMFpPwbqm0z66GNIaXFcEz3QQPHzjuaECu6xhQ72jSi8xQj98kpU_6dvc_IoXs-T1kO-DfeFNHQUIuRDPQLNZ3A_mPuA6yNEvPbBTpu4nwnEF-d20v4IdOu9gTVuWZrU1ivZRVtZC0fubfXnP3G27k7tNLNE1FAOQWUxFsVWwcbqzkIqt24iuno_DYnM0Isl8hgl3NqGyBkAVPUkRoXYjT1ZGE3g3hME9iZAwyg4Cf2BOjeyzFzhExbYyMx_5fMfoGNa8W4GSFq8Wp_9Lfu0ZmYGXZ-MJbij0uhYO0ypjyDBQxR-EEEydMUg1BXGodOOLmnMppzjEizX_0G01AvyATZinLa/',
          html_tracking_url: 'https://tracking.musixmatch.com/t1.0/m_html/e_0/sn_1/l_12080868/su_0/tr_VwPHgxSVfuIPJvwghgndMAbVlEgTMYDOJknA-zMFpPwbqm0z66GNIaXFcEz3QQPHzjuaECu6xhQ72jSi8xQj98kpU_6dvc_IoXs-T1kO-DfeFNHQUIuRDPQLNZ3A_mPuA6yNEvPbBTpu4nwnEF-d20v4IdOu9gTVuWZrU1ivZRVtZC0fubfXnP3G27k7tNLNE1FAOQWUxFsVWwcbqzkIqt24iuno_DYnM0Isl8hgl3NqGyBkAVPUkRoXYjT1ZGE3g3hME9iZAwyg4Cf2BOjeyzFzhExbYyMx_5fMfoGNa8W4GSFq8Wp_9Lfu0ZmYGXZ-MJbij0uhYO0ypjyDBQxR-EEEydMUg1BXGodOOLmnMppzjEizX_0G01AvyATZinLa/',
          updated_time: '2015-09-04T19: 49: 23Z'
       }
    }

    License

    MIT. See the License file for more info.

    Install

    npm i rnd-song

    DownloadsWeekly Downloads

    3

    Version

    1.0.2

    License

    MIT

    Last publish

    Collaborators

    • kodie