ttsave 1.3.5

A simple tool to save TikTok videos

TTSAVE - Скачивать ведь так просто 🫢

Технологии

Описание

TTSave упрощает процесс скачивания видео из TikTok, предоставляя удобный интерфейс для пользователей. Библиотека использует Selenium для автоматизации процесса скачивания, обеспечивая стабильность и надежность.

Функционал TTSave

• Скачивание видео
• Скачивание фото и аудио дорожки
• Cкачмвание музыки

Установка

1. Используйте pip для установки из PyPi:

   pip3 install ttsave
   

2. Используйте pip для установки из GitHub:

   pip3 install git+https://github.com/FlacSy/ttsave
   

Требования

• Python 3.10.0
• Установленный Chrome браузер и ChromeDriver

Библиотеки перечислены в файле requirements.txt

Пример использования

Пример кода

import os
from selenium import webdriver
from ttsave import TTSave

def main():
    url = input("TikTok URL: ")
    options = webdriver.FirefoxOptions()

    download_dir = os.path.dirname(os.path.abspath(__file__))

    # profile_path = 'C:/Users/<Ваше_Имя>/AppData/Roaming/Mozilla/Firefox/Profiles'
    # options.set_preference('profile', profile_path)

    downloader = TTSave(
        url=url,
        options=options,
        driver_class=webdriver.Firefox,
        download_dir=download_dir
    )

    out = downloader.download()
    print(out)

if __name__ == "__main__":
    main()

Более подробный пример можно найти в example.py

CLI

TTSave также предоставляет удобный интерфейс командной строки (CLI) для скачивания видео из TikTok.

Установка

CLI устанавливается вместе с библиотекой TTSave. Используйте одну из команд установки, приведенных выше.

Примеры использования CLI

# Запуск CLI
ttsave

# Скачивание видео по URL
ttsave download <TikTok URL> <download_dir> --debug

# Показать версию
ttsave version

# Показать справку
ttsave help

Команды CLI

• download <url> <download_dir> --debug: Скачивание видео или фото из TikTok по указанному URL. Параметр download_dir является необязательным, по умолчанию используется текущая директория. Опция --debug включает режим отладки.
• version: Показать информацию о версии TTSave CLI.
• help: Показать доступные команды.

FAQ

• Ничего не скачивается

  Просто подождите и попробуйте позже.

  Если это не помогло, проверьте инструкции ниже:

  Убедитесь, что все делаете по инструкции.

  Если это не помогло, откройте issue на GitHub.

• Не скачивается фото или не отображается другая информация.

  Запустите TTSave в режиме DEBUG.

  Если вы используете CLI, добавьте аргумент --debug. Если вы используете класс TTSave, то при его создании установите параметр debug_mode=True.

  Если вы видите капчу в окне браузера, попробуйте использовать профиль вашего браузера.

  1. Chrome браузер:

  from selenium import webdriver
  from ttsave import TTSave
  
  profile_path = 'C:/Users/<Ваше_Имя>/AppData/Local/Google/Chrome/User Data/Default'
  
  options = webdriver.ChromeOptions()
  options.add_argument(f'user-data-dir={profile_path}')
  
  downloader = TTSave(
      options=options,
      driver_class=webdriver.Chrome,
      debug_mode=True
      ...
  )
  

  Еще рекомендуеться поставить дополнительные опции для скрытия автоматизированого ПО. Пример:

  ...
  options = webdriver.ChromeOptions()
  
  options.add_argument("--disable-blink-features=AutomationControlled")
  options.add_experimental_option("excludeSwitches", ["enable-automation"])
  options.add_experimental_option('useAutomationExtension', False)
  

  2. Firefox браузер:

  from selenium import webdriver
  from ttsave import TTSave
  
  profile_path = 'C:/Users/<Ваше_Имя>/AppData/Roaming/Mozilla/Firefox/Profiles'
  
  options = webdriver.FirefoxOptions()
  options.set_preference('profile', profile_path)
  
  downloader = TTSave(
      options=options,
      driver_class=webdriver.Firefox,
      debug_mode=True
      ...
  )
  

  Если вы используете CLI, добавьте флаг --profile, указав путь к вашему Chrome профилю:

  ttsave download https://vm.tiktok.com/qwerty --debug --profile "C:/Users/<Ваше_Имя>/AppData/Local/Google/Chrome/User Data/Default"
  

Если у вас возникли вопросы или проблемы, пожалуйста, откройте issue на GitHub.