EZPicspl
by Chris Peterson(derMoerder)

 

Features

 

EZPicspl is one of the most fully-featured EZPics clients available(not that there's that many... but it's still special!;)). The following is a list of key features:

    • Very importantly, EZPicspl can download a virtually unlimited number of files simultaneously! The user can specify the number of simultaneous downloads desired. This can speed up series downloads by a great margin.
    • Cross-platform functionality. EZPicspl can be run on any Operating System with a Perl interpreter that can call or emulate the Unix fork() command and a port of GNU wget. This means Unix, Mac OSX and Windows users can all use EZPicspl!
    • Ability to download EZCodes where the files end with a different number of digits( ex: With a set like 7-119 or 007-119, EZPicspl will be able to appropriately place or not place zeros as padding ). Maybe not a big deal, but many clients lack this functionality and break in one situation or the other.
    • EZPicspl also checks files after downloading to make sure they're of adequate size, and can remove them if they're below a certain cutoff size which the user can specify. This is to prevent any pretty 404 or other errors being saved from the server when it's not what the user's looking for.
    • Ability to handle a virtually unlimited amount of EZCodes at once. EZPicspl can take as input EZCodes from both files and the command-line both at once.
    • The ability to trick servers into letting the user download files that they would not normally be able to get to by indirect means.
    • Renaming functionality - EZPicspl can rename your files according to the EZCode's subdirectory field.
    • In conjunction with or separate from renaming, the user has the option to override the subdirectory field and download to the current directory.
    • And most importantly, ability to download EZCodes.:D

 

 

 

Versions

The following is a changelog for all releases of EZPicspl, with download links:

  • Version 1.0
    • NOW ABLE TO DOWNLOAD A VIRTUALLY UNLIMITED NUMBER OF FILES SIMULTANEOUSLY! Use can specify the number of simultaneous downloads with the -t option, which was meant to stand for "threads" though I wound up using Perl's fork instead. Still, you get the idea. This is the reason for the large leap in the version number - this is a big part of what EZPicspl was meant to be.
    • Took the '=' chars out of the wget call so as to please more shells.
    • Code-testing with -s works ok now.
    • Added the ability to take ezcodes from a file with -i either with a code on the command-line, or alone. It'll just make things easier to just cut/paste from a list of EZCodes this way.
    • Also made it possible to include multiple EZCodes on the commandline.
    • Modified the behaviour of -r for renaming so that it still places the pictures into their subdirectory, leaving -d to make decisions about directories.
    • Added an option -p to specify not to put pictures into a subdirectoy. Meant to be used in conjunction with -r, but this is not necessary.
    • Download
  • Verison 0.5
    • Made it so codes like url/3name002?3name009?dirname don't make ezpicspl choke.
    • Cleaned up the code a lot, made it work with 'use strict'.
    • Added a commandline option for the cutoff size.
    • Added a commandline option to flag whether or not to download anything. This way a user can specify -s on the commandline and test their ezcodes without actually downloading and wasting bandwidth/time. This is not guaranteed to work in this version.
    • Added rename functionality on the command line.. user can now tell ezpicspl to rename the file according to the last ezcodes field, rather than insert them into a subdirectory of that name.
    • Fixed the file removal code.
    • Download
  • Version 0.2
    • Fixed it up to work around some servers better with the advice of JesusSavesPorn.
  • Version 0.1
    • First version. Downloads EZCodes, most of the time.
    • Download

 

 

Install

Requirements for all systems:

  • Perl
  • GNU wget, v1.6 or better(prior versions lacked the --referer option, which is necessary for EZPicspl to funtion).

 

Since you've clicked to here, I'm going to assume you need some baby steps in setting up to use EZPicspl. I'm going to go over windows setup only because, simply put, if you're on a Unix system you should be able to figure out how to run a simple Perl script on your own. A usage tip for Unix people though: depending on your shell, you may need to precede '?' chars in the EZCodes with a '\'. Sh, for example, takes '?' as a special character and you need to escape it in your command-lines to use EZPicspl. Bash works fine with the question marks. In general, just try it in your shell and see if it works. If it doesn't, start adding the escapes.

Windows Setup:

    1. Make sure you have GNU wget 1.6 or better installed on your system. There are a couple of ways to go about getting it if you don't already have it. First, check that you in fact do not have it by opening up a command prompt( Start>Run>command ) and typing in "wget", without the quotes. Now you have two options if you don't have it - the Please Get This Overwith method or the Advanced method. For the former, simply follow this link and extract the newest GNU wget binaries into your Windows' System/System32 directory from the Zip. For the latter "Advanced" method, you'll thank yourself later if you install the entirety of the Cygwin install, which contains wget as well as a plethora of other Unix tools for Windows.
    2. Make sure you have Perl installed on your system. Go to download ActiveState Perl for your Operating System from their download page here. Install it, and when prompted, let ActiveState Perl associate itself with .pl files and also to insert itself into your PATH. If you don't know what this means, it doesn't matter - it only makes things easier.
    3. Now download the EZPicspl script into your intended download directory where you will be downloading your series of files. Don't worry, you're almost there.
    4. The rest is simply a matter of setting everything up so you can more easily access EZPicspl. You can stop here if you want and simply open a new command prompt each time you want to use EZPicspl and CD to the right directory, but that can be tedious. If there's no one else who will be using the computer that might notice and mind a shortcut to an EZPicspl command prompt, do as follows; Right-click on the Command Prompt icon in your Start>Programs>Accessories and drag it to where you want the easy EZPicspl shortcut to be. Drop it there, and click "Copy Here". Now right-click it and "Rename" it to "EZPicspl" or whatever you see as suitable.
    5. Just to top things off and make them pretty, right-click and download download this icon to your Windows directory. Right-click on your new shortcut again, and click "Change Icon". Click "Browse" and click your way to the icon you just downloaded. Now you're all set.
    6. To use EZPicspl, open up your new shortcut, and type something along the lines of the following: "ezpics.pl http://www.server.dom/001.jpg?005.jpg?Rename". Where you pass the EZCode as a command-line options separated from the command by a space. For further help on usage and options, run "ezpics.pl --help" and read the output.

Mac Setup:

I've put a mirror of the original "EZPics on MacOS X" thread from DPPH which was posted by kingturd here for your viewing. It should cover the bases for you.

 

 

 
You can download the newest version of EZPicspl here, and individual version descriptions are here.

 

 

 
 

About

 

EZPicspl is a Perl clone of EZPics which aims to offer cross-platform command-line EZPics functionality with Perl. The original idea behind EZPics came when a fellow named JesusSavesPorn noticed that porn series(amongts other things) were almost always named sequentially. He proposed an original EZCode, which was in fact not easy at all and horrendous to look at. Since then people involved have come to a consensus on the format. It is as follows:

http://www.domain.com/picture01?picture09?Rename

As might be obvious, there are three important parts to the EZCode: the beginning web address, then the beginning and ending filenames, and finally the rename field. This last field was a good idea in that it is used by EZPics programs as a name for a subdirectory for the downloaded files. This way files are not overwritten in the current directory. Some clones, like mine, try to expand upon the original idea.

 

Me: I'm a student at Rutgers University, and a faithful SomethingAwful forum goon. I'm known as derMoerder both there and on the ever-elusive DPPH. This was my first real exercise in Perl programming, and it just seemed like a good idea since it would be something that people would actually use, which would give me incentive. With a personal distaste for VB, I felt there was a lacking in the EZPics department that needed to be filled(and the want for a multithreaded client was some incentive as well).

I welcome any email with suggestions or criticisms. Send 'em to derM@eden.rutgers.edu

 

 

 

 

Links

 

Some necessary EZPics linkage:

  • EZPics - This is the original EZPics, by JesusSavesPorn.
  • Other Clones - The links page of the original EZPics' site with links to some other clones.
  • EZCDB - The EZCode database. It's up and down a lot, but when it's around it's very much worth a look.

 

 

 

Contact

 

Email: derM@eden.rutgers.edu

ICQ: 23115071

 

Most recently updated: Friday November 30, 2001