Installation tutorial · Scene Workshop
Your pack set up in OBS or Streamlabs, step by step.
Example with the free look, Wave. The TUTORIEL.html inside your own pack's ZIP names your own files. Pick your software: every instruction follows.
- 14scenes
- 4separate elements
- 18fixed visuals
- 7alert types
- 43steps
Chapter 00
Before you start
Everything runs on your computer: nothing is sent anywhere, the pages work without a connection. Here is what the folder contains.
scenes/14 pages, one per scene and per look
- onde-demarrage.html
- onde-pause.html
- onde-intermission.html
- onde-fin.html
- onde-hors-ligne.html
- onde-en-jeu.html
- onde-just-chatting.html
- onde-webcam.html
- onde-chat.html
- onde-tiers-inferieur.html
- onde-transition.html
- onde-alerte.html
- onde-objectif.html
- onde-planning.html
- elements/the separate elements, one folder per look
onde/Wave
- bandeau.html
- reseaux.html
- logo-et-nom.html
- tiers-inferieur.html
- visuels/Twitch panels, offline screen, icons
onde/Wave
- panneau-a-propos.jpg
- panneau-regles.jpg
- panneau-reseaux.jpg
- panneau-planning.jpg
- panneau-equipement.jpg
- panneau-don.jpg
- panneau-discord.jpg
- panneau-faq.jpg
- ecran-hors-ligne.jpg
- icone-twitch.png
- icone-youtube.png
- icone-instagram.png
- icone-tiktok.png
- icone-x.png
- icone-discord.png
- icone-kick.png
- icone-facebook.png
- icone-site.png
alertes/the alerts for the Streamlabs Alert Box
- apercu.html
- source-navigateur.html
- streamlabs/
- LISEZMOI.txt
polices/5 fonts used by the pages
- montserrat-latin-wght-normal.woff2
- barlow-latin-600-normal.woff2
- saira-latin-wdth-normal.woff2
- barlow-latin-500-normal.woff2
- barlow-latin-700-normal.woff2
- LISEZMOI.txtthe same guide, as plain text
- LICENCE.txtwhat you can do with this pack
- TUTORIEL.htmlthis tutorial, with your pack's files
Unzip into a folder that will not move
On Windows: right-click the ZIP, “Extract All”, then pick a stable folder, for example
Documents\Stream. Always work from the unzipped folder, never from inside the ZIP.Why it must not move
Each source in your software points to a file in this folder, by its full path on your drive. If you move or rename the folder, the source can no longer find its page and stays empty: you will have to redo the path of every source (see the Troubleshooting chapter).
Keep the structure as it is
The
polices/folder must stay next toscenes/, and two levels aboveelements/onde/, as in the ZIP. Don't take a page out of the folder on its own: the text would change font.Check in your browser
Double-click
scenes/onde-demarrage.html: the scene opens in your browser and moves. The folder is ready. Then pick your software at the top of the page: every instruction follows that choice.
Chapter 01
Add a full-screen scene
Starting, break, intermission, ending, offline and schedule: 1920 x 1080 pages that cover the whole screen. They all go in the same way, one scene each.
| File | Size | What it is | Example setting |
|---|---|---|---|
scenes/onde-demarrage.html | 1920 x 1080 | Starting. Before the stream. Countdown to an exact time. | ?cible=2026-11-02T20:00 |
scenes/onde-pause.html | 1920 x 1080 | Break. “Be right back”. Timer in minutes. | ?duree=5 |
scenes/onde-intermission.html | 1920 x 1080 | Intermission. Camera, chat and timer during a longer break. | ?duree=10 |
scenes/onde-fin.html | 1920 x 1080 | Ending. “Thanks for watching” and your social links. | |
scenes/onde-hors-ligne.html | 1920 x 1080 | Offline. Next stream and social links, for the offline screen. | |
scenes/onde-planning.html | 1920 x 1080 | Schedule. The week in seven animated boxes. | ?lundi=21:00 Ranked;mercredi=20:00 Discovery |
Create one scene per screen
In the “Scenes” panel, click
+, name the scene (for example “Starting”) and confirm.OBS StudioScenes- Starting
- In game
- Just chatting
+−Sources- Game Capture
- Webcam
+−⚙Audio MixerStreamlabs DesktopScenes+- Starting
- In game
- Just chatting
Sources+- Game Capture
- Webcam
Add a browser source
With the scene selected, click
+in “Sources” and choose “Browser”. Give it a name, then OK.With the scene selected, click+(Add Source) in “Sources”, choose “Browser Source”, then “Add Source”. Name it and confirm.OBS StudioScenes- Starting
- In game
- Just chatting
+−Sources- Game Capture
- Webcam
+−⚙Audio MixerStreamlabs DesktopScenes+- Starting
- In game
- Just chatting
Sources+- Game Capture
- Webcam
OBS StudioStreamlabs DesktopAdd SourceGame CaptureBrowser SourceImageMedia FileAdd SourcePick the screen's file
Tick “Local file”, click “Browse” and pick
scenes/onde-demarrage.html(or the page of the screen you want, see the table).If the “Local file” option does not appear, paste the full address in the “URL” field (chapter 04).
Properties · OBS StudioLocal fileLocal file…/scenes/onde-demarrage.htmlBrowseWidth1920Height1080Shutdown source when not visibleRefresh browser when scene becomes activeCancelOKProperties · Streamlabs DesktopLocal fileLocal file…/scenes/onde-demarrage.htmlBrowseWidth1920Height1080Shutdown source when not visibleRefresh browser when scene becomes activeCancelOKWidth 1920, height 1080
The screens are all 1920 x 1080. A source at the right size stays sharp: the page adapts to the size you give it.
The useful options
- Tick “Refresh browser when scene becomes active”“Refresh browser when scene becomes active”: the entrance animation replays each time.
- Leave “Shutdown source when not visible” unticked for the screens, ticked for the alerts if you want them to replay.
- Leave the custom CSS field as it is: the pages already have a transparent background where needed.
Confirm and fit the source
Confirm. If the source does not fill the screen: right-click the source, “Transform”, “Fit to screen”.Confirm, then fit the source to the screen if needed (right-click the source, transform menu).
Repeat for each screen
Same thing for
onde-pause.html,onde-intermission.html,onde-fin.html,onde-hors-ligne.html,onde-planning.html. The starting screen counts down to the stream time, the break and the intermission count minutes: these settings go in the address (chapter 04).
Chapter 02
In game, just chatting and overlays
These pages go on top of your game capture and your camera. Their background is transparent or cut out: the order of the sources does everything.
| File | Size | What it is | Example setting |
|---|---|---|---|
scenes/onde-en-jeu.html | 1920 x 1080 | In game. Webcam frame and banner on top of your game capture. Transparent center. | |
scenes/onde-just-chatting.html | 1920 x 1080 | Just chatting. Big camera and chat area, semi-transparent background. | |
scenes/onde-webcam.html | 1000 x 660 | Webcam only. The webcam frame on its own, to place over your webcam. | |
scenes/onde-chat.html | 560 x 900 | Chat box. Chat decoration, transparent background, reserved message area. | |
scenes/onde-tiers-inferieur.html | 1920 x 1080 | Lower third. Name and title sliding in at the bottom of the screen. | ?nom=Kestrel&titre=Tonight's guest |
scenes/onde-transition.html | 1920 x 1080 | Transition. Animated curtain that covers the screen, then pulls back. | ?boucle |
scenes/onde-alerte.html | 1920 x 1080 | Alert. Animated card played on load. | ?type=follow&nom=Kestrel |
scenes/onde-objectif.html | 1000 x 200 | Goal bar. Animated gauge. | ?titre=Follower goal&actuel=37&cible=50 |
The in-game scene
Add your game capture and your webcam
In your in-game scene, add your game capture (“Game Capture”) and your webcam (“Video Capture Device”), as usual.
Add the in-game page on top
scenes/onde-en-jeu.htmlas a browser source, 1920 x 1080, as in chapter 01. Drag it to the very top of the source list: the highest one is in front. Its center is transparent.onde-en-jeu.htmlfront- Webcam
- Game Captureback
In the source list, the highest one is in front. Place your webcam under the frame
Recommended spot: position 56, 650, size 480 x 270.
Right-click the webcam, “Transform”, “Edit Transform”, then Position 56 and 650, Size 480 x 270.Drag the webcam under the frame and adjust its size with its handles, until it fills the opening.
Webcam56, 650 · 480 x 270BannerCoordinates in pixels, on a 1920 x 1080 screen.
Just chatting and intermission
Add the page and your webcam under it
scenes/onde-just-chatting.html(orscenes/onde-intermission.html) at 1920 x 1080. Your webcam goes under the page, at 80, 190, size 1200 x 675: the page background is cut out at that spot.- Your chat sourcefront
onde-just-chatting.html- Webcamback
The chat box
The chat area is reserved on the right: 500 x 675 at 1340, 190 (500 x 400 in the intermission, the timer is below). Put your chat source on top of the page, in that area: for example the free Aghenor.TV chat widget (your username goes in its address with
?channel=your_username), or the Streamlabs Chat Box widget.Webcam80, 190 · 1200 x 675Chat1340, 190 · 500 x 675BannerCoordinates in pixels, on a 1920 x 1080 screen.
The other overlays
The webcam frame and the chat box on their own
For your own layouts:
scenes/onde-webcam.html(1000 x 660) goes over your webcam, andscenes/onde-chat.html(560 x 900) is a chat decoration with a transparent background. At their original size, the chat box's message area is 500 x 720 at 30, 100: your chat source goes on top of it.The lower third
scenes/onde-tiers-inferieur.htmlat 1920 x 1080, at the very top of the sources. It shows your name and your tagline; for a guest, add?nom=Kestrel&titre=Tonight's guestto the address, and&boucleto make it enter and exit in a loop.The transition
scenes/onde-transition.htmlis not a stinger video: add it at the very top of the arrival scene, at 1920 x 1080, with “Refresh browser when scene becomes active”“Refresh browser when scene becomes active” ticked. It covers the screen on arrival, then pulls back. Add it to every scene where you want to see it.Alerts and goal: at the very top
The alerts, the goal bar (
scenes/onde-objectif.html, 1000 x 200, place it wherever you want), the lower third and the transition go above everything else. Alerts have their own chapter (05).
Chapter 03
The separate elements
The full-screen scenes stay in scenes/. The elements take pieces of the overlays, with the same look and the same animations, but each one in its own source, at its own size: you place them in your scene wherever you want.
| File | Size | What it is | Example setting |
|---|---|---|---|
elements/onde/bandeau.html | 1920 x 140 | Info banner. The banner of the In game and Just chatting scenes, on its own: logo, scrolling social links, tagline and time. | |
elements/onde/reseaux.html | 760 x 120 | Social block. Your social links, one by one, in the look's plate. | |
elements/onde/logo-et-nom.html | 1100 x 180 | Logo and name. Your logo and your name, as they enter on the screens. | |
elements/onde/tiers-inferieur.html | 1640 x 300 | Lower third only. The lower third at its own size, to place wherever you want. | ?nom=Kestrel&titre=Tonight's guest |
The webcam frame and the chat box are already separate sources: scenes/onde-webcam.html (1000 x 660) and scenes/onde-chat.html (560 x 900).
Add the element
“Sources”,
+, “Browser”.+, “Browser Source”. Tick “Local file” and pick the page inelements/onde/.Give it its exact size
Width and height of the element (table above), then confirm. Also tick “Refresh browser when scene becomes active”“Refresh browser when scene becomes active” to replay the entrance.
Place it, enlarge it without blur
Drag the source where you want it. To make it bigger without blur, change the width and the height in the source properties rather than pulling a corner, keeping the same proportions: the page adapts. Pulling a corner stretches an image that is already drawn.
Example:
elements/onde/tiers-inferieur.htmlgoes from 1640 x 300 to 2460 x 450 to be one and a half times bigger.Pulling a corner
Your usernameSettle in, we're on our way.Stretched image: blurry.
Width / Height
Your usernameSettle in, we're on our way.1640 x 300 becomes 2460 x 450: sharp.
Crop with the Alt key
In the OBSStreamlabs preview, hold Alt and drag an edge of the source: you crop instead of resizing. Handy to keep only part of the banner.
AltYour username
Chapter 04
Settings in the address
Some pages read settings at the end of their address: the start time, a timer, a guest's name, an alert. Here are all the ones they recognize.
Untick “Local file”
The “Local file” box does not allow settings. In the source properties, untick it: the “URL” field appears.
Paste the full address
It starts with file:/// followed by the file path, with forward slashes, then the settings after the question mark:
file:///C:/Users/you/Documents/Stream/scenes/onde-demarrage.html?cible=2026-11-02T20:00The builder below makes it for you. Confirm: the page reads its settings again at each load.
The address builder
Paste your folder path (from the File Explorer address bar), pick the page, set it up: the address updates. Nothing leaves this page.
| Setting | Pages | What it does | Example |
|---|---|---|---|
cible | onde-demarrage.html | Countdown to an exact time, in your local time, in the YYYY-MM-DDTHH:MM format. | ?cible=2026-11-02T20:00 |
duree | onde-pause.html, onde-intermission.html | Timer, in minutes. | ?duree=10 |
nom, titre | onde-tiers-inferieur.html, elements/onde/tiers-inferieur.html | Lower third texts. | ?nom=Kestrel&titre=Tonight's guest |
type, nom, montant | onde-alerte.html | The alert: type follow, sub, don, raid or bits, the username, and an amount that rolls up to its value. | ?type=follow&nom=Kestrel&montant=42 |
titre, actuel, cible | onde-objectif.html | The goal bar. | ?titre=Follower goal&actuel=37&cible=50 |
lundi, mardi, mercredi, jeudi, vendredi, samedi, dimanche | onde-planning.html | The schedule. Days you do not give keep those of the pack. Separate days with & or ;. | ?lundi=21:00 Ranked;mercredi=20:00 Discovery |
boucle | onde-tiers-inferieur.html, onde-alerte.html, onde-transition.html | Replays in a loop (the transition every 4 seconds, handy for testing). | ?boucle |
type, nom, montant, message, boucle, figer | alertes/source-navigateur.html | The test alert of the Streamlabs alerts: type follow, sub, resub, don, bits, raid or host; figer keeps it on screen. | ?type=raid&nom=Kestrel&montant=42 |
Spaces go through as they are; if they cause trouble, replace them with %20. The parameter names stay in French: cible = target, duree = duration, nom = name, titre = title, actuel = current, montant = amount, boucle = loop, figer = freeze, and the days lundi, mardi, mercredi, jeudi, vendredi, samedi, dimanche.
Chapter 05
The alerts
Animated alerts in your look: follow, subscription, resub, donation, bits, raid and host. Only the Streamlabs Alert Box receives your channel's real events.
Open the Alert Box
Go to streamlabs.com, log in, then Widgets (or “All widgets”) > Alert Box. Open the alert type you want.
Turn on custom code
Scroll down to “Custom HTML/CSS” (or the Custom Code tab) and turn it on.
streamlabs.comstreamlabs.com · Alert Box- Follows
- Subscriptions
- Donations
- Bits
- Raids
Custom HTML/CSSHTMLCSSJSAlert Duration7Text Delay0Save SettingsThe settings keep their Streamlabs names. Paste the three files
HTML tab: delete everything, paste the contents of
alertes/streamlabs/<type>/html.txtfor the same type. CSS tab: delete everything, pastecss.txt. JS tab: delete everything, pastejs.txt. The CSS is the same for all seven types (fonts included).The alert types and their folders Type Folder In the Alert Box Follow alertes/streamlabs/follow/Follows Subscription alertes/streamlabs/sub/Subscriptions Resub alertes/streamlabs/resub/Resubs (or the resub variant in Subscriptions, depending on your version) Donation alertes/streamlabs/don/Donations (or Tips) Bits alertes/streamlabs/bits/Bits (Cheers) Raid alertes/streamlabs/raid/Raids Host alertes/streamlabs/host/Hosts Set the duration and the rest
- Alert duration (Alert Duration): 7 seconds. If you pick another one, also change data-duree in the HTML (in milliseconds: 7 s = 7000).
- Text delay (Text Delay): 0. Streamlabs entrance and exit animation: a simple fade, or none. The alerts already have their own.
- Alert image: leave it empty (the type's icon shows), or upload your logo: it replaces the icon. The sound is up to you.
Save and test
Save Settings, then “Test Follow” (or Test Sub, Test Donation...). To see each type right away, open
alertes/apercu.htmlin your browser.Show the Alert Box in OBSStreamlabs
On the Alert Box page, copy the widget address (Widget URL). In OBS, add a “Browser” source, untick “Local file” and paste that address in “URL”, 1920 x 1080.In Streamlabs Desktop,
+in “Sources”, then the “Alert Box” widget: it is linked to your account. Put it at the very top of the sources. If your source is not the size of your screen, the alert scales by itself.Without Streamlabs: for testing
alertes/source-navigateur.htmlplays a test alert on load (“Browser” source, local file, 1920 x 1080), andscenes/onde-alerte.htmldoes the same in the style of the scenes. Neither one receives your channel's real events: without an alerts service, they are only for testing the look or playing an alert by hand.
Hosting no longer exists on Twitch since 2022: its folder is only useful if your platform or your version of Streamlabs still offers it. Streamlabs tokens and containers can change: if something is missing, run a test again from Streamlabs.
Chapter 06
The fixed visuals
Drawn in the colors and the font of your pack, with your texts, in the language of the scenes: Twitch panels, offline screen, social icons.
The Twitch panels
640 x 320 (Twitch shows them 320 wide, the double stays sharp), in
visuels/onde/. On your Twitch channel, About tab: turn on “Edit Panels”, add an image panel, upload the image, then add the link and the text below it.Aboutpanneau-a-propos.jpgChat rulespanneau-regles.jpgSocialspanneau-reseaux.jpgSchedulepanneau-planning.jpgGearpanneau-equipement.jpgSupportpanneau-don.jpgDiscordpanneau-discord.jpgFAQpanneau-faq.jpgThe real images are drawn with your font and your look. The offline screen
visuels/onde/ecran-hors-ligne.jpg, 1920 x 1080. On Twitch, it is set in the channel settings (video player banner). In OBSStreamlabs, you can also add it as an “Image” source.The social icons
128 x 128, transparent background:
icone-twitch.png,icone-youtube.png,icone-instagram.png,icone-tiktok.png,icone-x.png,icone-discord.png,icone-kick.png,icone-facebook.png,icone-site.png. These are generic pictograms (no brand logo): place them in OBSStreamlabs (“Image” source) or on your panels.
Chapter 07
Organize and switch scenes
One scene per moment of the stream, the same sources in the same order: you switch scenes without thinking about it.
| Scene | Sources, top to bottom |
|---|---|
| Starting | onde-demarrage.html |
| In game | onde-tiers-inferieur.html, Alert Box, onde-en-jeu.html, Webcam, Game Capture |
| Just chatting | your chat source, onde-just-chatting.html, Webcam |
| Break | onde-pause.html |
| Intermission | your chat source, onde-intermission.html, Webcam |
| Ending | onde-fin.html |
This is an example: add onde-transition.html at the top of each arrival scene if you want the curtain.
Switch scenes with one click
Click the scene in the “Scenes” panel. Studio Mode shows you the next scene before sending it live.
Keyboard shortcuts
In the OBS settings, Hotkeys section: each scene has its own line to switch to it. Click in the field and press the key you want.In the Streamlabs Desktop settings, Hotkeys section: one key per scene, in the scenes part.
Keyboard (example)
F1StartingF2In gameF3Just chattingF4BreakStream Deck
StartingIn gameJust chattingBreakIntermissionEndingThe keys are an example: pick the ones that suit you. With a Stream Deck
The Stream Deck app offers actions for OBSStreamlabs, including switching scenes: drag the action onto a key and pick the scene.
The transition between scenes
Keep your software's transition short, a quick fade or a clean cut:
onde-transition.html, at the top of the arrival scene, does the curtain.What about automatic switching?
The pages in this pack do not switch scenes on their own. Scenes that switch on their own are another Aghenor.TV service: they go through the Streamlabs API, and the OBS version, through obs-websocket, is in the works. How it works.
Keep your setup safe
Once everything is in place, export your scene collection from the OBS scene collection menu: you get it back after a reinstall.Streamlabs Desktop keeps your scenes in scene collections. In any case, keep the pack folder in the same place: the source paths point to it.
Edit or update your pack
- Reopen the Scene Workshop. In the TUTORIEL.html of your own pack, a link reopens it directly with your settings. The logo is not in it: add it again.
- Change the colors, the texts or the look, then download the new ZIP.
- Unzip the new ZIP over your current folder, replacing the files. The files keep the same names and the same places: your OBSStreamlabs sources stay connected, nothing to set up again.
If a scene still shows the old version, refresh the source: open its properties and confirm, or hide it and show it again.
Chapter 08
Troubleshooting
The most common problems, and how to fix them.
The text is in the wrong font
The polices/ folder is no longer next to scenes/, or the page was taken out of the folder. Put the ZIP structure back, then refresh the source. The pages in elements/onde/ look for the fonts two levels up.
The source stays empty, black or white
The path no longer leads to the file: folder moved or renamed, or address mistyped. Open the source properties and pick the file again, or fix the address (file:/// then the path with forward slashes). Also check that the width and height are not zero.
To find where the problem comes from, double-click the file: if it works in your browser, it is the source that needs fixing. If all your browser sources stay black in OBS, try changing the browser source hardware acceleration option (in the OBS advanced settings), then restart OBS.
The animation does not replay, the page does not update
Tick “Refresh browser when scene becomes active”“Refresh browser when scene becomes active”. After replacing files, use the cache refresh button in the source properties (Refresh cache of current page).
The countdown does not show
Without a valid setting, the starting screen shows its waiting text instead of the countdown. Check that “Local file” is unticked, that the address ends with ?cible= and that the time follows the YYYY-MM-DDTHH:MM format. A time already passed shows the end-of-countdown message.
The address settings are ignored
The “Local file” box is ticked: it does not keep what follows the question mark. Untick it and paste the full address in “URL” (chapter 04).
Streamlabs does not show “Local file”
Paste the full address in the “URL” field: the builder in chapter 04 prepares it.
Things lag during the stream
Each browser source is a small browser. Keep only the useful sources in each scene, give them the intended size (no bigger), and close the previews open in your browser during the stream.
If your system asks for less motion, the backgrounds freeze and the entrances become simple fades.
Updating the pack
Go back to the Scene Workshop, make your pack again with the same looks and unzip it into the same folder, replacing the files: the names do not change, your sources keep working. Then refresh each source. Another look gives other file names: you then have to pick the new pages.
You're all set.
To change the colors, the texts or the look, go back to the Scene Workshop and download a new pack. The folder's LISEZMOI.txt has this tutorial as plain text.
The Scene Workshop