svtplay-dl/README.rst

svtplay-dl
==========

Installation
------------

Mac OSX
=======

If you have OS X and `Homebrew`_ you can install with:

::

    brew install svtplay-dl
    Make sure you notice that you need to run `brew install ffmpeg` or `brew install libav` afterwards, if you don't already have one of these packages.

Debian and Ubuntu
=================

svtplay-dl(v 0.30) is available in Debian in Jessie and later and Ubuntu in
14.04 and later, which means you can install it straight away using apt (even though version included in the official Debian and Ubuntu apt repos is very old and we **strongly** recommend using our own apt repo which always include the latest version.)

    **svtplay-dl apt repo for debian / ubuntu (https://apt.svtplay-dl.se/)**
    
    # Add the release PGP keys:
    
    curl -s https://svtplay-dl.se/release-key.txt | sudo apt-key add -

    # Add the "release" channel to your APT sources:
    
    echo "deb http://apt.svtplay-dl.se/ svtplay-dl release" | sudo tee /etc/apt/sources.list.d/svtplay-dl.list


    # Update and install svtplay-dl:
    
    sudo apt-get update
    
    sudo apt-get install svtplay-dl
    
… as root.

Windows
=======

You can download windows binaries from `svtplay-dl.se`_

If you want to build your own windows binaries:

1. Install `Visual Studio Express`_ or some other Visual Studio thing you have.
2. Install `nuitka`_
3. Follow the steps listed under `From source`_
4. cd path\to\svtplay-dl && mkdir build
5. `nuitka --recurse-all --output build bin/svtplay-dl`
6. Find binary in build folder. you need `svtplay-dl.exe` and `pythonXX.dll` from that folder to run `svtplay-dl.exe`

Other systems with python
=========================


::

    pip3 install svtplay-dl

From source
===========

If packaging isn’t available for your operating system, or you want to
use a non-released version, you’ll want to install from source. Use git
to download the sources:

::

    git clone git://github.com/spaam/svtplay-dl

svtplay-dl requires the following additional tools and libraries. They
are usually available from your distribution’s package repositories. If
you don’t have them, some features will not be working.

-  `Python`_ 3.4 or higher
-  `RTMPDump`_ 2.4 or higher to download RTMP streams.
-  `pycryptodome`_ to download encrypted HLS streams
-  `PyYaml`_ for configure file
-  `Requests`_
-  `PySocks`_ to enable proxy support
-  `ffmpeg`_ or `avconv`_ for postprocessing and/or for DASH streams

To install it, run

::

    sudo python3 setup.py install

After install
=============

::

    svtplay-dl [options] URL


If you encounter any bugs or problems, don’t hesitate to open an issue
`on github`_. Or why not join the ``#svtplay-dl`` IRC channel on Freenode?

Supported services
------------------

This script works for:

-  aftonbladet.se
-  bambuser.com
-  comedycentral.se
-  dbtv.no
-  di.se
-  dn.se
-  dplay.se
-  dr.dk
-  efn.se
-  expressen.se
-  hbo.com
-  kanal9play.se
-  nickelodeon.nl
-  nickelodeon.no
-  nickelodeon.se
-  nrk.no
-  oppetarkiv.se
-  ruv.is
-  svd.se
-  sverigesradio.se
-  svtplay.se
-  viafree.se (former tv3play.se, tv6play.se, tv8play.se, tv10play.se)
-  viafree.dk (former tv3play.dk)
-  viafree.no (former tv3play.no, viasat4play.no)
-  tv3play.ee
-  tv3play.lt
-  tv3play.lv
-  tv4.se
-  tv4play.se
-  twitch.tv
-  ur.se
-  urplay.se
-  vg.no
-  viagame.com

License
-------

This project is licensed under `The MIT License (MIT)`_.
Homepage: `svtplay-dl.se`_

.. _Python: https://www.python.org/
.. _Homebrew: http://brew.sh/
.. _Visual Studio Express: https://www.visualstudio.com/vs/express/
.. _nuitka: http://nuitka.net/
.. _RTMPDump: http://rtmpdump.mplayerhq.hu/
.. _pycryptodome: https://www.pycryptodome.org/en/latest/
.. _PyYaml: https://github.com/yaml/pyyaml
.. _Requests: http://www.python-requests.org/
.. _PySocks: https://github.com/Anorov/PySocks
.. _ffmpeg: https://ffmpeg.org
.. _avconv: https://libav.org
.. _on github: https://github.com/spaam/svtplay-dl/issues
.. _svtplay-dl.se: https://svtplay-dl.se
.. _The MIT License (MIT): LICENSE