THU Cloud Downloader

Tsinghua Cloud Downloader

2024/09: 毕业啦?本项目暂停维护

Tsinghua Cloud Disk Batch Download Assistant is suitable for situations where the shared file size is too large and cannot be downloaded directly. This script adds more practical functions:

• Directly download all files in the link, no packaging process, and no limit on the number and size of files
• Supports downloading cloud disk links with passwords
• Supports viewing the total file download size and download progress
• Supports fuzzy matching of files that need to be downloaded (such as specifying file types/specifying folder downloads)

Dependency

You need to install python in advance, the installation process is abbreviated, and the dependent libraries in the requirements.txt file:

pip install -r requirements.txt

Usage

Flags	Default	Description
--link, -l	Required	Share link of Tsinghua Cloud.
--save_dir, -s	~/Desktop	Path to save the files. Default: Desktop
--file, -f	None	Regex to match the file path. Default: download all files.

Example

python thu_cloud_download.py 
    -l https://cloud.tsinghua.edu.cn/d/1234567890/ 
    -s " /PATH/TO/SAVE " 
    -f " *.pptx? " (regex, 正则表达式) 

Support file format

The --file, -f parameters support UNIX shell-style pattern strings and support the following wildcard characters:

• * : can match any number of any characters.
• ? : can match any character.
• [Character sequence] : Can match any character in the character sequence in square brackets. This character sequence also supports centerline notation. For example, [ac] can represent any one of the characters a, b and c.
• [!Character sequence] : can match any character not in the character sequence between square brackets.

The specific usage is as follows

 # 下载链接中所有文件
python thu_cloud_download.py -l https://xxx
# 下载链接中所有的.txt文件
python thu_cloud_download.py -l https://xxx -f * .txt
# 下载链接中某个文件夹的所有文件
python thu_cloud_download.py -l https://xxx -f folder/subfolder/ * 

Output Log Example

Download all txt files in the link

 >>  python thu_cloud_download.py -l https://cloud.tsinghua.edu.cn/d/b9aca92417f04166acdc/ -f *.pcd

2023-12-18 21:15:11,853 - INFO - Share key: b9aca92417f04166acdc
2023-12-18 21:15:12,811 - INFO - Searching for files to be downloaded, Wait a moment...
=======================================================
Last Modified Time           File Size   File Path
-------------------------------------------------------
2022-06-27T19:30:21+08:00     53324648   /cam3.pcd
2022-06-27T19:30:28+08:00     52693930   /cam4.pcd
2022-06-27T19:30:35+08:00     52672991   /cam5.pcd
2022-06-27T19:30:42+08:00     52774114   /cam6.pcd
-------------------------------------------------------
2023-12-18 21:15:14,449 - INFO - # Files: 4. Total size:  201.7 MB.
Start downloading? [y/n]y
2023-12-18 21:15:25,671 - INFO - Root directory name: livoxscan_20220626
[4/4]: 100%|███████████████████████████████| 202M/202M [00:33<00:00, 6.26MiB/s]
2023-12-18 21:15:59,479 - INFO - Download finished.