cultome_player 2.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 520affa57eb4cbb5aee209993047772c18379b0d
+  data.tar.gz: 2fe8bbee2da06c8515a710edb4666a825e7dd19e
+SHA512:
+  metadata.gz: c286b696f6881b843c7577bb8451d21a6c8312c61d47e1e6986845b132637c0933311fe9d5ad17c3a3dd39709e7559ce8b36f46a565feaa9c04acf83278fa192
+  data.tar.gz: 9ac39288b1acea2127f0e7f6d8f19e85f4bf37e5c54912bdb648de9039ab4498fb819628e7703c6b6f97e3d8dd7f4b4a08cae6a3ac73fdae2ef6770ca85c147c

data/.coveralls.yml

@@ -0,0 +1 @@
+service_name: travis-ci

data/.gitignore

@@ -0,0 +1,24 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+*.swp
+tester.rb
+*.tmp
+TODO
+checklist
+spec/db.dat
+spec/db.log

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format progress

data/.travis.yml

@@ -0,0 +1,7 @@
+language: ruby
+rvm:
+    - 2.0
+script: rspec spec
+
+before_install:
+  - sudo apt-get install libtag1-dev

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in cultome_player.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Carlos Soria
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,325 @@
+[![Gem Version](https://badge.fury.io/rb/cultome_player.png)](http://badge.fury.io/rb/cultome_player)
+[![Build Status](https://travis-ci.org/cultome/cultome_player.svg)](https://travis-ci.org/cultome/cultome_player)
+[![Coverage Status](https://coveralls.io/repos/cultome/cultome_player/badge.png)](https://coveralls.io/r/cultome/cultome_player)
+
+# Cultome Player
+A handy music library explorer. Is designed to facilitate you to play the music you like in the moment you want.
+
+**"I want to play exactly this music"**
+
+The player is designed around this concept, so it has commands to help you find music in your library and play it.
+
+## Usage
+
+Lets see a couple examples and translate it to what to expect
+
+```ruby
+play a:weird
+```
+Generate a playlist with songs whose artist contains the string 'weird' in their name.
+
+```ruby
+play @history
+```
+Generate a playlist with all the songs you have heard in this session.
+
+```ruby
+play a:gorillaz b:demon
+```
+Generate a playlist with songs from albums that contains the string 'demon' in their name and their artist's name contains the string 'gorillaz'
+
+```ruby
+search rose
+```
+Finds all the songs whose title, artist'name or album's name has the string 'rose' in them.
+
+```ruby
+play 12
+```
+From the *focused list*, play the 12th item but dont modify the *current playlist*. If the *focused list* is a list of songs, then play a song, but if the *focused list* is of artists o albums, the play all the song from that artist o album.
+
+```ruby
+play @album
+```
+Generate a playlist with the songs from the *current song*'s album
+
+```ruby
+play @search
+```
+Generate a playlist with the results of the latest *search*.
+
+```ruby
+play @tribal
+```
+Generates a playlist with song whose genres includes 'tribal'
+
+## Player's command interface
+To understand the command interface, you need to understand its parameters types and formats.
+
+#### Criterio
+A criterio is a key:value pair. In this moment only three keys are valid:
+```
+* a    Stand for Artist
+* b    Stand for Album
+* t    Stand for Title
+```
+
+Examples of criterio are:
+
+```ruby
+a:duffy
+```
+```ruby
+b:"this is"
+```
+```ruby
+t:Jugulator
+```
+
+#### Literal
+A chain of non-space characters. If you require spaces you can wrap the text in " or ' so this can be considered only one parameter.
+
+Examples of literals are:
+
+```ruby
+tunnels
+```
+
+```ruby
+"The miss and the pit"
+```
+
+#### Object
+The objects are words with special meaning to the player prefixed with an @. In this moment the fully recognized objects are:
+```
+* @library         Refers to the complete list of songs in you *connected* collection.
+* @search          Refers to the list of songs returned in your last search.
+* @playlist        Refers to the current playlist. @current work as well.
+* @history         Refers to the playlist of songs you have heard in this session.
+* @queue           Refers to the list of songs scheduled to be played next.
+* @song            Refers to the current song playing.
+* @artist          Refers to the current song's artist playing.
+* @album           Refers to the current song's album playing.
+* @drives          Refers to all the drives the player knows.
+```
+
+Some others are not player's objects but act as special functions placeholders.
+```
+* @artists         Referes to the complete list of artists in you *connected* collection.
+* @albums          Referes to the complete list of albums in you *connected* collection.
+* @genres          Referes to the complete list of genres in you *connected* collection.
+* @recently_added  Referes to the list of recently added to the collection's songs.
+* @recently_played Referes to the list of recently played songs.
+* @more_played     Referes to the list of songs with more playbacks.
+* @less_played     Referes to the list of songs with less playbacks.
+* @populars        Referes to the list of songs with highest puntuations from playback preferences.
+```
+
+And anything else is interpreted as follow:
+* If there is a @drive with the same name, the @drive is used. The spaces in the @drive name are replaced with _. So, @my_drive search a drive with name 'my drive', no matter the case.
+* Try to match a genre, with same name tranformation as above. So, @rock refers to the genre named 'rock', no matter the case.
+
+#### Number
+The numbers refers to elements in a displayed list. When a list is displayed, that lists becomes the *focused list* and any given numerical parameter refers to the elements in this list. Depending on the list type, that will be the type of parameter used.A *focused list* is usually the latest list displayed by the player.
+
+Lets say we have the following *focused list*:
+
+```ruby
+35 :::: Song: Suburban War \ Artist: Arcade Fire \ Album: The Suburbs ::::
+36 :::: Song: Butcher Blues \ Artist: Kasabian \ Album: Kasabian ::::
+37 :::: Song: Master Of Puppets \ Artist: Metallica \ Album: 40 Greatest Metal Songs (Vh1) ::::
+38 :::: Song: Gavilán O Paloma \ Artist: La Lupita \ Album: Un Tributo A José José ::::
+39 :::: Song: La Primavera \ Artist: Manu Chao \ Album: Proxima Estacion: Esperanza ::::
+40 :::: Song: Caviar And Meths \ Artist: Judas Priest \ Album: Rocka Rolla ::::
+41 :::: Song: Take Me Out \ Artist: Franz Ferdinand \ Album: Take Me Out ::::
+42 :::: Song: Si Señor \ Artist: Control Machete \ Album: Artilleria Pesada, Presenta ::::
+43 :::: Song: Her We Kum \ Artist: Molotov \ Album: Dance And Dense Denso ::::
+```
+
+Because is a songs list, if we do
+
+```ruby
+play 39
+```
+We're saying that we want to play the song 'La Primavera'. But if we have the following *focused list*:
+
+```ruby
+149 :::: Artist: Paloma Faith ::::
+150 :::: Artist: Duffy ::::
+151 :::: Artist: Ke$Ha ::::
+152 :::: Artist: Interpol ::::
+153 :::: Artist: Jean Knight ::::
+154 :::: Artist: Curtis Mayfield ::::
+155 :::: Artist: War ::::
+```
+
+And the we do
+
+```ruby
+play 151
+```
+
+We get a playlist with all the songs of 'Ke$ha'. Similar behavior if we have had a albums list.
+
+#### Path
+Is an absolute path inside the filesystem. As with literals if the path has any spaces in it, is required to be wrapped inside " or '. In this moment there is no route expansion, so path like ~/music are not valids.
+
+```
+/home/usuario/music
+```
+
+#### Boolean
+Basicly anything that match the next regex is considered a boolean value, so watch out if you try to insert a literal value instead of a boolean.
+```
+/^(on|off|yes|false|true|si|no|y|n|s|ok)$/
+```
+
+#### IP
+A valid IP4 address.
+
+```ruby
+192.168.0.1
+```
+
+
+## Commands
+The commands are very rustic. Basicly consist in a command name and a list of parameters.
+
+```ruby
+<command> [<param>...]
+```
+
+The following command are implemented in this moment.
+
+```
+* help           Provides information for player features.
+* play           Creates a playlist and start playing. Resumes playback.
+* pause          Toggle pause.
+* stop           Stops current playback.
+* next           Play the next song in current playlist.
+* prev           Play the last song in history playlist.
+* quit           Quits the playback and exit the player.
+* search         Search into the connected music drives.
+* show           Shows representations of diverse objects in the player.
+* enqueue        Append a playlist to the queue playlist.
+* shuffle        Check the state of shuffle. Can turn it on and off.
+* connect        Add or reconnect a drive to the music library.
+* disconnect     Disconnect a drive from the music library.
+* ff             Fast forward 10 seconds the current playback.
+* fb             Fast backward 10 seconds the current playback.
+* repeat         Repeat the current playback from the begining.
+```
+
+Parameters passed to commands that dont require any are simply ignored.
+
+Normally and where makes sense, multiple parameters can mix types. For example, in the 'play' the following is valid and means 'Create a playlist with the results from last search, the artist 'Loly' and any song, artist or album whose name contains 'little'.
+
+```ruby
+play @search a:Loly little
+```
+
+The following search songs of artist named 'Poor' or 'Rich'
+
+```ruby
+search a:Poor a:Rich
+```
+
+If in doubt of a command please refer to the help of the command inside the app with the following:
+```ruby
+help <command_name>
+```
+
+## Installation
+Due I'm not a genius, I rely in an excelent media player as a multimedia backbone. So, unless you're trying to write yor own adapter for other music player, you need to have Mpg123 installed. With linux, is a piece of cake:
+
+For Ubuntu
+```
+sudo apt-get install mpg123
+```
+
+When you finish install this gem:
+```ruby
+gem install cultome_player
+
+cultome_player
+
+connect /home/user/music => main
+
+play
+```
+
+## What's new
+
+**Version 2.0.0**
+
+You know! I cant remember how many times I have rewrited this player. Mainly I do it because is fun to work in it, but the ugly truth is that I never finish it. However I will try to delivery at least a stable and prolonged api for this version. I'm taking my time and hopefully some day near I can delivery a fully funcional version with the plugins and all the flashing lights. If you wanna try the player while Im building it, try this version, if not stick it to the 1.0.0 (Im using version 1.0.0 while writing this) until I reach the functional point of that version, when that happens I'll post it here.
+
+UPDATE:
+
+I'm working again! Some changes ocurred since last update. First I change mi github account for dumb reasons, anyway this is the new old gem and I have this first stable new version. You know, some rought edges but at least is useful. I'll release the gem with another name because the cultome_player namespace is reserved. I let you know which one I pick. Wait the new gem in a couple days.
+
+**Version 1.0.0**
+
+I took so long I know, but it was for a good cause. When I realized thanks to [Travis CI](https://travis-ci.org/csoriav/cultome_player) that my code was a little more than difficult to test in more than one environment, considering the weird hybrid that result the JRuby thing, I decided to rewrite all the player, and that was what i been doing since then.
+
+With the hope to deliver zero-defect, multiple-environment-friendly, less error prone code, a better developer experience and a truly code that could be called gem, I invest a lot of effort writing with a test-first methodology with new version. As you can see my coverage incremented radically.
+
+As you can imagine, I test a lot, but even with my greattest efforts is possible that some scenarios have gone under the radar. I'm also conscient that this version still has some jagged edges, mostly of then I have identified but, by the nature of this change and the time it took, i decide to release this stable version and polish all the other things in the next release.
+
+So, whats new with this release? Well at first sight you will feel the speed in the starting, also will note the memory consumption is now less than half than before. I also remove dependencies but over all now the player is **PURE RUBY**... well! you still need to have java installed because the music player is the same, but now run in a separate process and the communication between ruby and java is with sockets. This allows to use the gem even without a music player or connect a nother player, lets say mplayer, with just overwriting a couple methods =D
+
+I remove the share funcitonality in this version, but it will come back in esteroids in future releases.
+
+Whats next? Musicbrainz integration, I need to tags correctly all the songs if I want to go further. So, see you next version!
+
+**Version 0.4.0**
+
+* Now you database and your config file are inside you user directory (~/.cultome), that mean every new version dont require re-connect you music or make your aliases again.
+* Scrobbler? of course! why not? but please run **'configure_lastfm begin'** before use it.
+* Better environment startup check.
+
+**Version 0.3.0**
+
+* Colors!!! Yeah! a color schema that you can customize if you dont like mine.
+* Some ASCII progress bars to let you know the player is not stuck!
+* Improvement in the 'help <command>' command, to, hopefully help you you surf in the player.
+* Add but not yet fully tested the *share* command to share music between two machines.
+* Some minor bugs fixed.
+* Specs up to date! YEAH!
+
+**Version 0.2.0**
+
+* The code were reorganized to be more API-oriented, even when this was not the mainly intention of this project, but can be uselful for others to use it this way.
+* The some commands were extracted from the core, like help and kill.
+* The command 'copy <object> <destiny_path>' were added to copy all the songs in the objet to a directory in the filesystem.
+* The option 'search @\<artist|album\>' was implemented to facilitate the __'that album rocks! lets hear it!'__.
+* The player now emit exception-thrown events, a general exception and a player's exception.
+* The aliases/shortcuts/macros plugin is in place. With this you can translate user input into commands, for example type 'sa' and the players tranform it to 'search @artist'.
+* Changes in plugin structure. Not the final version but a step ahead for building a better plugin model.
+* Some minor bugs fixes, like the db hanging or the lost in focus when search is empty.
+
+## TODO
+
+* Connect with musicbrainz to tag correctly and beatifuly my music, this also surge as Last.fm is very picky with the information you submit with your scrobbles.
+* Add tags to the songs, for example 'party' or 'sadness'.
+* A friend of mine give me an idea, when you are in a place where many people hear the same music, you should be able to decide what to play, as everyone else. So I will try an implementation of this idea, maybe a slave-masters model.
+* Support for Windows. Not my priority but would be nice my wife to use it.
+* Add gestures to the detector and start making appropiated suggestions for them.
+* Refine the taste analizer, which is the component that give preference points to songs.
+* Change the underlying in-file database for a real one, thinking on mongo or mysql.
+
+## Contributing
+
+  1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+  3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+  5. Create new Pull Request
+
+## Additional Information
+
+#### jlGui BasicPlayer
+  This component is what I use to play music and is included within the libraries of this project, dependencies included of course.
+
+  [jlGui](http://www.javazoom.net/jlgui/developerguide.html)
+

data/Rakefile

@@ -0,0 +1,8 @@
+require "bundler/gem_tasks"
+
+$LOAD_PATH.unshift(File.join(File.dirname(File.expand_path(__FILE__)), 'lib'))
+
+dirname = File.join(File.dirname(File.expand_path(__FILE__)), "tasks")
+Dir.entries(dirname).each do |task|
+  import "#{dirname}/#{task}" if task.end_with?(".rake")
+end

data/bin/cultome_player

@@ -0,0 +1,39 @@
+#!/usr/bin/env ruby
+$LOAD_PATH.unshift(File.join(File.dirname(File.expand_path(__FILE__)), '../lib'))
+
+require 'optparse'
+require 'cultome_player'
+
+options = {
+  interactive: false,
+  environment: :user,
+}
+
+parser = OptionParser.new do |opts|
+  opts.banner = "Usage: cultome_player [options] [file1, file2, ...]"
+
+  opts.on('-i', '--interactive', 'Starts the player in interactive mode') do
+    options[:interactive] = true
+  end
+
+  opts.on('-e', '--env ENV', 'Starts the player in interactive mode') do |env|
+    options[:environment] = env.to_sym
+  end
+
+  opts.on('--version', "Shows version") do
+    puts CultomePlayer::VERSION
+    exit
+  end
+
+end
+
+ARGV << "--help" if ARGV.empty?
+
+# parseamos las opciones
+parser.parse!(ARGV)
+
+player = CultomePlayer.get_player(options[:environment])
+
+if options[:interactive]
+  player.begin_session
+end