# Options page

{% hint style="info" %}
**Info:** about all the options in the extension's options page. For advanced users only.
{% endhint %}

## :passport\_control: Passport

***

{% hint style="warning" %}
**Important:** increase the slider only if you are seeing ads with the current setting. If you are seeing "Commercial break in progress" ads, increasing the slider will not help.
{% endhint %}

Controls which types of requests are proxied, in which you have three options to choose from: **Ordinary**, **Official** and **Diplomatic**. The Ordinary option is the most proxy-friendly and will have low proxy usage, whilst Official and Diplomatic may use more frequently the proxy, with more traffic.

Depending on if you're using the Proxy ad requests only option or the Proxy all requests option, the Passport proxy usage will vary, with the latter being the most bandwidth/CPU intensive. Below you'll find a table with some information in regards:

### If you're using the Proxy ad requests only option

<table><thead><tr><th width="255">Domain</th><th>Ordinary<select><option value="8pQvMUOg8fbn" label="All" color="blue"></option><option value="wbJuSSVtlWKG" label="Few" color="blue"></option><option value="9vgpLAhasuGy" label="None" color="blue"></option></select></th><th>Official<select><option value="iyNj6HNA2qRX" label="All" color="blue"></option><option value="mNNYCsHkYTcB" label="Few" color="blue"></option><option value="fcHQCfCIccWw" label="None" color="blue"></option></select></th><th>Diplomatic<select><option value="YKzojVUTXHcH" label="All" color="blue"></option><option value="ePZAANOOIsEV" label="Few" color="blue"></option><option value="fPaFW56mao9D" label="None" color="blue"></option><option value="9pLbVKPLYEoh" label="Some" color="blue"></option></select></th></tr></thead><tbody><tr><td>passport.twitch.tv</td><td><span data-option="9vgpLAhasuGy">None</span></td><td><span data-option="iyNj6HNA2qRX">All</span></td><td><span data-option="YKzojVUTXHcH">All</span></td></tr><tr><td>usher.ttvnw.net</td><td><span data-option="8pQvMUOg8fbn">All</span></td><td><span data-option="iyNj6HNA2qRX">All</span></td><td><span data-option="YKzojVUTXHcH">All</span></td></tr><tr><td>video-weaver.*.hls.ttvnw.net</td><td><span data-option="wbJuSSVtlWKG">Few</span></td><td><span data-option="mNNYCsHkYTcB">Few</span></td><td><span data-option="ePZAANOOIsEV">Few</span></td></tr><tr><td>*.playlist.ttvnw.net</td><td><span data-option="wbJuSSVtlWKG">Few</span></td><td><span data-option="mNNYCsHkYTcB">Few</span></td><td><span data-option="ePZAANOOIsEV">Few</span></td></tr><tr><td>*.playlist.live-video.net</td><td><span data-option="wbJuSSVtlWKG">Few</span></td><td><span data-option="mNNYCsHkYTcB">Few</span></td><td><span data-option="ePZAANOOIsEV">Few</span></td></tr><tr><td>gql.twitch.tv</td><td><span data-option="9vgpLAhasuGy">None</span></td><td><span data-option="mNNYCsHkYTcB">Few</span></td><td><span data-option="9pLbVKPLYEoh">Some</span></td></tr><tr><td>www.twitch.tv</td><td><span data-option="9vgpLAhasuGy">None</span></td><td><span data-option="fcHQCfCIccWw">None</span></td><td><span data-option="YKzojVUTXHcH">All</span></td></tr></tbody></table>

### If you're using the Proxy all requests option

<table><thead><tr><th width="254">Domain</th><th>Ordinary<select><option value="5730fRcjWsvk" label="All" color="blue"></option><option value="KJpyFasGMimF" label="None" color="blue"></option><option value="zEmlDoEmx7GR" label="Few" color="blue"></option></select></th><th>Official<select><option value="3cvxs8Zs3uAW" label="All" color="blue"></option><option value="nElq6wOsQaEx" label="None" color="blue"></option><option value="TN1aogp41Mwd" label="Few" color="blue"></option></select></th><th>Diplomatic<select><option value="ut8QF99jTft8" label="All" color="blue"></option><option value="ORbEmgV4tBsn" label="None" color="blue"></option><option value="iS3Y3TnJrJ7N" label="Few" color="blue"></option></select></th></tr></thead><tbody><tr><td>passport.twitch.tv</td><td><span data-option="5730fRcjWsvk">All</span></td><td><span data-option="3cvxs8Zs3uAW">All</span></td><td><span data-option="ut8QF99jTft8">All</span></td></tr><tr><td>usher.ttvnw.net</td><td><span data-option="5730fRcjWsvk">All</span></td><td><span data-option="3cvxs8Zs3uAW">All</span></td><td><span data-option="ut8QF99jTft8">All</span></td></tr><tr><td>video-weaver.*.hls.ttvnw.net</td><td><span data-option="5730fRcjWsvk">All</span></td><td><span data-option="3cvxs8Zs3uAW">All</span></td><td><span data-option="ut8QF99jTft8">All</span></td></tr><tr><td>*.playlist.ttvnw.net</td><td><span data-option="5730fRcjWsvk">All</span></td><td><span data-option="3cvxs8Zs3uAW">All</span></td><td><span data-option="ut8QF99jTft8">All</span></td></tr><tr><td>*.playlist.live-video.net</td><td><span data-option="5730fRcjWsvk">All</span></td><td><span data-option="3cvxs8Zs3uAW">All</span></td><td><span data-option="ut8QF99jTft8">All</span></td></tr><tr><td>gql.twitch.tv</td><td><span data-option="KJpyFasGMimF">None</span></td><td><span data-option="3cvxs8Zs3uAW">All</span></td><td><span data-option="ut8QF99jTft8">All</span></td></tr><tr><td>www.twitch.tv</td><td><span data-option="KJpyFasGMimF">None</span></td><td><span data-option="nElq6wOsQaEx">None</span></td><td><span data-option="ut8QF99jTft8">All</span></td></tr></tbody></table>

## :bust\_in\_silhouette: Anonymous mode

***

Watch streams as if you were logged out. This option might help reduce the number of "Commercial break in progress" ads.

To make this work, we remove certain user identifiable headers from some requests to Twitch, but we try not to break anything, so please report us any issues with this option enabled at our [official-links](https://wiki.cdn-perfprod.com/information/official-links "mention").&#x20;

Drops should work just fine, same applies to Channel Points and others, however there's been some reports lately of Drops not working due to some Twitch "feature" update, so if you're in this situation, you may have to disable it.

## :white\_heart: Whitelisted channels

***

{% hint style="warning" %}
**For Chromium users:** whitelisting will only work when all opened Twitch tabs are whitelisted channels
{% endhint %}

Support your favorite content creators by whitelisting their channels. You can manually add channels there and once the extension detects that you're on that specific channel, any sort of proxying to that stream will be disabled.

## :desktop: Proxies

***

Add proxies for the extension to bypass/avoid Twitch ads. Proxies **must be HTTP** and other protocols such as HTTPS, SOCKS4, SOCKS5, ... are not compatible.

You can add proxies in the **Primary** or the **Fallback** field. Each time you restart your browser, by default, the first proxy in the list will be selected for proxying Twitch traffic. If a request fails to that specific proxy server, it will try proxying to the second one, and so on. This does not mean that each request will be tested with the first server always, but if the first server fails, it will be deemed as dead by the browser and will only proxy on the working one until you restart your browser, or TTV LOL PRO stops managing the browser's Proxy settings.

{% hint style="warning" %}
Proxy fallback is handled by the browser itself, and we have no control over it, so it may behave differently on Firefox than on Chromium-based browsers.
{% endhint %}

If there are no proxies available to use due to them being dead or not adding any to the list, the browser will just not proxy any traffic and the following banner will be shown in the extension's dropdown page.

<figure><img src="https://3089871892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fw0DtUs3tWZJZTa0QKQCG%2Fuploads%2FjWxbGdPl0KCZ3DYf1r42%2Fimage.png?alt=media&#x26;token=514dcfc2-1da4-4707-bee1-b7a4ab0f8654" alt=""><figcaption></figcaption></figure>

Well, now that we know how proxies will be handled by the extension, let's explain the differences between Proxy ad requests only and Proxy all requests.

Take a look at the following table to know which traffic and how much of it is getting proxied depending on the option you choose: [#passport](#passport "mention").

### Proxy ad requests only

{% hint style="success" %}
**Recommended:** option to use by default if it works fine for you, but may be less reliable.
{% endhint %}

By default, the option Proxy ad requests only will be selected, which means that fewer packets will be proxied to the server, thus less bandwidth/CPU will be used on the server's side.&#x20;

This option kinda "exploits" a bug in how Twitch serves ads, which means that it could get patched at any time. Nonetheless, newer versions of the extension (2.3 and above) have huge improvements to this proxying option and are way more reliable.

As we're not actively proxying weaver requests, Twitch will reassign you to your closest weaver server possible (despite the proxy's location) after a few minutes have passed from the proxied requests. This also means that you'll get reassigned again to your proxy's closest Twitch streaming server when a midroll is intercepted by TTV LOL PRO, or switch between streamers.&#x20;

As we've not actively experimented with this, we can't certainly say if latency to the streamer is affected by using this option or the Proxy all requests option. If anyone wants to experiment with this, we would appreciate some feedback at our [official-links](https://wiki.cdn-perfprod.com/information/official-links "mention").

### Proxy all requests

{% hint style="warning" %}
**Recommended:** option to use if you don't have very limited CPU/bandwidth allocations and want a more consistent and reliable stream.
{% endhint %}

This proxying option is opt-in by default. This proxying mechanism, by design, uses more CPU and Bandwidth on the server's side as (primarily) we're constantly proxying weaver requests without applying any algorithm to check whether we should proxy that request or not, as we don't need to proxy most of them.

This option is more consistent and reliable because you'll always be assigned to the same Twitch streaming server, which means that your latency to the broadcaster will be consistent and will not vary depending on if TTV LOL PRO needs to intercept an ad or not.

{% hint style="warning" %}
**Important:** this option is always more consistent and reliable whenever your proxy server has good connectivity to you and to Twitch's streaming servers, which most of them do.
{% endhint %}

## :scroll: Ad log

***

{% hint style="danger" %}
**This option is only available for the Firefox version of the extension**
{% endhint %}

By default, this ad log will be enabled, which means that TTV LOL PRO will log all ads (only on your computer) that did not get bypassed/avoided for debugging purposes only.&#x20;

Do keep in mind that entries are automatically removed after 7 days, on the client-side (Extension) and on the server-side (Where it gets logged if you opt to send the ad log to the developer).

You may opt into sending the ad log to the developer if you'd like, in which case we periodically check them to ensure that there are no issues with the extension. You can also export the ad log as a JSON file or clear the ad log, but keep in mind that all logs sent to the developer are not removed with this button, but automatically removed every week.

{% hint style="success" %}
**We don't log any sort of information that may identify the user who sent it, at all.** We only log the following information:

* **adType:** preroll/midroll
* **isPurpleScreen:** false/true
* **proxy:** "your proxy address" (stripped when sending ad log to the developer) or null
* **channel:** "channel name"
* **passportLevel:** 0, 1 or 2
* **anonymousMode:** false/true
* **timestamp:** timestamp
* **videoWeaverHost:** "video-weaver.$.hls.ttvnw\.net" or "$.playlist.ttvnw\.net" or "$.playlist.live-video.net"
* **videoWeaverUrl:** "like above, but the m3u8 file itself"
  {% endhint %}


---

# 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://wiki.cdn-perfprod.com/advanced/options-page.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.