Skip to main content

a command-line song lyric fetcher

Project description

Build Status


A command-line song lyric fetcher.

Inspired by @gleitz’s howdoi. Name from the German word for “lyrics”.


LyricWiki is currently the only supported API.

LYRICSnMUSIC used to be an option but it appears to have been shut down. However, contributions are always welcome, especially for new API integrations.


With pip:

$ pip install songtext

With distutils:

$ python install


Search by both artist name (-a, --artist) and song title (-t, --title):

$ songtext -a pvris -t fire

Don't blame your death on the shit in your head
That you claimed ate you like a virus for days on end
I watched you decay, watched you waste away
Who'd you think you'd fool, baby, diggin' your own grave?

Note that option values that consist of more than one word need to be quoted:

$ ./songtext -a 'nina simone' -t sinnerman

Nina Simone: Sinnerman
Oh sinnerman, where you gonna run to?
Sinnerman, where you gonna run to?
Where you gonna run to?
All along dem day

Note that paging is turned on by default. Use the --no-pager flag to turn it off.

argument/API lyricwiki
positional (generic search) No
-a, --artist Yes
-t, --title Yes
-w, --words No
-l, --show-list No
--limit No
--no-pager Yes
-i, --index No


Project details

Release history Release notifications

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
songtext-0.1.7.tar.gz (5.8 kB) Copy SHA256 hash SHA256 Source None Apr 7, 2017

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page