# TTSAVE - Скачивать ведь так просто 🫢
## Технологии
## Описание
TTSave упрощает процесс скачивания видео из TikTok, предоставляя удобный интерфейс для пользователей.
## Функционал TTSave
- Скачивание видео
- Скачивание фото и аудио дорожки
## Установка
1. Используйте pip для установки из [PyPi](https://pypi.org/project/ttsave/):
```bash
pip3 install ttsave==2.0.0
```
2. Используйте pip + git для установки из [GitHub](https://github.com/FlacSy/ttsave/):
```bash
pip3 install git+https://github.com/FlacSy/ttsave
```
## Требования
- Python 3.10.0 и выше
- Node.js 18.0.0 и выше
Библиотеки перечислены в файле [requirements.txt](./requirements.txt)
## Пример использования
```python
from ttsave import TTSave
load_dotenv()
ttsave = TTSave('./downloads')
save_info = ttsave.save('https://www.tiktok.com/@example/video/1234567890')
print(save_info)
```
## CLI
TTSave также предоставляет удобный интерфейс командной строки (CLI) для скачивания видео из TikTok.
### Установка
CLI устанавливается вместе с библиотекой TTSave. Используйте одну из команд установки, приведенных выше.
### Примеры использования CLI
```bash
# Запуск CLI
ttsave
# Скачивание видео по URL
ttsave download <TikTok URL> <download_dir> --debug
# Показать версию
ttsave version
# Показать справку
ttsave help
```
### Команды CLI
- `download <url> <download_dir>`: Скачивание видео или фото из TikTok по указанному URL. Параметр `download_dir` является необязательным, по умолчанию используется текущая директория, но после первого ввода сохраняеться. Опция `--debug` включает режим отладки **на текущий момент опция недоступна**
- `version`: Показать информацию о версии TTSave CLI.
- `exit`: Выйти из TTSave CLI.
- `help`: Показать доступные команды.
### FAQ
- #### Ничего не скачивается
Просто подождите и попробуйте позже.
**Также не забудте проверить ваш `tt_chain_token`!**
Убедитесь, что все делаете по инструкции.
Если это не помогло, откройте issue на [GitHub](https://github.com/FlacSy/ttsave/issues).
> Если у вас возникли вопросы или проблемы, пожалуйста, откройте issue на [GitHub](https://github.com/FlacSy/ttsave/issues).
Raw data
{
"_id": null,
"home_page": "https://github.com/FlacSy/ttsave",
"name": "ttsave",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": null,
"author": "FlacSy",
"author_email": "flacsy.tw@gmail.com",
"download_url": null,
"platform": null,
"description": "# TTSAVE - \u0421\u043a\u0430\u0447\u0438\u0432\u0430\u0442\u044c \u0432\u0435\u0434\u044c \u0442\u0430\u043a \u043f\u0440\u043e\u0441\u0442\u043e \ud83e\udee2\r\n\r\n## \u0422\u0435\u0445\u043d\u043e\u043b\u043e\u0433\u0438\u0438\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n## \u041e\u043f\u0438\u0441\u0430\u043d\u0438\u0435\r\n\r\nTTSave \u0443\u043f\u0440\u043e\u0449\u0430\u0435\u0442 \u043f\u0440\u043e\u0446\u0435\u0441\u0441 \u0441\u043a\u0430\u0447\u0438\u0432\u0430\u043d\u0438\u044f \u0432\u0438\u0434\u0435\u043e \u0438\u0437 TikTok, \u043f\u0440\u0435\u0434\u043e\u0441\u0442\u0430\u0432\u043b\u044f\u044f \u0443\u0434\u043e\u0431\u043d\u044b\u0439 \u0438\u043d\u0442\u0435\u0440\u0444\u0435\u0439\u0441 \u0434\u043b\u044f \u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u0435\u043b\u0435\u0439.\r\n\r\n## \u0424\u0443\u043d\u043a\u0446\u0438\u043e\u043d\u0430\u043b TTSave\r\n- \u0421\u043a\u0430\u0447\u0438\u0432\u0430\u043d\u0438\u0435 \u0432\u0438\u0434\u0435\u043e \r\n- \u0421\u043a\u0430\u0447\u0438\u0432\u0430\u043d\u0438\u0435 \u0444\u043e\u0442\u043e \u0438 \u0430\u0443\u0434\u0438\u043e \u0434\u043e\u0440\u043e\u0436\u043a\u0438 \r\n\r\n## \u0423\u0441\u0442\u0430\u043d\u043e\u0432\u043a\u0430\r\n\r\n1. \u0418\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0439\u0442\u0435 pip \u0434\u043b\u044f \u0443\u0441\u0442\u0430\u043d\u043e\u0432\u043a\u0438 \u0438\u0437 [PyPi](https://pypi.org/project/ttsave/):\r\n\r\n ```bash\r\n pip3 install ttsave==2.0.0\r\n ```\r\n2. \u0418\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0439\u0442\u0435 pip + git \u0434\u043b\u044f \u0443\u0441\u0442\u0430\u043d\u043e\u0432\u043a\u0438 \u0438\u0437 [GitHub](https://github.com/FlacSy/ttsave/):\r\n\r\n ```bash\r\n pip3 install git+https://github.com/FlacSy/ttsave\r\n ```\r\n\r\n## \u0422\u0440\u0435\u0431\u043e\u0432\u0430\u043d\u0438\u044f\r\n- Python 3.10.0 \u0438 \u0432\u044b\u0448\u0435 \r\n- Node.js 18.0.0 \u0438 \u0432\u044b\u0448\u0435 \r\n\r\n\u0411\u0438\u0431\u043b\u0438\u043e\u0442\u0435\u043a\u0438 \u043f\u0435\u0440\u0435\u0447\u0438\u0441\u043b\u0435\u043d\u044b \u0432 \u0444\u0430\u0439\u043b\u0435 [requirements.txt](./requirements.txt)\r\n\r\n## \u041f\u0440\u0438\u043c\u0435\u0440 \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u043d\u0438\u044f\r\n\r\n\r\n```python\r\nfrom ttsave import TTSave\r\n\r\nload_dotenv()\r\n\r\nttsave = TTSave('./downloads')\r\n\r\nsave_info = ttsave.save('https://www.tiktok.com/@example/video/1234567890')\r\n\r\nprint(save_info)\r\n```\r\n\r\n\r\n## CLI\r\n\r\nTTSave \u0442\u0430\u043a\u0436\u0435 \u043f\u0440\u0435\u0434\u043e\u0441\u0442\u0430\u0432\u043b\u044f\u0435\u0442 \u0443\u0434\u043e\u0431\u043d\u044b\u0439 \u0438\u043d\u0442\u0435\u0440\u0444\u0435\u0439\u0441 \u043a\u043e\u043c\u0430\u043d\u0434\u043d\u043e\u0439 \u0441\u0442\u0440\u043e\u043a\u0438 (CLI) \u0434\u043b\u044f \u0441\u043a\u0430\u0447\u0438\u0432\u0430\u043d\u0438\u044f \u0432\u0438\u0434\u0435\u043e \u0438\u0437 TikTok. \r\n\r\n\r\n\r\n### \u0423\u0441\u0442\u0430\u043d\u043e\u0432\u043a\u0430\r\n\r\nCLI \u0443\u0441\u0442\u0430\u043d\u0430\u0432\u043b\u0438\u0432\u0430\u0435\u0442\u0441\u044f \u0432\u043c\u0435\u0441\u0442\u0435 \u0441 \u0431\u0438\u0431\u043b\u0438\u043e\u0442\u0435\u043a\u043e\u0439 TTSave. \u0418\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0439\u0442\u0435 \u043e\u0434\u043d\u0443 \u0438\u0437 \u043a\u043e\u043c\u0430\u043d\u0434 \u0443\u0441\u0442\u0430\u043d\u043e\u0432\u043a\u0438, \u043f\u0440\u0438\u0432\u0435\u0434\u0435\u043d\u043d\u044b\u0445 \u0432\u044b\u0448\u0435.\r\n\r\n### \u041f\u0440\u0438\u043c\u0435\u0440\u044b \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u043d\u0438\u044f CLI\r\n\r\n```bash\r\n# \u0417\u0430\u043f\u0443\u0441\u043a CLI\r\nttsave\r\n\r\n# \u0421\u043a\u0430\u0447\u0438\u0432\u0430\u043d\u0438\u0435 \u0432\u0438\u0434\u0435\u043e \u043f\u043e URL\r\nttsave download <TikTok URL> <download_dir> --debug\r\n\r\n# \u041f\u043e\u043a\u0430\u0437\u0430\u0442\u044c \u0432\u0435\u0440\u0441\u0438\u044e\r\nttsave version\r\n\r\n# \u041f\u043e\u043a\u0430\u0437\u0430\u0442\u044c \u0441\u043f\u0440\u0430\u0432\u043a\u0443\r\nttsave help\r\n```\r\n\r\n### \u041a\u043e\u043c\u0430\u043d\u0434\u044b CLI\r\n\r\n- `download <url> <download_dir>`: \u0421\u043a\u0430\u0447\u0438\u0432\u0430\u043d\u0438\u0435 \u0432\u0438\u0434\u0435\u043e \u0438\u043b\u0438 \u0444\u043e\u0442\u043e \u0438\u0437 TikTok \u043f\u043e \u0443\u043a\u0430\u0437\u0430\u043d\u043d\u043e\u043c\u0443 URL. \u041f\u0430\u0440\u0430\u043c\u0435\u0442\u0440 `download_dir` \u044f\u0432\u043b\u044f\u0435\u0442\u0441\u044f \u043d\u0435\u043e\u0431\u044f\u0437\u0430\u0442\u0435\u043b\u044c\u043d\u044b\u043c, \u043f\u043e \u0443\u043c\u043e\u043b\u0447\u0430\u043d\u0438\u044e \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0435\u0442\u0441\u044f \u0442\u0435\u043a\u0443\u0449\u0430\u044f \u0434\u0438\u0440\u0435\u043a\u0442\u043e\u0440\u0438\u044f, \u043d\u043e \u043f\u043e\u0441\u043b\u0435 \u043f\u0435\u0440\u0432\u043e\u0433\u043e \u0432\u0432\u043e\u0434\u0430 \u0441\u043e\u0445\u0440\u0430\u043d\u044f\u0435\u0442\u044c\u0441\u044f. \u041e\u043f\u0446\u0438\u044f `--debug` \u0432\u043a\u043b\u044e\u0447\u0430\u0435\u0442 \u0440\u0435\u0436\u0438\u043c \u043e\u0442\u043b\u0430\u0434\u043a\u0438 **\u043d\u0430 \u0442\u0435\u043a\u0443\u0449\u0438\u0439 \u043c\u043e\u043c\u0435\u043d\u0442 \u043e\u043f\u0446\u0438\u044f \u043d\u0435\u0434\u043e\u0441\u0442\u0443\u043f\u043d\u0430** \r\n\r\n- `version`: \u041f\u043e\u043a\u0430\u0437\u0430\u0442\u044c \u0438\u043d\u0444\u043e\u0440\u043c\u0430\u0446\u0438\u044e \u043e \u0432\u0435\u0440\u0441\u0438\u0438 TTSave CLI.\r\n- `exit`: \u0412\u044b\u0439\u0442\u0438 \u0438\u0437 TTSave CLI.\r\n- `help`: \u041f\u043e\u043a\u0430\u0437\u0430\u0442\u044c \u0434\u043e\u0441\u0442\u0443\u043f\u043d\u044b\u0435 \u043a\u043e\u043c\u0430\u043d\u0434\u044b.\r\n\r\n### FAQ\r\n\r\n- #### \u041d\u0438\u0447\u0435\u0433\u043e \u043d\u0435 \u0441\u043a\u0430\u0447\u0438\u0432\u0430\u0435\u0442\u0441\u044f \r\n \u041f\u0440\u043e\u0441\u0442\u043e \u043f\u043e\u0434\u043e\u0436\u0434\u0438\u0442\u0435 \u0438 \u043f\u043e\u043f\u0440\u043e\u0431\u0443\u0439\u0442\u0435 \u043f\u043e\u0437\u0436\u0435. \r\n **\u0422\u0430\u043a\u0436\u0435 \u043d\u0435 \u0437\u0430\u0431\u0443\u0434\u0442\u0435 \u043f\u0440\u043e\u0432\u0435\u0440\u0438\u0442\u044c \u0432\u0430\u0448 `tt_chain_token`!**\r\n\r\n \u0423\u0431\u0435\u0434\u0438\u0442\u0435\u0441\u044c, \u0447\u0442\u043e \u0432\u0441\u0435 \u0434\u0435\u043b\u0430\u0435\u0442\u0435 \u043f\u043e \u0438\u043d\u0441\u0442\u0440\u0443\u043a\u0446\u0438\u0438. \r\n\r\n \u0415\u0441\u043b\u0438 \u044d\u0442\u043e \u043d\u0435 \u043f\u043e\u043c\u043e\u0433\u043b\u043e, \u043e\u0442\u043a\u0440\u043e\u0439\u0442\u0435 issue \u043d\u0430 [GitHub](https://github.com/FlacSy/ttsave/issues).\r\n \r\n\r\n\r\n> \u0415\u0441\u043b\u0438 \u0443 \u0432\u0430\u0441 \u0432\u043e\u0437\u043d\u0438\u043a\u043b\u0438 \u0432\u043e\u043f\u0440\u043e\u0441\u044b \u0438\u043b\u0438 \u043f\u0440\u043e\u0431\u043b\u0435\u043c\u044b, \u043f\u043e\u0436\u0430\u043b\u0443\u0439\u0441\u0442\u0430, \u043e\u0442\u043a\u0440\u043e\u0439\u0442\u0435 issue \u043d\u0430 [GitHub](https://github.com/FlacSy/ttsave/issues).\r\n",
"bugtrack_url": null,
"license": "Apache",
"summary": "A simple tool to save TikTok videos",
"version": "2.0.0",
"project_urls": {
"Homepage": "https://github.com/FlacSy/ttsave"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "24456fe48301cdb214d7efa1bf6b25af649f6f1bb0f9229298b28edf32a4a27c",
"md5": "7cf25bb954e1bb28a1a34285c5923f63",
"sha256": "8e4d702f9f4db317bbb66e4ab0de7aa9fb600384de089f86a016cdd8c2167452"
},
"downloads": -1,
"filename": "ttsave-2.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "7cf25bb954e1bb28a1a34285c5923f63",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 84970,
"upload_time": "2024-12-13T01:16:03",
"upload_time_iso_8601": "2024-12-13T01:16:03.944284Z",
"url": "https://files.pythonhosted.org/packages/24/45/6fe48301cdb214d7efa1bf6b25af649f6f1bb0f9229298b28edf32a4a27c/ttsave-2.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-13 01:16:03",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "FlacSy",
"github_project": "ttsave",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "requests",
"specs": [
[
"==",
"2.32.3"
]
]
},
{
"name": "cython",
"specs": [
[
"==",
"3.0.11"
]
]
},
{
"name": "PyExecJS",
"specs": [
[
"==",
"1.5.1"
]
]
},
{
"name": "colorama",
"specs": [
[
"==",
"0.4.6"
]
]
},
{
"name": "click",
"specs": [
[
"==",
"8.1.7"
]
]
},
{
"name": "click_shell",
"specs": [
[
"==",
"2.1"
]
]
},
{
"name": "PyYAML",
"specs": [
[
"==",
"6.0.2"
]
]
},
{
"name": "rich",
"specs": [
[
"==",
"13.9.4"
]
]
}
],
"lcname": "ttsave"
}
JSON
