Skip to content

rickomax/psxprev

Repository files navigation

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

Alpha 0.9.8.4: Models from Planet DOB

Program Preview


Alpha 0.9.7.1: Models from PsyQ demo files

Program Preview


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:

  • An OpenGL 3.0 compatible video card
  • .NET Framework 4.5.1

Supported formats:

  • Models: TMD, PMD, HMD, BFF (Blitz Games), PIL (Blitz Games), MOD (Croc), PSX (Neversoft)
  • Textures: TIM, HMD, SPT (Blitz Games), PSX (Neversoft)
  • Animations: AN, TOD, VDF, HMD, PIL (Blitz Games), PSX (Neversoft)

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:

  • Models: Viewer for models found while scanning files.
  • Textures: Viewer for textures found while scanning files.
  • VRAM: Viewer for a replica of PSX Video RAM, which consists of 32 256x256 textures. (These pages are used to compose the final textures applied to models)
  • Animations: Player for animations found while scanning files.

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)