Obscure HVP tool

A simple CLI tool to extract and create hvp archives from obscure game series and Final Exam
_{Support PC, PS2, PSP and Wii versions}

Supported Games • Installation • Usage • Contributing • License

Supported Games

Game	Status	Platforms	Notes
Obscure 1	✅	PC, PS2, XBOX
Obscure 2	✅	PC, PS2, PSP, Wii
Alone in the Dark 2008	✅	PS2, Wii	Uses same format as Obscure 2
Final Exam	✅	PC, (and probably PS3, Xbox 360)

Installation

You can download latest version of the program from Release page

Usage

Run obscure-hvp --help to see all available options. Each subcommand has its own detailed help accessible via obscure-hvp <command> --help.

Extract Files from HVP Archive

# Extract to a folder named after the HVP file
obscure-hvp extract "game_data.hvp"

# Extract to a specific directory
obscure-hvp extract "game_data.hvp" "extracted_files"

Create New HVP Archive

# Create archive from extracted files
obscure-hvp create "new_archive.hvp" "extracted_files"

# Create without compression (faster, larger file)
obscure-hvp create "test_archive.hvp" "extracted_files" --skip-compression

Advanced Options

# Force specific game
obscure-hvp extract "unknown.hvp" --game obscure1

# Force update all files when creating (ignore modification detection)
obscure-hvp create "archive.hvp" "files" --update-all-files

Notes

• when creating a new archive tool will check which file is modified and just read the modified files from disk, you can override this feature and force the tool to read all the files from disk using --update-all-files option.
• tool will autodetect the game from input hvp, but you can also set it manually using --game option.
• For quick HVP extraction without the need of opening a terminal, simply drag and drop a single HVP file onto the tool executable to extract it immediately.
• For quick HVP packing without the need of opening a terminal, drag and drop both the original HVP file and the extracted folder onto the tool executable to create a new archive automatically.

Contributing

Contributions are welcome! Please open an issue or PR.

License

This project is licensed under the MIT License - see LICENSE for more details.

Made with ❤️ for the Obscure community