Stream Tools

Settings

Important Info

The Settings menu allows you to login to your Twitch account. Within this menu you can toggle and configure functionality for StreamLoots and Chat Messages.

At the top of the application, select Stream Tools. From that dropdown, select Settings.
MSST1.1.png

  1. Click the Login to Twitch button in the top left.
    MSST1.2.png

StreamLoots

Important Info

StreamLoots allows viewers to purchase virtual cards that trigger specific actions within the stream, such as playing sound effects, displaying animations, or influencing gameplay.

With StreamLoots enabled in MultiShock, your selected devices are activated whenever a viewer redeems a card.

Creating Shocking Cards

  1. To begin, visit https://www.streamloots.com/
  2. Select Join Now near the top of the page, this will scroll down to the bottom where you will select Login with Twitch.
    StreamLootsLogin.png
  3. Once logged in, select your icon in the top right corner and select Creator dashboard from the menu that appears.
    StreamLootsProfileMenu.png
  4. On the left-hand menu, find Configuration, select the Alerts & Widgets option which is nested under Configuration.
    StreamLootsCreatorConfigurationAlerts.png
  5. In this new menu, you will see many options sorted by category, look for Integrations, under this category find ChatBot and select Configure Chatbot
    Enable Chatbot must be selected or StreamLoots will NOT affect your device activations.
  6. On the left-hand menu select either My collections
    StreamLootsCreatorMycollections.png
  7. Select + Create Collection. You'll be met with 2 options, select Create your collection.
    StreamLootsCreateyourcollection.png
  8. Create your collection and select Create Collection
    StreamLootsCreateCollection.png
  9. You should now see your newly created collection on your My collections page. From here, select Manage.
    StreamLootsMycollections.png
  10. Find and select Add Card. You'll be met with 3 options, select Create Your Card.
    StreamLootsAddCard.png
  11. Once your new card is made, scroll down to the bottom of the page and select + Add integration.
    StreamLootsAddIntegration.png
  12. Select Chatbot: Custom card messages.
    StreamLootsChatbotIntegration.png
  13. Scroll down once more to find the Chatbot: Custom card messages section and select Custom message.
    StreamLootsCustomMessage.png
  14. In the body of the message, paste in the following: PiShock Action! {{username}} Shock|1|70
    Understanding The Custom Chat Command

    Shock|1|70 can be broken down into 3 parts.

    • The first part "Shock" determines what action the device will take. The available options are Shock, Vibrate, and Beep.
    • The second part "1" determines the duration, this number can be set anywhere from 1 to 15.
    • The third part "70" determines the intensity, this number can be set anywhere from 1 to 100.

Device Setup

  1. Toggle StreamLoots to enable or disable Shocker activation upon redemption of StreamLoots cards.
    MSST1.3a.png

  2. Select the Shockers you want to activate whenever a StreamLoots card is redeemed.
    MSST1.3b.png

  3. Set Select Mode to your preference:
    MSST1.3c.png

    • All: All available unpaused Shockers will be selected.

    • Random: A random available unpaused shocker will be selected.

    • Round-Robin: Shockers will be activated in sequential order.

      Example

      When conditions are met, Shocker #1 will be activated, when conditions are met again, Shocker #2 will be activated, and so on.

  4. Click Save to ensure your settings are saved.
    MSST1.5.png

    The above image has been shortened for illustrative purposes for this guide only!

Chat Messages

Important Info

By enabling Chat Messages, actions like Cheers, Redeems, Subscriptions, and more trigger customizable messages that are posted directly to the stream's chat.

Enabling this feature does NOT trigger device activation.

Please see Cheers, Redeems, Subs & Gifted Subs, and Follows for further information on setting up your device(s) to respond to the relevant Twitch.tv features.

  1. Toggle Chat Messages to enable or disable Chat Messages for a variety of options. (see below.)
    MSST1.4a.png
  2. Enable, disable, and change any of the Chat Messages to your preferences.
    MSST1.4b.png
  3. Click Save to ensure your settings are saved.
    MSST1.5.png
    The above image has been shortened for illustrative purposes for this guide only!

Cheers

Important Info

The Cheers menu allows you to customize how your device(s) react whenever a viewer activates a Cheer with Bits to your Twitch channel.

What is a Cheer?

A Cheer on Twitch is a way for viewers to show support and celebrate using Bits, Twitch.tv's virtual currency. Cheers with Bits triggers special animations and sounds in the stream, it can also unlock custom rewards set by the streamer.

Link to Twitch.tv: How to Purchase Bits
Link to Twitch.tv: Guide to Cheering with Bits


At the top of the application, select Stream Tools. From that dropdown, select Cheers.
MSST2.1.png

Sections

Important Info

Sections can be made to specify new Keywords. These Keywords will trigger activation of your selected device(s) each time they appear in a Cheer.

Each Section can be configured to activate different devices with different Device Setting options.

About The Default Section

The first available Section will always be labeled as "Default".
The "Default" Section is used if a Cheer does NOT include any text that can be matched with another active Section's Keyword.

The "Default" Section cannot be removed.
The "Default" Section cannot be renamed.

Adding And Removing Sections

  • Select Add Selection to create a new Section.
    MSST2.2.png

  • Select Remove Last Section or the V dropdown to remove any unwanted Sections.
    MSST2.3.png

    The Default Section cannot be removed!

Setting Up Sections

  1. Toggle Enabled to enable or disable each Section.
    MSST2.4.png
  2. Enter a Keyword for each Section (e.g. zap).
    MSST2.5.png
  3. Select the Shockers you want this Keyword to activate.
    MSST2.7.png
  4. Select the Device Setting you would prefer the specified Keyword to trigger.
    MSST2.8.png
    • Shock: The device will emit a shock.
    • Vibrate: The device will vibrate.
    • Beep: The device will emit a beep.

Brackets

Important Info

Brackets can be added to change the way your selected device(s) respond the amount of Bits received from Cheers.

Bits Within Brackets

About If you have 2 brackets, one with a bit amount of 100 and another with a bit amount of 200, donations between 100-199 bits will round down to 100.

Adding And Removing Brackets

  • Select the Add Bracket button to create a new Bracket.
    MSST2.9.png
  • Select Delete to remove any unwanted Brackets.
    MSST2.15.png

Setting Up Brackets

  1. Set the Bit Amount for the Bracket.
    MSST2.10.png
  2. Set your preferred Intensity for the selected Shockers within the Bracket. (Max 100)
    MSST2.11.png
  3. Set the activation Durationfor the selected Shockers within the Bracket. (Max 15) MSST2.12.png
  4. Enable the Warn? option if you want the selected Shocker(s) to vibrate before emitting a shock.
    MSST2.13.png
  5. Set Select Mode for the Bracket.
    MSST2.14.png
    • All: All available unpaused Shockers will be selected.
    • Random: A random available unpaused shocker will be selected.
    • Round-Robin: Shockers will be activated in sequential order.
      Example

      When conditions are met, Shocker #1 will be activated, when conditions are met again, Shocker #2 will be activated, and so on.

Redeems

Important Info

The Redeems menu allows you to customize how your device(s) react when viewers redeem Channel Point rewards your Twitch channel offers.

What is a Redeem?

A Redeem on Twitch is when a viewer uses their accumulated Channel Points (these are earned periodically by watching and engaging with a stream) to claim a custom reward set by the streamer. These rewards can range from special emotes to interactive experiences within the stream.

Link to Twitch.tv: Channel Points FAQ
Link to Twitch.tv: Channel Points Guide for Viewers
Link to Twitch.tv: Channel Points Guide for Creators

Ensure You Are Logged in!!

Redeems will be automatically loaded IF you are logged in and have them on your account. If you are NOT logged in or your account has NO Redeems


At the top of the application, select Stream Tools. From that dropdown, select Redeems.
MSST3.1.png

  1. Select Re-Fetch Redeems to refresh this menu for a more up-to-date list of your currently available Redeems.
    MSST3.2.png
  2. Enable any redeems you want the selected Shocker(s) to activate with the specified Redeem(s).
    MSST3.3.png
  3. Select the Shockers you want to activate with the specified Redeem.
    MSST3.4.png
  4. Select the Device Setting you want the selected Shocker(s) to use upon activation by the specified Redeem.
    MSST3.5.png
  5. Set your preferred Intensity you want the selected Shocker(s) to use upon activation by the specified Redeem. (Max 100)
    MSST3.6.png
  6. Set the activation Durationfor the selected Shocker(s) to use upon activation by the specified Redeem. (Max 15)
    MSST3.7.png
  7. Enable the Warn? option if you want the selected Shocker(s) to vibrate before emitting a shock.
    MSST3.8.png
  8. Set Select Mode to your preference:
    MSST3.9.png
    • All: All available unpaused Shockers will be selected.
    • Random: A random available unpaused shocker will be selected.
    • Round-Robin: Shockers will be activated in sequential order.
      Example

      When conditions are met, Shocker #1 will be activated, when conditions are met again, Shocker #2 will be activated, and so on.

Subs & Gifted Subs

Important Info

The Subs & Gifted Subs menu allows you to customize how your device(s) react to new Subscriptions and Gifted Subscriptions to your Twitch channel.

What are Subs and Gifted Subs?

A Sub (short for Subscription) is a monthly payment viewers can make to support a streamer and gain access to exclusive perks like ad-free viewing and custom emotes.

A gifted sub is when a viewer purchases a subscription for another viewer in the channel.

Link to Twitch.tv: How to Add Bonus Sub Benefits
Link to Twitch.tv: Local Subscription Pricing Countries
Link to Twitch.tv: Purchasing Gift Subscriptions

At the top of the application, select Stream Tools. From that dropdown, select Subs & Gifted Subs.
MSST4.1.png

Handle Subs As Cheers

Enable the Handle subs as Cheers? option if you want the all subscriptions to be treated as cheers.
MSST4.2.png

Sub to Bits Conversions
  • Tier 1 Sub = 250 Bits
  • Tier 2 Sub = 500 Bits
  • Tier 3 Sub = 1,250 Bits
  • Example: User A gifts 10 Tier 2 Subs, this amount is equal to 5,000 Bits.

Setting Up Tiers

  1. Enable each Subscription Tier you want to trigger the selected Shocker(s).
    MSST4.3.png
  2. Select Shockers for each Tier you have enabled.
    MSST4.4.png
  3. Select the Activation Type (Incremental or Brackets).
    MSST4.5.png

Activation Types

Brackets

Adding And Removing Brackets
  • Select Convert from Bits to a new Bracket based on your Cheers settings to that specific Tier.
    MSST4.6a.png
  • SelectAdd Bracket to add a new Bracket to that specific Tier.
    MSST4.6b.png
  • Select Delete to remove any unwanted Brackets.
    SubBracketDelete.png
Setting Up Brackets

  1. Set the Sub Amount for that specific Tier.
    MSST4.6c.png

  2. Set your preferred Intensity for the selected Shockers within the Bracket. (Max 100)
    MSST4.6d.png

  3. Set the activation Durationfor the selected Shockers within the Bracket. (Max 15)
    MSST4.6e.png

  4. Enable the Warn? option if you want the selected Shocker(s) to vibrate before emitting a shock.
    SubBracketWarn.png

  5. Set Select Mode to your preference:
    SubBracketSelect.png

    • All: All available unpaused Shockers will be selected.
    • Random: A random available unpaused shocker will be selected.
    • Round-Robin: Shockers will be activated in sequential order.
      Example

      When conditions are met, Shocker #1 will be activated, when conditions are met again, Shocker #2 will be activated, and so on.

  6. Select the Device Setting.
    SubBracketDevice.png

    • Shock: The device will emit a shock.
    • Vibrate: The device will vibrate.
    • Beep: The device will emit a beep.

Incremental

  1. Set your preferred baseline Intensity and Max Intensity for the selected Shockers for each Tier. (Max 100)
    MSST4.5a.png

  2. Set the left-most Increment by to increase the intensity of the selected Shockers for each new Sub gained for that specific Tier. (Max 100)
    MSST4.5b.png

  3. Set the baseline activation Duration and Max Duration for each new Sub gained for that specific Tier. (Max 15)
    MSST4.5c.png

  4. Set the right-most Increment by to increase the activation duration for each new Sub gained for that specific Tier. (Max 15)
    MSST4.5d.png

  5. Set Select Mode to your preference:
    MSST4.8.png

    • All: All available unpaused Shockers will be selected.
    • Random: A random available unpaused shocker will be selected.
    • Round-Robin: Shockers will be activated in sequential order.
      Example

      When conditions are met, Shocker #1 will be activated, when conditions are met again, Shocker #2 will be activated, and so on.

  6. Select the Device Setting.
    SubsIncrementalDevice.png

    • Shock: The device will emit a shock.
    • Vibrate: The device will vibrate.
    • Beep: The device will emit a beep.

Hype Train

Important Info

The Hype Train menu allows you to customize how your device(s) react to each level of the Hype Train you gain on your Twitch channel.

What is a Hype Train?

A Hype Train is a community event on Twitch where viewers work together to reach a series of escalating goals by cheering with Bits, subscribing, or gifting subscriptions.

As the Hype Train progresses through levels, everyone in the chat gets access to special emotes and other benefits.

Link to Twitch.tv: Hype Train Guide

At the top of the application, select Stream Tools. From that dropdown, select Hype Train.
MSST5.1.png

On New Level

Important Info

Enabling this option will activate the selected Shocker(s) with each new Hype Train Level.

MSST5.2a.png

  1. Select the Shockers you want to activate on each new Hype Train Level gained.
    MSST5.2b.png
  2. Select the Activation Type (Incremental or Normal).
    MSST5.2c.png

Activation Types

Normal

Important Info

Activates at a set intensity and duration for each new Hype Train Level gained.

  1. Set your preferred Intensity for the selected Shockers. (Max 100)
    MSST5.2e1.png

  2. Set Duration to change the activation duration for each new Hype Train Level gained. (Max 15)
    MSST5.2e2.png

  3. Enable the Warn? option if you want the selected Shocker(s) to vibrate before emitting a shock.
    MSST5.2f.png

  4. Set Select Mode to your preference:
    MSST5.2g.png

    • All: All available unpaused Shockers will be selected.
    • Random: A random available unpaused shocker will be selected.
    • Round-Robin: Shockers will be activated in sequential order.
      Example

      When conditions are met, Shocker #1 will be activated, when conditions are met again, Shocker #2 will be activated, and so on.

  5. Select the Device Setting.
    MSST5.2h.png

    • Shock: The device will emit a shock.
    • Vibrate: The device will vibrate.
    • Beep: The device will emit a beep.

Incremental

Important Info

Intensity and duration will increase with each Hype Train Level.

  1. Set your preferred baseline Intensity and Max Intensity for the selected Shockers. (Max 100)
    MSST5.2d1.png

  2. Set the left-most Increment by to increase the intensity of the selected Shockers for each new Hype Train Level gained. (Max 100)
    MSST5.2d2.png

  3. Set the baseline activation Duration and Max Durationof the selected Shockers for each new Hype Train Level gained. (Max 15)
    MSST5.2d3.png

  4. Set the right-most Increment by to increase the activation duration of the selected Shockers for each new Hype Train Level gained. (Max 15)
    MSST5.2d4.png

  5. Enable the Warn? option if you want the selected Shocker(s) to vibrate before emitting a shock.
    HypeIncrementalWarn.png

  6. Set Select Mode to your preference:
    MSST5.3g.png

    • All: All available unpaused Shockers will be selected.
    • Random: A random available unpaused shocker will be selected.
    • Round-Robin: Shockers will be activated in sequential order.
      Example

      When conditions are met, Shocker #1 will be activated, when conditions are met again, Shocker #2 will be activated, and so on.

  7. Select the Device Setting.
    MSST5.2h.png

    • Shock: The device will emit a shock.
    • Vibrate: The device will vibrate.
    • Beep: The device will emit a beep.

On Train End

Important Info

Enabling this option will activate the selected Shocker(s) when the Hype Train ends.

MSST5.3a.png

  1. Select the Shockers you want to activate each time a Hype Train ends.
    MSST5.3b.png

  2. Set your preferred baseline Intensity and Max Intensity for the selected Shockers. (Max 100)
    MSST5.3c.png

  3. Set Increment by to increase the intensity of the selected Shockers for each Hype Train Level gained before the Hype Train ended. (Max 100)
    MSST5.3d.png

  4. SetDuration Per Level to change the duration extension for each Hype Train Level gained before the Hype Train ended.
    MSST5.3e.png

  5. Enable the Warn? option if you want the selected Shocker(s) to vibrate before emitting a shock.
    MSST5.3f.png

  6. Set Select Mode to your preference:
    MSST5.3g.png

    • All: All available unpaused Shockers will be selected.
    • Random: A random available unpaused shocker will be selected.
    • Round-Robin: Shockers will be activated in sequential order.
      Example

      When conditions are met, Shocker #1 will be activated, when conditions are met again, Shocker #2 will be activated, and so on.

  7. Select the Device Setting.
    MSST5.3h.png

    • Shock: The device will emit a shock.
    • Vibrate: The device will vibrate.
    • Beep: The device will emit a beep.

Follows

Important Info

The Follows menu allows you to customize how your device(s) react to new Follows to your Twitch channel.

What is a Follow?

A Follow on Twitch is when a viewer chooses to follow a streamer's channel, showing their interest in the content and receiving notifications when the streamer goes live.

At the top of the application, select Stream Tools. From that dropdown, select Follows.
MSST6.1.png

Important Info

Enabling this option will activate the selected Shocker(s) with each new Follower to your Twitch channel.

MSST6.2.png

  1. Select the Shockers you want to activate whenever you gain a new Follow.
    MSST6.3.png

  2. Set your preferred Intensity for the selected Shockers. (Max 100)
    MSST6.4.png

  3. Set Duration to change the activation duration for each new new Follow gained. (Max 15)
    MSST6.5.png

  4. Enable the Warn? option if you want the selected Shocker(s) to vibrate before emitting a shock.
    MSST6.6.png

  5. Set Select Mode to your preference:
    MSST6.7.png

    • All: All available unpaused Shockers will be selected.

    • Random: A random available unpaused shocker will be selected.

    • Round-Robin: Shockers will be activated in sequential order.

      Example

      When conditions are met, Shocker #1 will be activated, when conditions are met again, Shocker #2 will be activated, and so on.

  6. Select the Device Setting.
    MSST6.8.png

    • Shock: The device will emit a shock.
    • Vibrate: The device will vibrate.
    • Beep: The device will emit a beep.