rickomax / psxprev

PSXPREV - Playstation (PSX) Files Previewer/Extractor
BSD 2-Clause "Simplified" License
193 stars 10 forks source link

PSXPrev

PSXPREV - PlayStation (PSX) Files Previewer/Extractor

Release Release Date Downloads Discord


Program Preview

(Models from Action Man 2: Destruction X)

Old preview images --- ##### Beta 0.9.9: Models from Planet DOB ![Program Preview][Preview Planet DOB DOB] ##### Alpha 0.9.8.4: Models from Planet DOB ![Program Preview][Preview Planet DOB cast] --- ##### Alpha 0.9.7.1: Models from PsyQ demo files ![Program Preview][Preview Space Shuttle]

Treat this as an experimental release and use this tool at your own risk. Warning: PSXPrev uses a lot of memory to scan files, so your system might run out of resources while scanning.

Links: Video tutorial | Compatibility list

Credits:

Runtime Requirements:


Supported formats:

Usage: A scanner window will be displayed when running the application without passing any command line arguments. When passing command line arguments, PSXPrev will start scanning for files using the given parameters. As the scan runs, a new window will be displayed, containing the following tabs:

To scan more files, you can select File > Start Scan to open the scanner window again.

Known issues/limitations: PSXPrev only finds files conformant to the file formats it's scanning for. PSXPrev can't scan any compressed or proprietary formats.

Command line usage:

usage: PSXPrev <PATH> [FILTER="*"] [-help] [...options]

arguments:
  PATH   : folder or file path to scan
  FILTER : wildcard filter for files to include (default: "*")

scanner formats: (default: all formats except SPT)
  -an        : scan for AN animations
  -bff       : scan for BFF models and animations (Blitz Games)
  -hmd       : scan for HMD models, textures, and animations
  -mod/-croc : scan for MOD models (Croc)
  -pil       : scan for PIL models and animations (Blitz Games)
  -pmd       : scan for PMD models
  -psx       : scan for PSX models, textures, and animations (Neversoft)
  -spt       : scan for SPT textures (Blitz Games)
  -tim       : scan for TIM textures
  -tmd       : scan for TMD models
  -tod       : scan for TOD animations
  -vdf       : scan for VDF animations

scanner options:
  -ignorehmdversion     : less strict scanning of HMD models
  -ignorepmdversion     : less strict scanning of PMD models
  -ignoretimversion     : less strict scanning of TIM textures
  -ignoretmdversion     : less strict scanning of TMD models
  -align <ALIGN>        : scan offsets at specified increments
  -start <OFFSET>       : scan files starting at offset (hex)
  -stop  <OFFSET>       : scan files up to offset (hex, exclusive)
  -range [START],[STOP] : shorthand for [-start <START>] [-stop <STOP>]
  -startonly  : shorthand for -stop <START+1>
  -nextoffset : continue scan at end of previous match
  -regex      : treat FILTER as Regular Expression
  -depthlast  : scan files at lower folder depths first
  -syncscan   : disable multi-threaded scanning per format
  -scaniso    : scan individual files inside .iso files
  -scanbin    : scan individual files inside raw PS1 .bin files
                not all files may be listed in a .bin file, use -databin as a fallback
  -databin    : scan data contents of raw PS1 .bin files
  -binsector <START>,<SIZE> : change sector reading of .bin files (default: 24,2048)
                              combined values must not exceed 2352

log options:
  -log       : write output to log file
  -debug     : output file format details and other information
  -error     : show error (exception) messages when reading files
  -noverbose/-quiet : don't write output to console

program options:
  -drawvram  : draw all loaded textures to VRAM (not advised when scanning many files)