2013-05-17 00:41:10 +02:00
|
|
|
.. _issues:
|
|
|
|
|
|
|
|
|
|
Common issues
|
|
|
|
|
=============
|
|
|
|
|
|
2013-12-07 22:52:18 +01:00
|
|
|
.. _issues-player_caching:
|
|
|
|
|
|
|
|
|
|
Streams are buffering/lagging
|
|
|
|
|
-----------------------------
|
2014-08-02 20:22:28 +02:00
|
|
|
|
|
|
|
|
Enable caching in your player
|
|
|
|
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
|
|
2014-07-12 13:12:40 +02:00
|
|
|
By default most players do not cache the data they receieve from Livestreamer.
|
|
|
|
|
Caching can reduce the amount of buffering you run into because the player will
|
|
|
|
|
have some breathing room between receving the data and playing it.
|
2013-12-07 22:52:18 +01:00
|
|
|
|
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
|
|
|
|
|
MPlayer2 ``-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
|
|
|
============= ======================== ======================================
|
2013-12-07 22:52:18 +01:00
|
|
|
|
2014-07-12 13:12:40 +02:00
|
|
|
Use the :option:`--player` option to pass these options to your player.
|
2013-12-07 22:52:18 +01:00
|
|
|
|
2013-05-17 00:41:10 +02:00
|
|
|
|
2014-08-02 20:22:28 +02:00
|
|
|
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 it's own option, these options are currently available:
|
|
|
|
|
|
|
|
|
|
=================================== ============================================
|
|
|
|
|
Option Used by these plugins
|
|
|
|
|
=================================== ============================================
|
2014-08-06 18:32:18 +02:00
|
|
|
:option:`--hls-segment-threads` `twitch`, `youtube` and many more.
|
2014-08-02 20:22:28 +02:00
|
|
|
: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.
|
|
|
|
|
|
