Skip to content
This repository

flickr-fu is a ruby interface around the flickr REST api

branch: master

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 lib
Octocat-spinner-32 spec
Octocat-spinner-32 .gitignore
Octocat-spinner-32 Gemfile
Octocat-spinner-32 Gemfile.lock
Octocat-spinner-32 LICENSE
Octocat-spinner-32 README.md
Octocat-spinner-32 Rakefile
Octocat-spinner-32 VERSION.yml
Octocat-spinner-32 flickr_fu.gemspec
README.md

flickr-fu

Contact

Author: Ben Wyrosdick Email: ben [at] commonthread.com Issue tracker: https://github.com/commonthread/flickr_fu/issues Code Repository: http://github.com/commonthread/flickr_fu/tree/master

Getting Started

You need to first get an API key as detailed here:

http://www.flickr.com/services/api/misc.api_keys.html

Installation

sudo gem install flickr_fu

Documentation

Documentation can be found here: http://rubydoc.info/gems/flickr_fu/

Example flickr.yml

--- !map:HashWithIndifferentAccess
key: "YOUR KEY"
secret: "YOUR SECRET"
token_cache: "token_cache.yml"

Authorization

To authorise your application to access Flickr using your API key you will need to access a specific URL.

To generate this URL run the following and when presented with the URL access it from your browser. Confirm the application has permission at the level you have specified.

Note that flickr has different types of keys. If you use one for a webapplication, which is most likely, you need to define a callback and somehow make sure that you connect the parameter :frob that flickr send via the callback is assigned to the right user account. The best way to do this is to loop over all the current user's flickr accounts and try flickr.auth.token with the :frob.

Finally, cache the token (this will create the token cache file)

If you have an invalid API key you will see errors such as:

"100: Invalid API Key"

If you don't follow the process below to authorise your application you will see errors such as:

"98: Login failed / Invalid auth token" or 
"99: User not logged in / Insufficient permissions"

Authorization Example for non-webapplication

require 'flickr_fu'
 
flickr = Flickr.new('flickr.yml')
  
puts "visit the following url, then click  once you have authorized:"

 # request write permissions
puts flickr.auth.url(:write)
  
gets
  
flickr.auth.cache_token

Authorization Example for a webapplication

flickr.auth.token also contains the nsid and username, this example only stores the token and no other userdata.

require 'flickr_fu'
  class FlickrController  current_user.flickr_token))
      # now you have full access on the user's data :)
    end
end

Search Example

require 'flickr_fu'

flickr = Flickr.new('flickr.yml')

photos = flickr.photos.search(:tags => 'ruby-flickr')

puts "found #{photos.size} photo(s)"

photos.each do |photo|
    puts photo.title
    puts photo.description unless [nil, ''].include?(photo.description)
    [:square, :thumbnail, :small, :medium, :large, :original].each do |size|
      puts "#{size}: #{photo.url(size)}"
    end
    puts "comments: #{photo.comments.size}"
    photo.comments.each do |comment|
      intro = "#{comment.author_name} says - "
      puts "#{intro}\"#{comment.comment.gsub("\n", "\n"+(" "*intro.length))}\""
    end
    puts "notes: #{photo.notes.size}"
    photo.notes.each do |note|
      puts "[#{note.x},#{note.y} ~ #{note.width}x#{note.height}] - \"#{note.note}\""
    end
    puts
    puts
  end

Another Search Example

If searching for photos by user id then you need to specify the 'alias' - without intervention this is usually set by Flickr and is an alphanumeric string.

To find out the user id for a given user, you can use the tool at:

http://idgettr.com/

And replace the line in the above sample to query on user id:

photos = flickr.photos.search(:user_id => 'your_user_id_here')

Patch Contributers

  • Chris Ledet
  • Maciej Biłas
  • Mike Perham
  • Chris Anderton
  • Luke Francl
  • Thomas R. Koll
  • P. Mark Anderson
  • Josh Nichols
Something went wrong with that request. Please try again.