Google Photos Deduper 使用教程
项目介绍
Google Photos Deduper 是一个用于删除 Google Photos 中重复照片的本地运行 Web 应用和 Chrome 扩展。该项目由 mtalcott 开发,使用 React、Python、TypeScript 和 Docker 等技术构建。由于 API 使用限制、Google 应用验证过程的成本和用户隐私考虑,目前没有提供托管的 Web 应用,用户需要本地运行该应用。
项目快速启动
1. 安装 Docker Desktop
确保你的系统上已安装 Docker Desktop。如果没有安装,可以从 Docker 官网 下载并安装。
2. 克隆项目仓库
git clone https://github.com/mtalcott/google-photos-deduper.git
cd google-photos-deduper
3. 创建 Google Cloud 项目和 OAuth 凭证
- 创建一个 Google Cloud 项目(指南)。
- 启用 Photos Library API。
- 在 OAuth 同意屏幕中,选择外部用户类型并创建应用。
- 添加必要的 OAuth 范围:
https://www.googleapis.com/auth/userinfo.profile
https://www.googleapis.com/auth/userinfo.email
https://www.googleapis.com/auth/photoslibrary
- 创建 OAuth 客户端 ID,应用类型选择 Web 应用,并设置授权的 JavaScript 来源和重定向 URI 为
http://localhost
。
4. 设置本地环境变量
cp example.env .env
编辑 .env
文件,填入你的 OAuth 客户端 ID 和客户端密钥。
5. 启动应用
docker-compose up
应用启动后,访问 http://localhost
即可使用。
应用案例和最佳实践
应用案例
- 个人用户:定期清理 Google Photos 中的重复照片,节省存储空间。
- 摄影师:在不同设备上编辑和上传照片后,使用该工具删除重复的照片,保持图库整洁。
最佳实践
- 定期使用:建议定期运行该工具,特别是在导入大量新照片后。
- 备份数据:在删除重复照片之前,确保已备份重要数据,以防误删。
典型生态项目
- Google Photos API:该项目依赖 Google Photos API 进行照片管理和删除操作。
- Docker:使用 Docker 容器化应用,简化部署和运行过程。
- React:前端界面使用 React 框架开发,提供良好的用户体验。
- Python:后端逻辑使用 Python 编写,处理照片去重和 API 调用。
通过以上步骤,你可以快速启动并使用 Google Photos Deduper 工具,有效管理你的 Google Photos 图库,删除重复照片,提升存储效率。