This is a fork of the seemingly defunct http://code.google.com/p/folders2flickr/ project.

When looking for a good way to upload photos and videos to flickr from the command line, I found the following free software options:

• flickrfs - doesn't support video, freezes all the time
• imguploadr - has too many dependencies and after fixing the Solaris-based Makefile it still didn't work
• flickr_upload - doesn't support sets, is in "write-only" Perl
• uploadr - really basic, hardcoded paths and just too untested

After diving into each, folders2flickr seemed the best. It is based on uploadr, but fixes the problems I had. However it still had some bugs:

• sets didn't quite work
• slow, as it did pointless things multiple times

Fortunately it is written in Python and the code wasn't too bad. I've cleaned it up and it runs great on GNU/Linux - specifically tested on Ubuntu 12.04.

To fix the slow initial run, it will upload all photos and videos it doesn't know about. So keep the database it creates in a safe place!

The easiest way is to just make a local clone of the repository

git clone https://github.com/richq/folders2flickr.git

Then you will need to configure the directories to use:

cp uploadr.ini.sample uploadr.ini
sensible-editor uploadr.ini
# modify at least 'imagedir' to point to the location of new images

I try to keep the master branch usable and for now there are no external dependencies, so this should be fine.

As an alternative, you can also use pip.

pip install --user git+https://github.com/richq/folders2flickr.git

This will create ~/.local/bin/folders2flickr and install the library to the right place in .local. The sample configuration file can be created like this:

cp ~/.local/share/folders2flickr/uploadr.ini.sample ~/.uploadr.ini
sensible-editor ~/.uploadr.ini
# modify 'imagedir', etc.

Two files are created during execution:

• .flickrToken, which has the token to authenticate to flickr
• the history file, which contains the photos uploaded so far

By default both of these are created in the current working directory, so next time you run folders2flickr you should do so from the same place.