clip2preview

Rust crate for extracting preview images from .clip files.

What it does:

• finds the embedded SQLite database inside the .clip container
• reads CanvasPreview
• returns the largest preview row
• detects PNG, JPEG, or WebP from the blob bytes

Rust

use clip2preview::extract_preview;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let preview = extract_preview("sample.clip")?;
    preview.save("preview.png")?;
    Ok(())
}

API

Function	Parameters	Returns
extract_preview(path)	path: P where P: AsRef<Path>	Result<Preview>
extract_preview_from_reader(reader)	reader: &mut R where R: Read + Seek	Result<Preview>

Preview method	Parameters	Description
format()	none	Returns PreviewFormat
bytes()	none	Returns encoded image bytes
len()	none	Returns byte length
is_empty()	none	Returns whether the payload is empty
dimensions()	none	Returns (width, height) if present
save(path)	path: P where P: AsRef<Path>	Writes the preview to disk

CLI

cargo run -- sample.clip
cargo run -- sample.clip preview.png

If no output path is given, it writes sample.preview.<ext> next to the input file.

Argument	Required	Description
input.clip	yes	Source .clip file
output	no	Output path for the extracted preview

Errors

Error	Meaning
ClipError::Io	File open, read, seek, or write failed
ClipError::Sqlite	Embedded SQLite open or query failed
ClipError::InvalidFormat	Input is not a supported .clip layout
ClipError::PreviewNotFound	CanvasPreview exists but no usable preview row was found
ClipError::Unsupported	File looks related but uses a variation not handled yet