https://github.com/dmunozv04/isponsorblocktv

SponsorBlock client for all YouTube TV clients.
https://github.com/dmunozv04/isponsorblocktv

appletv chromecast python roku sponsorblock tizen-tv youtube

Last synced: about 22 hours ago
JSON representation

SponsorBlock client for all YouTube TV clients.

• Host: GitHub
• URL: https://github.com/dmunozv04/isponsorblocktv
• Owner: dmunozv04
• License: gpl-3.0
• Created: 2022-01-15T18:26:33.000Z (almost 3 years ago)
• Default Branch: main
• Last Pushed: 2024-10-16T17:25:33.000Z (about 1 month ago)
• Last Synced: 2024-10-29T14:53:18.948Z (22 days ago)
• Topics: appletv, chromecast, python, roku, sponsorblock, tizen-tv, youtube
• Language: Python
• Homepage:
• Size: 321 KB
• Stars: 2,456
• Watchers: 15
• Forks: 102
• Open Issues: 54
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        
# iSponsorBlockTV

Skip sponsor segments in YouTube videos playing on a YouTube TV device (see below for compatibility details).

This project is written in asynchronous python and should be pretty quick.

## Installation

Check the [wiki](https://github.com/dmunozv04/iSponsorBlockTV/wiki/Installation)

Warning: docker armv7 builds have been deprecated. Amd64 and arm64 builds are still available.

## Compatibility

Legend: ✅ = Working, ❌ = Not working, ❔ = Not tested

Open an issue/pull request if you have tested a device that isn't listed here.

| Device             | Status |

|:-------------------|:------:|

| Apple TV           |   ✅    |

| Samsung TV (Tizen) |   ✅    |

| LG TV (WebOS)      |   ✅    |

| Android TV         |   ✅    |

| Chromecast         |   ✅    |

| Google TV          |   ✅    |

| Roku               |   ✅    |

| Fire TV            |   ✅    |

| CCwGTV             |   ✅    |

| Nintendo Switch    |   ✅    |

| Xbox One/Series    |   ✅    |

| Playstation 4/5    |   ✅    |

## Usage

Run iSponsorBlockTV on a computer that has network access.

Auto discovery will require the computer to be on the same network as the device during setup.

The device can also be manually added to iSponsorBlockTV with a YouTube TV code. This code can be found in the settings page of your YouTube application.

It connects to the device, watches its activity and skips any sponsor segment using the [SponsorBlock](https://sponsor.ajay.app/) API.

It can also skip/mute YouTube ads.

## Libraries used

- [pyytlounge](https://github.com/FabioGNR/pyytlounge) Used to interact with the device

- asyncio and [aiohttp](https://github.com/aio-libs/aiohttp)

- [async-cache](https://github.com/iamsinghrajat/async-cache)

- [Textual](https://github.com/textualize/textual/) Used for the amazing new graphical configurator

- [ssdp](https://github.com/codingjoe/ssdp) Used for auto discovery

## Projects using this project

- [Home Assistant Addon](https://github.com/bertybuttface/addons/tree/main/isponsorblocktv)

## Contributing

1. Fork it ()

2. Create your feature branch (`git checkout -b my-new-feature`)

3. Commit your changes (`git commit -am 'Add some feature'`)

4. Push to the branch (`git push origin my-new-feature`)

5. Create a new Pull Request

## Contributors

- [dmunozv04](https://github.com/dmunozv04) - creator and maintainer

- [HaltCatchFire](https://github.com/HaltCatchFire) - updated dependencies and improved skip logic

- [Oxixes](https://github.com/oxixes) - added support for channel whitelist and minor improvements

## License

[![GNU GPLv3](https://www.gnu.org/graphics/gplv3-127x51.png)](https://www.gnu.org/licenses/gpl-3.0.en.html)