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
getSongs
not returning all songs.
v3.0.2 25-07-2020
- #7Added the ability to use custom path with
getLyrics
. - Added
self.lyrics
andself.songs
to store last call. - Added
self.lyrics_history
that 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
getSongs
andgetLyrics
. - 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
azapi-3.0.8.tar.gz
(8.1 kB
view details)
Built Distribution
azapi-3.0.8-py3-none-any.whl
(20.6 kB
view details)
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 |