Ektoplayer

Ektoplayer is a commandline client for ektoplazm.com, a website where you can listen and download freely licensed psytrance, techno and downtempo music.

It allows you to

• Search for tracks by tags (artist, album, style, ...)
• Play tracks located at ektoplazm.com
• Display information about albums
• Download whole albums as mp3

Features

• Mouse support
• Vi-like keybindings (hjkl, ^d, ^u, /, ?, n, N, ...)
• Up to 256 colors are supported
• Local sound file cache
• Song prefetching

Screenshots

Requirements

• Ruby (1.9)
• Mpg123 (1.14)
• Sqlite3
• One of the following ncurses gems: curses, ffi-ncurses, ncurses, ncuresw

Optional Requirements

• For extracting album archives either unzip, 7z or the Gem RubyZip is needed

Installation

Note: Running ruby gems requires to change the $PATH variable. See output of gem env gempath.

Arch Linux

• Using yaourt:

  yaourt -S ektoplayer
  

• Using makepkg:

  git clone https://github.com/braph/ektoplayer
  cd ektoplayer
  makepkg
  sudo pacman -U ektoplayer-*.pkg.tar.xz
  

• Using gem:

  pacman -S --needed ruby mpg123 sqlite3 ncurses
  gem install ektoplayer
  

Debian (*)

• Using gem:

  apt-get install ruby ruby-dev libz libz-dev ruby-ncurses ruby-nokogiri ruby-sqlite3 \
                  mpg123 sqlite3 libncurses5
  gem install ektoplayer
  

OpenSuse (*)

• Using gem:

  zypper in ruby ruby-devel gcc sqlite3 sqlite3-devel ncurses ncurses-devel zlib zlib-devel \
            mpg123 
  gem install ektoplayer ffi-curses
  

Ubuntu (*)

• Using gem:

  apt-get install ruby ruby-dev sqlite3 ruby-sqlite3 ruby-nokogiri ruby-ncurses mpg123
  gem install ektoplayer
  

(*) Not tested yet

Configuration

Ektoplayer keeps it's default configuration file under ~/.config/ektoplayer/ektoplayer.rc.

Available configuration commands:

• set <option> <value>
• bind <window> <key> <command>
• undbind <window> <key>
• unbind_all
• color <name> <fg> [<bg> [<attribute> ...]]
• color_mono <name> <fg> [<bg> [<attribute> ...]]
• color_256 <name> <fg> [<bg> [<attribute> ...]]

See ektoplayer.rc for a configuration file with the default values.

Authors

• Benjamin Abendroth

See also

• Ektoplayer was inspired by Soundcloud2000 and ncmpcpp