flickrbackup 0.10.1

安装

需要Python 3和pip。

$ pip install flickrbackup

使用方法

注意：您必须拥有Flickr Pro账户才能使用此工具，因为Flickr仅允许Pro会员访问原始尺寸的图片。

第一次运行flickrbackup时，您应指定一个开始日期，格式为YYYY-MM-DD

$ flickrbackup.py -f 2012-02-28 photos

这会要求您访问一个URL以授权flickrbackup使用您的Flickr账户，如果您尚未这样做的话。然后Flickr会提供一个短期的令牌，您必须将其输入到控制台。此令牌将保存以供将来使用，因此您不应需要任何手动干预，除非您或Flickr吊销了此令牌。

一旦授权，flickrbackup将下载所有授权账户在“开始”日期或之后创建或更新的照片和视频，并将它们下载到指定的目录中（在这个例子中是photos）。项目将按集和年份、月份和日期组织到子文件夹中。如果一个项目出现在多个集中，它将复制到两个集的目录中。标题、描述、标签和其他信息将放置在与图像文件相邻的具有.txt扩展名的文件中。图像文件名基于图像的Flickr ID。

第一次成功运行后，下载目录中会放置一个名为.stamp的特殊文件，其中包含上次备份的日期。这使得flickrbackup可以在没有-f参数的情况下再次运行，例如在计划的夜间“cron”作业中，从上次停止的地方继续。

$ flickrbackup.py /path/to/photos

在这里，我们也省略了“-v”（详细）标志，这意味着只有错误和重要消息会输出到控制台，以及处理过的照片的ID日志（主要作为进度指示器）。

将重要消息记录到文件中可能很有用。在这种情况下，使用--log-file（-l）选项（带或不带-v标志来控制输出信息的数量）

$ flickrbackup.py -l /var/log/flickrbackup.log /path/to/photos

日志文件将包含消息类型（例如，INFO表示信息性消息或WARN表示警告）以及消息的日期和时间。

如果出现错误怎么办，例如由于临时连接问题？flickrbackup将尝试再次下载它们（您可以使用--retry选项来控制重试次数或关闭此功能；默认为重试一次），但如果仍然存在错误，它们将被打印到控制台/日志文件。

我们可以使用--error-file（-e）标志来存储未正确处理的照片和视频的ID列表

$ flickrbackup.py -e /path/to/photos/errors.txt /path/to/photos

稍后，我们可以尝试使用--download（-d）选项手动重新处理这些照片

$ flickrbackup.py --download /path/to/photos/errors.txt /path/to/photos

如果成功，您应该删除errors.txt，因为-e选项将始终追加到该文件，而不是替换它。

从版本0.10开始，还可以下载认证用户的收藏夹照片（可能是其他用户上传的）。在这种情况下，文件总是按日期组织，而不是设置

$ flickrbackup.py --favorites /path/to/faves

要查看更多帮助，请运行

$ flickrbackup.py --help

已知限制

• 电影文件将始终使用.mov扩展名，即使最初上传为.avi或.mpg等，因为Flickr没有提供发现原始文件扩展名的方法。

• 在备份后已删除或在不同集之间移动的照片将保留在备份中。

注销

OAuth令牌存储在位于~/.flickr/oauth-tokens.sqlite的数据库中。如果需要，您可以删除此文件以强制重新授权。

变更日志