WARNING: THIS TOOL IS COMPLETELY VIBECODED

PSP PMP video converter and compressor.

# Binary (no dependencies)
./dist/pmp-cli-bin convert video.mp4 output.pmp

# From source (requires Python 3.7+ and ffmpeg)
./pmp-cli convert video.mp4 output.pmp

# Convert video to PMP
pmp-cli convert video.mp4 output.pmp

# Compress existing PMP
pmp-cli compress input.pmp output.pmp --crf 30

# Batch convert directory
pmp-cli batch ./videos/ --batch-mode convert --output-dir ./pmp-files/

# Maximum quality
pmp-cli convert movie.mp4 movie.pmp --crf 18 --preset veryslow

# PSP reference-compatible encode (uses bundled bin/x264)
pmp-cli convert video.mp4 output.pmp --x264-exe bin/x264

# Batch compress, replace originals
pmp-cli batch ./library/ --batch-mode compress --recursive --replace --crf 30

pmp-cli bundles a native x264 built with --psp-compat, which emits the exact PSP reference SPS (log2_max_frame_num_minus4=5, pic_order_cnt_type=0) — the same stream params XviD4PSP 5 produced (fixes stutter/tearing on real PSP).

• When bin/x264 exists next to pmp-cli it is used automatically.
• --x264-exe <path> overrides the binary. A non-.exe build runs directly (native); a .exe (e.g. the old XviD4PSP 2009 build) runs via wine.

• --crf 0-51 — Quality (lower = better, default 28)
• --fps 1-25 — Frame rate (default 24, max 25)
• --preset — Speed: ultrafast, fast, slow, veryslow
• --profile — baseline, main, high
• --width/--height — Resolution (default 480x272, must be divisible by 8)
• --deinterlace — Apply deinterlacing filter

• --audio-bitrate — CBR bitrate (default 96)
• --audio-quality 0.1-5.0 — VBR quality (lower = better)
• --audio-rate — Sample rate: 32000, 44100, 48000
• --no-audio — Strip audio

• -r, --recursive — Process subdirectories
• --replace — Replace originals
• --dry-run — Show what would be done

Full options: run pmp-cli convert --help

PMP (Portable Media Player) is a PSP multimedia container with H.264 video + AAC audio.

Container Structure:

Header (56 bytes) → 14 × uint32_t (little-endian)
Frame Index       → n_vframes × uint32_t (size << 1 | keyframe_flag)
Packet Data       → Video + Audio packets

Constraints:

• Video: H.264 Annex B, baseline/main profile, level 3.0
• Audio: AAC-LC 44.1kHz stereo, raw frames (no ADTS headers)
• Resolution: up to 720×512 (divisible by 8), 480×272 recommended
• FPS: 1-25 (>25 causes performance issues on PSP)
• Critical: aud_scale must be 1024 (PSP crashes if set to 1)
• Critical: NAL structure must be AUD → SPS → PPS → IDR (PSP hardware decoder requirement)

pip install pyinstaller
pyinstaller --onefile --name pmp-cli-bin pmp-cli
# Output: dist/pmp-cli-bin

Player crashes on PSP:

• Use --profile baseline --level 3.0

No audio:

• Check --audio-rate 44100 and --audio-channels stereo

Choppy playback:

• Lower FPS: --fps 20
• Lower resolution: --width 368 --height 208
• Lower bitrate: --crf 30

• PMP-Mod GitHub — Original player source
• PMP Container Spec — Format docs

MIT