Skip to main content

A simple package for retrieving music information from various music platforms APIs.

Project description

yutipy

GitHub Actions Workflow Status PyPI Documentation Status License Stars Issues

A simple Python package for searching and retrieving music information from various music platforms APIs, including Deezer, iTunes, Spotify, and YouTube Music.

Table of Contents

Features

  • Simple & Easy integration with popular music APIs.
  • Search for music by artist and song title across multiple platforms.
  • It uses RapidFuzz to compare & return the best match so that you can be sure you got what you asked for without having to worry and doing all that work by yourself.
  • Retrieve detailed music information, including album art, release dates, lyrics, ISRC, and UPC codes.

Available Music Platforms

Right now, the following music platforms are available in yutipy for searching music. New platforms will be added in the future. Feel free to request any music platform you would like me to add by opening an issue on GitHub or by emailing me.

Installation

You can install the package using pip. Make sure you have Python 3.8 or higher installed.

pip install -U yutipy

Usage Example

Here's a quick example of how to use the yutipy package to search for a song:

Deezer

from yutipy.deezer import Deezer

with Deezer() as deezer:
    result = deezer.search("Artist Name", "Song Title")
    print(result)

For more usage examples, see the Usage Examples page in docs.

Contributing

Contributions are welcome! Please follow these steps:

  1. Fork the repository.
  2. Optionally, create an issue to discuss the changes you plan to make.
  3. Create a new branch linked to that issue.
  4. Make your changes in the new branch.
  5. Write tests if you add new functionality.
  6. Ensure all tests pass before opening a pull request.
  7. Open a pull request for review.

Thank you for your contributions!

License

This project is licensed under the MIT License. See the LICENSE file for details.

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

yutipy-1.3.0.tar.gz (88.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

yutipy-1.3.0-py3-none-any.whl (20.8 kB view details)

Uploaded Python 3

File details

Details for the file yutipy-1.3.0.tar.gz.

File metadata

  • Download URL: yutipy-1.3.0.tar.gz
  • Upload date:
  • Size: 88.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for yutipy-1.3.0.tar.gz
Algorithm Hash digest
SHA256 39d1efb8c72b14d66ca1ebf60d5ac270e0251c20e6a9db7e961311f50abcad09
MD5 6b91ebbf0dbd9df89cecf3f93d065e07
BLAKE2b-256 9b9e9fd3f16b7be421aa2790689e3f5a315968666b25bc45fd8f36f22ae1eb81

See more details on using hashes here.

Provenance

The following attestation bundles were made for yutipy-1.3.0.tar.gz:

Publisher: release.yml on CheapNightbot/yutipy

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file yutipy-1.3.0-py3-none-any.whl.

File metadata

  • Download URL: yutipy-1.3.0-py3-none-any.whl
  • Upload date:
  • Size: 20.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for yutipy-1.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 d3d4d1276fa292e44c05d5c8b12b9428e529d18b43bdd12be7d16eb888d7aebc
MD5 b12d15f9ea5a580414b4932c6d0c4bda
BLAKE2b-256 afd1cbe73e8ad296366b056b9b057ecc55f7154b1574e49d5fd1529293e1a994

See more details on using hashes here.

Provenance

The following attestation bundles were made for yutipy-1.3.0-py3-none-any.whl:

Publisher: release.yml on CheapNightbot/yutipy

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

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