Format:SMDH
| Magic | 53 4D 44 48 ("SMDH") at offset 0 |
|---|---|
| Extensions | .smdh, icon (ExeFS) |
| Endianness | little |
| On this wiki | Facts · Code · Notes · Topics |
The 3DS application metadata block (SMDH, icon.smdh, also the icon file of an ExeFS): magic SMDH, 16 language titles, region/rating/flag settings and two RGB565 icons, 0x36C0 bytes in total.
Layout
See Fact:SMDH/struct/Header. Total size derived from the structures: 0x2040 bytes of header plus a 24x24 icon (0x480 bytes) plus a 48x48 icon (0x1200 bytes) = 0x36C0 bytes.
- 0x00: magic
SMDH, u16 version (3dsxtool writes 0), u16 zero. - 0x08: 16 title records of 0x200 bytes each: short description (0x40 UTF-16 code units), long description (0x80) and publisher (0x40). Language slots in 3dsxtool's enum order: Japanese, English, German, Italian, Spanish, Simplified Chinese, Korean, Dutch, Portuguese, Russian, Traditional Chinese (11 named of 16 slots; 3dsxtool's
smdhtool --createcopies one string into all 16). Unverified: the order of the language slots beyond this enum (for example where French sits) is not shown by the code I read. - 0x2008: settings (0x30 bytes): 16 rating bytes, u32 region lockout bitmask, 12-byte match maker ids, u32 flags, u16 EULA version, u16 zero, u32 optimal banner frame, u32 StreetPass id; then 8 zero bytes.
- 0x2040: small icon 24x24 then large icon 48x48, 16 bits per pixel RGB565, stored as 8x8 tiles in the Morton-like order of the
tile_ordertable in smdhtool.cpp. smdhtool writes the small icon first, then the large one.
Region bits: Japan 0, USA 1, Europe 2, Australia 3, China 4, Taiwan 5, Korea 6 (all = 0xFFFFFFFF). Flag bits: visible 0, autoboot 1, uses 3D effect 2, requires EULA acceptance 3, autosave on exit 4, extended banner 5, region rating used 6, uses save data 7, record usage 8, disable save data backup 9 (Fact:SMDH/enum/Settings flags).
Where it is found
Embedded in Format:3DSX files (offset and size in the extended header), as the icon file of an Format:ExeFS (3DS) and inside Format:CIA meta sections (azahar's CIA reader loads an SMDH after the 0x400-byte metadata block). Unverified: the extended banner flag (bit 5) refers to a separate banner format that I did not read.
Code & repositories
- https://github.com/devkitPro/3dstools @
718d6f2330dbef9dd5726573392425dcbd451677· license: none
3dstools (3dsxtool, smdhtool): src/3dsxtool.cpp writes the 3DSX header and relocations, src/smdhtool.cpp the SMDH structures. Read for format facts only.
Tested on: source read, not run · checked 2026-10-18; last activity 2023-11-17; no license: not reusable