README

一个用于Flickr的命令行界面。通过shell上传和下载照片、照片集、目录。

安装

1. 从Github克隆

    git clone https://github.com/TheFox/flickr-cli.git
   

2. 安装依赖项

    composer install
   

3. 前往 https://www.flickr.com/services/apps/create/apply/ 创建新的API密钥。第一次运行 ./bin/flickr-cli auth 时，您将被提示输入新的消费者密钥和密钥。

用法

首先获取访问令牌

./bin/flickr-cli auth

上传

./bin/flickr-cli upload [-d DESCRIPTION] [-t TAG,...] [-s SET,...] DIRECTORY...

下载

./bin/flickr-cli download -d DIRECTORY [SET...]

将所有照片集下载到目录 photosets

./bin/flickr-cli download -d photosets

或只下载照片集 2013年假日

./bin/flickr-cli download -d photosets 'Holiday 2013'

要下载所有照片到以照片ID命名的目录（这样在重命名相册或照片时不会改变；非常适合完整的Flickr备份），可以使用 --id-dirs 选项

./bin/flickr-cli download -d flickr_backup --id-dirs

这会创建一个稳定的目录结构，形式为 destination_dir/hash/hash/photo-ID/，并保存完整的原始照片文件以及包含所有照片元数据的 metadata.yml 文件。MD5哈希的前两组两位字符是必需的，以防止单个目录包含过多的子目录（以避免某些文件系统的问题）。

Docker镜像的用法

设置

要使用Docker中的此软件，请按照以下步骤操作。

1. 创建一个卷。这将用于存储 auth 步骤的配置文件。

    docker volume create flickrcli
   

2. 获取访问令牌（它将在卷中创建 config.yml 文件）。

    docker run --rm -it -u $(id -u):$(id -g) -v "$PWD":/mnt -v flickrcli:/data thefox21/flickr-cli auth
   

   或者您可以将 config.yml 存储在您的 $HOME/.flickr-cli 目录中并使用

    mkdir $HOME/.flickr-cli
    docker run --rm -it -u $(id -u):$(id -g) -v "$PWD":/mnt -v "$HOME/.flickr-cli":/data thefox21/flickr-cli auth
   

用法

将填充JPEG的目录 2017.06.01-Spindleruv_mlyn 上传到Flickr

docker run --rm -it -u $(id -u):$(id -g) -v "$PWD":/mnt -v flickrcli:/data thefox21/flickr-cli upload --config=/data/config.yml --tags "2017.06.01 Spindleruv_mlyn" --sets "2017.06.01-Spindleruv_mlyn" 2017.06.01-Spindleruv_mlyn

对于Docker镜像的问题排查，您可以使用

docker run --rm -it -u $(id -u):$(id -g) -v "$PWD":/mnt -v flickrcli:/data --entrypoint=/bin/bash thefox21/flickr-cli

路径

• /app - 主应用程序目录。
• /data - 变量数据的卷。
• /mnt - 主机系统的 $PWD。

文档

• Flickr API文档
• Docker文档

许可

版权（C）2016 Christian Mayer https://fox21.at

本程序是自由软件：您可以根据自由软件基金会发布的GNU通用公共许可证的条款重新分发和/或修改它，许可证版本为3，或者（根据您的选择）任何较新版本。

本程序是根据希望它将是有用的目的进行分发的，但没有任何保证；甚至没有关于适销性或适用于特定目的的隐含保证。有关详细信息，请参阅GNU通用公共许可证。您应该已随本程序收到GNU通用公共许可证的副本。如果没有，请参阅https://gnu.ac.cn/licenses/。