Skip to main content

Get Lyrics from AZLyrics.com like a Boss ~(0_0)~

Project description

azapi

HitCount Build Status Python version Codacy Badge

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:

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 and self.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 and getLyrics.
  • You can use search albums, songs and artists.

v2.0.1 11-09-2019

  • First Release

Stargazers over time

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


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)

Uploaded Source

Built Distribution

azapi-3.0.8-py3-none-any.whl (20.6 kB view details)

Uploaded Python 3

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

Hashes for azapi-3.0.8.tar.gz
Algorithm Hash digest
SHA256 ccc5d108da0e3c735e57debecb519247b2fbfb332b1cf6db79ac3e0e346fa415
MD5 ceaa7bf09ec9b26e244532050340c8ac
BLAKE2b-256 e509f65bd8b1c62ea764a792b4b7f60a9cf643f4f482bc890775de83eb979cce

See more details on using hashes here.

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

Hashes for azapi-3.0.8-py3-none-any.whl
Algorithm Hash digest
SHA256 ed606a82a0f1d1e45cb43bba474f08bd7221b8fd31db3d5950c59e6264858130
MD5 de5c0cd191848c62a5bd922c34ca4d44
BLAKE2b-256 5307369300f9833fdb75312a8a58537ec1e1fe8faa5018a8029a5885bf2c2e3a

See more details on using hashes here.

Supported by

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