TikHub-Multi-Functional Downloader 🚀📱
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.
📋 Table of Contents
🌟 Features
-
📹 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
🖥️ System Requirements
- 🪟 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+
🔧 Technical Requirements
- 🐍 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)
🚀 Installation and Running
📥 Download Methods
1. Windows Users (Recommended) 💯
- ⬇️ Download pre-compiled
.exe executable directly from Releases
- 📦 No need to install Python environment, ready to use out of the box
- 🖱️ Double-click to run the application
Method One: Run Source Code Directly 👨💻
- 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
Method Two: Package using build.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
./dist directory
🔑 API Key Setup
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-in button 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/Pricing on 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
Settings tab of the application, click the Save button
- 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
📖 User Guide
🎬 Single Video Download
- 📋 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
👤 User Video Download
- 🔗 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
📚 Batch Download
- 📋 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
⚙️ Advanced Settings
- 📁 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
📸 Application Screenshots
1. Single Work Download Page 🎬
- 🔗 Supports Douyin and TikTok links as input
- 👁️ Can directly preview video details
- 📊 Displays likes count, comments count, and other data
- 📥 One-click download function
2. User Homepage Download Page 👤
- 🔍 Supports Douyin and TikTok user homepage links
- ⚙️ Can set maximum video count
- 📊 Displays user profile and work statistics
- ✅ Batch selection for download
3. Batch Download Page 📚
- 🔄 Supports mixed platform links
- 🧠 One-click extraction of links from input text
- 📁 Supports importing links from text files
- ⚡ Parallel downloads for improved efficiency
4. Settings Page ⚙️
- 🌓 Supports theme switching (light, dark, system)
- 🌍 Multi-language support (Chinese, English)
- 🔌 Community contributed language pack interface
- 🔄 Check for updates function
5. Image Collection Preview - HTML Preview 🖼️
- 🌐 Automatically generates HTML file
- 📱 Responsive design, suitable for various devices
- 🖼️ Supports image collection and album preview
- 👆 User-friendly image browsing interface
6. Image Collection Details Preview 📊
- 📝 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
❓ FAQ
Q: Why did my API request fail?
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
Q: How can I increase my API call limit?
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
Q: Why can’t a video be downloaded or parsing fails?
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
Q: How to download high-definition videos?
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
⚙️ Software Usage Issues
Q: What if the software fails to start?
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.log file in the application directory) and contact the developer
Q: How to backup my settings and API key?
A: Configuration file is located at:
- .\TikHub-Multi-Functional-Downloader\config.json
Backing up this file will save all your settings and API key.
🤝 Contribution Guidelines
We welcome all forms of contribution, whether feature requests, bug reports, or code contributions!
📝 How to Contribute
- 🍴 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
🌍 Language Contributions
- You can contribute translations by adding new language files
- Language files are located in the
./downloader/locales directory
- Please use ISO language codes as filenames (e.g.:
en.json, zh.json)
🐛 Reporting Issues
- Use GitHub Issues to report problems
- Please provide detailed reproduction steps and environment information
- Attaching relevant logs and screenshots is helpful
📄 License
This project is licensed under the GNU General Public License (GNU GPL) Version 3.
GNU General Public License (GPL) 📜
Version 3, June 29, 2007
Copyright © 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.
Main Terms:
- 🆓 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.
🎉 Acknowledgments
👨💻 Developers
🌐 Resources
📶 Support
🙏 Special Thanks
- 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
评论