I'm pleased to announce the release of AlbumFetcher! AlbumFetcher is a little pet project of mine which I've decided to make freely available to the SmugMug community. I've received amazing amounts of help (and ideas) through these forums, and this my way of saying thanks. It's a simple little app that serves two main functions:
1. Download one or many SmugMug galleries at once
2. Embed captions and keywords into your downloaded images' IPTC headers
AlbumFetcher should run on Win2000, WinXP and above. It has been reported to run under Wine on Linux and through Parallels on a Mac. It's a single file, so it's easily portable and doesn't need to be installed. AlbumFetcher is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
This DGrin thread will be the project's home page. Feedback is extremely appreciated, and if there are bugs and/or other issues (as there always are), please let me know here. This is a hobby, so I can't hope to live up to SmugMug's standard of customer service, but I will try to help you out if you're having an issue with the software. One word of caution - beware of the total number of bytes you download. You could easily run up against your monthly bandwith limit.
Again, this is yours to use forever for free. However, if you're a fan of my little app and feel so inclined, you can send me the electronic equivalent of the adult beverage of your choice here.
-GregCurrent version: v0.3.3 - Application | SourceHow Does it Work?
Download AlbumFetcher (zip file) with the link above.
Use WinZip or your favorite zip program to extract AlbumFetcher.exe (the program) to the folder of your choice (maybe the desktop).
Double-click the AlbumFetcher program icon.
If you're an account owner: In the top-right corner, enter your SmugMug ID and password. If you're a guest: Switch the login type selector to Guest. Then enter the SmugMug ID of the account you'd like to work with. You'll only have access to listed public galleries. (SmugMug ID means either your email address which is registered with SmugMug or the yourname part of yourname.smugmug.com. Your ID and password go directly to SmugMug; there's nobody listening in between.)
Click List Albums. A listing of all your albums will appear.
In the Download Options box (on the right), pick a folder to save albums to. Also pick the image sizes and other options as you wish.
Click the list to select albums for download. Use Ctrl-clicking or Shift-clicking to select more than one.
Click Fetch Albums. AlbumFetcher will now download your requested albums at the size you specified.
Have a tasty beverage.
UPDATE, Nov 14 2006:
I've incorporated some of Pat Kane's requests and some improvements of my own into v0.2. New features include:
Datetime stamp for each line in log file
Files with same original name are now handled successfully (an underscore is prepended to the second file's name).
Users can optionally skip over previously downloaded images (helpful when a download fails and you want to start over, but not re-download all the successful images).
Category/subcategory info is shown as a field in the list control.
A thumbnail of the image currently being downloaded is displayed.
Total time statistics are recorded when a job is completed successfully.
MD5 hashes are now compared. Files that fail the comparison are left alone, but a note is made in the log file.
UPDATE, Nov 16 2006:
Pat Kane pointed out a bug in the folder selector, which is now fixed. Current version is now 0.2.1. Thanks, Pat!
UPDATE, Jan 11 2008:
I'm pleased to announce the release of AlbumFetcher v0.3. There are several improvements in this release. Read on for details.
Multiple login options - Users may now login to SmugMug as account owner, guest, or guest with site password. If you're uncomfortable with other people being able to bulk-download your images, set your external linking option (in gallery customization) to "No."
Album-level password support - Guests may download password-protected galleries (with the proper password of course).
Selectable image size for download - Choose which size you want! AlbumFetcher will find the next largest available if logged in as guest and requested size is not available.
Video support - Choose which size you want! AlbumFetcher will find the next largest available if logged in as guest and requested size is not available. Support is also included for legacy mpeg-1 videos.
As inspired by SmugMug, AlbumFetcher is stretchy!
No more runtime errors - (Fingers crossed.) AlbumFetcher has essentially been completely rewritten. I found a few scenarios that caused the app to crash during my development process, and they've been eliminated. I've successfully downloaded thousands of images while testing. Let me know if you still have runtime problems.
UPDATE, Jan 12 2008:
Scott Walter pointed out a bug which caused the app to crash when downloading GIFs, which is now fixed. Current version is now 0.3.1. Thanks, Scott!
UPDATE, Jan 29 2008:
A few people were having similar issues. Basically AlbumFetcher was bombing out if it tried to download an image which was missing (for whatever rare reason) on SmugMug. This is now handled more gracefully in new Version 0.3.2 (link above) - AlbumFetcher will stop the download and report the error (instead of crashing).
UPDATE, Mar 3 2008:
AlbumFetcher is now compatible with SmugMug's security changes (use of keys).
UPDATE, Dec 15 2008:
It's been a pleasure over the past two years to see AlbumFetcher become a useful little download utility for members of the SmugMug family. The users of AlbumFetcher deserve a product that will continue to evolve and keep up with the latest SmugMug features (hidden photos, SmugVault, etc). To use the catchphrase circulating at work, I no longer have the personal bandwidth to keep AlbumFetcher current.
This thread is a call for help for someone to take the AlbumFetcher reins. The code is simple Microsoft Visual C++, using MFC. If there's anyone interested in taking the project over as-is or porting it to something cross-platform, let me know.
Thanks, and thanks again to those who've had kind words and future ideas for AlbumFetcher.
I am new to Smug Mug but my company has created a partnership with them... we are a video production company that deals with lots of photos and I am using SM to organize photos. Clients can upload them, sort them, caption them and then we pull them down...
I got your program (which is very cool), to batch download, but the are not staying in the order they are re-arranged and I can't find the IPTC / Captions. I've been testing for hours... can you help?[email protected]
AlbumFetcher does not currently support any kind of sorting order. The files will be arranged by filename or whatever your operating system defaults to. This functionality could be added, as I assume SmugMug makes that information available in the API; it's just not implemented.
AlbumFetcher embeds the IPTC and caption info in the JPEGs directly. They should be viewable by an image viewer which displays this information. If you wanted the captions written to some sort of text file, that functionality could be added to the app.
Thanks for the question; hope this helps.
It would be great if you could retain the Category/Sub-Category of a Gallery (using Folders and Sub-Folders). I have gone to great lengths to organize my Galleries by Year/Month (custom Category/Sub-Category), and having this feature would be unbelievably helpful.
Mine won't connect for some reason. Did something change that requires an update?
Same here, smugmug ID is an email address... i've been using the same creds, worked earlier today, didn't work last night, not working tonight at all. ARG1
I can connect to my account correctly, however fetching images results in this error: "GetUrlContentsAsMemFile failed in GetUrlContentsAsFile call". I get this error with both my accounts, and it does not matter how I log in (guest/owner).
Is there a change in the API or something? Does someone else also know about this problem?
Just checked, and I'm getting the same error. I've seen announcements about SmugMug doing some work, but didn't think it would affect the API. If the problem persists, I'll dig into the code.
To the Smug peeps, have there been any changes to the API that would break apps? I'm sure I'm using a ye olde version of the API. Thanks!
Downloaded the program, unzippped. Have no idea what to click on to open program and start?
Thank you SO much for this! I've been thinking about returning to a free site for photosharing so that I could use Carbonite or Backblaze for back up (and not have to pay for 2 services), but now I see there is an easy way to retrieve my photos from Smugmug too.
Are there any limitations on what it can retrieve? I have already tested it with JPG and PNG. How about movie files and document files (I use SmugVault)?
Make sure you got the program link, and not the code link. The program is just one file - AlbumFetcher.exe.
In the original post, did you click on Source instead of Application? I clicked on Application and only got the program.
On different computer, think I clicked on Program not source. What would you get if you clicked on source ? Downloaded the program on this computer: opened and worked fine.
Problem : how do you specify what gallery you want to download ? Seems to just start downloading every thing. I mean after the first gathering of album list.
Also won't abort. Starts filling up this person's wee laptop with allmy albums.
I need an idea of what to expect : 1st it does this, then it does this, then this happens, then the album is located somewhere,etc.Right now each step is cause for panic.
When you run AlbumFetcher, you must first log in with your SmugMug UserID/email and password. Then you'll be presented with a list of galleries. Select the galleries you want (use the Control button to select more than one), and then start the download.
I get the following error in the log
Internet Exception: 12016
When I run the api url as it appears in the log I get a good return.
Download failed on file https://api.smugmug.com/services/api/rest/1.2.1/?method=smugmug.login.withPassword&APIKey=gcmpLhfmdqnLIjmn5FyT5ELQcc01VObf&[email protected]&Password=xxxxxxi. Received Internet Exception: 12016
Removed email and password.
I still get the same error. Did you already figured out what the problem is?
Are you able to get any galleries downloaded at all? I suppose I'm asking whether the problem is general, or specific to some set of circumstances.
No, cannot get any galleries. If I login as guest without a password I can download but then I get the photos with the watermarks on it.
When you login (as owner), are you using your email address or your smugmug userid? Try whichever you haven't.
My next question will be whether you have any non-alphanumeric characters in your password. You don't have to answer, but it's possible that SmugMug handles them fine and my app doesn't.
I've tried both Email and userid. Password is numeric and alpha. The strange this is when I pull the url from the log and put it into the browse I get a good return.