poka.sh

Docs

VDI

Generated by scripts/gen-format-pages.py from docs/data/format-metadata/, FILE_FORMATS.csv and docs/formats-master.csv. Do not edit by hand: change the source, then run the script.

VirtualBox VDI Preview.

At a glance

Purpose A VirtualBox disk image: a header, a block map and the virtual disk's data blocks.
Extensions .vdi
Poka parser poka-vdi
Viewer poka-tree-viewer
Depth tier Parser with a shared viewer (see Depth tiers)
Breadth tier B4 Summary (see Breadth tiers)

How much Poka reads

B4 Summary. The container and metadata are read and summarised (counts, properties, structure), but the main content is not rendered.

Confidence: medium (the reviewer read the code). Basis: Reviewed 2026-10-26: read parsers/poka-vdi/src/main.rs (384 lines) and plugin.json. No unit tests or tests/samples.rs; the corpus has sample.vdi, read by no test. Covers .vdi and .vdi-vbox. The tree reads only the header: image type, virtual size, block size and counts, sector size, geometry, version, flags, description, image and parent UUIDs, block-map and data offsets, and the size on disk. Judgement: B4 rather than B5: the whole header is decoded, but the disk's contents are not.

What Poka does not read

  • The virtual disk's contents (partitions, file systems, files) are not read
  • The block map is located, not read, so allocation is not checked
  • Snapshot and creation UUIDs other than image and parent are not shown

Libraries

Libraries Poka uses or has assessed for this format, with the status, licence and language the registry records.

  • vdi (vdi-rs) (candidate; MIT; Rust; https://github.com/cohaereo/vdi-rs) — Read-only VDI reader with Read/Seek support; very young project (14 commits, no releases shown).

Sources

  • parsers/poka-vdi/src/main.rs
  • parsers/poka-vdi/plugin.json