# Seekable ZEX files
**License:** **GPL-3.0-only** — see [`../LICENSE`](../LICENSE).
## Purpose
Random access into large compressed streams without decoding the entire file.
## Format
Concatenated independent `ZEX1` frames, followed by a **ZXSI** trailer:
| magic | 4 | `ZXSI` |
| version | 2 | `1` |
| num_entries | 4 | frame count |
| entries[] | 16 × n | offset, comp_size, decomp_size |
| trailer_size | 4 | total trailer length (locate from EOF) |
## API
```rust
use zexc::{compress_seekable, decompress_range, decompress_seekable, CompressOptions};
let blob = compress_seekable(data, 256 * 1024, &CompressOptions::default())?;
let all = decompress_seekable(&blob, &Default::default())?;
let window = decompress_range(&blob, 1_000_000, 4096, &Default::default())?;
```
## CLI
```bash
zexc seek-compress big.bin -o big.zexs --frame-kib 256 -l 3
```
## Notes
- Each frame is a complete independent ZEX frame (CRC per frame if enabled).
- Dictionary / encryption apply per frame via normal `CompressOptions`.
- Locate the table by reading the last 4 bytes (`trailer_size`), then seeking back.