TweetJukeBox, a "virtual" jukebox for Twitter
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
audio
lib
log
.gitignore
README.md
config.php
download.php
play.php
tweet.php
tweetjukebox.sh

README.md

TweetJukeBox

TweetJukeBox is a "virtual" jukebox that uses Twitter to select a song, with a special hashtag, and search for the song in the database of YouTube. The song is added to a local queue and is played using mplayer.

The TweetJukeBox has been developed by Catodo as art installation. You can read more about the art project here: http://www.catodo.net/tweetjukebox/

SYSTEM REQUIREMENTS

TweetJukeBox requires the GNU/Linux operating system with the following softwares:

  • PHP 5.3 (or later);
  • mplayer 1.x.

You need the PDO and SQlite extension enabled on your PHP environment (PDO and the PDO_SQLITE driver is enabled by default as of PHP 5.1.0).

INSTALLATION

You can download (or clone) TweetJukeBox from github.

To download as ZIP file click here.

To clone it, run the following command:

$ git clone https://github.com/iamcatodo/TweetJukeBox.git

After the download you need to enable the execution of the tweetjukebox.sh script using the following command:

$ chmod +x tweetjukebox.sh

Now you are ready to execute the TweetJukeBox!

USAGE

Before start the TweetJukeBox you need to configure it. The configuration is stored in the config.php file. You can use the default values. The hashtag parameter can be customized to specify the hash to search in Twitter for the selection of the songs.

To start the TweetJukeBox you can use the following command:

$ ./tweetjukebox.sh start

To stop the TweetJukeBox you can use the following command:

$ ./tweetjukebox.sh stop

You can also restart the TweetJukeBox using the following command:

$ ./tweetjukebox.sh restart

LICENSE

Creative Commons Attribution-NonCommercial 3.0

http://creativecommons.org/licenses/by-nc/3.0/

COPYRIGHT

(C) Copyright 2012 by Catodo - http://www.catodo.net