Help information for LaxaeRipper

This application will download (or rip) images from various image hosts. Mostly it is intended to be used on https://vipergirls.to

Current version: 1.1.0

Installation

Windows Installation

Prerequisites

You must have php installed and running on your computer.

To verify that you do have php installed, open a Command prompt and type:

php -v

You should see something like:

If you don't see something similar, then you will need to install php and add it to your PATH

To install php: https://www.php.net/manual/en/install.windows.php

To add php to your PATH: https://www.sunant.com/running-php-from-windows-command-line/

Mac Installation

You must have php installed and running on your computer. If you don't you can use these instructions to get it installed

To install php: https://www.php.net/manual/en/install.macosx.php

Unzip the laxaeripper-x.y.z.zip file

Extract the contents of the zip file, it can be located pretty much anywhere on your computer. You should have a directory and file structure like this:

laxaeripper/
├── app/
│   └── Helpers/
├── assets/
├── check.php
├── conf/
│   └── config.php
├── cookie_vipergirls.txt
├── example_list.csv
├── example_list.php
├── history/
├── images/
├── laxaeripper.sqlite
├── license.md
├── readme.html
├── readme.md
└── rip.php

Uninstall

To uninstall simply delete the laxaeripper directory and the zip file. LaxaeRipper doesn't install anything or put anything else on your computer.


Usage

To run LaxaeRipper, open a terminal window or Command Prompt and navigate to the laxaeripper folder. Then type:

php rip.php

You should see something like this:

Select one of the variety of ways to download images or control the application by clicking the corresponding key on your keyboard.

[1] Rip images in thread - one or most posts

Use this to download all the images in one or more posts in a thread. Most of the time, I use this option. For example, this page: https://vipergirls.to/threads/5262129-Taylor-Nature-Queen-(May-06-2020)-82X currently contains three different posts of the same photo set. LaxaeRipper will try to figure out the title for each post and will do some clean up of the title. This option is probably the one you will use most often. The easiest way to use this option is to copy the URL from your browser and paste it when prompted.

[2] Rip images in post

Use this to download all the images in a single post of a thread. This is helpful if there are a large number of posts in a thread (for example the "collections" thread can have a huge number of posts). To use this option, right click on the post number in the post header, it will be something like #121,(see image below) and copy the URI to the post. In Chrome look for Copy Link Address. In Firefox look for Copy Link Location. Then paste it when prompted

[3] Rip images from threads listed in a file

Use this to download all threads or posts which are stored in a file. The file must be in the root of the application and it must follow the format of either of the example files: example_list.php or example_list.csv. Albums in the file are treated by LaxaeRipper the same was as Option 2. You can use either of the example_list files as the basis of your file. The files must have a title and URI and optionally a 'start' value. If a start value is set, we will start the download at that point in the list. If there are 100 images to download and the start number is 25, then we will skip the first 24 images and start downloading at number 25.

[4] Rip images from a pasted list

Use this to download an arbitrary list of images. Best way to get the list is to view the source of the page and copy the links for the images that you want. The image links will be between <blockquote class="postcontent restore "> and </blockquote>

[6] History

Use this to view your download history. You can also create an HTML report for your download history.

When you are in the History section you can:

[1] view history, which will display a table of your downloads

[2] generate HTML report, which will create an HTML file named something like: history-2019-11-03.html with a history of your downloads. This file will be located in the history folder.

[x] clear history, this will delete your download activity/history from the SQLite database.

History is turned on by default, you can change that in Config by changing log_downloads to FALSE

The history of your downloads is stored in a SQLite database called 'laxaeripper'. You can use any app that interacts with SQLite databases to view the contents.

[7] Update

Use this to update Laxaeripper to a newer version, if one is available.

[8] Config

Use this to configure Laxaeripper. You can use this to create the config file, edit it and view your current config.

When you are in the Config section you can:

[ 1 ] to edit, which allows you to edit your current config file.

[ 2 ] to replace, which allows you to replace your current config file.

[ 3 ] view current config values, which allows you to view your current config file settings.

[ 9 ] test login, use this to confirm that LaxaeRipper can log into ViperGirls with your credentials.

[9] Help Information

Use this to view the help information.


FAQ

Filenames. LaxaeRipper will use the file names supplied by the image host for the images that are being downloaded. Sometimes those are kind of nasty, like this one: 174ffa1269420444.jpg You can configure Laxaeripper to prepend or append to the file name in Config.


Flags

-v sets LaxaeRipper to run in verbose mode, which will override whatever is in config


Config

You can use Config to change the behavior of LaxaeRipper. The config values are stored in conf/config.php

The following is a list of the current config items and their default values

verbose: Set the verbose mode, which is a lot of information. Can be set to TRUE or FALSE. Default value is FALSE

image_folder: This is the path to the folder where you want to store the ripped images, must have a trailing slash. Default value is images/

display_progress: Whether to display a progress indicator. Default value is TRUE

display_progress_interval: How often the progress indicator. Default is 10

display_progress_character: The character do you want to use as the progress indicator. Default value is .

image_set_threshold: The minimum number of images needed to be considered an image set

prepend_increment: Some file hosts use string of numbers and letters like: 42a2dd1323232737.jpg for the filename. If this is set to true we will add an incrementer to the filename so it looks something like: 01_42a2dd1323232737.jpg. Default is FALSE

append_increment: Instead of prepending, append the increment so the filename looks something like: 42a2dd1323232737_01.jpg. Default is FALSE

log_downloads: If set to TRUE all downloads will be logged into a SQLite database called laxaeripper.sqlite. If set to FALSE downloads will not be logged. Default is TRUE

username: Your vipergirls.to username

password: Your vipergirls.to password

auto_like: When downloading an album, automatically 'Like' the post. Default is TRUE

clean_title: Attempt to clean up the title, which gets used as the name of the image folder. Default is TRUE


Additional thoughts

Depending on how many images you're planning to download at a time you might need to change the memory-limit for php.

memory_limit = 128M

Note: I've downloaded over 1000 images at a time with the memory_limit at 128M without problems.

Help/Support

If you need help or support with this application, please feel free to ask me Laxaeman. I'll do what I can to help.

If you find a bug (and I'm sure you will eventually) please create a new post on the thread on vipergirls.to for the bug.

As I add new features and fix bugs, I'll create a new post for the updated version, in the thread on vipergirls.to

License

Creative Commons License
This work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License

PHP Requirements

Make sure that file_get_contents() can open a https address by uncommenting this line in your php.ini file:

;extension=php_openssl.dll

Uncomment the line by removing the semi-colon.


cURL

open a terminal or Command Prompt and run the check.php file that's located in the laxaeripper folder. If you have cURL installed and configured, then you're good to go. Otherwise you will need to install it.

To install cURL on a Windows10 machine I did the following:
Download from https://curl.haxx.se/download.html
Unzip the downloaded file and place the files somewhere on your computer. For me I put them in a directory c:\dev\curl
Go to System Properties...Advanced...Environment Variables, click on "Path" and then Edit. Add curl to the path by clicking New then typing in the location of the exe. For me that was c:\dev\curl\curl.exe then click OK. Then close out of System Properties.
Open up a Command Prompt and type 'curl -help' (without the quotes) you should see a bunch of information about cURL.
If you don't then cURL isn't installed correctly. Most likely you have the location incorrect in the path. Which means fixing your PATH.
Now we need to get the digital certifcates installed so we can read SSL sites.
Go to: https://curl.haxx.se/docs/caextract.html and download the cacert.pem file.
Save the cacert.pem into your curl directory.
Next edit the php.ini file, by opening it in your favorite text editor.
Look for it in the php folder. If you don't have a php.ini file, then open the php.ini-development and save it as php.ini
Next search for

    ;extension=curl
and remove the leading semi-colon. You might have to replace curl with the absolute path to the curl.exe. In my case the line looks like this:
    extension=C:\dev\php\ext\php_curl.dll
Now look for:
    ;curl.cainfo=
and remove the leading semi-colon, and add in the absolute path to the cacert.pem file that you just downloaded. In my case the line looks like this:
   curl.cainfo="C:\dev\curl\cacert.pem"
Next look for:
    allow_url_include = Off
and change it to:
    allow_url_include = On
Finally look for:
    ;extension=openssl
and change it to include the path to your php ext folder:
    extension=C:\dev\php\ext\php_openssl.dll
Change the path to match where you have php installed. Save and exit the file.

To ensure you have cURL installed correctly you can run the check.php file.

If you need to install sqlite3 on your computer, go to https://www.sqlite.org/downloads and follow the instructions for installing sqlite3.s

Supported Hosts

The following is a list of the currently supported hosts