pixelfeeder 0.1.1

Import Flickr data into a Pixelfed account

Pixelfeeder

Synopsis

Flickr is a popular photohosting site.

Pixelfed is a photohosting platform too, but federative one. It means it has plenity of community-driven instances and you able to even set up your own.

Pixelfeeder helps to import user's photo from Flickr to Pixelfed instance. Pixelfeeder has a CLI for bulk operations and a GUI for more grain control.

Installation

pip3 install pixelfeeder

Preparing

1. Get your Flickr data as described in documentation in seciton "Download all your content".

   You will get a little archive with metadata JSON files and one or more with images.

2. Create a token with write permission for your Pixelfed account. It may be done in Edit profile -> Applications -> Personal access token block.

3. Fill the options on the settings tab of Pixelfeeder GUI. Or place the obtained token file with the URL of your Pixeled instance into a config.yaml manually. See the example config.yaml

~/.config/pixelfeeder/config.yaml contains a sensitive token

Ready, steady...

FYI: Licenses of your Pixelfed photos may be changed at once with Edit profile -> Media section or you may just set desired option before uploading.

Pixelfeeder allows to reorganize caption entries with the caption_order config option. Also caption_datetime_format defines format of the date_taken entry. It should be string as in the Python datetime documentation. The default specification %c respects locale, so if it is e.g. desirable to have a lating string, environment variable may be used:

LC_CTYPE=C pixelfeeder-gui

Use ignore_ssl_verify to come through self-signed certificate.

CLI

pixelfeeder --images-dir IMAGES_DIR [--metadata-dir METADATA_DIR] [--config-file CONFIG_FILE] [--dry-run] [--help]

To just upload all the data obtained from the Flickr profile you may use the command:

pixelfeeder --images-dir PATH_TO_FLICKR_DATA

Both Flickr JSON files and corresponding images should be somewhere inside the PATH_TO_FLICKR_DATA directory (nested dirs supported).

It is possible also to prepare a directory with selected photo files to upload only some picture:

pixelfeeder --images-dir PATH_TO_CHOOSEN_IMAGES --metadata-dir PATH_TO_FLICKR_METADATA

The pixelfeeder command has the -n / --dry-run flag. With the flag no data are uploading, but output is more comprehensive.

To know all the arguments use the -h / --help flag.

GUI

pixelfeeder-gui [--config-file CONFIG_FILE] [--verbose] [--safe-mode] [--help]

Graphical interface has mostly the same options as the CLI, but upoads images one-by-one in interactive mode. User able to correct caption and visibility of a post. Tool will keep position between sessions.

Edits are not persistent for now, so it is better to make corrections just before uploading