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 hashes)

Uploaded Source

Built Distribution

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

Uploaded Python 3

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