Metadata-Version: 2.1
Name: ykdl
Version: 1.8.2
Summary: a video downloader written in Python
Home-page: https://github.com/SeaHOH/ykdl
Author: Zhang Ning
Author-email: zhangn1985@gmail.com
Maintainer: SeaHOH
Maintainer-email: seahoh@gmail.com
License: MIT
Keywords: video download youku acfun bilibili
Platform: any
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Topic :: Internet
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Multimedia
Classifier: Topic :: Multimedia :: Sound/Audio
Classifier: Topic :: Multimedia :: Video
Classifier: Topic :: Utilities
Requires-Python: >=3.5
License-File: LICENSE.txt
Requires-Dist: m3u8 >=1.0.0
Requires-Dist: jsengine >=1.0.5
Requires-Dist: colorama ; os_name == "nt"
Provides-Extra: all
Requires-Dist: BrotliCFFI ; extra == 'all'
Requires-Dist: quickjs ; extra == 'all'
Requires-Dist: ExtProxy ; extra == 'all'
Provides-Extra: br
Requires-Dist: BrotliCFFI ; extra == 'br'
Provides-Extra: js
Requires-Dist: quickjs ; extra == 'js'
Provides-Extra: net
Requires-Dist: ExtProxy ; extra == 'net'
Requires-Dist: BrotliCFFI ; extra == 'net'
Provides-Extra: proxy
Requires-Dist: ExtProxy ; extra == 'proxy'

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>`_.
