Skip to content
This repository


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Smugmug API Wrapper

branch: master

Fetching latest commit…


Cannot retrieve the latest commit at this time

Octocat-spinner-32 lib
Octocat-spinner-32 test
Octocat-spinner-32 .gitignore
Octocat-spinner-32 LICENSE
Octocat-spinner-32 README.rdoc
Octocat-spinner-32 Rakefile
Octocat-spinner-32 smirk.gemspec


Smirk is a Ruby wrapper around the SmugMug 1.2.2 API. You can access the albums, images, and categories behind an authenticated account.


First, you need to start a session with your SmugMug username and password.

smug ="", "mypassword")

You can call albums, categories, find_image, and find_album methods on a Client object.", ")
=> "Trees, Flowers, Birds"", ")
=> "Airplanes, Animals, Aquariums, Architecture, Art"

You can gather all the images within albums.

smug.albums.each do |a|", ")
=> "IMG_513.jpg, IMG_514.jpg, IMG_515.jpg"

When you're done, you should logout to terminate the session:


More documentation to come.

Note on Patches/Pull Requests

  • Fork the project.

  • Make your feature addition or bug fix.

  • Add tests for it. This is important so I don't break it in a future version unintentionally.

  • Commit, do not mess with rakefile, version, or history. (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)

  • Send me a pull request. Bonus points for topic branches.


Copyright © 2010 James Miller. See LICENSE for details.

Something went wrong with that request. Please try again.