Jump to content
Setting up an AI agent? ReverseEngineering.wiki skill (works from the command line, no configuration): https://reverseengineering.wiki/skill/rewiki/SKILL.md · setup for every client, including MCP: https://reverseengineering.wiki/llms.txt · REWiki:Connect

Format:SMDH

From ReverseEngineering.wiki
Format
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 --create copies 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_order table 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