ykdl 1.8.2
a video downloader written in Python
License: MIT
Requires Python: >=3.5
Keywords: video download youku acfun bilibili

YouKuDownLoader
===============

.. image:: https://img.shields.io/pypi/v/ykdl.svg
   :target: https://pypi.python.org/pypi/ykdl


A video downloader focus on China mainland video sites.

Origin website: https://github.com/zhangn1985/ykdl

Now, it has migrated to the new website: https://github.com/SeaHOH/ykdl

**And, it is still looking for a new owner,**
see `#565 <https://github.com/SeaHOH/ykdl/issues/565>`_.

This project is a fork of
`you-get <https://github.com/soimort/you-get>`_ with below changes.

- Structured source code.
- Focus on China mainland video sites.
- Dropped supports of Python 3.4 and below
  (see `#487 <https://github.com/SeaHOH/ykdl/issues/487>`_).

Simple installation guide
-------------------------

There are some useful software package managers.

- **macOS/Linux**: `Homebrew <https://brew.sh/>`_
- **Debian/Linux**: APT
- **Windows**: `Chocolatey <https://chocolatey.org/install>`_

Step:
 0. Dependencies

    | `FFmpeg <https://ffmpeg.org/>`_, for merge media files.
    | `mpv <https://mpv.io/>`_, default media player (optimal compatibility).

 #. `Python 3 <https://www.python.org/downloads/>`_

 #. pip and setuptools, make sure they are updated.

    .. code-block:: console

        python3 -m ensurepip
        python3 -m pip install pip --upgrade
        python3 -m pip install setuptools --upgrade

 #. ykdl from PyPI or GitHub

    .. code-block:: console

        pip3 install ykdl --upgrade

    .. code-block:: console

        pip3 install https://github.com/SeaHOH/ykdl/archive/master.zip --force-reinstall --no-deps
        pip3 install https://github.com/SeaHOH/ykdl/archive/master.zip --upgrade

 #. Make sure those folders are in your **PATH**, if they are not, add them.

    | **Windows**: folders of ffmpeg.exe, mpv.exe, and python.exe,
                   and folder "<**PYTHONHOME**>\\Scripts"
    | **others**: "~/.local/bin" or "/usr/local/bin"

Site status
-----------

Please check wiki page:
`sites-status <https://github.com/SeaHOH/ykdl/wiki/sites-status>`_

Bugs report, features require, and pull requests are welcome.


Change Log for ykdl
===================

1.8.2
-----------

- enable pep517
- change API name from "vid" to "mid", step 1
- add index item to MediaInfo for playlist
- add util.lazy
- fix compatibility with m3u8 3.5.0 (#621) @Joeky
- fix default filename timestamp (#622) @a67878813
- add new extractor: acfun.live
- update GeneralSimple, Bilibili, Douban, DouYin, iQIYI, iXiGua, Huya, Weibo
- move extractor from "le.le" to "le"
- remove Baidu, iXiGua.live

1.8.1.post1
-----------

- fix compatibility bug on Python 3.9 and below (#604)

1.8.1
-----

- add support HTTP cache
- add support interactive mode
- add `--show-all` argument
- improve handling of media title and filename
- bilibili.live API has been changed (#600 @fraic)
- support new sites: iXiGua
- update GeneralSimple, Bilibili, DouYin, YinYueTai

1.8.0
-----

:warning: :warning: :warning: <lots of breaks>

- add Brotli support (extra)
- fix output and update dependencies
- update Bilibili, Douban, Huya, iQIYI, Weibo
- more see early PRE-releases

`See full change log <https://github.com/SeaHOH/ykdl/blob/master/CHANGELOG.rst>`_.