File types

tessera recognises file types by extension for two purposes: the type: query filter and the embedding modality selector.

Type filter categories

CategoryExtensions
imagejpg, jpeg, png, gif, webp, bmp, tiff, tif, heic, heif, avif, cr2, cr3, nef, arw, raf, dng, orf, rw2, pef, srw, x3f, raw
videomp4, mkv, avi, mov, webm, m4v, ts, flv, wmv, ogv, 3gp
audiomp3, flac, ogg, opus, wav, aac, m4a, wma, alac, aiff, ape, mka
documentpdf, docx, doc, odt, rtf, txt, md, markdown, rst, tex, epub, html, htm
archivezip, cbz, cbr, rar, 7z, tar, gz, bz2, xz, zst

Aliases for type: queries:

AliasResolves to
img, photo, picimage
vid, movievideo
aud, musicaudio
docdocument
arc, archivearchive

Embedding modalities

For semantic search, files are embedded according to their extension:

ModalityExtensionsMethod
Visionjpg, jpeg, png, webp, bmp, gif, tiff, tifThumbnail → vision model
Visionmp4, mkv, avi, mov, webm, m4v, ts, flvSprite sheet (video frames) → vision model
Visioncbz, cbrCover image → vision model
Texttxt, md, markdown, rstFile content → text model
TextepubExtracted text → text model
TextzipEntry listing → text model

Files with other extensions are skipped during bulk indexing.