THU 雲端下載器

Tsinghua Cloud Downloader

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

清華雲盤批量下載助手，適用於分享的文件size 過大導致無法直接下載的情況，本腳本添加了更多實用的小功能：

• 直接下載連結中的所有文件，無打包過程，且無文件數量和大小限制
• 支援下載帶密碼雲盤鏈接
• 支援檢視檔案下載總大小和下載進度
• 支援模糊比對需要下載的檔案（如指定檔案類型/ 指定資料夾下載）

Dependency

需要事先安裝python，安裝過程略，以及requirements.txt檔案裡面的依賴函式庫：

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.

範例

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

Support file format

--file, -f參數支援UNIX shell 風格的pattern 字串，支援使用下列幾個通配符：

• * : 可符合任意個任意字元。
• ? :可符合一個任意字元。
• [字元序列] : 可匹配中括號裡字元序列中的任意字元。此字元序列也支援中畫線表示法。例如[ac] 可代表a, b 和c 字元中任一個。
• [!字元序列] : 可匹配不在中括號裡字元序列中的任意字元。

具體用法如下

 # 下载链接中所有文件
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

下載連結中的全部txt文件

 >>  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.