Get Lyrics from AZLyrics.com like a Boss ~(0_0)~
Project description
azapi
A fast and secure API for AZLyrics.com to get lyrics easily :)
Features
- Get artist's songs list with Album, Year ...etc
- Can get results via Google* and Duckduckgo* for accurate results.
- Save lyrics in a .txt file or any format you like.
- Avoid BAN using proxy** and multiple user agents.
Installation
azapi requires Python 3.
Use pip to install the package from PyPI:
pip install azapi
Or, install the latest version of the package from GitHub:
pip install git+https://github.com/elmoiv/azapi.git
Usage
import azapi
API = azapi.AZlyrics('google', accuracy=0.5)
API.artist = 'Tylor Swft'
API.title = 'Bad Blods'
API.getLyrics(save=True, ext='lrc')
print(API.lyrics)
# Correct Artist and Title are updated from webpage
print(API.title, API.artist)
Tests
Here are a few sample tests:
- Getting lyrics
- Getting lyrics (Custom Path)
- Getting songs list
- Downloading lyrics from a list
- Get Lyrics by title only
- Using search engine with titles
- Using search engine with mistyped title and artist
Changelog
v3.0.7 03-01-2022
- #6 [Re-Fixed] Single albums return relative urls.
v3.0.6 12-02-2021
- #11 Fixed proxy not used properly.
v3.0.5 26-09-2020
- #10 Fixed one-liner lyrics can't be retrieved.
- Direct lyrics URLs can now be passed without artist or title.
- Fixed minor bugs.
v3.0.4 22-08-2020
- #9 Update title and artist attributes with exact values from AZLyrics.com.
- Fixed minor bugs.
v3.0.3 13-08-2020
- #8 Fixed
getSongsnot returning all songs.
v3.0.2 25-07-2020
- #7Added the ability to use custom path with
getLyrics. - Added
self.lyricsandself.songsto store last call. - Added
self.lyrics_historythat stores all fetched lyrics.
v3.0.1 07-07-2020
- #6 Fixed single albums return relative urls.
v3.0.0 15-06-2020
- Project re-done from scratch.
- Added the ability to use search engines.
- Fixed unicode issue with non-english lyrics.
- Fixed songs list not working for artists with single album.
- Removed search as it's no longer needed.
- Fixed NoneType bugs.
v2.1.0 18-10-2019
- Added search feature to
getSongsandgetLyrics. - You can use search albums, songs and artists.
v2.0.1 11-09-2019
- First Release
Stargazers over time
Contributing
Please contribute! If you want to fix a bug, suggest improvements, or add new features to the project, just open an issue or send me a pull request.
*It is adviced not to send too many requests to avoid IP ban by search engines.
**Proxy is set by the user, defult is empty.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file azapi-3.0.8.tar.gz.
File metadata
- Download URL: azapi-3.0.8.tar.gz
- Upload date:
- Size: 8.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.27.1 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.45.0 CPython/3.7.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ccc5d108da0e3c735e57debecb519247b2fbfb332b1cf6db79ac3e0e346fa415
|
|
| MD5 |
ceaa7bf09ec9b26e244532050340c8ac
|
|
| BLAKE2b-256 |
e509f65bd8b1c62ea764a792b4b7f60a9cf643f4f482bc890775de83eb979cce
|
File details
Details for the file azapi-3.0.8-py3-none-any.whl.
File metadata
- Download URL: azapi-3.0.8-py3-none-any.whl
- Upload date:
- Size: 20.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.27.1 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.45.0 CPython/3.7.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ed606a82a0f1d1e45cb43bba474f08bd7221b8fd31db3d5950c59e6264858130
|
|
| MD5 |
de5c0cd191848c62a5bd922c34ca4d44
|
|
| BLAKE2b-256 |
5307369300f9833fdb75312a8a58537ec1e1fe8faa5018a8029a5885bf2c2e3a
|