Photobucket ripper update


I wrote about mine in past posts (here and here) but ever since PB has updated their design, my implementation has become broken. The method I used was no longer working… overall the tool was very popular, was reposted a few times and I received lots much valued feedback for it :) but I didn’t continue because I didn’t need it myself, among other things.

However my dear friend Daxda was kind enough to find a new way to do it and he re-wrote the tool in a more error-tolerant manner, that I believe should work for much longer than mine.
Right now it’s still in development stage but it works more or less and is very simple to use. It’s called “PB Shovel” (

Here’s an output of the script:

usage: [-h] [-r] [-o OUTPUT_DIRECTORY] [--omit-existing]
                    [-v VERBOSE] (-f FILE | -u URLS [URLS ...])
                    [--images-only | --videos-only] [-n USERNAME]
                    [-p PASSWORD]

optional arguments:
  -h, --help            show this help message and exit
  -r, --recursive       Recursively extracts images and videos from all passed
                        The directory the extracted images getting saved in.
  -v VERBOSE, --verbose VERBOSE
  -f FILE, --file FILE  A file containing one or more Photobucket links which
                        you want to download.
  -u URLS [URLS ...], --urls URLS [URLS ...]
                        One or more links which point to an album or image
                        which is hosted on Photobucket.
  --images-only         Do not download any other filetype besides image.
  --videos-only         Do not download any other filetype besides video.

  -n USERNAME, --username USERNAME
                        The username or email which is used to authenticate
                        with Photobucket.
  -p PASSWORD, --password PASSWORD
                        The matching password for your account.

For a private album the format is like this:

python -u "password@"

To run it, you will need 2 libraries called “Requests” and “BeautifulSoup”, both for your convenience been uploaded here, simply extract the archive into the “PB Shovel” folder and done.

Edit 2014.04.17: added an option to skip existing images. They will be skipped if image names match. If that option is not set then the script will not replace or skip images. To skip images just add “–omit-existing” to the command line.

Edit 2014.04.07: lots of things have changed and a lot of things have been added. It’s now more functional than it was. Supports downloading from your own account, downloading locked (private) archives, you can choose what types of files (video or image) to get and download whole albums, including sub-albums.

So, to use it, typically you run this command:

python -u "" -r -o PB_Shovel

If anything comes up, please post here so the tool could be improved :)


  1. Old Windways says:

    I tried running the tool to pull an album (starting with a small one to test), and got the following output in the command line:

    Estimated files in current album: 3
    Traceback (most recent call last):
    File “”, line 355, in
    File “”, line 132, in extract
    image_links = self._album(source)
    File “”, line 332, in _album
    obj[“likeCount”], obj[“commentCount”],
    KeyError: ‘likeCount’

    I’m not sure why it seems to be choking on likeCount…

  2. Kulverstukas says:

    Hello Old Windways. The script has been updated just now. Try it again :)
    If it breaks again, it would be very helpful if you could share the album URL so we could see for ourselves.

  3. Old Windways says:

    I had to install beautifulsoup4, but it seems to be working now (both using a single link, and with a file listing 4 links)! Hooray!!

  4. Sing says:

    Hi, me again.

    I noticed your script is not downloading the original size of photos.
    The original size path should be

    By the way, the extension I made has a free version.
    It limited to 100 photos/album and compressed size of photos(fullsizeUrl)

    The extension is totally Javascript, but it will not open source
    until Photobucket officially released the download album function :)

  5. Kulverstukas says:

    AFAIK PB already has an album downloading feature, however only for your own albums.
    Thanks for the tips though, we’ll see what can be done :)

  6. Kulverstukas says:

    Since the author is too shy to post here, I’ll say that the script has been updated to download full size images now and connection timeout increased for slow internet speeds. Enjoy! :)

  7. Dude says:

    Hi just stopped by to say thanks, you just saved me hours of boring work.
    Keep rocking

  8. Kulverstukas says:

    Hey you’re welcome :) keep checking, the author might include some great features in the future ;)

  9. Ripper says:

    Any way to skip already downloaded images?

  10. Kulverstukas says:

    Hey ripper,
    Such function isn’t available right now, but Daxda is working on that and should be implemented in a few days or something :)

  11. Kulverstukas says:

    Script has been updated.
    Added an option to skip existing images. They will be skipped if image names match. If that option is not set then the script will not replace or skip images. To skip images just add “–omit-existing” to the command line.

  12. KL says:

    Does PB Shovel work for albums that are private and don’t have input form for password? Do you have to get password for private albums?

  13. Kulverstukas says:

    @KL: It should work for all kinds of private albums. If the album is also locked with the password, it will have to be provided. PB shovel doesn’t crack them :P

  14. phatWares says:

    Just wanted to say “thanks” where it’s due. In this case, it’s thanks to YOU (and “Daxda” maybe) for leading me to how to login to guest-pass protected albums. I hadn’t really been sweating it much since most people tend not to have guest passes to use. But it’s a nice feature to have either way.
    I’m not using Python, so it took a bit of translation. But your code was clean and well-commented which made life very easy. :-)
    If you can compile this (so people don’t need to download a Python interpreter and various libraries) and put it inside a nice GUI … in other words dummy-proofing it for the general public … you might be able to compete with me. ;-)

  15. phatWares says:

    Oh, and if anyone out there DOES have the hacking wizardry skills to crack private albums and is interested in being buried in money, feel free to click on my name above to go to my home page and click on the “Contact” button. My old hacking partner decided to take his ball and go home (immigrated to the US and left bucket hacking behind). So I am searching for a new partner.
    I’m a developer primarily and NOT a hacker. I’ll admit it; no shame in my game. ;-)

  16. Kulverstukas says:

    @phatWares: Daxda is the author, and about making a GUI, well that might come in the future, however the tool wasn’t intended to be the best one out there, it just works very well :)
    Btw you seem like a knowledgeable dude, if you don’t mind, hop onto Evilzone’s irc channel (, #evilzone) to chat and maybe find fellow devs :)

  17. Jango says:

    So I couldn’t actually get this to download any private albums. It would connect and all that but it would just say download files 0/0. I tried a bunch of private profiles but no luck. Does it no longer work?

  18. Kulverstukas says:

    AFAIK it should still be working. It would help a lot if you could post some album that doesn’t work for you :)

  19. kraz says:

    Yea im having the same 0/0 issue. Not sure if private albums need a specific url or not. No issue with publics. This returned no results “”

  20. zeu says:

    Any words on an update for this problem of 0/0 downloads?

  21. Kulverstukas says:

    If I may ask how are you invoking the tool? obviously to download a private album you need to provide a password for it.
    For guest albums command is:
    python -u “password@”

    And to download a completely private album, you need to use -n (username) and -p (password) switches, otherwise you get the same 0/0 issue.

  22. kraz says:

    ^yea I think guest pass isn’t working as a whole for doesn’t work through the webpage either

  23. Kulverstukas says:

    Well then we’ll have to wait and see :)

  24. jojo says:

    Hey could anyone “shovel” this for me?

  25. Kulverstukas says:

    No one can unless you have a password for it…

  26. leroy says:

    does this still work I was using your old one just started getting back into PB. I only need it to download complete buckets because the download button sometimes is stuck in a loop

  27. Kulverstukas says:

    My old one doesn’t work AFAIK, however this one (PB Shovel) was working last time I checked. Try it and see.

  28. leroy says:

    do you have a tutorial on how to make this work? not my field of expertise python wise

  29. Kulverstukas says:

    You do not need a tutorial to make this work. Install python and run

    python -u "" -r -o PB_Shovel

    from command line

    I wrote that at the very end of the post… You have to be completely clueless if you can’t understand from here.

  30. JJ says:

    Just keep getting syntax errors from ‘’ :[

  31. Kulverstukas says:

    Would be nice if you posted those syntax errors so I can help more.

    Btw, The author of this tool has deprecated it and I’m afraid but he’s no longer going to work on it :( however it should still be working?

  32. JJ says:

    Wish I could help more but I’m not a tech person to be honest. One of the first times I’m using the cmd line to do anything. I installed python fine, According to your last post I should input this into the command line [python -u “” -r -o PB_Shovel] substituting of course, the actual photobucket address I want to use.

    It says file (stdin) line 1.
    Invalid syntax

  33. Kulverstukas says:

    With Python you also need to install 2 other libraries, that might be the cause. I repacked those libs for convenience, you can download them from here and extract that to PB Shovel folder.

    Edit: Just tried it, still works good. You are most likely missing the libs, which means you didn’t read my post to the end :)

  34. leroy says:

    Still can’t get it to work. I’m working on a mac and I downloaded canopy. Then I opened shovel.
    In the top box I get a bunch of code and in the lower box is where I can type in the request.

    I have one folder inthere I have the file pb° and I have 2 folders bs4 and request.

    when I enter

    python -u -r -o PB_Shovel in the lower box I get syntaxerror: invalid syntax same for
    python -u and

    Any suggestions ?

  35. Kulverstukas says:

    You need to put the URL in double quotes, like so:

    python -u "" -r -o PB_Shovel

    That’s essentially how the command line works :)

  36. Kulverstukas says:

    This is a really weird problem. Might be related to that Canopy thing you use, why are you even using that? Just Python and Command line is enough…

  37. sur says:

    I am getting the following error:

    File “”, line 6, in from urlparse import urljoin, urlparse ImportError: No module named ‘urlparse’

  38. Kulverstukas says:

    Then you have a flawed Python installation. Reinstall and try again, using Python 2.7.

  39. leroy says:

    do you know how to get it to work on a mac? I’m using python 2.7.8

  40. Kulverstukas says:

    Like I said… uninstall whatever you installed that is supposed to be Python and install normal Python:
    Then try again.

  41. Karma says:

    Is there an argument to download full size files? I’m only getting the compressed versions. I can click through on the webpage to the fullsizes. Thanks.

  42. Kulverstukas says:

    Uhm… AFAIK it gets full-sized pics, if not then too bad.

  43. JJ says:

    I’ve actually read and followed your instructions quite a few times. I always take my time to read over and I’m still stumped. I have installed the libs into the folder and still cant get it. – Installation folder – The Invalid syntax error

  44. Kulverstukas says:

    The problem here is that you launch the interactive Python shell before running the command… Don’t run python, just paste that command. Also you have Python 3.4, when I said it over and over that you need Python 2.7.

  45. JJ says:

    Un-Installed 3.4 and Installed 2.7.

    Now I’m getting this

    This is from the command line, I stopped running python prior the command

  46. Kulverstukas says:

    Jesus man… you need to CD into the dir before you can use it…
    Just an FYI, this tool isn’t for completely clueless people. At this point I’ll tell you to RTFM, please, if you can’t figure this stuff out.

  47. JJ says:

    Sorry. I did say earlier I had never used command prompt before, but I figured out what you meant. It’s now working, but I did not read the comments previously where people were 0/0 downloads out of private photobuckets without the password. But thanks for your patience. Much appreciated!

  48. MTAK says:

    I’ve just tried this today and I’m having an odd issue. I am using the -r recursive switch and then just -u and the URL of a user — something like “”

    When I do this, it says “Processing” the URL and then says a quick summary:
    Images: 273
    Sub-albums: 0
    Videos: 17

    It then loops forever doing:
    Collected links: 24Images: 273
    Sub-albums: 0
    Videos: 17

    Then Collected links: 48″… Then 72… And so on.

    The problem is that is goes forever. It never seems to find the end of the album even when it passes the 290 mark (which is the 273 images plus the 17 videos). It never stops.

    So, after I know it is past the 290 mark, I send a Cntl-C and it then says:

    Downloaded files: 0/600 (where 600 is where I finally stopped it from looping)

    It will then download the entire thing — so it “works” — but it just gets confused once it gets past the 290 actual files.

    When it finishes downloading the actual files, it gives an error:

    ‘page’ is not recognized as an internal or external command.

    Basically, it looks like it gets confused looking for some keyword and then eventually tries to actually execute the word “page”.

    Also, taking a quick look at the code, it seems to be looping looking for “end of album” to exist in the HTML. But, looking at the PB source, I don’t see that that ever occurs (which would explain the endless looping).

    Maybe an update is needed?

    EDIT: Upon further review, it looks to me like it actually only does the FIRST page of downloads — then tries to do them over and over again. So, something is definitely broken with the paging — it doesn’t find the “next” page to get more images — and it doesn’t find the “last” page to know when to stop looking.

  49. Kulverstukas says:

    Thank you for your very informative reply MTAK :) Yes, the tool could be broken, I wouldn’t be surprised. Parsing HTML is a tricky thing and PB with this whole new design is bound to change some things around from time to time and when that happens, tools like this tends to usually break as well. I know that very well :P

    However, neither me nor the original author Daxda has time to work on it and fix it. I believe it would be an easy fix for someone who knows Python however…

    Maybe you could give it a go MTAK? :) clone the project from github.

  50. juice says:

    Hi, I ran into this webpage because I have been trying to grab files from an account that I own for several months now. After intense research and many, many, manyyy requests … STILL no success and/or replies from anyone I have ever contacted. However, I did find a way to view some of my files (the method is unknown by the public). My account was private from day #1 with the “filename scrambler” feature enabled to avoid easy access to my family photos. Anyway, this is for my personal account and I think that the method I now know could benefit programmers to view more than 1 or 2 files. But I have 0 coding experience and I simply need help! Please help, the features I enabled really messed me up. Thanks!

  51. MTAK says:

    Thanks for the reply, Kulverstukas. I was giving some thought to cloning it and fixing it, but then stumbled across another project that works and appears to still be updated: “ripme”. It is also at Github:

    It is Java-based and works with PhotoBucket and other sites. Seems to work well from some quick testing. So, for now, I’m just going to recommend that instead. :)

  52. juice says:

    ^ that is cool. Is there a way I can access my photos if I was able to reach 1 or 2 files though?

  53. MTAK says:

    No, not with that tool, at least. As far as I know, there isn’t any way to access private or password-protected content with any tool.

  54. juice says:

    I see. Well, I will continue to contact them and try retrieving my old content. If anyone ever figures anything out, let me know. I am supplying only one username (my username). Thanks!

  55. Dumblas says:

    Hey Kulverstukas, I’ve done like you said with the url command.

    python -u “” -r -o PB_Shovel

    But I get an invalid syntax error which asks me to delete pb_shovel from the text. If I do that it asks to remove these “. Any help?

    Tried through cmd, and got this error ‘python’ is not recognized as an internal or external command, operable program or batch file.

  56. Kulverstukas says:

    Regarding that error, you need to put PB_Shovel into the dir where python is installed and then CD into it, then run python executable on python files…

  57. Xires says:

    I run it and there’s no window or anything. Not even an ‘okay’ button. Worst ever. It’s not even written in Ruby. I want my money back.

    (delete the crap out of this)

  58. Arin says:

    I dunno if the the PB account I tried to ripped from was empty or not. But I believe the PB account is a motherload. Unfortunately when I used PB_Shovel, no files were downloaded.

  59. Kulverstukas says:

    More information is needed to determine anything, however it might be that, because the tool wasn’t updated for quite a while and PB probably changed their code around a bit.

  60. ..... says:

    Works great. Thanks to Daapii for continuing the work.

  61. BG says:

    Excuse me Kulverstukas, sir I got the 0/0 download files problem too. I don’t quite understand the solution you provided(I’m not a native English speaker)…

    Do you mean I can’t download anything if I don’t have the password?

    (this is the format of the link I want to access)

  62. Kulverstukas says:

    If the album is private, you cannot download it without a password.

  63. BG says:

    Sir thank you for the prompt reply! :)

  64. Mike says:

    Hi, when I installed python 27 then I unzip the master and put the 2 files into the master. Now when I click PB Shovel in order to input python command it disappears, what gives? is there a reason why it disappears when I open PB Shovel to into the commands?

  65. Kulverstukas says:

    Read what has been said over and over again above.

  66. Mike says:

    I read what you said and I understood the commands, thats not the problem, what I am asking is how can I get the PB_Shovel to start or should I be doing the command within rather PB_Shovel.

Leave a Reply

Your email address will not be published. Required fields are marked *