Import Flickr data into a Pixelfed account
Project description
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
-
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.
-
Create a token with
write
permission for your Pixelfed account. It may be done in Edit profile -> Applications -> Personal access token block. -
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 | |
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
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for pixelfeeder-0.1.1.post0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | b494db8f4815c0fc11e6ba545530e396577977bc050aacf3e99cd1356a9320a3 |
|
MD5 | 5b027289ee5f512e4fa6413754a00a6e |
|
BLAKE2b-256 | d8aceadb93b23db5c1fc456fa872e805f034f628ec5ca03829c0cf805adadcf1 |