TwitchAdSolutions/README.md

# TwitchAdSolutions

This repo aims to provide multiple solutions for blocking Twitch ads.

**Don't combine Twitch specific ad blockers.**

## Recommendations

Proxies are the most reliable way of avoiding ads ([buffering / downtime info](full-list.md#proxy-issues)).

- `TTV LOL` - [chrome](https://chrome.google.com/webstore/detail/ttv-lol/ofbbahodfeppoklmgjiokgfdgcndngjm) / [firefox](https://addons.mozilla.org/en-US/firefox/addon/ttv-lol/) / [code](https://github.com/TTV-LOL/extensions)

Alternatively:

- `Video Ad-Block, for Twitch` (fork) - [chrome](https://chrome.google.com/webstore/detail/twitch-adblock/ljhnljhabgjcihjoihakgdiicdjncpkd) / [firefox](https://addons.mozilla.org/en-US/firefox/addon/twitch-adblock/) / [code](https://github.com/cleanlock/VideoAdBlockForTwitch)
- `Alternate Player for Twitch.tv` - [chrome](https://chrome.google.com/webstore/detail/alternate-player-for-twit/bhplkbgoehhhddaoolmakpocnenplmhf) / [firefox](https://addons.mozilla.org/en-US/firefox/addon/twitch_5/)
- `Purple AdBlock` - [chrome](https://chrome.google.com/webstore/detail/purple-adblock/lkgcfobnmghhbhgekffaadadhmeoindg) / [firefox](https://addons.mozilla.org/en-US/firefox/addon/purpleadblock/) / [code](https://github.com/arthurbolsoni/Purple-adblock/)
- `ttv-ublock` - [chrome](https://chrome.google.com/webstore/detail/ttv-ad-block/kndhknfnihidhcfnaacnndbolonbimai) / [firefox](https://addons.mozilla.org/en-US/firefox/addon/ttv-adblock/) / [code](https://github.com/odensc/ttv-ublock)
- `vaft` - see below

[Read this for a full list and descriptions.](full-list.md)

## Scripts

**There are better / easier to use methods in the above recommendations.**

- vaft - [ublock](https://github.com/pixeltris/TwitchAdSolutions/raw/master/vaft/vaft-ublock-origin.js) / [userscript](https://github.com/pixeltris/TwitchAdSolutions/raw/master/vaft/vaft.user.js) / [ublock (permalink)](https://github.com/pixeltris/TwitchAdSolutions/raw/e80025cbd1eef78f3c609eaff8d5f934abcc9cf8/vaft/vaft-ublock-origin.js)
  - `Video Ad-Block, for Twitch` (fork) as a script.
  - *If the ad-free stream fails you'll see an adblocker warning. For more info see [#89](https://github.com/pixeltris/TwitchAdSolutions/issues/89).*

*For the sake of security it's recommended to use a permalink when using uBlock Origin (permalinks do not auto update).*

## Applying a script (uBlock Origin)

- Navigate to the uBlock Origin Dashboard (the extension options)
- Under the `My filters` tab add `twitch.tv##+js(twitch-videoad)`.
- Under the `Settings` tab, enable `I am an advanced user`, then click the cog that appears. Modify the value of `userResourcesLocation` from `unset` to the full url of the solution you wish to use (if a url is already in use, add a space after the existing url). e.g. `userResourcesLocation https://github.com/pixeltris/TwitchAdSolutions/raw/master/vaft/vaft-ublock-origin.js` 
- To ensure uBlock Origin loads the script I recommend that you disable/enable the uBlock Origin extension (or restart your browser).

*To stop using a script remove the filter and make the url `unset`.*

## Applying a script (userscript)

- Viewing one of the userscript files should prompt the given script to be added.
Initial implementations 2020-12-22 19:43:13 +01:00			`# TwitchAdSolutions`

			`This repo aims to provide multiple solutions for blocking Twitch ads.`

Fix broken site functionality #50 #45 2021-10-14 15:36:13 +02:00			`Don't combine Twitch specific ad blockers.`

Add recommendations 2020-12-29 15:17:38 +01:00			`## Recommendations`

Info about proxy buffering / downtime issues 2021-07-04 17:08:20 +02:00			`Proxies are the most reliable way of avoiding ads ([buffering / downtime info](full-list.md#proxy-issues)).`
Add recommendations 2020-12-29 15:17:38 +01:00
Update status of TTV LOL 2022-09-02 18:23:58 +02:00			- `TTV LOL` - [chrome](https://chrome.google.com/webstore/detail/ttv-lol/ofbbahodfeppoklmgjiokgfdgcndngjm) / [firefox](https://addons.mozilla.org/en-US/firefox/addon/ttv-lol/) / [code](https://github.com/TTV-LOL/extensions)
Add recommendations 2020-12-29 15:17:38 +01:00
Remove dead m3u8 proxy 2021-01-06 01:06:48 +01:00			`Alternatively:`
Update m3u8 proxy 2020-12-31 04:27:21 +01:00
Update info for "Video Ad-Block, for Twitch (fork)" 2022-08-30 19:15:12 +02:00			- `Video Ad-Block, for Twitch` (fork) - [chrome](https://chrome.google.com/webstore/detail/twitch-adblock/ljhnljhabgjcihjoihakgdiicdjncpkd) / [firefox](https://addons.mozilla.org/en-US/firefox/addon/twitch-adblock/) / [code](https://github.com/cleanlock/VideoAdBlockForTwitch)
List "Video Ad-Block, for Twitch" and add "TTV.LOL" firefox link 2021-04-25 16:00:07 +02:00			- `Alternate Player for Twitch.tv` - [chrome](https://chrome.google.com/webstore/detail/alternate-player-for-twit/bhplkbgoehhhddaoolmakpocnenplmhf) / [firefox](https://addons.mozilla.org/en-US/firefox/addon/twitch_5/)
Disable the proxy used by vaft and update list Also disabled stream "correction" (pause/play) on background tabs 2022-09-01 20:12:51 +02:00			- `Purple AdBlock` - [chrome](https://chrome.google.com/webstore/detail/purple-adblock/lkgcfobnmghhbhgekffaadadhmeoindg) / [firefox](https://addons.mozilla.org/en-US/firefox/addon/purpleadblock/) / [code](https://github.com/arthurbolsoni/Purple-adblock/)
Update status of TTV LOL 2022-09-02 18:23:58 +02:00			- `ttv-ublock` - [chrome](https://chrome.google.com/webstore/detail/ttv-ad-block/kndhknfnihidhcfnaacnndbolonbimai) / [firefox](https://addons.mozilla.org/en-US/firefox/addon/ttv-adblock/) / [code](https://github.com/odensc/ttv-ublock)
Update recommendations and relist vaft "Video Ad-Block, for Twitch (fork)" has been relisted in the recommendations as it does still work in terms of hiding the ads. "vaft" has been improved and relisted. This solution is now a hybrid of embed / proxy / the "commercial break in progress" screen. If one method fails it moves to the next. 2022-08-27 16:56:24 +02:00			- `vaft` - see below
List "Video Ad-Block, for Twitch" and add "TTV.LOL" firefox link 2021-04-25 16:00:07 +02:00
Update recommendations and relist vaft "Video Ad-Block, for Twitch (fork)" has been relisted in the recommendations as it does still work in terms of hiding the ads. "vaft" has been improved and relisted. This solution is now a hybrid of embed / proxy / the "commercial break in progress" screen. If one method fails it moves to the next. 2022-08-27 16:56:24 +02:00			`[Read this for a full list and descriptions.](full-list.md)`

			`## Scripts`

Disable the proxy used by vaft and update list Also disabled stream "correction" (pause/play) on background tabs 2022-09-01 20:12:51 +02:00			`There are better / easier to use methods in the above recommendations.`
Update recommendations and relist vaft "Video Ad-Block, for Twitch (fork)" has been relisted in the recommendations as it does still work in terms of hiding the ads. "vaft" has been improved and relisted. This solution is now a hybrid of embed / proxy / the "commercial break in progress" screen. If one method fails it moves to the next. 2022-08-27 16:56:24 +02:00
Update vaft permalink 2022-08-28 20:13:52 +02:00			`- vaft - [ublock](https://github.com/pixeltris/TwitchAdSolutions/raw/master/vaft/vaft-ublock-origin.js) / [userscript](https://github.com/pixeltris/TwitchAdSolutions/raw/master/vaft/vaft.user.js) / [ublock (permalink)](https://github.com/pixeltris/TwitchAdSolutions/raw/e80025cbd1eef78f3c609eaff8d5f934abcc9cf8/vaft/vaft-ublock-origin.js)`
Update recommendations and relist vaft "Video Ad-Block, for Twitch (fork)" has been relisted in the recommendations as it does still work in terms of hiding the ads. "vaft" has been improved and relisted. This solution is now a hybrid of embed / proxy / the "commercial break in progress" screen. If one method fails it moves to the next. 2022-08-27 16:56:24 +02:00			- `Video Ad-Block, for Twitch` (fork) as a script.
Disable the proxy used by vaft and update list Also disabled stream "correction" (pause/play) on background tabs 2022-09-01 20:12:51 +02:00			`- If the ad-free stream fails you'll see an adblocker warning. For more info see [#89](https://github.com/pixeltris/TwitchAdSolutions/issues/89).`
Update recommendations and relist vaft "Video Ad-Block, for Twitch (fork)" has been relisted in the recommendations as it does still work in terms of hiding the ads. "vaft" has been improved and relisted. This solution is now a hybrid of embed / proxy / the "commercial break in progress" screen. If one method fails it moves to the next. 2022-08-27 16:56:24 +02:00
			`For the sake of security it's recommended to use a permalink when using uBlock Origin (permalinks do not auto update).`

			`## Applying a script (uBlock Origin)`

			`- Navigate to the uBlock Origin Dashboard (the extension options)`
			- Under the `My filters` tab add `twitch.tv##+js(twitch-videoad)`.
			- Under the `Settings` tab, enable `I am an advanced user`, then click the cog that appears. Modify the value of `userResourcesLocation` from `unset` to the full url of the solution you wish to use (if a url is already in use, add a space after the existing url). e.g. `userResourcesLocation https://github.com/pixeltris/TwitchAdSolutions/raw/master/vaft/vaft-ublock-origin.js`
			`- To ensure uBlock Origin loads the script I recommend that you disable/enable the uBlock Origin extension (or restart your browser).`

			To stop using a script remove the filter and make the url `unset`.

			`## Applying a script (userscript)`

			`- Viewing one of the userscript files should prompt the given script to be added.`