/python-tidal

Python API for TIDAL music streaming service

Primary LanguagePythonGNU Lesser General Public License v3.0LGPL-3.0

tidalapi

https://api.netlify.com/api/v1/badges/f05c0752-4565-4940-90df-d2b3fe91c84b/deploy-status

Unofficial Python API for TIDAL music streaming service.

Requires Python 3.7 or higher.

0.7.0 Rewrite

The 0.7.0 rewrite is now complete, see the migration guide for dealing with it

Installation

Install from PyPI using pip:

$ pip install tidalapi

Example usage

import tidalapi

session = tidalapi.Session()
# Will run until you visit the printed url and link your account
session.login_oauth_simple()
album = session.album(66236918)
tracks = album.tracks()
for track in tracks:
    print(track.name)
    for artist in track.artists:
        print(' by: ', artist.name)

Documentation

Documentation is available at https://tidalapi.netlify.app/

Development

This project uses poetry for dependency management and packaging. To install dependencies and setup the project for development, run:

$ pip install pipx
$ pipx install poetry
$ poetry install --no-root