Socket
Socket
Sign inDemoInstall

lyricwikia

Package Overview
Dependencies
0
Maintainers
1
Alerts
File Explorer

Install Socket

Protect your apps from supply chain attacks

Install

lyricwikia

LyricWikia API for song lyrics

    0.1.11

Maintainers
1

Readme

Description
-----------

`LyricWikia`_ is an online wiki-based lyrics database and encyclopedia.
It used to provide full access to song lyrics via API, but the service
has been discontinued.

This API scrapes the song web page and returns the lyrics. Please verify
that your use complies with the `LyricWikia`_ terms of service.


Installation
------------

The package ``lyricwikia`` is on `PyPI`_, so you can install it using pip:

.. code::

    pip install lyricwikia

Otherwise download this repository and use the ``setup.py`` file:

.. code::

    python setup.py install

It is also avaliable on the AUR for Arch Linux users: `python-lyricwikia`_


Usage
-----

You can use the ``lyrics`` command to look for a song lyrics.

    usage: lyrics [-h] [--separator SEPARATOR] [--version] ARTIST SONG

    Get lyrics of a song from LyricWikia

    positional arguments:
      ARTIST                Artist name
      SONG                  Song title

    optional arguments:
      -h, --help            show this help message and exit
      --separator SEPARATOR
                            line separator
      --version             show program's version number and exit


Example
-------

.. code::

    $ lyrics 'Led Zeppelin' 'Stairway to heaven'
    There's a lady who's sure all that glitters is gold
    ...


API
---

At the moment ``lyricwikia`` provides two APIs that are not officially already
provided by the official APIs):

- ``get_lyrics(artist, song, linesep='\n', timeout=None)``: returns a string
    that contains the lyrics of the song as provided by LyricWikia. If the
    lyrics is not found, the ``LyricsNotFound`` exception is raised.
  
- ``get_all_lyrics(artist, song, linesep='\n', timeout=None)``: returns a list
  of all the lyrics versions of the song (e.g., both the *kanji* and the
  *romaji* versions if available).  If the lyrics is not found, the
  ``LyricsNotFound`` exception is raised.


.. code:: python

    import lyricwikia
    lyrics = lyricwikia.get_lyrics('Led Zeppelin', 'Stairway to heaven')


Used by
-------

- `spotify-downloader`_: download Spotify playlists with albumart and meta-tags
- `spotify-music-videos`_: watch Youtube music videos (and lyrics) for the currently playing Spotify songs


.. _LyricWikia: http://lyrics.wikia.com
.. _PyPI: https://pypi.python.org/pypi/lyricwikia
.. _spotify-downloader: https://github.com/ritiek/spotify-downloader
.. _python-lyricwikia: https://aur.archlinux.org/packages/python-lyricwikia/
.. _spotify-music-videos: https://github.com/marioortizmanero/spotify-music-videos

Keywords

FAQs


Did you know?

Socket installs a GitHub app to automatically flag issues on every pull request and report the health of your dependencies. Find out what is inside your node modules and prevent malicious activity before you update the dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc