# \&meterstyle

General Option! ([`&push`](/advanced-settings/setup-parameters/push.md), [`&room`](/advanced-settings/setup-parameters/room.md), [`&view`](/advanced-settings/mixer-scene-parameters/view.md), [`&scene`](/advanced-settings/mixer-scene-parameters/scene.md), [`&director`](/advanced-settings/director-parameters/director.md))

## Aliases

* `&meter`

## Options

Example: `&meterstyle=3`

<table><thead><tr><th width="218.55474452554745">Value</th><th>Description</th></tr></thead><tbody><tr><td>Default</td><td>a green dot in the right-corner that only shows in the guest / director view</td></tr><tr><td><code>1</code> | (no value given)</td><td>will show the VU-style meter that the director has by default already</td></tr><tr><td><code>2</code></td><td>will show a green-border around the guest's video when they are talking</td></tr><tr><td><code>3</code></td><td>will show a little green dot in the top-right corner when the guest's talking; this is default for the guest's view already</td></tr><tr><td><code>4</code></td><td>no meter is shown, but a data-attribute named <code>data-loudness</code> is applied to the video element. This can be targeted with CSS to do custom styles via OBS browser source or with <a href="/pages/-MZNW5d8bRb7mzFAIouh"><code>&#x26;css</code></a></td></tr><tr><td><code>5</code></td><td>has the audio-only background image pulse larger in size when that specific guest is speaking</td></tr></tbody></table>

<figure><img src="/files/Opv5vcLzNiIUfPq7HHzU" alt=""><figcaption></figcaption></figure>

## Details

If you add this to a director's/guest's URL, it will show an optional audio style type, when a guest is talking.

For guests and directors, there is a default meter style that shows a green dot in the top right for when someone is speaking.

<figure><img src="/files/hfpd3OxB7t6VKKtrv5mI" alt=""><figcaption><p>Default meter style for guests/directors</p></figcaption></figure>

When using any `&meterstyle` effect, I now include a data attribute called `data-speaking` to the video element. It will be either 0, 1, or 2. 0 is quiet, 1 is whispering, and 2 is loud. `&meterstyle=4` includes a fine-grain option already for loudness as an attribute, but for basic CSS needs, this option might be more approachable.

You can use this attribute to use CSS to customize your own effects when someone speaks. You can further target what is CSS used based on a specific guest by using each video's stream ID data attribute as well.

The meter will not appear if audio is not yet playing/active, or is audio-processing is disabled (\&noap). This might be the case with certain mobile devices as well.

### \&meterstyle=2

A common request is a green box around the activer speaker

### ![](/files/O0rOGA2Z0Thb5iMOWwfX)

### \&meterstyle=4

When using `&meterstyle=4` or greater, the background of an audio-only element is transparent now; not black. I also specifically hide the video-control bar when using `&meterstyle=4`, but you can use [`&videocontrols`](/advanced-settings/buttons-and-control-bar-parameters/and-videocontrols.md) to add them back in if needed.

### \&meterstyle=5

It can be used in conjunction with [`&bgimage`](/advanced-settings/design-parameters/and-bgimage.md) to specific a custom background image for the video, which will pulse in size. ie: `&meterstyle=5&bgimage=./media/avatar1.png`

## Related

{% content-ref url="/pages/-MZHeaXqdR9WQuzFCjZc" %}
[\&activespeaker](/advanced-settings/mixer-scene-parameters/activespeaker.md)
{% endcontent-ref %}

{% content-ref url="/pages/-MZX7oiFsDcg\_A1Z-R2M" %}
[\&style](/advanced-settings/design-parameters/style.md)
{% endcontent-ref %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.vdo.ninja/advanced-settings/design-parameters/meterstyle.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.