Skip to main content

Python wrapper for several music platforms API

Project description

MusicAPy

Music API Python wrapper, currently supports limited API.

  • Supported API
    • JioSaavn

Docs Deployment Status

Deploy Docs

Installation

  • Using pip and git

    python3 -m pip install git+https://github.com/dmdhrumilmistry/MusicAPy
    
  • Using pypi

    python3 -m pip install MusicAPy
    

Usage

  • Jio Saavn API

    • From Script

      from musicapy.saavn_api.api import SaavnAPI
      
      # create API obj
      api = SaavnAPI()
      
      
      ## Search Services
      # Search Song
      data = api.search_song('song_name')
      
      # Search Album
      data = api.search_album('album_name')
      
      # Search All
      data = api.search_all('song_or_album_name')
      
      ## Song Services
      # get song link
      saavn_song_link = 'https://www.jiosaavn.com/song/song_name/id'
      
      # create identifier
      identifier = api.create_identifier(link, 'song')
      
      # get trending songs
      trending_songs = api.get_trending()
      
      # get latest charts
      charts = api.get_charts()
      
      # get song link from identifier
      song_link = api.get_song_link(identifier)
      
      # get song details
      details = api.get_song_details(identifier)
      
      # get song lyrics
      lyrics = api.get_song_lyrics(identifier)
      
      # get download links
      download_links = api.generate_song_download_links(identifier)
      
      ## Albums Service
      # get song details
      album_details = api.get_album_details(identifier)
      
      # get album songs download links
      data = api.generate_album_download_links(identifier) 
      
      ## Playlist Service
      # with featured playlist link
      id = api.create_identifier('https://www.jiosaavn.com/featured/arijits-sad-songs/8RkefqkCO1huOxiEGmm6lQ__', None)
      
      # with playlist link
      id = api.create_identifier('https://www.jiosaavn.com/s/playlist/a60306bf0bd5cacc95a888a361163e07/Ppll/Iz0pi7nkjUHfemJ68FuXsA__', 'playlist')
      
      # with playlist/list id
      id = api.create_identifier(802336660, 'playlist')
      
      # fetch playlist details
      playlist_details = api.get_playlist_details(id)
      
      # fetch Playlist song details with download links
      playlist_songs_details = api.get_playlist_song_download_links(id)
      
    • From Command Line

      python3 -m musicapy.saavn_api -h
      

      Command Line Output

      usage: __main__.py [-h] [-t] [-c] [-d] [-l LINK] [-aD] [-a] [-sS SEARCH_SONG_QUERY] [-sA SEARCH_ALBUM_QUERY] [-sa SEARCH_ALL_QUERY]
      
      options:
        -h, --help            show this help message and exit
        -t, --trending        get trending songs
        -c, --charts          get charts
        -d, --download        generate download links
        -l LINK, --link LINK  link of song or album
        -aD, --album-details  get album details from link
        -a, --album           get album download links
        -sS SEARCH_SONG_QUERY, --search-song SEARCH_SONG_QUERY
                              search song by name
        -sA SEARCH_ALBUM_QUERY, --search-album SEARCH_ALBUM_QUERY
                              search album by name
        -sa SEARCH_ALL_QUERY, --search-all SEARCH_ALL_QUERY
                          search album or song by name
      

License

MIT License

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

musicapy-2.2.0.tar.gz (10.0 kB view hashes)

Uploaded Source

Built Distribution

musicapy-2.2.0-py3-none-any.whl (11.1 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page