Skip to content

Library

Info

This page is a work in progress and needs to be updated with additional information.

The library is how TagStudio represents your chosen directory, with every file inside being represented by a file entry. You can have as many or few libraries as you wish, since each libraries' data is stored within a .TagStudio folder at its root. From there the library save file itself is stored as ts_library.sqlite, with TagStudio versions 9.4 and below using a the legacy ts_library.json format.

Note that this means tags you create only exist per-library. Global tags along with other library structure updates are planned for future releases on the roadmap.


Preview Support

TagStudio offers built-in preview and thumbnail support for a wide variety of file types. Files that don't have explicit support can still be added to your library like normal, they will just show a default icon for thumbnails and previews. TagStudio also references the file's MIME type in an attempt to render previews for file types that haven't gained explicit support yet.

Images

Images will generate thumbnails the first time they are viewed or since the last time they were modified. Thumbnails are used in the grid view, but not in the Preview Panel. Animated images will play in the Preview Panel.

Filetype Extensions Animation
Animated PNG .apng
Apple Icon Image .icns
AVIF .avif
Bitmap .bmp
GIF .gif
HEIF .heif, .heic
JPEG .jpeg, .jpg, .jfif, .jif, .jpg_large1
JPEG-XL .jxl
OpenEXR .exr
OpenRaster .ora
PNG .png
SVG .svg
TIFF .tiff, .tif
Valve Texture Format .vtf
WebP .webp
Windows Icon .ico

RAW Images

Filetype Extensions
Camera Image File Format (Canon) .crw, .cr2, .cr3
Digital Negative .dng
Fuji RAW .raf
Nikon RAW .nef, .nrw
Olympus RAW .orf
Panasonic RAW .raw, .rw2
Sony RAW .arw

Videos

Video thumbnails will default to the closest viable frame from the middle of the video. Both thumbnail generation and video playback in the Preview Panel requires FFmpeg installed on your system.

Filetype Extensions Dependencies
3GP .3gp FFmpeg
AVI .avi FFmpeg
AVIF .avif FFmpeg
FLV .flv FFmpeg
HEVC .hevc FFmpeg
Matroska .mkv FFmpeg
MP4 .mp4 , .m4p FFmpeg
MPEG Transport Stream .ts FFmpeg
QuickTime .mov, .movie, .qt FFmpeg
WebM .webm FFmpeg
WMV .wmv FFmpeg

Audio

Audio thumbnails will default to embedded cover art (if any) andfallback to generated waveform thumbnails. Audio file playback is supported in the Preview Panel if you have FFmpeg installed on your system. Audio waveforms are currently not cached.

Filetype Extensions Dependencies
AAC .aac, .m4a FFmpeg
AIFF .aiff, .aif, .aifc FFmpeg
Apple Lossless2 .alac, .aac FFmpeg
FLAC .flac FFmpeg
MP3 .mp3, FFmpeg
Ogg .ogg FFmpeg
WAVE .wav, .wave FFmpeg
Windows Media Audio .wma FFmpeg

Documents

Preview support for office documents or well-known project file formats varies by the format and whether or not embedded thumbnails are available to be read from. OpenDocument-based files are typically supported.

Filetype Extensions Preview Type
Blender .blend, .blend<#> Embedded thumbnail
Keynote (Apple iWork) .key Embedded thumbnail
Krita3 .kra, .krz Embedded thumbnail
MuseScore .mscz Embedded thumbnail
Numbers (Apple iWork) .numbers Embedded thumbnail
OpenDocument Presentation .odp, .fodp Embedded thumbnail
OpenDocument Spreadsheet .ods, .fods Embedded thumbnail
OpenDocument Text .odt, .fodt Embedded thumbnail
Pages (Apple iWork) .pages Embedded thumbnail
PDF .pdf First page render
Photoshop .psd Flattened image render
PowerPoint (Microsoft Office) .pptx, .ppt Embedded thumbnail

3D Models

3D Model Support

TagStudio does not currently support previews for 3D model files (outside of Blender project embedded thumbnails). This is on our roadmap for future features.

Fonts

Font thumbnails will use a "Aa" example preview of the font, with a full alphanumeric of the font available in the Preview Panel.

Filetype Extensions
OpenType Font .otf, .otc
TrueType Font .ttf, .ttc
Web Open Font Format .woff, .woff2

Text

Plain Text Support

TagStudio supports the vast majority of files considered to be "plain text". If an extension or format is not listed here, odds are it's still supported anyway.

Text files render the first 256 bytes of text information to an image preview for thumbnails and the Preview Panel. Improved thumbnails, full scrollable text, and syntax highlighting are on our roadmap for future features.

Filetype Extensions Syntax Highlighting
CSV .csv
HTML .html, .htm, .xhtml, .shtml, .dhtml
JSON .json, .jsonc, .json5
Markdown .md, .markdown, .mkd, .rmd
Plain Text .txt, .text
TOML .toml
XML .xml, .xul
YAML .yaml, .yml

Other

Filetype Extensions Preview Type
EPUB .epub Embedded ebook cover

  1. The .jpg_large extension is unofficial and instead the byproduct of how Google Chrome used to download images from Twitter. Since this mangled extension is still in circulation, TagStudio supports it. 

  2. Apple Lossless traditionally uses .m4a and .caf containers, but may unofficially use the .alac extension. The .m4a container is also used for separate compressed audio codecs. 

  3. Krita also supports saving projects as OpenRaster .ora files. Support for these is listed in the "Images" section.