Format:Assets.car (compiled asset catalog)
| Platforms | Platform:IOS, Platform:MacOS |
|---|---|
| Magic | "BOMStore" outer container; CARHEADER block starts with bytes "RATC" |
| Extensions | .car |
| Endianness | BOM structure big-endian, CAR payloads little-endian |
| On this wiki | Facts · Code · Notes · Topics |
The compiled form of an Xcode asset catalog (.xcassets): a Format:BOM (Bill of Materials store) whose named blocks and trees (CARHEADER, KEYFORMAT, RENDITIONS, FACETKEYS...) hold per-variant renditions of images, colours, data and icons, read at runtime by Apple's private CoreUI framework.
Where it is
Assets.car sits at the top of an app bundle (see Format:IPA); system themes (Aqua.car and so on) use the same format. Xcode's actool compiles .xcassets into it. Image files named in the app's asset catalog are therefore NOT separate PNGs in the IPA: extract them from the .car.
Container
Outer layer: Format:BOM (Bill of Materials store). The vars used (from ipsw pkg/car):
- CARHEADER block: tag bytes "RATC" (the string CTAR stored little-endian), CoreUI version u32, storage version u32, storage timestamp u32, rendition count u32, a 128-byte main version string, a 256-byte version string, a 16-byte UUID, associated checksum, schema version, colour space id, key semantics. All little-endian.
- EXTENDED_METADATA block: tag "META" then four 256-byte strings: thinning arguments, deployment platform version, deployment platform, authoring tool (this one is big-endian in ipsw's reader; Unverified: why).
- KEYFORMAT block: tag bytes "tmfk" (kfmt little-endian), version, maximum rendition key token count N, then N u32 attribute ids. This defines the layout of every rendition key. KEYFORMATWORKAROUND holds only count + ids and is used as a fallback.
- RENDITIONS tree: key = array of u16 attribute values in KEYFORMAT order; value = a CSI record (below).
- FACETKEYS tree: key = asset name (the logical name used by imageNamed:), value = a key token list with attributes including Identifier (id 17); join with the rendition key's Identifier to get a rendition's name.
- APPEARANCEKEYS (name -> appearance id, u16), LOCALIZATIONKEYS, BITMAPKEYS, COLORS (named colours) trees.
- CARGLOBALS: a binary plist (Format:Property list (binary bplist00)).
- Optional, retained but uninterpreted by ipsw: EXTERNAL_KEYS, BEZELS, ELEMENT_INFO, FONTS, FONTSIZES, GLYPHS, PART_INFO.
Rendition key attributes
Ids in KEYFORMAT order of meaning: 0 ThemeLook, 1 Element, 2 Part, 3 Size, 4 Direction, 5 Placeholder, 6 Value, 7 ThemeAppearance, 8 Dimension1, 9 Dimension2, 10 State, 11 Layer, 12 Scale, 13 Localization, 14 PresentationState, 15 Idiom, 16 Subtype, 17 Identifier, 18 PreviousValue, 19 PreviousState, 20 HorizontalSizeClass, 21 VerticalSizeClass, 22 MemoryLevelClass, 23 GraphicsFeatureSetClass, 24 DisplayGamut, 25 DeploymentTarget, 26 GlyphWeight, 27 GlyphSize. Scale values are 1, 2, 3; idiom 1 is iPhone and 2 iPad (Unverified for this page: idiom numbering was only seen as an example flag in ipsw's README, --idiom 1).
CSI rendition record
Each RENDITIONS value starts with a header whose signature on disk is "ISTC" (CSI), then little-endian: version u32, flags u32 (bit0 FPO, 1 excluded from filter, 2 vector based, 3 template, 4 template automatic, 5 opt-out of thinning, 6 flippable, 7 tintable, 8 preserved vector representation), width, height, scale factor (100, 200, 300; 0 native), 4-byte pixel format, colour space, then a metadata struct (modtime u32, layout u16, generation u16, 128-byte name), chain size, and a bitmap list. A chain of tagged resources follows: id, length, data, with ids 1001 slices, 1002 samples, 1003 metrics, 1004 compositing options, 1005 metadata, 1006 EXIF orientation, 1007 image row bytes, 1008 external link, 1010 internal link, 1011 alpha cropping, 1012 layer reference, 1013 packed names, 1014 texture interpretation, 1015 physical size, 1016 rendition properties, 1017 transformation.
Layout types (u16): 0 one part, 1 three-part horizontal, 2 three-part vertical, 3 nine part, 4 twelve part, 5 many part, 6 gradient, 7 effect, 8 animation, 9 vector, 12 icon image, 1000 raw data, 1001 external link, 1002 image stack, 1003 internal link, 1004 packed image, 1005 named contents, 1006 thinning placeholder, 1007 texture rendition, 1008 texture image, 1009 colour, 1010 multi-size image set, 1011 ModelIO asset, 1012 model mesh, 1013 recognition group, 1014 recognition object, 1016 ModelIO submesh, 1017 vector glyph, 1018 solid image stack.
Pixel payloads: a bitmap element starts with "MLEC" (CELM) followed by chunks tagged "KCBC" (CBCK); compression kinds seen by ipsw include uncompressed, row RLE, ZIP, LZVN, LZFSE, palette images, JPEG+LZFSE, deepmap2, ASTC and DXTC textures. Raw-data renditions (layout 1000) start with "DWAR" (RAWD) and wrap an original file (PDF, JPEG, HEIF, SVG or arbitrary data).
Reversing notes
- A string like ProThemeDefinition inside the file marks a "Pro" theme store (a system theme, not an app catalog); Asset Catalog Tinkerer refuses these.
- On macOS, Apple's CoreUI (CUICatalog, CUIStructuredThemeStore, CUIThemeRendition) reads the file; Asset Catalog Tinkerer uses these private classes, so it cannot run elsewhere. ipsw's
ipsw caris a pure Go reader. - Names: app code calls imageNamed:/UIImage(named:) with a FACETKEYS name; searching the Mach-O strings (Technique:Objective-C runtime metadata) for such names then looking them up in the car gives the image.
- Thinned (App Store) catalogs hold only the variants for a device class; the DeploymentPlatform and ThinningArguments strings record that.
Tools
Tool:Asset Catalog Tinkerer (macOS GUI, BSD-2-Clause, uses CoreUI), ipsw car (MIT, Go, no CoreUI needed), bomutils (generic BOM). Related: Format:Mach-O, Format:NIBArchive.
Code & repositories
- https://github.com/blacktop/ipsw @
a9eae76e8b1e901e4a03dd530defac8a1b33f91a· license: MIT
ipsw pkg/car (pure Go CAR reader/exporter with README on compression kinds and rendition keys) and pkg/bom (generic BOM reader).
Tested on: source read, not run: not run; source and README read · checked 2026-10-18; last activity 2026-10-16; Note: the latest release ships binaries; the wiki links only the source, never the binaries - https://github.com/insidegui/AssetCatalogTinkerer @
f5208620695b1eec451d6943beeb4ac1bfd37c63· license: BSD-2-Clause
macOS app exporting Assets.car images through private CoreUI; its private header lists CoreUI classes.
Tested on: source read, not run: not built; AssetCatalogReader.m and CoreUI.h read · checked 2026-10-18; last activity 2026-04-27; Note: the latest release ships binaries; the wiki links only the source, never the binaries