Skip to content

Latest commit

 

History

History
81 lines (60 loc) · 3.92 KB

README.md

File metadata and controls

81 lines (60 loc) · 3.92 KB
Raw

flickr-uploader

Upload a directory of media to Flickr to use as a backup to your local storage.

Interested in helping manage pull requests and issues? I need one or more collaborators since I no longer actively use this script.

  • trickortweak was kind enough to add me as a contributor to this repository.
  • I will be maintaining it mostly to answer queries and to incorporate pull requests/changes from other contributors.
  • I do more actively maintain this fork flickr-uploader also available on pypi.org also.

Features:

  • Uploads images in full resolution to Flickr account (JPG, PNG...)
  • Reuploads modified images
  • Removes images from Flickr when they are removed from your local hard drive
  • Uploads videos (AVI, MOV, MPG, MP4, 3GP...)
  • Stores image information locally using a simple SQLite database
  • Creates "Sets" based on the folder name the media is in (getting existing sets from Flickr is managed also)
  • Ignores unwanted directories (like ".picasabackup" for Picasa users)
  • Allows specific files to be ignored (via regular expressions)
  • Convert RAW files (with an external tool)

THIS SCRIPT IS PROVIDED WITH NO WARRANTY WHATSOEVER. PLEASE REVIEW THE SOURCE CODE TO MAKE SURE IT WILL WORK FOR YOUR NEEDS. IF YOU FIND A BUG, PLEASE REPORT IT.

Requirements:

  • Python 2.7+ (for DSM use: Official package from Synology does not work for HTTPS so use package from SynoCommunity)
  • File write access (for the token and local database)
  • Flickr API key (free)

Setup:

Go to http://www.flickr.com/services/apps/create/apply and apply for an API key Edit the following variables in the uploadr.ini:

  • FILES_DIR = "YourDir"
  • FLICKR = { "title" : "", "description" : "", "tags" : "auto-upload", "is_public" : "0", "is_friend" : "0", "is_family" : "0", "api_key" : "Yourkey", "secret" : "YourSecret" }
  • FLICKR["api_key"] = ""
  • FLICKR["secret"] = ""

Refer to https://www.flickr.com/services/api/upload.api.html for what each of the upload arguments above correspond to for Flickr's API.

Usage

Place the file uploadr.py in any directory and run via ssh (execution privs required):

$ ./uploadr.py

It will crawl through all the files from the FILES_DIR directory and begin the upload process. To check what files uploadr.py would upload and delete you can run the script withe option --dry-run:

$ ./uploadr.py --dry-run

In case you've changed the EXCLUDED_FOLDERS setting in your INI file and want to remove any previously uploaded files that are now ignored, run the script with the option --remove-ignored

$ ./uploadr.py --remove-ignored

Q&A

  • Q: Who is this script designed for?

  • A: Those people comfortable with the command line that want to backup their media on Flickr in full resolution.

  • Q: Why don't you use OAuth?

  • A: The older method is simpler to understand and works just as good. No need to fix what isn't broken.

  • Q: Are you a python ninja?

  • A: No, sorry. I just picked up the language to write this script because python can easily be installed on a Synology Diskstation.

  • Q: Is this script feature complete and fully tested?

  • A: Nope. It's a work in progress. I've tested it as needed for my needs, but it's possible to build additional features by contributing to the script.

  • Q: How to automate it with a Synology NAS ?

  • A: First you will need to run script at least one time in a ssh client to get the token file then with DSM 5, create an automate task, make it run once a day for example, and put this in the textbox without quotes "path_to_your_python_program path_to_your_script". For example, assuming you installed Python package from Synocommunity, command should look like "/usr/local/python/bin/python /volume1/script/flickr-uploader/uploadr.py".