qobra 1.0.3

A simple music player for the command line

Contents

• Installation
  • Windows
• Dependencies
• Configurations
• Current Issues

qobra

Simple music player for the command line written in Python 🐍.

Why qobra?

When it comes to minimal software, you want to use programs that do one thing, and do it well. This is exactly what qobra does: play music, and nothing else.

As of version 1.3.0, with qobra you can:

• Display a list of your music.
• Play selected song.
• Play next or previous song.
• Pause a song.
• Toggle between Shuffle and Normal mode.
• Search for a song.

Installation

qobra is available in the PyPI. To install it run:

pip install qobra

Dependencies

• pygame

Usage {#usage}

qobra [options] [path to your music directory]

Controls

Key	Function
k	go up a song
j	go down a song
l	play selected song
p	toggle pause state
q	exit qobra
o	play next song
i	play previous song
s	switch to shuffle mode
n	switch to normal mode
/	bring up the search box
Enter	submit search
Esc	close the search box

Configuration

qobra will look for a configuration file in ~/.config/qobra/config.py or use the default configuration if it can't find one. You can copy the sample config.py file in this repository to ~/.config/qobra/config.py if you want to have your configuration.

You can customize qobra's colors in the config.py file, as well as set your music directory to avoid having to write it out on the command line:

music_dir = "~/music"

TO DO's

• Make next song play after current one finishes.
• Shuffle mode.
• Resume song after pausing.
• Format usage message
• Accept individual files as input.
• Handle window resizing.
• Handle unsupported file formats
• Filter songs
• Add a config file

Current Issues

• qobra may misbehave if you resize the window while the search bar is showing (why would you want to do that anyway?).
• qobra may engage in erratic behaviour if you try to play a song with an unsupported file format.
• qobra will crash if you attempt to run it in a terminal with height less than or equal to 33 lines.
• You won't see current playing status nor song if you resize your terminal after executing qobra.

Bugs

Please, feel free to report any bugs at [e-mail], or make a pull request.

Contribute

If you'd like to contribute, e-mail me at [e-mail] 😀.