Search and play any song from terminal
Alternatives To Playx
Project NameStarsDownloadsRepos Using ThisPackages Using ThisMost Recent CommitTotal ReleasesLatest ReleaseOpen IssuesLicenseLanguage
12 years ago23October 03, 20195mitPython
A CLI application for controlling Spotify
Lyricsgenius72615136 months ago46April 18, 202136mitPython
Download song lyrics and metadata from 🎶🎤
Music Dl429
17 hours ago44October 09, 2022mitPHP
Music Searcher and Downloader. - 音乐搜索下载器。
3 years ago15gpl-3.0Python
Google Play Music Proxy - "Let's stream Google Play Music using any media-player"
4 months ago1April 22, 202127mitGo
Practical Music Search is an interactive Vim-like console client for the Music Player Daemon.
3 years ago3mitPython
Search and play any song from terminal
10 months ago10gpl-3.0JavaScript
Source of and API to search for lyrics of a song
Showcase Songs Search121
8 months agoapache-2.0JavaScript
A site to instantly search 32M songs from the MusicBrainz songs database, using Typesense Search (an open source alternative to Algolia / ElasticSearch) ⚡ 🎵 🔍
5 days ago50gpl-3.0JavaScript
Clone Hero-friendly Organized Repository of User-provided Songs
3 years ago40January 06, 202011mitPython
A fancy TUI client for Google Play Music
Alternatives To Playx
Select To Compare

Alternative Project Comparisons

Search and play any song from terminal.

Philosophy   |   Requirements   |   Installation   |   Features   |   Usage   |   Example   |   Contribution   |   To-DO   |   Acknowledgements

playx in action


Play any songs that come in your mind.

Hoping to make it an awesome music assistant


  • For Arch Linux users, it is available in AUR with the name playx.

  • For others, it can be installed manually.

    Make sure all the dependencies are installed.

    Run the following command in the root directory to install playx.

    pip install -e .

    Or install using as:

    python install


  1. Python3.x

  2. pip3

  3. MPV

  1. Chromium

Note: These dependencies in linux can be installed in other variants.
For arch linux, you can use pacman package manager accordingly. Numpy is used for Markov-Chain based playlist.


  • play by query
  • play by youtube url
  • play a youtube playlist
  • play a billboard chart
  • play a spotify playlist
  • play from soundcloud playlist
  • play from JioSaavn playlist
  • play from gaana playlist.
  • play from local playlist
  • play from Youtube Music playlist
  • cache support
  • CLI using mpv
  • auto generate playlist


For now, the application is in development phase.

usage: playx [-h] [-rsearch [RSEARCH [RSEARCH ...]]] [-p] [-n] [-a] [-d] [-r] [-k] [-c] [--sync-pl PLAYLIST] [-l] [--shuffle] [--repeat [NUMBER]] [--pl-start START] [--pl-end END]
             [--level LEVEL] [--disable-file] [--list-level]
             [song [song ...]]

playx - Search and play any song that comes to your mind. If you have any issues, raise an issue in the github ( page

positional arguments:
  song                  Name or youtube link of song to download

optional arguments:
  -h, --help            show this help message and exit
  -rsearch [RSEARCH [RSEARCH ...]], --rsearch [RSEARCH [RSEARCH ...]]
                        Play based on terms provided
  -p, --play-cache      Play all songs from the cache. The cache is located at [~/.playx/songs/] by default
  -n, --no-cache        Don't download the song for later use.
  -a, --auto            Auto generate playlist
  -d, --skip-cached     Don't search the song in the cache.
  -r, --no-related      Disable playing related songs extracted from YouTube
  -k, --disable-kw      Disable addition of keywords while searching the song on YouTube.
  -c, --clean           Clean(fix) broken references
  --sync-pl PLAYLIST    Sync the playlists. Pass the name as arguement. If all the playlists are to be synced, just pass [All].
  -l, --lyrics          Show lyircs of the song.
  --shuffle             Shuffle the playlist in case it is one, else the option will have no effect.
  --repeat [NUMBER]     Put the passed entity on repeat , be it a playlist or a song. If an arg is not passed, infinite loop is considered. (default = Infinite)
  --pl-start START      Start position in case a playlist is passed. If passed without a playlist it has no effect.
  --pl-end END          End position in case a playlist is passed. If passed without a playlist it has no effect.

  --level LEVEL         The level of the logger that will be used while verbosing. Use `--list-level` to check available options.
  --disable-file        Disable logging to files
  --list-level          List all the available logger levels.


Play by song name

playx man sold world nirvana

This plays the song titled "The man who sold the world by Nirvana"

Play by youtube link


This plays the song The Sound of Silence.

Play by soundcloud links


This plays soundcloud track

Play from youtube playlist


This plays the songs from my personal (and public) playlist named Chilld and Wisdom.

Play from a Billboard Chart

playx hot-100

This plays the songs from Billboards hot-100 chart. The billboard charts can be found here

Play from spotify playlist


This plays the songs from Spotify Summer Party playlist.

Play from soundcloud playlist


This plays the songs from SoundCloud playlist

Play from JioSaavn playlist


This plays songs from the JioSaavn playlist

Play from YouTube Music Playlist


This plays songs from this playlist

Play from local playlist

The local playlist should have an extension .playx in order for us to recognize it as a playlist.

playx example.playx

This plays a playlist named example.playx

For a playlist every line is considered an entry. Refer to example.playx.

Auto-Generate Playlist

playx --auto

This will automatically generate a playlist by using the frequency of songs played that has been logged in the log file.

Term-Based Search

playx --rsearch pink floyd

This will automatically generate a playlist of cached songs containing the provided terms.

Cache Directory Structure

By default, playx creates a directory in the home as ~/.playx (which is a hidden folder). Structure is like:

    |- songs/
    |- logs/
    |- playlist/
    |- playxlist/

songs: This stores all the songs downloaded by playx
logs: This stores the log for user activities of songs that are searched and played with creation date. This will be used for recommendation of songs in future version playlist: This stores all the cached playlists files. playxlist: Stores all the playxlist files.

Having Issues? (We're not perfect!)

First update youtube-dl

youtube-dl is the core through which we fetch stream urls for any song or any YT playlist.
So, update it first

pip install -U youtube-dl

youtube-dl keeps on rolling out updates actively because the YouTube keeps on updating its internals for html. So, the parser/crawler should be updated periodically.

Second try cleaning the broken cache as

playx --clean

Chances are you have a url in the urls.json but the local mp3 might not exist in ~/.playx/songs/. So, cleaning and running the playx might mitigate that.

See The Partial Log

Log is found at logs/partial_log

See Playlist File

Files can be found inside playlist/. Chances are there might be empty links or names.

Selenium Web Driver Issue

Maybe you don't have the chromedriver that's required to crawl.
One example of how we use chromedriver is here.

Not having proper setup of the driver may result in empty playlists, especially related playlist one.

Please Create An Issue In GitHub here


Contributions are warmly welcome. Please do go through CONTRIBUTING.

Module-level Dependency Graph

This is generated using pydeps. The codebase is kinda messy, isn't it? :D


  • caching of downloaded songs (if the song exists locally, play it right away else play from youtube)
  • speed up the whole search->download->convert->play process
  • stream/play while downloading the song
  • play all the songs from the cache
  • search lyrics
  • play from youtube playlist
  • play from local playlist (may be a list of song names)
  • play from other playlist (spotify, billboard, etc.)
  • log activity
  • auto generate playlist
  • use Markov Chains to improve auto-playlist
  • local search based on term matching
  • use Factorization Machines to improve auto-playlist
  • use logs to create simple recommendations


  • Thanks to Deepjyoti Barman for doing all the major contributions (parallelizing streaming + downloads , playlist, logger)
  • Thanks to Mirza Zulfan for logo for playx. It's neat (and cool)
  • Thanks to Mattwmaster58 for creating packaging structure with setup file
  • A good blog by Deepjyoti about copyright infringement and licensing issues we encountered for playx can be found here.
Popular Songs Projects
Popular Search Projects
Popular Media Categories
Related Searches

Get A Weekly Email With Trending Projects For These Categories
No Spam. Unsubscribe easily at any time.
Play Framework