Skip to main content

(re)discover your music library.

Project description


Do you have a massive music library that you have no hope of ever going through? This tool aims to solve this problem.

What does it do

  • Provides a very simple curses interface

  • Recursively discover all sound files and their metadata under a directory

  • Allows tracking multiple different music libraries

  • Randomly selects the least played file to play

  • Keep track of favourite status

What does it not do

  • Replace your music player


  • Python 3.6 or later

  • curses
    • This should be available on most *nix operating systems. On Windows you can try WSL

  • ffmpeg
    • On Linux you can obtain them via your package manager

    • On macOS you can install ffmpeg using homebrew brew install ffmpeg --with-sdl2

    • On Windows you can follow the instructions here


pip install musicview

Or to install the latest development version, run:

git clone --recursive
cd musicview
pip install .

Quick Tutorial

To use the command line interface

$ musicview --help


  musicview, (re)discover your music library

  -h, --help  Show this message and exit.

  delete  Delete a music library
  list    List existing music libraries
  new     Create a new music library
  play    Start playing music
  update  Update an existing music library

The play command will start a simple curses music player.

Setting the configuration home

By default, musicview will store its configuration and data files under $HOME/.musicview, if you would like to change that, you can set the MUSICVIEW_CONFIG_HOME environment variable to the path you want.

Default curses interface controls

  • p play/pause

  • f toggle favourite status

  • > skip song

  • q quit

You can edit those in the musicview.toml file under your configuration home.


  • Tests

  • Better looking cueses UI

  • asyncio?


musicview is licensed under the terms of the GNU General Public License, either version 3 of the License, or (at your option) any later version.

Please see LICENSE for details

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

musicview-0.3.3.tar.gz (27.7 kB view hashes)

Uploaded source

Built Distribution

musicview-0.3.3-py2.py3-none-any.whl (29.8 kB view hashes)

Uploaded py2 py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page