Automatic Retries and Download Paths

New Features

• Set the number of retries for a given URL by setting the retries parameter.
  • The number of miliseconds between each retry can be set using the retry_delay paramater.
• Set the path to download the videos/images to by setting the download_path parameter.
  • Default is None and uses the current working directory.

Minor Updates

• Specify the timeout to wait for captcha to appear
• Specify the number of captcha attempts to perform
• All exceptions now derive from a base TikTokBaseException class
• Started to add tests – WIP

Hot fix for v1.3.0

Hot fix to address issues caused by 1.3.0 update

Fixes

• Fixed an issue caused by the renaming of video_download_setting to post_download_setting
• Fixed an issued cause by the renaming of video_id to post_id

Support added for TikTok Slideshows

This update makes some breaking changes to key package names as well as function names, see changes below:

Changes

• Changed download_video package to download_post
• Changed video_data package to post_data
• Changed get_video function to get_post
• TikTokVideo is now a subclass of TikTokPost and a sibling of TikTokSlide
• Some internal functions were renamed to refer to "posts" rather than "videos"

Better Playwright configuration support

Changes

• Added proxy kwarg to pass to Playwright, implements #1 feature request
• Added kwargs to allow passing any extra kwargs to either the Playwright browser context or browser instance
• Added force_download_strategy to manually choose a download strategy
• Added new exception ResponseParseException to handle when the HTML page cannot be parsed

Fixed pip package issues

Changes to setup.py to enable installing via PyPi and pip.

PyPi package now installable with pip install tiktok-dlpy>=1.1.1

Better Video Compatibility

Non-breaking update to improve video download compatibility.

Some videos do not allow a user to directly download them. This update allows videos with downloadSetting values not equal to 0 to be downloaded.

Currently the alternate download strategy only works when the browser is set to firefox, which is the default. Any video with downloadSetting = 0 will continue to use the primary download strategy, which is unchanged from v1.0.0

Changes

• Can now be installed using a pip package instead of needing the GitHub direct link.
• TikTokVideo dataclass has a new attribute: video_download_setting: int to store a video's downloadSetting.
• Videos with video_download_setting not equal to 0 will attempt to be downloaded with new alternate download strategy.
• Decreased the default timeout for waiting on a download to start from 30,000 ms to 5,000 ms.
• New download_timeout: float parameter in get_video() to set the timeout for the download to start, defaults to 5,000.

Initial Release

For usage see the Usage section of the README