You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Blaine Motsinger 9d370a1cca added NOTE for disclaimer at the top 2 years ago
README.md added NOTE for disclaimer at the top 2 years ago
scrape.pl cleaned up commenting 3 years ago

README.md

NOTE: soon after writing this script, vimm.net implemented a new system for downloading roms which breaks this from getting the roms. I may update it again in the future to actually read the link using mechanize instead of assuming the link structure, but just don’t really have interest in doing that right now. Please consider this script broken and unmaintained.

NAME

scrape.pl - scrapes roms rated 9.0 or higher from vimm.net

SYNOPSIS

scrape.pl --destination peculiar --platforms NES GB --extract --verbose

OPTIONS

  --destination        directory to put roms
  --platforms          available [ GB GBA GBC GameCube Genesis NES N64 PS1 PS2 SNES ]
  --extract            extract and unlink the downloaded archive
  --verbose            be more vocal about what's happening
  --help               print this dialogue
  --man                display full documentation

DESCRIPTION

This script makes it easier to download ROMs from vimm.net.

Running without any switches, scrape.pl won’t assume which platforms you want, but requires you to define them specifically.

  # this will get SNES NES and GB ROMs, but none of the other available platforms
  $ scrape.pl --platforms SNES NES GB

If you specify a platform which scrape.pl doesn’t know, the help menu will be printed.

By default, scrape.pl will create it’s directory structure in the Cwd.

  ./roms
  ./roms/SNES
  ./roms/NES
  ./roms/GB

You can also have scrape.pl put the ROMs into a specific directory.

  # only SNES this time, please. OH, and put them into the peculiar dir
  $ scrape.pl --platforms SNES --destination peculiar

the resulting directory structure will be created.

  ./peculiar/roms/SNES

If you want scrape.pl to extract and unlink the archives it downloads, just pass in the --extract option.

  # please extract and unlink them for me, thank you
  $ scrape.pl --platforms SNES --destination peculiar --extract

It’s aware of both .zip and .7z, and will skip the extraction on error or unknown archive format. For now, .7z (PS1 and PS2) archives will be skipped for extraction.

EXAMPLES

Scrape only SNES NES and GB roms

$ scrape.pl --platforms SNES NES GB

Scrape only SNES and put it into a specific dir

$ scrape.pl --platforms SNES --destination peculiar

Scrape only SNES and GB, into a dir, then extract and unlink the archive

$ scrape.pl --platform SNES GB --destination peculiar --extract

Be noiser about it.

$ scrape.pl --platform SNES --destination peculiar --extract --verbose

AUTHOR

Blaine Motsinger blaine@renderorange.com