antitux/clips repository overview

⁠Twitch Clips Player Overlay

⁠What is this?

obs_capture_clipsreel.webm⁠

This is a Twitch Clips Player, browser source overlay for OBS.

This grabs your Twitch clips and plays them one after the other in a loop. Keep your viewers entertained on your BRB or starting soon scenes.

⁠DISCLAIMER:

This project is "AS-IS". It is free to use, clone, fork, modify, make it your own.

Try it here⁠

FEATURES:

• Control the clips from Twitch chat. !clipskip, !clippause, !clipplay, !clipreload. Limited to Mods and Streamer.
• Show clips from channels that you follow. Grabs the most recent 700 channels.
• Use a custom command to start the clips reel and restrict it to Mods only.
• Type "!mycommand stop" in chat to stop the clips player.
• Date Range option: This will grab a clip from within the last 5days, 10day, 30days... If no clips exist, then skip to the next channel.
• Show clip details panel: This will display a panel in the lower third of the overlay that contains details about the clip. This can use variables:{channel},{title},{game},{creator_name},{created_at}.

⁠Notes:

Date range, featured clips: The clips player will try to find and play clips that meet these options first. If no clips are found within these filters, then it will play a clip from the top most popular. Playing any clip is better than not playing a clip at all.

Twitch authentication is now required if you would like to show clips from channels that you follow and/or show a message in chat.

In OBS, set the browser source to: "Shutdown source when not visible" and "Refresh browser when scene becomes active". This will prevent the clips player from playing in the background. It will also reload/refresh the clips player when the source becomes active.

⁠URL Parameters

channel=Your channel name or a comma separated list of channels (user1,user2,user3,user4)

preferFeatured=true/false Only pull featured clips.

showText=true/false Enables the channel name on top of the video.

showDetails=true/false Enables the clips details panel on overlay.

detailsText=string Displays custom details about the clips. Can include {channel},{title},{game},{creator_name},{created_at}.

limit=integer Max number of clips to pull from (max is 100).

dateRange=integer Only pull clips from a specific date range.

command=string Custom command to fire off the clips player. If Not set, clips player will play as soon as the scene is active.

showFollowing=true/false Pulls clips from the latest 100 channels that you are following.

customText=string Displays custom message on top of clips. Can include {channel}.

mainAccount=channel The main channel that you want to send chat messages to.

ref=base64 Access token

themeOption=integer Various pre-made css themes top choose from.

⁠Custom CSS

⁠Optional: Set a fixed video width and height.

Add this to the OBS browser source CSS properties (optional).

video {
    width: 1280px !important;
    height: 720px !important;
    background-color: #000000;
}

#container {
    padding:0;
    margin:0;
}

#details-container {
    top: 44vw;
}