pixelfeeder 0.2.0

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.

Now with the pixelfeeder-export command to download all your posts!

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.

Configuration syntax

A config file contains a sensitive token

A config file is YAML formatted and basically has form of variable: value. A config example file available in the source code repository. Also the pixelfeed-gui creates a ~/.config/pixelfeeder/config.yaml file.

Value	Required	Meaning	Note
instance	*	"Base URL" of a Pixelfed instance
token	*	User created token with write permission	May be placed just in a one long line
ignore_ssl_verify		Ignore certificate issues like self-signed certs	Boolean value like false|true
timeout		HTTP requests timeout including file operations	Not yet supported by gui
caption_datetime_format		strftime compatible string	Better to wrap the value into qoutes
caption_order		Fields will be placed in this order separated by empty lines	Field may be omitted or appears more than once
theme		Optional value for the Tk GUI

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.

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

Backup command

pixelfeeder-export --output-dir OUTPUT_DIR [--skip-media] [--config-file CONFIG_FILE] [--help]

Download all posts (statuses) with media of owner of the Pixelfed instance token (see Preparing.

Obtained data is prepared to be uploaded with pixelfed with some restrictions (e.g. no statues with multiple pictures).

See all options with the -h / --help flag.