lnbits-legend/lnbits/extensions/streamalerts
2022-01-05 07:36:10 -03:00
..
templates/streamalerts streamalerts converted untested 2021-10-29 12:44:45 +01:00
__init__.py black 2021-11-12 04:14:55 +00:00
config.json streamalerts converted untested 2021-10-29 12:44:45 +01:00
crud.py general cleanup and unused imports removal 2021-11-25 18:52:16 +00:00
migrations.py streamalerts converted untested 2021-10-29 12:44:45 +01:00
models.py black 2021-11-12 04:14:55 +00:00
README.md streamalerts converted untested 2021-10-29 12:44:45 +01:00
views_api.py Change _asdict() to dict() 2022-01-05 07:36:10 -03:00
views.py black 2021-11-12 04:14:55 +00:00

Stream Alerts

Integrate Bitcoin Donations into your livestream alerts

The StreamAlerts extension allows you to integrate Bitcoin Lightning (and on-chain) paymnents in to your existing Streamlabs alerts!

image

How to set it up

At the moment, the only service that has an open API to work with is Streamlabs, so this setup requires linking your Twitch/YouTube/Facebook account to Streamlabs.

  1. Log into Streamlabs.
  2. Navigate to the API settings page to register an App:
    image
    image
    image
  3. Fill out the form with anything it will accept as valid. Most fields can be gibberish, as the application is not supposed to ever move past the "testing" stage and is for your personal use only. In the "Whitelist Users" field, input the username of a Twitch account you control. While this feature is technically limited to Twitch, you can use the alerts overlay for donations on YouTube and Facebook as well. For now, simply set the "Redirect URI" to http://localhost, you will change this soon. Then, hit create:
    image
  4. In LNbits, enable the Stream Alerts extension and optionally the SatsPayServer (to observe donations directly) and Watch Only (to accept on-chain donations) extenions:
    image
  5. Create a "NEW SERVICE" using the button. Fill in all the information (you get your Client ID and Secret from the Streamlabs App page):
    image
    image
  6. Right-click and copy the "Redirect URI for Streamlabs" link (you might have to refresh the page for the text to turn into a link) and input it into the "Redirect URI" field for your Streamelements App, and hit "Save Settings":
    image
    image
  7. You can now authenticate your app on LNbits by clicking on this button and following the instructions. Make sure to log in with the Twitch account you entered in the "Whitelist Users" field:
    image
    image
    If everything worked correctly, you should now be redirected back to LNbits. When scrolling all the way right, you should now see that the service has been authenticated:
    image
    You can now share the link to your donations page, which you can get here:
    image
    image
    Of course, this has to be available publicly on the internet (or, depending on your viewers' technical ability, over Tor). When your viewers donate to you, these donations will now show up in your Streamlabs donation feed, as well as your alerts overlay (if it is configured to include donations).

CONGRATS! Let the sats flow!