Looking for an easy-to-use API or GUI to search for music, instead of using the CLI or building your own integration? Check out yutify — it’s powered by yutipy!
A simple Python package to interact with various music platforms APIs.
Table of Contents
Features
- Simple & Easy integration with popular music APIs.
- Search for music by artist and song title across multiple platforms.
- Async support for Deezer, iTunes, KKBOX, Spotify, and YouTube Music.
- Authorize and access user resources easily.
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.
Deezer: https://www.deezer.comiTunes: https://music.apple.comKKBOX: https://www.kkbox.comLastfm: https://last.fmSpotify: https://spotify.comYouTube Music: https://music.youtube.com
Installation
You can install the package using pip. Make sure you have Python 3.10 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 on Deezer:
from yutipy.deezer import Deezer
with Deezer() as deezer:
result = deezer.search("Artist Name", "Song Title")
print(result)
For asynchronous usage, you can use the matching async service class from the yutipy.async_* modules. For example:
import asyncio
from yutipy.async_deezer import AsyncDeezer
async def main():
async with AsyncDeezer() as deezer:
result = await deezer.search("Artist Name", "Song Title")
print(result)
asyncio.run(main())
For more usage examples, see the Usage Examples page in docs.
Command-Line Interface (CLI)
The yutipy package includes a CLI tool that allows you to search for music directly from the command line and configure API keys interactively.
Search for Music
You can use the CLI tool to search for music across multiple platforms:
yutipy-cli --artist "Rick Astley" --song "Never Gonna Give You Up" --service spotify
Options:
artist(required): The name of the artist.song(required): The title of the song.--service(required): Specify a single service to search (e.g.,deezer,spotify,itunes).--limit: The number of results to retrieve (default: 5).--verbose: Enable logging in the terminal.--version: Show installed yutipy version and exit.
Configuration Wizard
To set up your API keys interactively, use the configuration wizard:
yutipy-config
The wizard will guide you through obtaining and setting up API keys for supported services like Spotify and KKBOX. If the required environment variables are already set, the wizard will skip those steps.
Contributing
Contributions are welcome! Please follow these steps:
- Fork the repository.
- Optionally, create an issue to discuss the changes you plan to make.
- Create a new branch linked to that issue.
- Make your changes in the new branch.
- Write tests if you add new functionality.
- Ensure all tests pass before opening a pull request.
- 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.
1 maintainer
Metadata
1 maintainer
Release files for yutipy 5.4.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| yutipy-5.4.0.tar.gz | 113.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| yutipy-5.4.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 157.5 kB
Release files / yutipy-5.4.0.tar.gz
| Download URL | yutipy-5.4.0.tar.gz |
|---|---|
| Size | 113.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
fad14a96accaa65391bf3e7ee61d16e8b600cf9cc426c8cfb0c92d64b6af06b9
|
|
BLAKE2b-256 checksum How to use checksums |
bd043c2200ec773497b101a80289f108b33524d6d446b90032bead49b9546862
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 21, 2026.
Transparency logRelease files / yutipy-5.4.0-py3-none-any.whl
| Download URL | yutipy-5.4.0-py3-none-any.whl |
|---|---|
| Size | 44.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
1d119a458ff32fa3e8ecee29ee8011c5531f519ac5777fe73ebbde1263d6e4ee
|
|
BLAKE2b-256 checksum How to use checksums |
22a2e245c80d21acec76639d39b09b8254e4140079b8755ea4277347ce3d1f9a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 21, 2026.
Transparency log
