Your self hosted service for twitch web-based overlays and custom bot with Laravel.

0.7.0 2022-01-05 15:43 UTC


Latest Version on Packagist Total Downloads

OpenOverlay is a self-hosted service for your web-based twitch overlays and bot. This Laravel package helps you to receive all twitch events actions while you streaming and show them on your overlay. Also, you can develop your own bot with simple and advanced commands.

If you want to start from scratch with your overlay we have an example project. Standalone-Version: redbeed/OpenOverlay-Standalone


Via Composer

$ composer require redbeed/openoverlay


Add laravel config for OpenOverlay

php artisan vendor:publish --provider="Redbeed\OpenOverlay\OpenOverlayServiceProvider"

Migrate User Connections & Twitch Event table

php artisan migrate

Add configuration to config/services.php

'twitch' => [    
  'client_id' => env('TWITCH_CLIENT_ID'),  
  'client_secret' => env('TWITCH_CLIENT_SECRET'),  
  'redirect' => env('TWITCH_REDIRECT_URI') 

Thanks to SocialiteProviders/Twitch

Add ENV Keys




Add UserOpenOverlay trait to User.php


namespace App\Models;

use \Redbeed\OpenOverlay\Models\User\UserOpenOverlay;

class User extends Authenticatable
    use ...
    use UserOpenOverlay;

Add Callback URLs to your Twitch App


Generate APP Token

To subscribe the Twitch-EventSub you need to generate an App-Token.

  1. First you need to enable the "app token routes" in the openoverlay.php config.

    return [
        'webhook' => [
            'twitch' => [
                'app_token' => [
                    'regenerate' => true,

    Set regenerate to true.

  2. Open ${APP_URL}/connection/app-token/redirect with your laravel-app.

  3. Login into your Twitch-Developer account with your Twitch Application.

  4. Copy the App-Token and use it as value for your OVERLAY_TWITCH_APP_TOKEN ENV value.

Add Bot

To add a bot you need to link your app with the bot twitch account.

  1. Open ${APP_URL}/connection/bot/redirect with your laravel-app.
  2. Login into your Twitch-Bot account with your Twitch Application.
  3. After redirect you need to manually connect your laravel-Account with a bot.
  4. Open Your Database table "bot_connections" and connect your bot with your user.
  5. Restart the Bot Artisan Bot

Generate Secret

To validate each Twitch call you need to generate a secret for your app. If you change the OVERLAY_SECRET you need to subscribe each event again.

php artisan overlay:secret

Send Fake Events

You can send "Fake" Events while developing or testing an overlay.

php artisan {TwitchUserId} {EventType}
php artisan 1337 channel.follow

Change log

Please see the changelog for more information on what has changed recently.


$ composer test


Please see for details and a todolist.


If you discover any security related issues, please email author email instead of using the issue tracker.



license. Please see the license file for more information.