Skip to content
/ amp Public

🔉 A frictionless way to play music from the command line

License

Notifications You must be signed in to change notification settings

nivekuil/amp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

85 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Amp (asynchronous music player) is a command-line interface to YouTube that lets you find, play, and pause music with minimal effort. It takes arguments in the form of a YouTube search query and plays the first result in a background process.

Usage

  1. Open terminal
  2. Type “amp ” + title, artist, lyrics, etc.
  3. Enjoy the music!

Examples

Phrase stuff as a search query - be lazy!

$ amp portugal hard being wizard
Now playing: It's Complicated Being A Wizard (full) - Portugal. The Man [00:23:01]$

$ amp sotc ost
Stopping current song..
Now playing: Shadow of the Colossus OST (Playstation 2) [01:15:51]

Some songs can be found with just the lyrics:

$ amp ah look at all the lonely people
Now playing: the beatles "eleanor Rigby" with lyrics [00:02:07]

$ amp i knew the like the back of my hand
Stopping current song..
Now playing: Somewhere Only We Know - Keane (Lyrics) [00:04:15]

General usage:

$ amp
Playback paused. Type 'amp' again to resume.

$ amp
Playback resumed.

$ amp yellow
Stopping current song..
Now playing: Coldplay - Yellow [00:04:33]

$ amp yellow beatles -v
Stopping current song..
Now playing: the beatles- yellow submarine(LYRICS) [00:02:38]
Showing video in an external window.

Installation

Requirements

  • Python 3.3+ (recommended) or Python 2.7
  • mpv
  • Python build tools: pip, setuptools, etc.

The Python 3 version is recommended, and development is focused on that version first. Once you have all of these, amp can be installed from pip (with root privileges).

# pip install amp-player

Alternatively, you can build it yourself:

$ git clone https://github.com/nivekuil/amp.git
$ cd amp
$ python setup.py install

Planned features/fixes

  • List multiple results to choose a song from
  • Filters: by duration, quality, views, etc.
  • Queue songs
  • Song history
  • Handle invalid options more gracefully
  • When external dependency fails, show error output
  • Possiblty rewrite this to use sockets/REST instead of OS-level process control

Troubleshooting

If playback ends abnormally before anything starts playing, it might be an issue with one of amp’s dependencies. Try using amp --verbose to get the URL of the video, and then play the URL with mpv directly. If that works, then please submit an issue (or pull request).

About

🔉 A frictionless way to play music from the command line

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages