GithubHelp home page GithubHelp logo

streamlink-ttvlol's Introduction

streamlink-ttvlol

About

Streamlink Twitch plugin modified to work with the TTV.LOL API. This proxies the playlist request to a country where Twitch does not serve ads. Note that TTV.LOL can still rarely return a playlist with ads, if this happens you'll need to restart streamlink to get a different playlist (or try the experimental flag --twitch-reexec-on-ad to do this automatically).

Installation

Follow the instructions below for your specific operating system.

Windows, Linux, MacOS.

If you wish to install manually, you can get the latest release here.

More info on Streamlink plugin sideloading here.

After installation you will need to point Streamlink at a playlist proxy server with flags.

Windows

Automatically

Copy the command below and paste it into powershell. Do not run powershell as admin.

If you don't know how to open powershell. Press windows key + r and type powershell into the box and press enter. Copy the contents of the box below and then right click in the powershell window and press enter:

$null= New-Item -ItemType Directory -Path .\AppData\Roaming\streamlink\plugins -Force; iwr -Uri 'https://github.com/2bc4/streamlink-ttvlol/releases/latest/download/twitch.py' -OutFile .\AppData\Roaming\streamlink\plugins\twitch.py

NOTE: If you cannot resolve the URL (receive an error), this is likely due to your TLS version. Run the command below to set your TLS version to 1.2 and re-run the above command:

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

Manually

Navigate to:

C:\Users\%username%\AppData\Roaming\streamlink

Then create the plugins folder and drop the twitch.py inside of it.

Linux

Automatically

Run the below command in a terminal:

INSTALL_DIR="${XDG_DATA_HOME:-${HOME}/.local/share}/streamlink/plugins"; mkdir -p "$INSTALL_DIR"; curl -L -o "$INSTALL_DIR"/twitch.py 'https://github.com/2bc4/streamlink-ttvlol/releases/latest/download/twitch.py'

Manually

Copy the twitch.py file to:

~/.local/share/streamlink/plugins

MacOS

Automatically

Run the below command in terminal:

INSTALL_DIR="${HOME}/Library/Application Support/streamlink/plugins"; mkdir -p "$INSTALL_DIR"; curl -L -o "$INSTALL_DIR"/twitch.py 'https://github.com/2bc4/streamlink-ttvlol/releases/latest/download/twitch.py'

Manually

Copy the twitch.py file to:

${HOME}/Library/Application Support/streamlink/plugins

Flags

streamlink-ttvlol adds the following flags:

Flag Example Description
--twitch-proxy-playlist
--twitch-proxy-playlist=https://api.ttv.lol,https://eu1.jupter.ga/channel/[channel]
Proxy playlist request through a server that supports the TTV.LOL API (or a server that doesn't with a custom URL, see here). It can also be pointed at multiple comma separated servers which will try each server in order until successful.
--twitch-proxy-playlist-exclude
--twitch-proxy-playlist-exclude=forsen,twitch,twitchgaming
Can be used to exclude channels from being proxied (eg. you're subscribed to the channel and want to use your OAuth token to avoid ads instead)
--twitch-proxy-playlist-fallback
--twitch-proxy-playlist-fallback
Enable if Streamlink should fallback to Twitch servers if all requests to playlist proxies fail.
--twitch-ttvlol
--twitch-ttvlol
This is a convenience alias for:
--twitch-proxy-playlist=https://api.ttv.lol
--twitch-reexec-on-ad
--twitch-reexec-on-ad
(Experimental) Re-executes Streamlink to retrieve a new playlist when encountering an embedded advertisement segment.
NOTE: If you're recording the stream to a file with -o or similar this will overwrite the file when it triggers. To workaround this you can create a unique filename for each re-exec by appending the current timestamp with metadata variables.

streamlink-twitch-gui

If you're using streamlink-twitch-gui then you'll need to check the "Enable advanced settings and features" box on the Main tab in settings. You can then add the above flag of your choosing to the "Custom parameters" box on the Streaming tab.

Chatterino

If you're using Chatterino with Streamlink you'll need to add the above flag of your choosing to Settings -> External Tools -> Streamlink -> Additional options.

streamlink-ttvlol's People

Contributors

2bc4 avatar sokoloft avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.