Skip to main content

playlistdb: Keep track of on disk playlists.

Project description

# Command line playlist bookkeeping
When following multiple series, keeping track of which episodes were watched
can become a tedious task. This project aims to offload this task to a

## Installation
Via [PyPI](

pip install playlistdb

From source:

git clone
cd playlist
pip install .

## Usage
The program `playlist` is used to add and remove files and to set configuration
options per directory, i.e., for every directory a new entry is added to the

The `add` command can be used to add files, any configuration specific for
these files can be added with the `config` subcommand.

playlist add *.mkv
playlist config '-sid 1'

This adds all files with extension `.mkv` to the database. The configuration
`-sid 1`, a command line option for [mplayer](, is
added for the current directory.

An overview of the database contents for the current directory can be seen with
the `show` subcommand.

$ playlist show
* 00 - Credits.mkv
00 - Intro.mkv
01 - Episode 1.mkv
02 - Episode 2.mkv
03 - Episode 3.mkv

Config: -sid 1

The `*` marks the current file, this file is next in line to be played.

Entries can be removed by using the `remove` subcommand:

playlist remove '00 - Credits.mkv'

The current file can be retrieved with the `current` subcommand and set to a
specific file with the `set` subcommand. The configuration can be retrieved
with `show_config`:

$ playlist current
00 - Intro.mkv
$ playlist set '01 - Episode 1.mkv'
$ playlist current
01 - Episode 1.mkv
$ playlist show_config
-sid 1

Finally, the `next` subcommand will show the current file and will set the
current file to the next entry.

$ playlist next
01 - Episode 1.mkv
$ playlist next
02 - Episode 2.mkv

The output of these commands can be passed to any program. It may be convenient
to make an alias for particular application, for example:

alias playnext='mplayer $(playlist show_config) "$(playlist next)"'

## Database
The database is stored in `$HOME/.cache/playlist/db.yml`. Since it is stored in
[YAML]( format, it can easily be modified
using any text editor.

The database entry for our example looks as follows:

config: -sid 1
- 00 - Intro.mkv
- 01 - Episode 1.mkv
- 02 - Episode 2.mkv
- 03 - Episode 3.mkv
offset: 3

The top-level key `/media/Show` is also the name of the directory that contains
the files to be played, the configuration for this directory is stored in the
`config` variable, the file list is stored in `files`. The `offset` variable
contains the index of the current file. If this index is larger or equal to the
length of the list, then the playlist is finished.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for playlistdb, version 0.0.2
Filename, size File type Python version Upload date Hashes
Filename, size playlistdb-0.0.2.tar.gz (4.6 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page