# Supported file formats

On the Files page, tap **⋮ → Preview** on a file to open it in the previewer.

**Anything unrecognised still has a fallback**: a hex dump (first 4 KB, monospace, scrolls sideways).

> The list below and the code are **the same data** (`PreviewFormatCatalog`); a self-test asserts,
> entry by entry, that "this extension really goes through this previewer" — so the document
> cannot quietly drift away from the implementation.

## Text

| Kind | Extensions | What you get |
|---|---|---|
| Plain text / source | `.txt` `.log` `.rst` `.adoc` `.asciidoc` `.tex` `.latex` `.http` `.rest` `.rep` `.lst` | Monospace with line numbers |
| Markdown | `.md` `.markdown` | Rendered |
| Web pages | `.html` `.htm` `.xhtml` | Rendered as a web page (WebView; CSS, scripts and sibling assets load in the browser) |
| JSON | `.json` | Structured, foldable |
| XML | `.xml` | Node tree, foldable |
| CSV | `.csv` | Table |
| Tabular data | `.tsv` `.jsonl` `.ndjson` `.rep` | Table (`.rep` = PADS drill report) |
| SQL | `.sql` | SQL highlighting |
| Config files | `.yaml` `.yml` `.toml` `.ini` `.conf` `.cfg` `.properties` `.env` `.gradle` `.cmake` `.editorconfig` `.gitignore` `.gitattributes` `.dockerignore` `.npmrc` `.prettierrc` `.eslintrc` `.htaccess` | Key/value highlighting |
| Diff | `.diff` `.patch` | Add/remove colouring |
| draw.io | `.drawio` | Drawn as SVG at its own coordinates |
| Mermaid | `.mmd` `.mermaid` | Flowchart rendered (layered layout) · other kinds get node/edge tables |
| Jupyter Notebook | `.ipynb` | One section per cell |
| Protocol Buffers | `.proto` | Messages, enums, services |
| GraphQL | `.graphql` `.gql` | Types and fields |

## Documents

| Kind | Extensions | What you get |
|---|---|---|
| Office | `.docx` `.doc` `.xlsx` `.xls` `.pptx` `.ppt` | Extracted text + tables (docx/xlsx render as Markdown tables; **fonts/colours/exact layout not preserved**) |
| RTF | `.rtf` | Extracted text (control words hidden; layout not restored) |
| OpenDocument | `.odt` `.ods` `.odp` `.odg` | Extracted text |
| PDF | `.pdf` | Page images drawn when present (scans), else extracted text page by page |
| OFD | `.ofd` | Layout boxes (text/image blocks) + text per page (fonts not preserved) |
| XPS | `.xps` `.oxps` | Fixed-layout document: text per page (**fonts/layout not restored**, same scope as OFD) |
| EPUB | `.epub` | By chapter |
| Calendar / contacts | `.ics` `.ifb` `.vcf` `.vcard` | Property blocks → table |
| Subtitles | `.srt` `.vtt` `.ass` `.ssa` | Timeline + text |
| Property list | `.plist` | XML and bplist |

## Graphics

| Kind | Extensions | What you get |
|---|---|---|
| Images | `.svg` `.png` `.jpg` `.jpeg` `.gif` `.webp` `.bmp` `.tga` `.ico` `.cur` `.pnm` `.ppm` `.pgm` `.pbm` `.pam` | View, zoom, rotate |
| 3D models | `.obj` `.glb` `.gltf` `.stl` `.ply` `.3mf` | Software raster, orbit + zoom |
| PCB | `.gbr` `.ger` `.pho` `.gtl` `.gbl` `.gto` `.gbo` `.gts` `.gbs` `.gko` `.drl` `.nc` | Gerber / Excellon, drawn |
| KiCad | `.kicad_pcb` | Tracks, vias, pads |
| GDSII | `.gds` `.gds2` | Chip/mask layout: top cell's polygons drawn as a top view + cell/layer list (references and arrays counted, not expanded) |
| DXF | `.dxf` | 2D CAD line drawing |
| G-code | `.gcode` `.gco` `.ngc` `.tap` `.cnc` | Toolpath, top view |
| PSD | `.psd` `.psb` | Composite image (incl. Indexed, Lab; layer list fallback) |
| Fonts | `.ttf` `.otf` `.ttc` `.woff` `.woff2` | Info table + sample |

## Building / engineering

| Category | Extensions | Preview |
|---|---|---|
| gbXML | `.gbxml` | Building / space / surface tree + area summary (**no geometry**) |

## Circuits

| Kind | Extensions | What you get |
|---|---|---|
| SPICE | `.cir` `.sp` `.spice` | Connectivity graph (dots = nets, lines = devices; force-directed) + component list |

## Media

| Kind | Extensions | What you get |
|---|---|---|
| Audio | `.mp3` `.wav` `.ogg` `.oga` `.m4a` `.aac` `.flac` `.opus` | Play, pause, volume, progress |
| Video | `.mp4` `.m4v` `.webm` `.mov` `.mkv` | Native player controls |
| MIDI | `.mid` `.midi` | Piano roll |

## Data and containers

| Kind | Extensions | What you get |
|---|---|---|
| Archives | `.zip` `.tar` `.tgz` `.iso` | Entry list (**tap an entry to preview it**) · `.iso` reads the volume label and directory records, Joliet / Rock Ridge names preferred |
| SQLite | `.db` `.sqlite` `.sqlite3` | Schema + first rows |
| HTTP archive | `.har` | Request list |
| Torrent | `.torrent` | File list |
| Executables / objects | `.elf` `.so` `.o` `.a` `.dylib` `.exe` `.dll` `.dex` `.wasm` | Header + section table |
| Maps / tracks | `.kml` `.kmz` `.geojson` `.gpx` | Drawn as vectors |
| MBTiles | `.mbtiles` | Offline map: the highest zoom that fits stitched into one image (vector tiles get a coverage map) |
| Shapefile | `.shp` | GIS vectors (lines / polygons; `.dbf` row count in the status bar) |
| NumPy | `.npy` `.npz` | 2-D arrays drawn as a stretched grayscale image; 1-D gets a stats table |
| Scratch | `.sb3` `.sb2` | First costume rendered + sprites / blocks / sounds / variables (blocks not executed) |
| PDB | `.pdb` `.ent` | Cα trace + ball-and-stick render (PCA view) · atom/residue/chain/ligand counts |
| Sequence files | `.fasta` `.fa` `.fna` `.faa` `.fastq` `.fq` | Records / total bases / length range / GC / alphabet |
| QIF | `.qif` | Ledger: count / totals / date range + recent entries |
| OFX | `.ofx` `.qfx` | Bank statement (both 1.x SGML and 2.x XML) |
| EDI | `.edi` `.x12` `.edifact` | X12 / EDIFACT: segments + transaction set types |
| IGES | `.igs` `.iges` | Top-view outline: lines / arcs / polylines / B-splines / points (plus entity-type counts) |
| IFC | `.ifc` `.ifczip` | Building model: **wireframe top view** (IFCPOLYLOOP / IFCPOLYLINE / IFCTRIANGULATEDFACESET edges, XY projection) |
| STEP | `.stp` `.step` | CAD exchange: **wireframe top view** (EDGE_CURVE endpoints, XY projection) |
| EML | `.eml` `.mbox` | Email: subject / from-to / body / attachments (HTML not executed) |
| PCAP | `.pcap` `.pcapng` `.cap` | Capture: packets / time range / protocol mix (no TCP reassembly) |
| Certificates | `.pem` `.crt` `.cer` `.der` `.p12` `.pfx` `.p7b` | Subject / issuer / validity / SAN / thumbprint (no verification) |
| GML | `.gml` | GIS map: points/lines/polygons (raw coordinates) · falls back to the feature tree |
| GeoPackage | `.gpkg` | OGC geo database: geometry columns drawn as a map + table schema |
| dBASE | `.dbf` | Field definitions + first 10 rows (read-only) |
| Radiance HDR | `.hdr` | HDRI: decoded and tone-mapped |
| FITS | `.fits` `.fit` `.fts` | Astronomy: grayscale render + header summary |
| MATLAB MAT | `.mat` | Variable list (name/type/size) + grayscale heatmap of the first 2-D numeric matrix (v7.3 is HDF5; reported only) |
| NIfTI | `.nii` `.nii.gz` | Axial / coronal / sagittal middle slices side by side as one grayscale image |
| DICOM | `.dcm` | Medical: uncompressed gray/color (RGB, YBR), **RLE lossless** and JPEG baseline are drawn; first frame only; JPEG 2000 / JPEG-LS get tag summaries |
| HDF5 | `.h5` `.hdf5` `.he5` `.nc4` | Group/dataset tree + attributes; the largest 2-D numeric dataset is drawn as a grayscale heatmap (**MAT v7.3 and NetCDF-4 land here too**) |
| NetCDF | `.cdf` | 2-D numeric variables drawn as grayscale + dims/variables (`.nc` belongs to PCB drill files) |
| LAS | `.las` `.laz` | Top-view point cloud (`.laz` compressed is **not supported**) |
| Outlines / mind maps | `.opml` `.mm` | Foldable tree |

## Fallback

| Kind | Extensions | What you get |
|---|---|---|
| Anything else | any extension, or none | Hex dump: first 4 KB, monospace, scrolls sideways |

## Notes

- **Preview is read-only** — it never modifies the file. To edit, tap the file name to open the editor.
- **Text previews do no syntax validation**: there is no YAML/TOML parser, and half-baked
  validation that rejects valid files is worse than none. Only **structural** errors
  (a non-object line, broken JSON, missing tabs) are reported by name.
- **A parse failure never crashes the app**: anything that cannot be parsed falls back to the hex dump with a reason.
- **Large files are capped**: hex dump reads the first 4 KB; text over 8 MB is refused;
  text over 60,000 characters switches to plain monospace (no rich text, to avoid stalls).
- **Preview inside archives**: entries the previewer understands are tappable in a `.zip` listing
  (they are extracted to a cache directory first).
