Ninja Docs
Search
⌃K

&showlabels

Display labels as a video overlay
General Option! (&push, &room, &view, &scene)

Aliases

  • &showlabel
  • &sl

Options

There are some preset style options, which can be passed to the parameter as a value. You can also choose to just edit the label's style with CSS, as discussed lower on this page.
Example: &showlabels=ninjablue
Value
Description
(no value given)
Generic styled display names
fire
Fire looking display names
ninjablue
VDO.Ninja styled display names
skype
Skype styled display names
teams
Microsoft Teams styled display names
toprounded
Rounded display names
zoom
Zoom styled display names

Details

This parameter will display the user's display name or label on screen, as a text overlay. The label can be set either via the URL using the &label parameter, or the room's director can set it dynamically via the "Add a label" option.
This parameter can be used on guest links, view links, or scene links. It will be sticky to each individual video and not the browser window as a whole.
Underscores "_" used in label values will be replaced by spaces, allowing for word separation.
HTML5 Emojis 🎈 and some non-Latin characters are supported.
For example: https://vdo.ninja/?showlabels=fire
If no preset option is passed, a default generic style is used:

Font size customization

You can change the font-size without using CSS, using the &fontsize parameter. CSS is also supported though.
Font-size of labels will adjust slightly based on the window size.

Advanced Customization

CSS of the styles can be set via the OBS browser source stylesheet window. The CSS class name you can customize is called video-label.
An example of how to set a custom CSS style for labels
You can copy the below code, modifying it as you desire, as a starting point. You'll still need to use &showlabels to trigger the labels to display though.
.video-label {
color: red;
bottom: 2vh;
left: 50%;
transform: translateX(-50%);
background: rgba(0, 0, 0, .8);
pointer-events:none;
border-radius: 5px;
font-size: 0.8em;
}
Below is another example, this time we target the video tile class, creating a margin above the video elements. We can then move the display label into that space, creating a label that is not overlaying the video itself, but still attached.
We can paste the CSS code directly into the OBS browser source, or we can host the style in a file and access it via the &css parameter
.tile {
margin-top: 10vh !important;
max-height: 90vh!important;
}
.video-label {
bottom:unset;
top:0;
text-align:middle;
left:unset;
background:unset;
text-shadow : 0 0 10px #035;
font-size: 7vh!important;
}