Flickr 相簿還原工具 📸

這是一個用 Python 撰寫的工具，可根據 Flickr 匯出的完整資料包，自動將你的照片和影片依照「相簿」還原成原本的分類結構。

---

✅ 支援功能

• 支援還原 圖片與影片（jpg、png、mp4、mov、mkv 等格式）
• 自動建立 相簿資料夾
• 支援 Flickr 匯出中的 metadata 結構
• 還原進度條顯示
• 使用者互動：選擇是否在相簿資料夾名稱前加上「建立日期」前綴
• 還原結果將記錄成功與失敗項目
• ✅ 完整支援 Windows 11 PowerShell 與 Ubuntu 24.04 的檔名清單格式

---

🖥️ 適用環境

• ✅ Windows 11（PowerShell）
• ✅ Ubuntu 24.04（或其他常見 Linux 發行版）

---

📁 使用前資料準備

請將以下檔案/資料夾放在同一個目錄中：

restore_flickr_albums_v7_crossplatform.py         ← 本工具腳本
albums.json                                        ← Flickr 匯出的相簿資訊
photo_filenames.txt                                ← 照片與影片實體檔名清單
photos/                                            ← Flickr 匯出的照片與影片檔案
photo_id_json/                                     ← 每張照片的 JSON Metadata（Flickr 提供）

---

🐍 安裝 Python

Windows 11

1. 前往 https://www.python.org 下載並安裝最新版 Python
2. 安裝時請 勾選「Add Python to PATH」
3. 開啟 PowerShell，確認成功：

python --version

Ubuntu 24.04

sudo apt update
sudo apt install python3 python3-pip
python3 --version

---

⚙️ 安裝依賴套件（首次使用）

pip install tqdm

或 Ubuntu 使用：

pip3 install tqdm

---

🧰 如何產出 photo_filenames.txt

✅ Windows PowerShell

Get-ChildItem -Path ".\photos" -File -Recurse | Select-Object -ExpandProperty Name > photo_filenames.txt

（只包含檔名）

✅ Ubuntu / Linux

find photos -type f > photo_filenames.txt

（包含相對路徑）

🔁 v7 版腳本會自動處理這兩種格式，無需手動轉換。

---

▶ 執行腳本

Windows：

python restore_flickr_albums_v7_crossplatform.py

Linux / Ubuntu：

python3 restore_flickr_albums_v7_crossplatform.py

執行時會出現提示：

是否要在相簿名稱前加上建立日期？(Y/N):

---

📂 輸出結果說明

執行後會產生 flickr_albums_restored/，結構如下：

flickr_albums_restored/
├── 20220101_東京之旅/
│   ├── DSC00001.jpg
│   ├── IMG_0002.mp4
│
├── restored_success.txt     ← 成功還原清單
└── restored_failed.txt      ← 失敗項目與原因

📄 License / 授權條款

This project is licensed under the MIT License – see the LICENSE file for details.
本專案採用 MIT 授權條款，詳細內容請參閱 LICENSE 檔案。

You are free to use, modify, distribute, and even use it commercially, as long as you retain the original license notice.
您可以自由地使用、修改、再散佈，甚至商業使用，只需保留原始授權聲明即可。