mirror of
https://github.com/vgvr0/TikTok-Video-Downloader-Python.git
synced 2025-12-17 09:45:59 +00:00
📱 TikTok Video Downloader
🚀 Download TikTok videos quickly and easily! A simple yet powerful Python tool.
✨ Key Features
🎯 What you can do with this tool:
- 📥 Download TikTok videos using URLs
- 🏷️ Automatic video renaming with 'tiktok_' prefix
- 📊 Video metadata retrieval
- 🛡️ Robust error handling
🔧 Prerequisites
- 🐍 Python 3.6 or higher
- 📦
tiktok-scraperpackage
⚡️ Installation
1️⃣ Clone this repository:
git clone [repository-url]
cd tiktok-downloader
2️⃣ Install the required package:
pip install tiktok-scraper
📖 Usage
🎯 Basic Usage
from tiktok_downloader import download_tiktok_video
# Example
tiktok_url = "https://www.tiktok.com/@username/video/123456789"
download_directory = "/path/to/directory"
download_tiktok_video(tiktok_url, download_directory)
🔍 Function Parameters
- 🔗
video_url(str): The URL of the TikTok video to download - 📁
output_dir(str): The directory where the video will be saved
🎉 Output
The script will:
- ⬇️ Download the video to your specified directory
- ✏️ Rename the video with a 'tiktok_' prefix
- 📋 Print the video metadata
- 💬 Display success/error messages during the process
📝 Example Output
Downloaded video: /path/to/directory/video123.mp4
Renamed video: /path/to/directory/tiktok_video123.mp4
Video metadata: {video_information_object}
⚠️ Error Handling
The script includes error handling that will:
- 🚫 Catch and display any errors during download
- 📢 Print informative error messages
- 🛡️ Prevent script crashes due to download failures
🤝 Contributing
Feel free to submit issues and enhancement requests! We love community contributions! ✨
⚖️ Disclaimer
This tool is for educational purposes only. Please ensure you have the right to download and use any content from TikTok before using this script.
🌟 Made with ❤️ for the TikTok Developer Community
Languages
Python
100%