Project

ektoplayer

0.0
No commit activity in last 3 years
No release in over 3 years
Ektoplayer is a commandline client for http://ektoplazm.com, a website providing free electronic music such as techno, goa and psy-trance
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Runtime

~> 1.6
~> 1.0
~> 1.3
 Project Readme

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

Screenshot 2017-03-20 Screenshot 2017-03-20 Screenshot 2017-03-20 Screenshot 2017-03-20

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

See also