PylibMS

PylibMS is a library built in Python 3.12+ for the libMessageStudio (LMS) proprietary file formats (msbt, msbp, msbf) from Nintendo. It supports the following:

File Format	Read	Write	Configuration Support
MSBT	✅	✅	Complete attribute decoding + tag decoding down to official `mstxt` Nintendo tool syntax.
MSBF	✅	✅	Flexible node + parameter decoding through configuration definitions.
MSBP	✅	❌	N/A

This library is designed to support LMS revision 3.0 and above, with the associated file formats used across the following Nintendo platforms:

Wii (Specific titles only)
Nintendo 3DS
Wii U
Mobile (Specific titles only)
Nintendo Switch

Features and Usage

Simple preview of the library is below. See the wiki for more explanations and examples.

Reading

MSBT/MSBF

from lms.message.msbtio import read_msbt_path
from lms.message.msbfio import read_msbf_path

msbt = read_msbt_path("Game.msbt")
msbf = read_msbf_path("Game_Flowchart.msbf")

Writing

from lms.message.msbtio import write_msbt_path
from lms.message.msbfio import write_msbf_path

write_msbt_path("Out_Game.msbt")
write_msbf_path("Out_Game_Flowchart.msbt")

Adding/Editing Presets

To add or edit Preset, you may create an issue with the relevant yaml file and the game it is for.

Installation

pip install PylibMS

Pip Page

Build Instructions

Python version must be >=3.12.

Clone the repository, then run pip install (venv recommended)

git clone https://github.com/AbdyyEee/PylibMS.git
cd PylibMS
pip install -e

Credits & Sources

Nintendo-File-Formats by Kinnay: For existing information on the MSBT and MSBP file formats.
Trippixyz: For helping me get started general decompilation of the formats and general help.
AeonSake: Inspiration for some the implementation of the library and a bit of general help.

Release files for PyLibMS 4.0.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for PyLibMS 4.0.1
File	Size	Uploaded
pylibms-4.0.1.tar.gz	63.7 kB	Aug 25, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for PyLibMS 4.0.1
File	Interpreter	ABI	Platform	Reset
pylibms-4.0.1-py3-none-any.whl 84.5 kB Aug 25, 2026	Python 3	none	any	Details

Total release size: 148.2 kB

Release files / pylibms-4.0.1.tar.gz

Download URL	pylibms-4.0.1.tar.gz
Size	63.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`5f38b1148d47593f37e29c229e5394bfb839b1704c1b28ce288dff8e6a4a9a5b`
BLAKE2b-256 checksum How to use checksums	`561872aee3fa571e83974ecc876ef269c7db7238df32bcf27f6e8c666e5d53c4`
Upload date	Aug 25, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.14.6`

Release files / pylibms-4.0.1-py3-none-any.whl

Download URL	pylibms-4.0.1-py3-none-any.whl
Size	84.5 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`da9be925758065856bc991e74d5daf96991db822ede3fead4d892f4e9dad19dc`
BLAKE2b-256 checksum How to use checksums	`8e880419e200d7e9e7a3ec3427cc1bc242bef8467935534b55596d31096187e1`
Upload date	Aug 25, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.14.6`