All documentation
Canvas and boards/02

Supported formats and thumbnails

Free

Images, videos, RAW files, documents, and shell thumbnails.

FenSight decides support in two layers: known extensions enter the normal ingest pipeline, then preview generation chooses the fastest safe thumbnail path for that file. Images and videos become visual board items, documents and creative project files become document/reference items, .fns files become board-preview items, and optional generic import can add other non-hidden files through Windows Shell thumbnails or file icons.

Screenshot coming soon

FenSight board showing mixed image, RAW, video, document, and project-file thumbnails

Screenshot placeholder. Expected production asset: /docs/screenshots/supported-formats-and-thumbnails.png.

Where formats enter the app

Menu

File -> Import Folder...

Recursively imports supported images, videos, documents, asset references, board previews, and image sequences.

Drag/drop

Explorer -> drag files or folders onto the canvas

Mixed drops use the same extension groups. With Accept all file types on, remaining non-hidden files become generic document items.

Menu

Settings -> Import -> Accept all file types on drop (uses Shell thumbnail / file icon)

Enables the generic fallback for file types outside the normal pipeline. Toggling it off leaves existing generic items on the board.

Menu

Settings -> Import -> Visualize audio files (waveform display)

When Accept all file types is also on, supported audio files can import as waveform AudioItem objects instead of generic icons.

Menu

File -> Pre-render previews...

Builds PreviewCache entries ahead of import for preview-supported image formats such as PNG, JPEG, TIFF, WebP, JXL, AVIF, HDR, DNG, HEIC, and HEIF.

Menu

File -> Rebuild Thumbnails

Regenerates missing board previews. Video thumbnails run through the dedicated video backfill path first, then still-missing image/sequence/document thumbnails are rebuilt.

Context menu

Video item -> Generate Video Thumbnail

Forces representative-frame regeneration for the selected video item or items.

Canonical extension groups

These groups come from the app's import pipeline. They determine which files are imported directly before the optional generic Shell-thumbnail fallback is considered.

Pipeline groupExact extensionsBoard item and preview behavior
PipelineSupportedImagesFree
.png, .jpg, .jpeg, .bmp, .gif, .tif, .tiff, .tga, .jp2, .jpf, .jpx, .j2k, .webp, .jxl, .avif, .heif, .heic, .dcm, .dicom, .dds, .ktx, .ktx2, .exr, .hdr, .raw, .dng, .nef, .cr2, .cr3, .crw, .arw, .sr2, .raf, .rw2, .orf, .pef, .k25, .kdc, .dcr, .mrw, .nrw, .srw, .srf, .erf, .iiq, .3fr, .mef, .mos, .rwl, .ai, .psd, .psb, .c4d, .pdfCreates ImageItem objects for decoded still images. The same set also admits special proxy formats such as .ai, .psd, .psb, .c4d, and .pdf, which use specialized preview/Shell handling rather than normal image dimensions.
Camera RAW subsetFree
.raw, .dng, .nef, .cr2, .cr3, .crw, .arw, .sr2, .raf, .rw2, .orf, .pef, .k25, .kdc, .dcr, .mrw, .nrw, .srw, .srf, .erf, .iiq, .3fr, .mef, .mos, .rwlRAW formats skip SixLabors header identification during ingest because ImageSharp cannot identify them reliably. The item still imports, then Magick.NET, preview cache, or Shell-backed paths fill thumbnails and dimensions where available.
HDR, texture, and medical image subsetFree
.hdr, .exr, .dds, .ktx, .ktx2, .dcm, .dicomThese are accepted by the image pipeline, but several bypass ImageSharp identification and use HDR/ImageSharp, Magick.NET, DDS dimension parsing, or thumbnail fallback paths depending on the format.
PipelineSupportedVideosFree
.mp4, .mov, .avi, .mkv, .wmv, .webm, .m4v, .mpg, .mpeg, .mpe, .m2v, .m2ts, .mts, .ts, .3gp, .3g2, .flv, .f4v, .asf, .ogv, .rm, .rmvb, .vob, .divx, .xvid, .mxf, .m2p, .m1v, .dv, .mod, .tod, .tp, .trpCreates VideoItem objects. FenSight stores duration and natural-size metadata, uses cached video thumbnails when available, and otherwise fills thumbnails through the post-ingest video backfill path.
PipelineSupportedDocumentsFree
.ppt, .pptx, .doc, .docx, .xls, .xlsx, .rtf, .eps, .indd, .idmlCreates DocumentItem entries. Preview thumbnails come from pre-rendered cache, direct specialized preview loading, Shell content thumbnails, or registered Windows Preview Pane handlers when available.
PipelineSupportedAssetRefsFree
.sbsar, .sbs, .spp, .spprj, .json, .fbx, .ma, .mb, .obj, .abc, .usd, .usda, .usdc, .usdz, .gltf, .glb, .blend, .flaCreates lightweight DocumentItem-style placeholders for Substance, DCC, USD, GLTF, Blender, Flash/Animate, and sidecar/reference files. The placeholder shows the extension and a production-specific subtitle.
PipelineSupportedBoardsFree
.fnsCreates a BoardPreviewItem using the board file's embedded PNG preview when present, otherwise a generated board placeholder. Loading a board is still File -> Load.
PipelineSupportedAudioFree
.mp3, .wav, .flac, .aac, .m4a, .ogg, .opus, .wma, .aiff, .aifAudio files require Accept all file types during folder import. With Visualize audio files on, they become waveform AudioItem objects; otherwise they use the generic document/icon thumbnail path.
Generic fallbackFree
Any non-hidden file outside the known pipeline groupsOnly active when Accept all file types on drop (uses Shell thumbnail / file icon) is enabled. FenSight asks Windows Shell for a 128px thumbnail or icon, then scales the generic document item to a 2048-canvas longest side.

Thumbnail source order

The visible thumbnail is not always decoded by the same library. FenSight picks a source based on the file type, board-load mode, cache state, and whether the work is a bulk operation.

SourceUsed forTechnical behavior
PreviewCacheFree
Fast board and index previews for images, sequences, videos, and AI/index candidates.Stores generated variants under the configured cache root. TryLoadPreRenderedPreview asks for the best available variant, so a 512px cached preview can satisfy a smaller board-load request.
WPF BitmapImageFree
Primary quick decode for common image formats when WIC can read the file.LoadBitmapSourceWithTimeout runs the decode off-thread, applies decode pixel limits, freezes the BitmapSource, and returns null on timeout rather than blocking the UI indefinitely.
SixLabors ImageSharpFree
Orientation-aware fallback and HDR-capable decode path for supported raster formats.ImageSharp identifies dimensions and EXIF orientation, auto-orients when needed, respects FenSight's decode limiter, and writes WPF-compatible pixel buffers.
Magick.NETFree
Fallback for formats WPF/WIC often cannot decode, including HEIC, AVIF, JXL, PSD/PSB, RAW, WebP edge cases, and similar production formats.Runs through MagickRuntime with the configured cache-root scratch directory, bounded read settings, resource limits, and stale magick-temp cleanup.
Windows Shell thumbnailFree
Uses installed Windows or app thumbnail handlers for file types FenSight does not decode directly.ThumbnailProvider first checks the Windows thumbcache, then calls IShellItemImageFactory on a dedicated STA thread with a timeout so Shell COM work does not marshal onto the WPF UI thread.
Content-only Shell thumbnailFree
Avoids generic file icons when FenSight needs real visual content, such as AI preview generation.Uses SIIGBF_THUMBNAILONLY without icon fallback. If Windows can only provide an app/file-type icon, the result is treated as unavailable.
Windows Preview Pane handlerFree
Specialized preview route for formats such as .ai, .c4d, .indd, and other files with registered IPreviewHandler support.FenSight looks up the preview-handler CLSID, hosts it in a hidden tool window, lets it render, captures the result with PrintWindow, and rejects mostly blank captures.
Video backfillFree
Generates representative frames for videos after ingest and on forced regeneration.RunVideoBackfillPhase4Async fills metadata and thumbnails separately from static images. Forced regeneration seeks near the midpoint, bypasses Shell icon fallback, and uses WPF MediaPlayer/LibVLC paths behind GetVideoThumbnailOffUi.
Asset-reference placeholderFree
Keeps production project/reference files visible even when no rich thumbnail exists.CreateAssetRefItem builds a 16:10 placeholder with the extension and a subtitle such as Substance material, 3D interchange, USD scene, Blender scene, or Animate project.

Settings that affect thumbnails

Exact labelUser-facing effectStored setting or implementation
Accept all file types on drop (uses Shell thumbnail / file icon)Free
Allows generic non-hidden files to land on the board even if they are outside the normal image/video/document/asset-reference sets.Persists IngestAllFileTypes. Generic fallback creates a DocumentItem from a Windows Shell thumbnail/icon or a square fallback if no thumbnail is available.
Visualize audio files (waveform display)Free
Shows supported audio files as waveforms instead of generic icons when generic ingest is enabled.Persists VisualizeAudioFiles. Waveform data is generated asynchronously through a throttle, and item dimensions are inferred from duration plus waveform data.
Defer thumbnail loading on large boardsFree
Keeps layout and initial board interaction responsive during large imports.Persists DeferThumbsOnLargeBoards. The setting defers image thumbnail decoding until after layout; video thumbnails still use their post-ingest backfill pass.
Aggressive video thumbnail backfillFree
Tries harder to create video thumbnails for files Windows Explorer has not already cached.Persists EagerVideoThumbnailBackfill. When on, FenSight uses WPF MediaPlayer and VLC fallbacks; when off, uncached videos may remain placeholders until later zoom or regeneration work.
Also cache video/document thumbnailsFree
Saves generated video and document thumbnails to disk so reopening boards is faster.Persists CacheVideoAndDocumentThumbnails and feeds the MediaCache document/video-thumb entries.
Clear generated cacheFree
Deletes rebuildable thumbnail/cache data when previews are stale or the cache is too large.Removes generated media, index preview, legacy previews-512, magick-temp, board-surface-thumbs, undo-backup, and sequence cache scopes while preserving the durable index/enrichment store.

Bulk thumbnail safety

FenSight intentionally avoids Shell thumbnail generation in large batch paths. Third-party Windows shell extensions can hook every Shell thumbnail request, and sustained high-volume calls are a reliability risk. Bulk preview generation therefore prefers direct decode, ImageSharp, and Magick.NET with skipShellFallback set, while Shell content thumbnails remain available for bounded on-demand cases.

  • AI/index preview generation uses direct decode/Magick.NET first and can skip Shell fallback in bulk mode.
  • Video thumbnail loops bypass Shell icon fallback and use cache-only Shell reads plus WPF MediaPlayer/LibVLC frame generation.
  • Individual user-triggered previews and generic file drops may still use Shell thumbnails because the request count is bounded by the action.

When a thumbnail is missing

A missing thumbnail does not always mean the file failed to import. Some formats are accepted as proxy items first, some video thumbnails arrive after Phase 4 backfill, and generic files depend on the Windows thumbnail provider installed for that file type.

  • If a video shows a placeholder, use the item context menu's Generate Video Thumbnail command or File -> Rebuild Thumbnails.
  • If a document or project file shows an icon, Windows may not have a content thumbnail or Preview Pane handler for that extension.
  • If a RAW/HDR/texture file opens as a placeholder during a large import, the background preview and LOD backfill paths may still replace it later.
  • If Accept all file types is off, unsupported files are skipped rather than imported as generic icon items.

Supported formats, thumbnail caching, rebuild thumbnails, Shell-thumbnail fallback, and audio waveform import are Free. Paid tiers are not required for the format and thumbnail pipeline itself.

A file type can be accepted without guaranteeing a rich visual preview on every machine. Shell and Preview Pane thumbnails depend on installed Windows codecs, shell extensions, or application preview handlers.

Connected guides

Follow these related pages when the workflow crosses into setup, search, organization, export, security, or another board-level system.