Version 1.8.1

Changelog

General:

• Added a wheel package to PyPi for speedier installation via pip.

Bug fixes:

• hls: Handle encrypted segments that are invalid length (not multiple by 16). (#365)

Plugins:

• Added plugin for Furstream, patch by Pascal Romahn. (#360)
• Added plugin for Viasat's play sites (tv6play.se, etc). (#378)
• Added plugin for ZDFmediathek, patch by Pascal Romahn. (#360)
• azubutv: Updated for service changes. (#373)
• crunchyroll: Correctly handle unicode errors, patch by Agustin Carrasco. (#387, #388)
• filmon: Updated for service changes, patch by Athanasios Oikonomou. (#375)
• hitbox: Updated for service changes.
• ilive: Updated for service changes, patch by Athanasios Oikonomou. (#376)
• svtplay: Added support for SVT Flow.
• twitch: Now uses the beta API on beta.twitch.tv URLs. (#391)
• ustream: Correctly handle UHS streams containing only video or audio.

Installing

The binaries listed here are for Windows only, but Livestreamer works on any OS that Python supports. See Installing for more information.

There is also a more detailed guide for Windows.

Documentation

If you are unsure how to use Livestreamer, please start with reading through the Tutorial.

About the downloads

• livestreamer-1.8.1-win32-setup.exe: This is a complete installer which installs rtmpdump, a default configuration file and adds Livestreamer to your PATH (making it possible to use Livestreamer directly from the command prompt without specifying its path). This is the recommended way to install Livestreamer on Windows.
• livestreamer-1.8.1-win32.zip: If you don't want to use the installer for whatever reason, this zip file only contains a compiled version of Livestreamer and nothing else.
• Source code The source listed here is a Git snapshot, the proper source dist is available at PyPi.

If you find Livestreamer useful, please consider supporting its author by donating via
Dogecoin: DCbQgDa4aEbm9QNm4ix6zYV9vMirUDQLNj, Flattr or PayPal.

Version 1.8.0

Changelog

CLI:

• Added option: --no-version-check
• Added HTTP options: --http-cookies,
  --http-headers,
  --http-query-params,
  --http-ignore-env,
  --http-no-ssl-verify,
  --http-ssl-cert,
  --http-ssl-cert-crt-key and
  --http-timeout
• Added HTTP stream option: --http-stream-timeout
• Added HDS stream options: --hds-segment-attempts,
  --hds-segment-timeout
--hds-timeout
• Added HLS stream options: --hls-live-edge,
  --hls-segment-attempts,
  --hls-segment-timeout and
  --hls-timeout
• Added RTMP stream option: --rtmp-timeout
• Added plugin options: --livestation-email and --livestation-password
• Added stream options: --retry-streams,
  --retry-open and
  --best-stream-default
• Deprecated option: --hds-fragment-buffer

Plugins:

• Added plugin for Bambuser, patch by Athanasios Oikonomou. (#327)
• Added plugin for Be-at.tv, patch by Athanasios Oikonomou. (#342)
• Added plugin for Chaturbate, patch by papplampe. (#337)
• Added plugin for Cybergame.tv, patch by Athanasios Oikonomou. (#324)
• Added plugin for Picarto, patch by papplampe. (#352)
• Added plugin for SpeedRunsLive, patch by Stefan Breunig. (#335)
• Removed plugins for dead services: Owncast.me and YYCast.
• azubutv: Added support for beta.azubu.tv.
• crunchyroll: Added workaround for SSL verification issue.
• dailymotion: Added support for HDS streams. (#348)
• gomexp: Fixed encoding issue on Python 2.
• livestation: Added support for logging in, patch by Sunaga Takahiro. (#344)
• mlgtv: Removed the mobile_ prefix from the HLS streams.
• twitch: Added workaround for SSL verification issue. (#255)
• ustreamtv: Improved UHS stream stability.
• ustreamtv: Added support for RTMP VODs.
• youtube: Updated for service changes.
• youtube: Added support for embed URLs, patch by Athanasios Oikonomou.
• youtube: Now only picks up live streams from channel pages.

General:

• Now attempts to resolve URL redirects such as URL shorterners.

Bug fixes:

• Added workaround for HTTP streams not applying read timeout on some requests versions.

API:

• Added new options: hds-segment-attempts,
  hds-segment-timeout,
  hds-timeout,
  hls-live-edge,
  hls-segment-attempts,
  hls-segment-timeout,
  hls-timeout,
  http-proxy,
  https-proxy,
  http-cookies,
  http-headers,
  http-query-params,
  http-trust-env,
  http-ssl-verify,
  http-ssl-cert,
  http-timeout,
  http-stream-timeout and
  rtmp-timeout
• Renamed option errorlog to subprocess-errorlog.
• Renamed option rtmpdump-proxy to rtmp-proxy.
• Renamed option rtmpdump to rtmp-rtmpdump.

Installing

The binaries listed here are for Windows only, but Livestreamer works on any OS that Python supports. See Installing for more information.

There is also a more detailed guide for Windows.

Documentation

If you are unsure how to use Livestreamer, please start with reading through the Tutorial.

About the downloads

• livestreamer-1.8.0-win32-setup.exe: This is a complete installer which installs rtmpdump, a default configuration file and adds Livestreamer to your PATH (making it possible to use Livestreamer directly from the command prompt without specifying its path). This is the recommended way to install Livestreamer on Windows.
• livestreamer-1.8.0-win32.zip: If you don't want to use the installer for whatever reason, this zip file only contains a compiled version of Livestreamer and nothing else.
• Source code The source listed here is a Git snapshot, the proper source dist is available at PyPi.

If you find Livestreamer useful, please consider supporting its author by donating via
Dogecoin: DCbQgDa4aEbm9QNm4ix6zYV9vMirUDQLNj, Flattr or PayPal.

Version 1.7.5

Changelog

Plugins:

• filmon: Added VOD support, patch by Athanasios Oikonomou.
• ilive: Added support for HLS streams, patch by Athanasios Oikonomou.
• mlgtv: Updated for service changes.
• veetle: Now handles shortened URLs, patch by Athanasios Oikonomou.
• youtube: Updated for service changes.

Bug fixes:

• Fixed gzip not getting decoded in streams.

Other:

• Added scripts to automatically create Windows builds via Travis CI.
  Builds are available here: http://livestreamer-builds.s3.amazonaws.com/builds.html

Installing

The binaries listed here are for Windows only, but Livestreamer works on any OS that Python supports. See Installing for more information.

Documentation

If you are unsure how to use Livestreamer, please start with reading through the Tutorial.

There is also a more detailed guide for Windows.

About the downloads

• livestreamer-1.7.5-win32-setup.exe: This is a complete installer which installs rtmpdump, a default configuration file and adds Livestreamer to your PATH (making it possible to use Livestreamer directly from the command prompt without specifying its path). This is the recommended way to install Livestreamer on Windows.
• livestreamer-1.7.5-win32.zip: If you don't want to use the installer for whatever reason, this zip file only contains a compiled version of Livestreamer and nothing else.
• Source code The source listed here is a Git snapshot, the proper source dist is available at PyPi.

If you find Livestreamer useful, please consider supporting its author by donating via
Dogecoin: DCbQgDa4aEbm9QNm4ix6zYV9vMirUDQLNj, Flattr or PayPal.

Version 1.7.4

Changelog

Plugins:

• Added plugin for MLG.tv. (#275)
• Added plugin for DMCloud, patch by Athanasios Oikonomou. (#297)
• Added plugin for NRK TV, patch by Jon Bergli Heier. (#309)
• Added plugin for GOMeXP.com.
• Removed GOMTV.net plugin as the service no longer exists.
• mips: Fixed issue with case sensitive playpath. (#306)
• ilive: Added missing app parameter. (#293)
• ustreamtv: Added support for password protected streams via --ustream-password.
• youtube: Now handles youtu.be shortcuts, patch by Andy Mikhailenko. (#288)
• youtube: Use first available stream found on channel pages, patch by "unintended". (#291)

Streams:

• hds: Fixed segmented streams logic, patch by Moritz Blanke.

Bug fixes:

• Fixed buffer overwriting issue when passing a memoryview, patch by Martin Panter. (#295)
• Avoid a ResourceWarning when using --player-continuous-http, patch by Martin Panter. (#296)

Installing

The binaries listed here are for Windows only, but Livestreamer works on any OS that Python supports. See Installing for more information.

Documentation

If you are unsure how to use Livestreamer, please start with reading through the Tutorial.

About the downloads

• livestreamer-1.7.4-win32-setup.exe: This is a complete installer which installs rtmpdump, a default configuration file and adds Livestreamer to your PATH (making it possible to use Livestreamer directly from the command prompt without specifying its path). This is the recommended way to install Livestreamer on Windows.
• livestreamer-1.7.4-win32.zip: If you don't want to use the installer for whatever reason, this zip file only contains a compiled version of Livestreamer and nothing else.
• Source code The source listed here is a Git snapshot, the proper source dist is available at PyPi.

If you find Livestreamer useful, please consider supporting its author by donating via
Dogecoin: DCbQgDa4aEbm9QNm4ix6zYV9vMirUDQLNj, Flattr or PayPal.

Version 1.7.3

Changelog

Plugins:

• Added plugin for hitbox.tv, patch by t0mm0. (#248)
• Added plugin for Crunchyroll, patch by Agustín Carrasco. (#262)
• twitch: Added support for hours in ?t=... on VODs.
• twitch: Added support for ?t=... on VOD highlights.

Streams:

• hls: Now allows retries on failed segment fetch.

Bug fixes:

• cli: Don't pass our proxy settings to the player. (#260)
• hds: Now uses global height as stream name if needed when parsing manifests.
• hls: Always use first stream for each quality in variant playlists. (#256)
• hls: Now returns correct exception on playlist parser errors.
• hls: Now remembers cookies set by variant playlist response. (#258)

Installing

The binaries listed here are for Windows only, but Livestreamer works on any OS that Python supports. See Installing for more information.

Documentation

If you are unsure how to use Livestreamer, please start with reading through the Tutorial.

About the downloads

• livestreamer-1.7.3-win32-setup.exe: This is a complete installer which installs rtmpdump, a default configuration file and adds Livestreamer to your PATH (making it possible to use Livestreamer directly from the command prompt without specifying its path). This is the recommended way to install Livestreamer on Windows.
• livestreamer-1.7.3-win32.zip: If you don't want to use the installer for whatever reason, this zip file only contains a compiled version of Livestreamer and nothing else.
• Source code The source listed here is a Git snapshot, the proper source dist is available at PyPi.

If you find Livestreamer useful, please consider supporting its author by donating via
DCbQgDa4aEbm9QNm4ix6zYV9vMirUDQLNj, Flattr or PayPal.

Version 1.7.2

Changelog

CLI:

• The --twitch-legacy-names option is now deprecated.
• Added --twitch-oauth-authenticate and --twitch-oauth-token options.

Plugins:

• filmon: Added quality weights. (#239)
• filmon_us: Added support for VODs, patch by John Peterson. (#237)
• twitch: Updated for service changes. No more RTMP streams, only HLS.
• twitch: Removed mobile streams since they are the same as the new desktop streams.
• twitch: Removed the legacy names option.
• twitch: Added support for OAuth2 authentication.
• twitch: Added support for the t=00m0s parameter in VOD URLs.

Bug fixes:

• Always wait for the player process to exit, patch by Martin Panter. (#234)
• Fixed potential deadlocking when using named pipe, patch by Martin Panter. (#236)
• Fixed issue with spaces in default player path, patch by John Peterson. (#237)

Installing

The binaries listed here are for Windows only, but Livestreamer works on any OS that Python supports. See Installing for more information.

Documentation

If you are unsure how to use Livestreamer, please start with reading through the Tutorial.

About the downloads

• livestreamer-1.7.2-win32-setup.exe: This is a complete installer which installs rtmpdump, a default configuration file and adds Livestreamer to your PATH (making it possible to use Livestreamer directly from the command prompt without specifying its path). This is the recommended way to install Livestreamer on Windows.
• livestreamer-1.7.2-win32.zip: If you don't want to use the installer for whatever reason, this zip file only contains a compiled version of Livestreamer and nothing else.
• Source code The source listed here is a Git snapshot, the proper source dist is available at PyPi.

If you find Livestreamer useful, please consider supporting its author by donating via Flattr, PayPal or Bitcoin (16jzxC8ZkuRhFhngNC8xJqfQcnnSxVBmSi).

Version 1.7.1

Changelog

Plugins:

• Added FilmOn Social TV plugin by John Peterson. (#225)
• twitch: Support mobile_source quality, patch by Andrew Bashore.

Streams:

• hds: Will now use video height as stream names if available.
• hds: Removed the use of movie identifier in the fragment URLs.
• hds: Added support for player verification, patch by Martin Panter. (#222)

Bug fixes:

• Fixed various Python warnings, patch by Martin Panter. (#221)
• cli: Fixed back-slash issue in --player-args. (#218)
• hds: Fixed some streams complaining about the hardcoded hdcore parameter.
• hls: Fixed live streams that keep all previous segments in the playlists. (#224)
• setup.py now forces requests 1.x on Python <2.6.3. (#219)

Installing

The binaries listed here are for Windows only, but Livestreamer works on any OS that Python supports. See Installing for more information.

Documentation

If you are unsure how to use Livestreamer, please start with reading through the Tutorial.

About the downloads

• livestreamer-1.7.1-win32-setup.exe: This is a complete installer which installs rtmpdump, a default configuration file and adds Livestreamer to your PATH (making it possible to use Livestreamer directly from the command prompt without specifying its path). This is the recommended way to install Livestreamer on Windows.
• livestreamer-1.7.1-win32.zip: If you don't want to use the installer for whatever reason, this zip file only contains a compiled version of Livestreamer and nothing else.
• Source code The source listed here is a Git snapshot, the proper source dist is available at PyPi.

If you find Livestreamer useful, please consider supporting its author by donating via Flattr, PayPal or Bitcoin (16jzxC8ZkuRhFhngNC8xJqfQcnnSxVBmSi).

Version 1.7.0

Changelog

CLI:

• Added a --player-no-close option.
• Added options to use HTTP proxies with --http-proxy and --https-proxy.
• It's now possible to specify multiple streams as a comma-separated
  list. If a stream is not available the next one in the list will be tried.
• Now only resolves synonyms once when using --player-continuous-http.
• Removed the -u shortcut for --plugins. This is a response to someone
  spreading the misinformation that -url is a sane parameter to use.
  It's technically valid, but due to the -u shortcut it would be
  interpreted by Python's argparse as --plugins --rtmpdump l which
  would cause livestreamer to look for a non-existing rtmpdump executable,
  thus disabling any RTMP streams. (#193)

Plugins:

• Added Afreeca.tv plugin.
• dailymotion: Fixed incorrect RTMP parameters. (#201)
• filmon: Updated after service changes. Patch by Athanasios Oikonomou. (#205)
• ilive: Updated after service changes. (#200)
• livestream: Added support for HLS streams.
• livestream: Updated after service changes. (#195)
• mips: Updated after service changes. (#200)
• svtplay: Fixed some broken HDS streams. (#200)
• twitch: Updated to use the new HLS API.
• weeb: Updated after service changes. Patch by Athanasios Oikonomou. (#207)
• youtube: Now handles 3D streams properly. (#202)

Stream:

• hds: Added support for global bootstraps.
• hls: Rewrote the playlist parser from scratch to be more solid and correct
  in accordance to the latest M3U8 spec.
• hls: Now supports playlists using EXT-X-BYTERANGE.
• hls: Now supports playlists using multiple EXT-X-KEY tags.
• hls: Now accepts extra requests parameters to be used when doing
  HTTP requests.

Bug fixes:

• Fixed bytes-serialization when using --json.

Installing

The binaries listed here are for Windows only, but Livestreamer works on any OS that Python supports. See Installing for more information.

Documentation

If you are unsure how to use Livestreamer, please start with reading through the Tutorial.

About the downloads

• livestreamer-1.7.0-win32-setup.exe: This is a complete installer which installs rtmpdump, a default configuration file and adds Livestreamer to your PATH (making it possible to use Livestreamer directly from the command prompt without specifying its path). This is the recommended way to install Livestreamer on Windows.
• livestreamer-1.7.0-win32.zip: If you don't want to use the installer for whatever reason, this zip file only contains a compiled version of Livestreamer and nothing else.
• Source code The source listed here is a Git snapshot, the proper source dist is available at PyPi.

If you find Livestreamer useful, please consider supporting its author by flattring it or donating via PayPal.

Version 1.6.1

Changelog

Bug fixes:

• CLI: Fixed broken --player-http and --player-continuous-http on Windows.
• CLI: Fixed un-quoted player paths containing backslashes being broken.

Installing

The binaries listed here are for Windows only, but Livestreamer works on any OS that Python supports. See Installing for more information.

Documentation

If you are unsure how to use Livestreamer, please start with reading through the Tutorial.

About the downloads

• livestreamer-1.6.1-win32-setup.exe: This is a complete installer which installs rtmpdump, a default configuration file and adds Livestreamer to your PATH (making it possible to use Livestreamer directly from the command prompt without specifying its path). This is the recommended way to install Livestreamer on Windows.
• livestreamer-1.6.1-win32.zip: If you don't want to use the installer for whatever reason, this zip file only contains a compiled version of Livestreamer and nothing else.
• Source code The source listed here is a Git snapshot, the proper source dist is available at PyPi.

Version 1.6.0

Changelog

General:

• All stream names are now forced to lowercase to avoid issues with
  services renaming streams. (#179)
• Updated requests compatibility to 2.0. (#183)

Plugins:

• Added plugin for Hashd.tv by kasper93. (#184)
• Azubu.tv: Updated after service changes. (#170)
• ILive.to: Updated after service changes. (#182)
• Twitch/Justin.tv: Refactored and split into separate plugins.
  • Added support for archived streams (VOD). (#70)
  • Added a option to force legacy stream names (720p, 1080p+, etc).
  • Added a option to access password protected streams.
• UStream.tv: Refactored plugin and added support for their RTMP API and
  special streaming technology (UHS). (#144)

CLI:

• Added some more player options: --player-args, --player-http,
  --player-continuous-http and --player-passthrough. (#131)
• Expanded --stream-sorting-excludes to support more advanced
  filtering. (#159)
• Now notifies the user if a new version of Livestreamer is available.
• Now allows case-insensitive stream name lookup.

API:

• Added a new exception (LivestreamerError) that all other exceptions
  inherit from.
• The sorting_excludes parameter in Plugin.get_streams
  now supports more advanced filtering. (#159)

Bug fixes:

• Fixed HTTPStream with headers breaking --json on Python 3.

Documentation

If you are unsure how to use Livestreamer, please start with reading the Tutorial.

About the downloads

• livestreamer-1.6.0-win32-setup.exe: This is a complete installer which installs rtmpdump, a default configuration file and adds Livestreamer to your PATH (making it possible to use Livestreamer directly from the command prompt without specifying its path). This is the recommended way to install Livestreamer on Windows.
• livestreamer-1.6.0-win32.zip: If you don't want to use the installer for whatever reason, this zip file only contains a compiled version of Livestreamer and nothing else.
• Source code The source listed here is a Git snapshot, the proper source dist is available at PyPi.