https://github.com/ElementsProject/lightning-jukebox

A Lightning powered Jukebox :zap: Pay with Bitcoin to choose your music.
https://github.com/ElementsProject/lightning-jukebox

bitcoin jukebox lightning lightning-charge micropayments nanopayments

Last synced: 8 days ago
JSON representation

A Lightning powered Jukebox :zap: Pay with Bitcoin to choose your music.

• Host: GitHub
• URL: https://github.com/ElementsProject/lightning-jukebox
• Owner: ElementsProject
• License: mit
• Created: 2018-03-16T04:51:14.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2021-09-20T12:55:53.000Z (about 3 years ago)
• Last Synced: 2024-10-24T07:43:13.285Z (16 days ago)
• Topics: bitcoin, jukebox, lightning, lightning-charge, micropayments, nanopayments
• Language: JavaScript
• Homepage: https://blockstream.com/2018/03/28/lightning-jukebox-offers-a-fun-end-to-our-week-of-lapps.html
• Size: 58.6 KB
• Stars: 36
• Watchers: 6
• Forks: 10
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-lightning-network - lightning-jukebox - A Lightning powered Jukebox; [Blog Post](https://blockstream.com/2018/03/28/lightning-jukebox-offers-a-fun-end-to-our-week-of-lapps.html) (Applications / Misc)
• awesome-lightning-network - lightning-jukebox - A Lightning powered Jukebox; [Blog Post](https://blockstream.com/2018/03/28/lightning-jukebox-offers-a-fun-end-to-our-week-of-lapps.html) (Applications / Misc)

README

        
# Lightning Jukebox

[![npm release](https://img.shields.io/npm/v/lightning-jukebox.svg)](https://www.npmjs.com/package/lightning-jukebox)

[![MIT license](https://img.shields.io/github/license/shesek/lightning-jukebox.svg)](https://github.com/shesek/lightning-jukebox/blob/master/LICENSE)

[![Pull Requests Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](http://makeapullrequest.com)

[![IRC](https://img.shields.io/badge/chat-on%20freenode-brightgreen.svg)](https://webchat.freenode.net/?channels=lightning-charge)

A Lightning powered Jukebox. Pay with Bitcoin to choose your music from YouTube.

[See it in action on YouTube](https://www.youtube.com/watch?v=AgGYpFJsh24)

Powered by :zap: [Lightning Charge](https://github.com/ElementsProject/lightning-charge)

## HOWTO

1. [Setup Lightning Charge](https://github.com/ElementsProject/lightning-charge/blob/master/README.md#getting-started).

2. Install Lightning Jukebox and start `jukeboxd`:

   ```bash

   $ npm install -g lightning-jukebox

   $ jukeboxd --charge-token mySecretToken --price '0.0001 BTC'

   Jukebox server running on http://localhost:6100

   ```

   You may pick a different theme from [bootswatch](https://bootswatch.com)

   by specifying `--theme [name]` (the default is `darkly`).

3. Navigate to `http://localhost:6100/` on the computer playing the music

   and click `Spawn YouTube player`.

   This will open a new YouTube window in a new tab.

   *Make sure to keep both* the page on `localhost:6100` and the youtube window open.

   You can use the YouTube window to start playing some initial music.

   

4. Make the payment page (`http://localhost:6100/pay`) available over the internet or set it up on a local device, like a tablet, near 

   the jukebox. The payment page allows users to pay for music selection.

   

   

   Once a payment is made, a push notification will be sent to the player window (via websockets),

   which will open the requested song in the spawned youtube window.

   Payments can also be made directly to the jukebox API:

   ```bash

   # with a search string

   $ BOLT11=`curl http://localhost:6100/invoice -d video='are you shpongled full album'`

   $ lightning-cli decodepay $BOLT11

   $ lightning-cli pay $BOLT11

   # with a specific video id

   $ lightning-cli pay `curl http://localhost:6100/invoice \

                        -d video=https://www.youtube.com/watch?v=IDiZG-eAk30`

   ```

## CLI options

```bash

$ jukeboxd --help

  A Lightning powered Jukebox

  Usage

    $ jukeboxd [options]

  Options

    -c, --charge-url       lightning charge server url [default: http://localhost:9112]

    -t, --charge-token   lightning charge access token [required]

    -P, --price          price to play music [default: 0.0001 BTC]

    -m, --theme           pick theme from bootswatch.com [default: darkly]

    -l, --title           website title [default: Lightning Jukebox]

    -p, --port            http server port [default: 9115]

    -i, --host            http server listen address [default: 127.0.0.1]

    -h, --help                  output usage information

    -v, --version               output version number

  Example

    $ jukeboxd -t chargeSecretToken -P '0.0005 EUR'

```

## Why a separate YouTube tab instead of embedding the video player?

So that "auto play next" works.

## License

MIT