English | 简体中文
A powerful cross-platform video download GUI application that supports multiple platforms including TikTok, Douyin, and others. Built on the TikHub.io API for watermark-free video downloading.
- 🌟 Features
- 🖥️ System Requirements
- 🚀 Installation and Running
- 🔑 API Key Setup
- 📖 User Guide
- 📸 Application Screenshots
- ❓ FAQ
- 🤝 Contribution Guidelines
- 📄 License
- 🎉 Acknowledgments
-
📹 Multi-platform Seamless Support:
- ✨ TikTok Video Download: Support for watermark-free downloading of various TikTok videos, image collections, and music
- ✨ Douyin Video Download: Perfect support for Douyin platform videos, image collections, and music works
- 🔄 Automatic Platform Detection: Intelligently detect link types and automatically select the appropriate download method
-
📥 Diverse Download Options:
- 🔗 Single Video Download: Quickly download individual videos without watermarks via share links
- 👤 User Video Batch Download: One-click access to all public videos from a specified user
- 📋 Batch Link Processing: Support for batch downloading of mixed platform links
- 🖼️ Image Collection Support: Complete saving of multi-image works, including metadata
-
🛠️ Advanced Features:
- 🧠 Smart Parsing: Automatically processes short links, redirect links, and various link formats
- 🔍 Media Preview: View video thumbnails, user information, and detailed data before downloading
- 🎵 Audio Extraction: Option to download only the audio portion of videos
- 📊 Download Management: Real-time display of download progress, speed, and status
-
⚙️ User-Friendly Settings:
- 🌓 Theme Switching: Support for light, dark, and system-following modes
- 🌍 Multi-language Support: Built-in Chinese and English interfaces, with support for community language extensions
- 📁 Custom Storage Path: Flexible setting of download file save locations
- 🔄 Automatic Update Checking: Keep software always up to date
-
🔐 Security and Compliance:
- 🛡️ Safe Downloads: Contains no ads or malicious code
- ⚖️ Compliant Usage: Designed for downloading publicly available content that users have the right to access
- 🔒 Privacy Protection: Doesn't collect personal data, protects user privacy
- 🪟 Windows 7/10/11 (Best Support)
- 🍎 macOS 10.14+ (Intel & M1/M2)
- 🐧 Linux (Ubuntu, Debian, Fedora, etc.)
- 🌐 Other operating systems that support Python 3.9+
- 🐍 Python 3.9 or higher
- 📦 Required Python dependencies (see
requirements.txt) - 🔑 TikHub.io API key (Get for free)
- 🌐 Stable network connection (Proxy tools recommended for users in mainland China downloading TikTok videos)
- ⬇️ Download pre-compiled
.exeexecutable directly from Releases - 📦 No need to install Python environment, ready to use out of the box
- 🖱️ Double-click to run the application
- Clone the repository
git clone https://github.com/TikHub/TikHub-Multi-Functional-Downloader.git
cd TikHub-Multi-Functional-Downloader- Install dependencies
pip install -r requirements.txt- Run the application
python main.py- Clone the repository and enter the directory
git clone https://github.com/TikHub/TikHub-Multi-Functional-Downloader.git
cd TikHub-Multi-Functional-Downloader- Install packaging dependencies and execute packaging
pip install -r requirements.txt
python build.py- ✅ Will automatically generate executable files according to your operating system
- 📁 Generated files are located in the
./distdirectory
Using the TikHub downloader requires obtaining an API key from TikHub.io (completely free):
- 🔐 Register an account on TikHub.io (email only required)
- 📆 Log into the user dashboard, click the
Check-inbutton at the top of the page to receive daily check-in rewards- Note: Check-in rewards affect download count, can be claimed once every 24 hours
- Note: If you don't check in, you may not be able to download videos
- 📊 Enter the user dashboard, click
API Management/Pricingon the left, then create your exclusive API key - ⚙️ Click to select all
API Key Scopes, ensure all permissions are selected and granted to the API key, then click save - 💡 Enter the API key in the
Settingstab of the application, click theSavebutton- Note: The API key only needs to be set up once, it will be automatically saved in the local configuration file
- Note: If you encounter any problems during use, please check if your API key is correct
- Note: If you need a higher download count, consider purchasing an API package
- 📋 Copy the video sharing link from Douyin/TikTok app, examples:
- 📲 Paste the video URL in the "Video Download" tab
- 🔍 Click "Parse Video" to get video information
- 👁️ View video preview and detailed information
- 💾 Click "Download Video" to save to local storage
- 🔗 Copy the user homepage URL, examples:
- 📲 Paste the user homepage URL in the "User Videos" tab
- 🔍 Click "Get User Info"
- Displays user avatar, nickname, followers count, etc.
- This step will trigger one API call
- 📊 Set the number of videos to fetch (maximum depends on user's work count)
- Default gets the user's latest 20 videos
- Every additional 20 videos will trigger one API call
- ✅ Select videos to download, or use "Download All Videos"
- 📥 Wait for the download queue to complete
- 📋 Prepare multiple video URLs (one per line)
- 📲 Paste these URLs in the "Batch Download" tab
- 🔍 Click "Extract Links" to verify the number of downloadable links
- Supports mixed platform links, short links, and redirect links or share text
- 📥 Click "Start Batch Download"
- Successful links will trigger one API call
- 📊 View download progress and status
- ✅ After all downloads are complete, success/failure statistics will be displayed
- 📁 Customize download folder path, automatically skip existing files (avoid duplicate downloads)
- 🎛️ Adjust concurrent download count
- 🌓 Choose interface theme (light/dark/follow system)
- 🌍 Switch interface language
- 🔄 Set automatic update check frequency
- 🔗 Supports Douyin and TikTok links as input
- 👁️ Can directly preview video details
- 📊 Displays likes count, comments count, and other data
- 📥 One-click download function
- 🔍 Supports Douyin and TikTok user homepage links
- ⚙️ Can set maximum video count
- 📊 Displays user profile and work statistics
- ✅ Batch selection for download
- 🔄 Supports mixed platform links
- 🧠 One-click extraction of links from input text
- 📁 Supports importing links from text files
- ⚡ Parallel downloads for improved efficiency
- 🌓 Supports theme switching (light, dark, system)
- 🌍 Multi-language support (Chinese, English)
- 🔌 Community contributed language pack interface
- 🔄 Check for updates function
- 🌐 Automatically generates HTML file
- 📱 Responsive design, suitable for various devices
- 🖼️ Supports image collection and album preview
- 👆 User-friendly image browsing interface
- 📝 View image collection detailed information
- 🌐 Supports multi-platform image collection preview
- ⏱️ Displays image collection creation time and related metadata
- 💾 One-click save of original resolution images
A: Possible reasons:
- ⏰ You've used up your API call count for today. Daily check-in can get free quota
- 🔑 API key is not correctly configured or has expired. Please check settings and ensure it's saved
- 🌐 Network issues prevent connection to TikHub servers
A: There are several ways:
- 📆 Log in to TikHub.io daily for check-in to get free quota
- 💰 Purchase a higher-level API package to get more call counts and higher concurrency limits
- 📊 Plan download tasks reasonably, avoid unnecessary API calls
A: Possible reasons:
- 🔒 The video may be set to private and cannot be publicly accessed
- 🌐 Users in mainland China need to use a proxy tool to download TikTok videos
- 🔗 Link format is incorrect or has expired
A: This software downloads the highest quality version by default. If you encounter problems:
- 🎥 Original video quality is limited by the original upload quality
- 📱 Some platforms may limit high-definition video downloads
A: Try the following methods:
- 🔄 Download the latest version of the software again
- 📦 Windows users try installing Visual C++ Redistributable
- 📝 Check the log file (located in the
app.logfile in the application directory) and contact the developer
A: Configuration file is located at:
- .\TikHub-Multi-Functional-Downloader\config.json
Backing up this file will save all your settings and API key.
We welcome all forms of contribution, whether feature requests, bug reports, or code contributions!
- 🍴 Fork this repository
- 🌿 Create your feature branch (
git checkout -b feature/AmazingFeature) - 💾 Commit your changes (
git commit -m 'Add some amazing feature') - 📤 Push to the branch (
git push origin feature/AmazingFeature) - 🔄 Submit a Pull Request
- You can contribute translations by adding new language files
- Language files are located in the
./downloader/localesdirectory - Please use ISO language codes as filenames (e.g.:
en.json,zh.json)
- Use GitHub Issues to report problems
- Please provide detailed reproduction steps and environment information
- Attaching relevant logs and screenshots is helpful
This project is licensed under the GNU General Public License (GNU GPL) Version 3.
Version 3, June 29, 2007
Copyright (C) 2007 Free Software Foundation https://fsf.org/
Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed.
- 🆓 Free Use: Anyone can use this software for any purpose
- 🔄 Free Distribution: You can freely copy and distribute this software
- 🛠️ Free Modification: You can modify the source code to meet your needs
- 📖 Source Code Must Be Open: Any modified version of this software must also be open-sourced under the GPL license
For complete license details, please check the LICENSE file.
- @Evil0ctal - Core development and maintenance
- TikHub.io - Provides powerful API support
- Python - Main development language
- ttkbootstrap - GUI framework
- 🏠 Home - TikHub homepage
- 👨💻GitHub - TikHub GitHub homepage
- 📧 Discord - TikHub community
- ⚡ Documents (Swagger UI) - API documentation
- 🦊 Documents (Apifox UI) - API documentation
- Thanks to all developers and users who help improve the project through issue reports, feature suggestions, and code contributions
- Thanks to the open source community for providing various tools and libraries
- Thanks to all translators who contributed to multi-language support
📢 Notes:
- ⚖️ Please comply with the copyright and usage policies of each platform, only download publicly available content that you have the right to access
- 📝 According to the GNU GPL v3 license, any modifications or derivative works based on this project must also follow GPL v3 and open source the code
- 🚫 This tool should not be used to infringe on others' intellectual property rights or violate terms of service
- 🔄 Regularly check for updates to get the latest features and security fixes