Phockup：照片与视频自动整理工具

Phockup：照片与视频自动整理工具

phockup Media sorting tool to organize photos and videos from your camera in folders by year, month and day. 项目地址: https://gitcode.com/gh_mirrors/ph/phockup

项目介绍

Phockup 是一个媒体整理工具，专门用于按年、月、日将来自相机的照片和视频文件自动分类到相应的文件夹中。它会保留原始文件内容不变，仅重命名文件并将它们放置在合适的时间结构目录下。所有无法识别为图片或视频，或缺失创建日期信息的文件，将被归类到名为“unknown”的文件夹中。此工具确保输入目录中的所有文件经过处理后，在输出目录中都有一个副本，从而允许安全删除原目录。

项目快速启动

环境需求

确保您的系统已安装 Docker 或符合特定平台的安装要求（如 Homebrew、Snap 或手动编译）。

使用 Docker 快速执行

对于一次性的执行，通过以下命令使用 Docker：

docker run -v ~/Pictures:/mnt ivandokov/phockup:latest /mnt/input /mnt/output

替换 ~/Pictures 为实际照片存储路径，并相应地调整输入输出目录。

若要设置定时执行（例如，每分钟运行一次），采用以下命令：

docker run -v ~/Pictures/input:/mnt/input -v ~/Pictures/output:/mnt/output -e "CRON=* * * * *" ivandokov/phockup:latest

请注意，需保证 Docker 可以访问您的照片目录。

非 Docker 安装（以Linux为例）

如果您不想使用 Docker，可以在支持的Linux发行版上通过源码编译安装。首先确保安装了必要的依赖项，然后按照以下步骤操作：

sudo apt-get install python3 libimage-exiftool-perl -y
curl -L https://github.com/ivandokov/phockup/archive/latest.tar.gz -o phockup.tar.gz
tar -zxf phockup.tar.gz
sudo mv phockup-* /opt/phockup
cd /opt/phockup
pip3 install -r requirements.txt
sudo ln -s /opt/phockup/phockup.py /usr/local/bin/phockup

之后，可以通过以下命令执行 Phockup：

phockup 输入目录 输出目录

应用案例和最佳实践

假设您有一个杂乱无章的摄影集存放于 ~/Photos 目录，想要将其整齐地按照时间线组织到 ~/Organized_Photos 中，可以简单地调用 Phockup。这不仅便于管理和回顾，也优化了备份过程。最佳实践中，建议先在一个测试目录上试验 Phockup 的功能，确保其满足您的整理需求，特别是文件重命名和目录结构方面。

典型生态项目

虽然 Phockup 本身是独立工作的，但它可以与各种云同步服务或家庭服务器集成，作为自动化工作流程的一部分。例如，结合使用 Raspberry Pi 运行定期的 Phockup 脚本，自动整理从多个设备上传的照片至网络存储，实现媒体资料的集中化管理。此外，与其他自动化工具如 GitLab CI/CD 结合，可实现在新照片添加时自动触发整理流程，进一步提升效率和便利性。

---

以上便是基于 Phockup 开源项目的简明指南，帮助您快速开始并理解其基本应用场景及维护策略。

phockup Media sorting tool to organize photos and videos from your camera in folders by year, month and day. 项目地址: https://gitcode.com/gh_mirrors/ph/phockup