stargazer/README.md

2.1 KiB

Stargazer

Library to handle STAR files from the PSX used by its package manager "PackmanJr". Comes with a CLI!

More info: https://playstationdev.wiki/ps2devwiki/index.php/STAR_Files

Usage

General usage

NAME:
   stargazer - A tool to handle PSX STAR files

USAGE:
   stargazer [global options] command [command options] [arguments...]

COMMANDS:
   unpack, u  Unpacks files from a STAR file
   pack, p    Pack a folder into a STAR file
   info, i    Shows information about a STAR file

GLOBAL OPTIONS:
   --help, -h     show help (default: false)
   --quiet, -q    Do not print any messages (default: false)
   --version, -v  print the version (default: false)    

Unpacking

NAME:
   stargazer unpack - Unpacks files from a STAR file

USAGE:
   stargazer unpack [command options] [arguments...]

OPTIONS:
   --input value, -i value   Path to STAR file
   --output value, -o value  Path to output directory. Defaults to '<input file without .star>_extracted'

If no output directory is given, the file is extracted to the file name minus the extension plus "_extracted" ( e.g. xPackmanJr_0.105.star -> xPackmanJr_0.105_extracted). Same goes for packing (it will append _packed.star).

Packing

NOTE: The correct order of the files is not implemented yet and there are many unknowns! See issue #1.

NAME:
   stargazer pack - Pack a folder into a STAR file

USAGE:
   stargazer pack [command options] [arguments...]

OPTIONS:
   --input value, -i value   Path to a folder
   --output value, -o value  Output path of the STAR file. Defaults to '<input folder>_packed.star'

If no output STAR file is given, the file will be created in the same directory as the stargazer binary with the name of the folder plus _packed.star.

Info

NAME:
   stargazer info - Shows information about a STAR file

USAGE:
   stargazer info [command options] [arguments...]

OPTIONS:
   --input value, -i value  Path to STAR file

Credits

Thanks to @martravi for helping with reverse-engineering!