> For the complete documentation index, see [llms.txt](https://wiki.cdn-perfprod.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.cdn-perfprod.com/v1/must-read/how-it-works.md).

# How it works

{% hint style="warning" %}
**Learn:** we strongly recommend you reading the following so you know how we make this work before continuing to the installation.
{% endhint %}

## :thinking: How it works

***

[<mark style="color:purple;">TTV LOL PRO</mark>](https://github.com/younesaassila/ttv-lol-pro/tree/v1) uses a proxy-based solution to avoid any ads on Twitch. Twitch ads can't be blocked, at all, but can be avoided/bypassed.

Also known as "server-sided" solutions, [<mark style="color:purple;">TTV LOL PRO</mark>](https://github.com/younesaassila/ttv-lol-pro/tree/v1) fully relies on a proxy in an ad-free country for it to avoid any possible Twitch ad.&#x20;

The "[<mark style="color:blue;">TTV LOL</mark>](https://github.com/TTV-LOL/extensions) method" of avoiding ads consists on grabbing the m3u8 file for that specific streamer from a proxy which is hosted in an ad-free country, thus giving you an ad-free playlist.

We avoid in-stream ads, but VODs or banner ads are not handled by the [<mark style="color:purple;">TTV LOL PRO</mark>](https://github.com/younesaassila/ttv-lol-pro/tree/v1) project, as some other amazing projects already do it.&#x20;

[<mark style="color:purple;">uBlock Origin</mark>](https://ublockorigin.com/) can be used alongside [<mark style="color:purple;">TTV LOL PRO</mark>](https://github.com/younesaassila/ttv-lol-pro/tree/v1) to block VOD and banner ads. Here at [<mark style="color:purple;">TTV LOL PRO</mark>](https://github.com/younesaassila/ttv-lol-pro/tree/v1) we strongly encourage users to use [<mark style="color:purple;">uBlock Origin</mark>](https://ublockorigin.com/) alongside [<mark style="color:purple;">TTV LOL PRO</mark>](https://github.com/younesaassila/ttv-lol-pro/tree/v1).

Additionally, you can add the following [<mark style="color:purple;">uBlock Origin</mark>](https://ublockorigin.com/) filter that's maintained by us to remove some stuff that [<mark style="color:purple;">uBlock Origin</mark>](https://ublockorigin.com/) default filters don't: `https://cdn.perfprod.com/static/ttvlolpro-rules.txt`

{% hint style="danger" %}
[<mark style="color:purple;">TTV LOL PRO</mark>](https://github.com/younesaassila/ttv-lol-pro/tree/v1) by default uses the [TTV LOL](https://github.com/TTV-LOL/extensions) API (api.ttv.lol) which has been offline for a few months already, and there's not been any signs of it coming back anytime soon. This means, that a default installation of the extension won't avoid any ads until you add working proxies. More information here: [Proxies](/v1/must-read/proxies.md).
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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/v1/must-read/how-it-works.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.