Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/vgvr0/tiktok-video-downloader-using-python-and-yt-dlp

A Python script for downloading TikTok videos using the yt-dlp library. Easily download your favorite TikTok videos and save them to your specified directory.
https://github.com/vgvr0/tiktok-video-downloader-using-python-and-yt-dlp

tiktok tiktok-api tiktok-downloader tiktok-follower tiktok-video-downloader tiktok-view-bot tiktok-views

Last synced: 2 months ago
JSON representation

A Python script for downloading TikTok videos using the yt-dlp library. Easily download your favorite TikTok videos and save them to your specified directory.

Host: GitHub
URL: https://github.com/vgvr0/tiktok-video-downloader-using-python-and-yt-dlp
Owner: vgvr0
Created: 2024-06-22T18:22:47.000Z (8 months ago)
Default Branch: main
Last Pushed: 2024-11-06T12:24:05.000Z (3 months ago)
Last Synced: 2024-11-06T13:31:04.596Z (3 months ago)
Topics: tiktok, tiktok-api, tiktok-downloader, tiktok-follower, tiktok-video-downloader, tiktok-view-bot, tiktok-views
Language: Python
Homepage:
Size: 105 KB
Stars: 8
Watchers: 1
Forks: 1
Open Issues: 0
Metadata Files:
- Readme: README.md

Awesome Lists containing this project

README

        # 🎵 TikTok Video Downloader Pro

![TikTok Cover](LogoTikTok.png)

A powerful and efficient Python tool for downloading TikTok videos with advanced features and error handling.

[![Python](https://img.shields.io/badge/python-3670A0?style=for-the-badge&logo=python&logoColor=ffdd54)](https://www.python.org/)

[![PyCharm](https://img.shields.io/badge/pycharm-143?style=for-the-badge&logo=pycharm&logoColor=black&color=green&labelColor=green)](https://www.jetbrains.com/pycharm/)

[![Git](https://img.shields.io/badge/git-F05032?style=for-the-badge&logo=git&logoColor=white)](https://git-scm.com/)

[![Telegram](https://img.shields.io/badge/telegram-2CA5E0?style=for-the-badge&logo=telegram&logoColor=white)](https://telegram.org/)

[![yt-dlp](https://img.shields.io/badge/yt--dlp-FF0000?style=for-the-badge&logo=youtube&logoColor=white)](https://github.com/yt-dlp/yt-dlp)

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=for-the-badge)](https://opensource.org/licenses/MIT)

## ✨ Features

- 📥 Download TikTok videos in highest quality available

- 🎯 Custom filename support with timestamps

- 🗂️ Automatic directory management

- 🔄 Progress tracking with real-time updates

- 🛡️ Robust error handling and validation

- 🌐 Browser cookie integration for better compatibility

- 📝 Detailed logging and status reporting

## 🚀 Prerequisites

- Python 3.7 or higher

- Required packages:

  ```

  yt-dlp>=2023.3.4

  typing>=3.7.4

  ```

## 📦 Installation

1. Clone the repository:

```bash

git clone https://github.com/vgvr0/TikTok-Video-Downloader-using-Python-and-yt-dlp

cd tiktok-downloader-pro

```

2. Create a virtual environment (optional but recommended):

```bash

python -m venv venv

source venv/bin/activate  # On Windows: venv\Scripts\activate

```

3. Install dependencies:

```bash

pip install -r requirements.txt

```

## 💻 Usage

### Basic Usage

```python

from tiktok_downloader import TikTokDownloader

# Initialize downloader

downloader = TikTokDownloader()

# Download single video

video_url = "https://www.tiktok.com/@username/video/1234567890"

downloader.download_video(video_url)

```

### Advanced Usage

```python

# Custom save location and filename

downloader = TikTokDownloader(save_path='my_tiktoks')

downloader.download_video(video_url, custom_name="dance_video")

# Download multiple videos

urls = [

    "https://www.tiktok.com/@user1/video/1234567890",

    "https://www.tiktok.com/@user2/video/0987654321"

]

for url in urls:

    downloader.download_video(url)

```

## 🛠️ Configuration Options

| Parameter | Description | Default |

|-----------|-------------|---------|

| save_path | Directory to save videos | 'tiktok_videos' |

| custom_name | Custom name for the video | None |

| use_cookies | Use browser cookies | True |

| quiet_mode | Suppress progress output | False |

## 📋 Example Output

```

Downloading: 45.2% at 1.2 MB/s ETA: 00:15

Download completed, finalizing...

Video successfully downloaded: my_tiktoks/dance_video_20240106_123045.mp4

```

## 🤝 Contributing

1. Fork the repository

2. Create your feature branch (`git checkout -b feature/AmazingFeature`)

3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)

4. Push to the branch (`git push origin feature/AmazingFeature`)

5. Open a Pull Request

## 📝 License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

## 🙏 Acknowledgments

- [yt-dlp](https://github.com/yt-dlp/yt-dlp) for the amazing download capabilities

- TikTok for providing the content platform

- All contributors and users of this project

## ⚠️ Disclaimer

This tool is for educational purposes only. Make sure to comply with TikTok's terms of service and respect content creators' rights when using this tool.

## 📞 Support

If you encounter any issues or have questions:

- Open an issue on GitHub

- Contact us via Telegram

- Check our documentation