1
mirror of https://github.com/streamlink/streamlink synced 2024-11-14 01:04:54 +01:00
streamlink/docs/issues.rst

52 lines
2.1 KiB
ReStructuredText
Raw Normal View History

.. _issues:
Common issues
=============
.. _issues-player_caching:
Streams are buffering/lagging
-----------------------------
Enable caching in your player
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
2016-09-19 23:38:33 +02:00
By default most players do not cache the data they receive from Streamlink.
Caching can reduce the amount of buffering you run into because the player will
2015-10-27 08:42:27 +01:00
have some breathing room between receiving the data and playing it.
2014-07-12 13:12:40 +02:00
============= ======================== ======================================
Player Parameter Note
============= ======================== ======================================
MPC-HC -- Currently no way of configuring the cache
MPlayer ``-cache <kbytes>`` Between 1024 and 8192 is recommended
mpv ``--cache <kbytes>`` Between 1024 and 8192 is recommended
2014-07-22 16:15:23 +02:00
VLC ``--file-caching <ms> Between 1000 and 10000 is recommended
--network-caching <ms>``
2014-07-12 13:12:40 +02:00
============= ======================== ======================================
2014-07-12 13:12:40 +02:00
Use the :option:`--player` option to pass these options to your player.
Multi-threaded streaming
^^^^^^^^^^^^^^^^^^^^^^^^
On segmented streaming protocols (such as HLS and HDS) it's possible to use
multiple threads to potentially increase the throughput.
Each stream type has its own option, and these are the ones that are currently available:
=================================== ============================================
Option Used by these plugins
=================================== ============================================
:option:`--hls-segment-threads` `twitch`, `youtube` and many more.
:option:`--hds-segment-threads` `dailymotion`, `mlgtv` and many more.
:option:`--stream-segment-threads` `ustreamtv`, `beattv` and any other plugins
implementing their own segmented streaming
protocol.
=================================== ============================================
.. note::
Using 2 or 3 threads should be enough to see an impact on live streams,
any more will likely not show much effect.