Skip to main content
https://badge.fury.io/py/musicview.svg https://circleci.com/gh/MaT1g3R/musicview.svg?style=svg https://travis-ci.org/MaT1g3R/musicview.svg?branch=master https://codecov.io/gh/MaT1g3R/musicview/branch/master/graph/badge.svg

Motivation

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

Requirements

  • 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

Installation

pip install musicview

Or to install the latest development version, run:

git clone --recursive https://github.com/MaT1g3R/musicview
cd musicview
pip install .

Quick Tutorial

To use the command line interface

$ musicview --help

Usage: main.py [OPTIONS] COMMAND [ARGS]...

  musicview, (re)discover your music library

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

Commands:
  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.

TODO

  • Tests

  • Better looking cueses UI

  • asyncio?

License

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

Metadata

Release files for musicview 0.3.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for musicview 0.3.3
File Size Uploaded Provenance
musicview-0.3.3.tar.gz 27.7 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for musicview 0.3.3
File Interpreter ABI Platform
musicview-0.3.3-py2.py3-none-any.whl Python 2, Python 3 none any Details

Total release size: 57.5 kB

Release files / musicview-0.3.3.tar.gz

Download URL musicview-0.3.3.tar.gz
Size 27.7 kB
Tags Source
SHA-256 checksum
How to use checksums
b7de849d293de0032e9a14574851073ddccd5d9ae013c6ccd1a3e3301e094ae5
BLAKE2b-256 checksum
How to use checksums
644a8d4c2705d38a3b62640c2b0ffbf842cb7bd42210f9f0e554416bf9a7afcd
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release files / musicview-0.3.3-py2.py3-none-any.whl

Download URL musicview-0.3.3-py2.py3-none-any.whl
Size 29.8 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
db58474b313941f8c0279307be85e37fb1457c624a53e9e98beec35afa4ec41e
BLAKE2b-256 checksum
How to use checksums
b196997f303c714dd3400bc9ea6ab3d68af84829493ed7b1539842b3ce6e149f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Security for musicview 0.3.3

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page