pmftools-plus

Tools for handling and converting PSP .pmf movie files.

Tools Included

• psmfdump - Extract .264 and .oma streams from .pmf files
• oMPSComposer - Encodes video + audio and muxes into .mps
• Mps2Pmf - Converts .mps files to .pmf format
• get_duration - Duration detection used internally by the pipeline
• ffmpeg - Used for video conversion and encoding in the pipeline

External Tool Requirement

The only external dependency you need to provide yourself is at3tool.exe for PSP.

at3tool.exe is not distributed with this project. You must obtain it on your own and place it in the tools folder of the release package.

Legal Notice

pmftools-plus does not include, distribute, or endorse distribution of copyrighted game files, ISOs, ROMs, firmware, Sony tools, or Sony assets.

This project is intended for research, preservation, translation, accessibility, and modding workflows using files legally obtained by the user. Users are responsible for complying with the laws and licenses that apply to their own game copies and extracted media.

pmftools-plus is not affiliated with, endorsed by, or sponsored by Sony Interactive Entertainment.

See NOTICE.txt for the release notice.

Download

You can Download a prebuilt package in the releases section.

Usage

The instructions below refer to the prebuilt release package.

Convert PMF to Video

1. Place your PSP movie files into input/pmf/
2. Run "pmftools-plus.bat"
3. Choose "A. PMF --> VIDEO"
4. Find the converted .mov files in output/video/

Convert Video to PMF

1. Place your edited .mov, .avi, or .mp4 files into input/video_edited/
2. Run "pmftools-plus.bat"
3. Choose "B. VIDEO --> PMF"
4. Find the converted PSP movie files in output/pmf/

Encoding settings can be changed from the launcher:

1. Run pmftools-plus.bat
2. Choose S. Encoding Settings
3. Set video bitrate, audio channel mode, ATRAC bitrate, Source Bitrate Match, and advanced encoder options. Source Bitrate Match can be enabled from Encoding Settings. When enabled, videos rebuilt from an extracted PMF use source metadata from worker.ini when available:
   • original video average bitrate
   • original ATRAC3plus bitrate
   • original mono/stereo channel mode. This helps the rebuilt movie stay closer to the original size and audio layout.

Advanced settings:

• Encode Mode: 1pass is faster, 2pass gives better bitrate control
• IDR Interval: recommended default is 2000 ms
• M-Frames: recommended default is 1

Required Build Tools

• Windows x64
• .NET SDK with support for the project targets below
• .NET Framework 4.7.2 Developer Pack / targeting pack
• Visual Studio or Build Tools with MSBuild, C++ tools, and Windows 10 SDK
• Python 3 with pip

Source Components

Component	Source path	Language/runtime
oMPSComposer.exe	src/oMPSComposer	C# / .NET Framework 4.7.2
psmfdump.exe	src/psmfdump	C# / .NET 7.0
Mps2Pmf.exe	src/Mps2Pmf	C++ / MSVC
get_duration.exe	src/get_duration	Python
pmftools-plus.bat	src/scripts	Windows batch

The Mps2Pmf build script currently passes PlatformToolset=v145 to MSBuild.

Python Requirements

get_duration needs:

pymediainfo
pyinstaller

Major Update: No UMD Stream Composer Required

The original pmftools by LITTOMA depended on Sony UMD Stream Composer to mux video and audio into .mps files. That made the PMF rebuild workflow hard to automate, tied to an old GUI tool, and difficult to preserve long-term.

pmftools-plus now replaces the UMD Stream Composer step with oMPSComposer.

• Extracts PMF/PSMF movies into editable .mov files
• Accepts edited .mov, .avi, or .mp4 files
• Re-encodes video to PSP-compatible H.264 via FFmpeg
• Encodes audio to ATRAC3plus via at3tool.exe
• Handles multiple audio tracks automatically through the launcher
• Muxes video and one or more audio tracks into a valid .mps through oMPSComposer
• Converts the generated .mps back into PMF/PSMF output
• Preserves original extension metadata and can match source video/audio bitrate settings

The oMPSComposer muxer was validated against .mps files generated by UMD Stream Composer, and the rebuilt PMF output has been tested on real PSP hardware.

Credits

• PMFtools-plus - Created by Alex "OAleex" Felix
• Original project lineage - Based on TeamPBCN/pmftools by LITTOMA
• psmfdump - Included from the TeamPBCN/pmftools lineage by LITTOMA; based on VGMToolbox
• Mps2Pmf - Included from the TeamPBCN/pmftools lineage by LITTOMA; based on piccahoe's PMF Creater
• oMPSComposer - Created by Alex "OAleex" Felix
• get_duration - Created by Alex "OAleex" Felix
• FFmpeg - Thanks to the FFmpeg project for essential video encoding support