https://github.com/lfcipriani/tweet-jukebox

A jukebox powered by tweets on a Raspberry Pi
https://github.com/lfcipriani/tweet-jukebox

Last synced: 2 days ago
JSON representation

A jukebox powered by tweets on a Raspberry Pi

• Host: GitHub
• URL: https://github.com/lfcipriani/tweet-jukebox
• Owner: lfcipriani
• License: apache-2.0
• Created: 2014-11-14T12:13:30.000Z (almost 10 years ago)
• Default Branch: master
• Last Pushed: 2020-05-24T09:41:00.000Z (over 4 years ago)
• Last Synced: 2024-08-02T05:09:48.013Z (3 months ago)
• Language: JavaScript
• Homepage:
• Size: 1.25 MB
• Stars: 38
• Watchers: 4
• Forks: 10
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
tweet-jukebox

=============

[![Build Status](https://travis-ci.org/lfcipriani/tweet-jukebox.svg?branch=master)](https://travis-ci.org/lfcipriani/tweet-jukebox)

A jukebox powered by tweets on a Raspberry Pi.

                    +---------------------------------+

                    |                                 |

    Tweet           | Raspberry Pi                    |

    (music request) |                                 |

       +            | +-----------+      +----------+ |           \o/ Music powered by:

       |            | | Twitter   | +--> | Mopidy   | |             Spotify

       +--------------> Streaming |      | Server   +------------>  Youtube

         network    | | API       | <--+ |          | |  audio      Soundcloud

                    | +-----------+      +----------+ |

                    |                                 |

                    +---------------------------------+

## Device

![Tweet jukebox picture](docs/tweetjukebox.png)

## Usage

![tweet request](docs/tweet.png)

Tweet request syntax:

    @jukebox_user song name [by artist] [#spotify|#youtube|#soundcloud]

or

    @jukebox_user [link to a spotify, youtube or soundcloud music]

* search will play the first result found for the query

* artist is optional, but can help to search the right song

* you can restrict the search to a specific source by using the hashtag with source name

* if no music #source is specified, it will play the first result found on Spotify, then Youtube, then Soundcloud

A pre-configured admin user can send DM messages to jukebos user to #play, #pause, #next (skip song).

## Resources needed

* [Mopidy](https://www.mopidy.com/) music server 

* Mopidy [Spotify](https://github.com/mopidy/mopidy-spotify), [Youtube](https://github.com/dz0ny/mopidy-youtube), [Soundcloud](https://github.com/mopidy/mopidy-soundcloud) plugins

* Node.js

* Twitter [REST](https://dev.twitter.com/rest/public) and [Streaming](https://dev.twitter.com/streaming/overview) API

* Raspberry Pi

* Network access (via ethernet or wifi)

You can run on any device and OS that supports these softwares. I'm running everything on a Raspberry Pi

## Schematic

![Schematic](docs/schematic.png)

More instructions soon...

Copyright 2015 Luis Cipriani. Under Apache v2 License terms