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.1.tar.gz (10.1 kB view details)

Uploaded Source

Built Distribution

musicapy-2.2.1-py3-none-any.whl (11.1 kB view details)

Uploaded Python 3

File details

Details for the file musicapy-2.2.1.tar.gz.

File metadata

  • Download URL: musicapy-2.2.1.tar.gz
  • Upload date:
  • Size: 10.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.3.2 CPython/3.10.8 Windows/10

File hashes

Hashes for musicapy-2.2.1.tar.gz
Algorithm Hash digest
SHA256 e082160b098531f3a7afb4af970344d349a0d5424dd9c5b22e4efcabe53d5961
MD5 fd9af2fc82e5fe513e0f38032b419a89
BLAKE2b-256 cee2f59e11dcef06062b3bcb2d55b7e504516a1fa1b56e600b1ad5674ad781d6

See more details on using hashes here.

File details

Details for the file musicapy-2.2.1-py3-none-any.whl.

File metadata

  • Download URL: musicapy-2.2.1-py3-none-any.whl
  • Upload date:
  • Size: 11.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.3.2 CPython/3.10.8 Windows/10

File hashes

Hashes for musicapy-2.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 319738b52c1788abf73ee423cd7bada9d6c82753c4c3e1e7f713719e58b5f0d8
MD5 8b92ee08d1cc13bddb958fe0c5eaee17
BLAKE2b-256 a0a71f6f147bef5aba7f3e87b3c66a4d736fb48d3c1826e7ab9d3873f90101f5

See more details on using hashes here.

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