# TagSpaces Documentation

> Complete reference documentation for TagSpaces

This file contains links to documentation sections following the llmstxt.org standard.

## Table of Contents

- [About the docs](https://docs.tagspaces.org//docs/aboutdocs.md): Overview of the TagSpaces documentation structure, contribution guidelines, formatting conventions, and explanation of symbols used throughout the ...
- [AI Functionality](https://docs.tagspaces.org//docs/ai.md): Learn how to use AI features in TagSpaces powered by Ollama for local, offline text and image analysis without sending data to external cloud servi...
- [Annotating files and folders](https://docs.tagspaces.org//docs/annotations.md): Guide to annotating files and folders in TagSpaces using descriptions, tags, and metadata stored locally without requiring external services or acc...
- [Bookmarks](https://docs.tagspaces.org//docs/bookmarks.md): Learn how to bookmark files and folders in TagSpaces for quick access from the Quick Access panel to navigate your most important content efficiently.
- [Perspectives Overview](https://docs.tagspaces.org//docs/browsing-files.md): Overview of TagSpaces file browsing perspectives including Grid, List, Gallery, Kanban, Calendar, Mapique, and FolderViz for flexible file management.
- [Create Files](https://docs.tagspaces.org//docs/creating-files.md): Learn how to create new files in TagSpaces including text, Markdown, HTML, and JSON formats with automatic timestamp tagging for unique file identi...
- [Command Line Tools](https://docs.tagspaces.org//docs/dev/command-line-tools.md): Documentation for TagSpaces CLI tools for generating search indexes and thumbnails programmatically, suitable for automation scripts and CRON job i...
- [Deployment Strategies](https://docs.tagspaces.org//docs/dev/deployment.md): Visual overview of TagSpaces deployment architectures for desktop, web, and combined installations showing how infrastructure components connect.
- [Extension Development Guide](https://docs.tagspaces.org//docs/dev/extension-development-guide.md): Complete guide for developing TagSpaces viewer and editor extensions — covers architecture, the postMessage API, React setup, testing, and contribu...
- [External Configuration](https://docs.tagspaces.org//docs/dev/external-config.md): This document will describe how to deploy TagSpaces Pro and Custom with predefined configuration such as custom logo and color, tag library or loca...
- [Specification of the meta file formats](https://docs.tagspaces.org//docs/dev/metafileformats.md): Technical specification of TagSpaces metadata file formats stored in .ts folders, including file meta, folder meta, and tag group JSON schemas.
- [Edit Files](https://docs.tagspaces.org//docs/editing-files.md): Edit files in TagSpaces using built-in editors for HTML, Markdown, plain text, and JSON with WYSIWYG support and file revision history.
- [3D Viewer](https://docs.tagspaces.org//docs/extensions/3d-viewer.md): TagSpaces Pro extension for previewing GLB, GLTF, STL, and OBJ 3D models with rotation, zoom, and PNG screenshot export capabilities.
- [Archive Viewer](https://docs.tagspaces.org//docs/extensions/archive-viewer.md): TagSpaces Archive Viewer extension for browsing and previewing ZIP file contents using the jszip library, bundled with all TagSpaces editions.
- [Contact Editor](https://docs.tagspaces.org//docs/extensions/contact-viewer.md): TagSpaces Pro extension for displaying VCF vCard contact files with clickable email and phone fields and multi-contact support.
- [Document Viewer](https://docs.tagspaces.org//docs/extensions/document-viewer.md): TagSpaces Document Viewer extension for previewing DOCX and ODT word-processing files with HTML export, zoom, and text search using mammoth.js.
- [eBook Viewer](https://docs.tagspaces.org//docs/extensions/ebook-viewer.md): TagSpaces eBook Viewer extension for reading EPUB ebooks with auto two-fold mode, adjustable font size, line spacing, and reading margin settings.
- [Font Viewer](https://docs.tagspaces.org//docs/extensions/font-viewer.md): TagSpaces Pro extension for previewing TTF, OTF, and WOFF font files with character glyph display using Opentype.js library.
- [HTML Editor](https://docs.tagspaces.org//docs/extensions/html-editor.md): TagSpaces HTML Editor extension providing a WYSIWYG interface for editing HTML documents using Summernote with clipboard image pasting support.
- [HTML Viewer](https://docs.tagspaces.org//docs/extensions/html-viewer.md): TagSpaces HTML Viewer extension for rendering local HTML files with zoom, search, print, reader mode, and display of web clipper metadata.
- [Image Viewer](https://docs.tagspaces.org//docs/extensions/image-viewer.md): TagSpaces Image Viewer extension supporting JPG, PNG, GIF, SVG, BMP, WEBP, AVIF, and TIFF with zoom, rotate, flip, EXIF reading, and image export.
- [JSON Editor](https://docs.tagspaces.org//docs/extensions/json-editor.md): TagSpaces JSON Editor extension for visually editing JSON documents with expand/collapse nodes, undo/redo support, and drag-based data manipulation.
- [Markdown Editor](https://docs.tagspaces.org//docs/extensions/md-editor.md): TagSpaces Markdown Editor with WYSIWYG editing, embedded images, emoji, tables, math expressions, text-to-speech, and mind map generation from head...
- [Markdown Viewer](https://docs.tagspaces.org//docs/extensions/md-viewer.md): Deprecated TagSpaces Markdown Viewer extension for previewing Markdown files with theme selection, text search, HTML export, zoom, and print.
- [Media Player](https://docs.tagspaces.org//docs/extensions/media-player.md): TagSpaces Media Player extension for playing audio and video files with fullscreen mode, auto-play next file, and advanced playback via Vidstack.
- [MHTML Viewer](https://docs.tagspaces.org//docs/extensions/mhtml-viewer.md): TagSpaces MHTML Viewer extension for opening MHTML web archives and EML email files with reader mode, source URL access, and text search.
- [Mindmap Viewer](https://docs.tagspaces.org//docs/extensions/mindmap-viewer.md): TagSpaces Mindmap Viewer extension for visualizing Markdown files as interactive mind maps using markmap.js with zoom and pan navigation.
- [MSG Viewer](https://docs.tagspaces.org//docs/extensions/msg-viewer.md): TagSpaces MSG Viewer extension for opening Microsoft Outlook MSG email files with HTML export and zoom functionality using msg.reader library.
- [PDF Viewer](https://docs.tagspaces.org//docs/extensions/pdf-viewer.md): TagSpaces PDF Viewer for viewing PDFs with annotation tools, text highlighting, search, page thumbnails, table of contents, and printing via PDF.js.
- [RTF Viewer](https://docs.tagspaces.org//docs/extensions/rtf-viewer.md): TagSpaces RTF Viewer extension for previewing Rich Text Format documents with HTML export and zoom support using the rtf.js open-source library.
- [Slides Viewer](https://docs.tagspaces.org//docs/extensions/slides-viewer.md): TagSpaces Slides Viewer extension for displaying Reveal.js HTML presentations with embedded slide content.
- [Spreadsheet Viewer](https://docs.tagspaces.org//docs/extensions/spreadsheet-viewer.md): TagSpaces Spreadsheet Viewer extension for previewing XLSX, ODS, and CSV files with sheet navigation, HTML export, and zoom using SheetJS.
- [Text Editor](https://docs.tagspaces.org//docs/extensions/text-editor.md): TagSpaces Text Editor powered by Monaco Editor for editing code and text files with syntax highlighting, adjustable font size, and word wrap support.
- [Text Viewer](https://docs.tagspaces.org//docs/extensions/text-viewer.md): TagSpaces Text Viewer extension for previewing any file as plain text, serving as a universal fallback viewer for all file formats.
- [URL Editor](https://docs.tagspaces.org//docs/extensions/url-viewer.md): TagSpaces bookmark editor extension for opening browser bookmark files (.url, .webloc, .desktop) enabling TagSpaces as a tag-powered bookmark manager.
- [Files Overview](https://docs.tagspaces.org//docs/files.md): Learn how to manage files in TagSpaces using the Details, Description, Revisions, and Links panels, plus file menu actions for organizing and shari...
- [Folders Overview](https://docs.tagspaces.org//docs/folders.md): Explore TagSpaces folder management features including tags, descriptions, custom thumbnails, background colors, and default perspectives for organ...
- [Installing TagSpaces](https://docs.tagspaces.org//docs/installation.md): Step-by-step installation guide for TagSpaces on Windows, macOS, and Linux covering the free Lite edition and Pro versions for desktop and web depl...
- [User Documentation](https://docs.tagspaces.org//docs/intro.md): TagSpaces is a free, open-source, cross-platform file manager that organizes files with tags and descriptions, working offline without accounts or ...
- [Link to files, folders and locations](https://docs.tagspaces.org//docs/linking.md): Discover how to create internal links between files, folders, and locations in TagSpaces for efficient cross-referencing and navigation within your...
- [Style Guide](https://docs.tagspaces.org//docs/markdown.md): Style guide and formatting conventions for contributing to TagSpaces documentation, covering Markdown syntax, headings, code blocks, and component ...
- [Calendar Perspective](https://docs.tagspaces.org//docs/perspectives/calendar.md): TagSpaces Pro feature which organizes files by date using tags, folder names, or file timestamps for chronological browsing and time-based retrieval.
- [FolderViz Perspective](https://docs.tagspaces.org//docs/perspectives/folderviz.md): TagSpaces Pro feature which provides folder trees, size trees, tag clouds, and file tree visualizations for analyzing folder structures and distrib...
- [Gallery Perspective](https://docs.tagspaces.org//docs/perspectives/gallery.md): TagSpaces Pro feature which provides a masonry image gallery with slideshow mode, full-screen viewing, and EXIF/IPTC metadata import for photo tagg...
- [Grid Perspective](https://docs.tagspaces.org//docs/perspectives/grid.md): TagSpaces Grid Perspective is the default file browser view showing files as tiles with thumbnails, tags, descriptions, and metadata for visual fil...
- [Kanban Perspective](https://docs.tagspaces.org//docs/perspectives/kanban.md): TagSpaces Pro feature which transforms subfolders into Kanban board columns with draggable cards for visual task management and project tracking.
- [List Perspective](https://docs.tagspaces.org//docs/perspectives/list.md): TagSpaces List Perspective displays files in compact, default, or large list format showing name, tags, descriptions, size, and modification date.
- [Mapique Perspective](https://docs.tagspaces.org//docs/perspectives/mapique.md): TagSpaces Pro feature which displays geo-tagged files on interactive OpenStreetMap maps for location-based photo organization and trip planning.
- [Quick Access](https://docs.tagspaces.org//docs/quick-access.md): Explore the TagSpaces Quick Access section providing fast navigation to bookmarks, recently opened files, recent edits, stored searches, and freque...
- [Search Overview](https://docs.tagspaces.org//docs/search.md): Complete guide to TagSpaces search with AND, OR, NOT operators, full-text search, tag filtering, and indexed search for fast file discovery across ...
- [Share files and folders](https://docs.tagspaces.org//docs/sharing.md): Learn how to share files and folders in TagSpaces using internal sharing links for cloud-synced files and download links for object storage locations.
- [Supported file formats](https://docs.tagspaces.org//docs/supported-file-formats.md): Complete reference of file formats supported in TagSpaces for viewing, editing, and thumbnail generation including images, documents, audio, video,...
- [Organizing Files and Folders with Tags](https://docs.tagspaces.org//docs/tagging.md): Discover how to organize files and folders in TagSpaces using tags stored in filenames or sidecar files, enabling portable, vendor-independent meta...
- [Thumbnail Generation](https://docs.tagspaces.org//docs/thumbnails.md): Learn about automatic thumbnail generation in TagSpaces for images, videos, PDFs, ebooks, and archives, cached in .ts folders for faster file brows...
- [How to use Cloudflare R2 buckets as locations](https://docs.tagspaces.org//docs/tutorials/cloudflare-r2-storage.md): Tutorial for setting up Cloudflare R2 S3-compatible object storage without egress fees and connecting it to TagSpaces as a cost-effective cloud loc...
- [How to use Contabo to store your files](https://docs.tagspaces.org//docs/tutorials/contabo-storage.md): Guide for creating GDPR-compliant Contabo object storage buckets with S3 credentials and integrating with TagSpaces as an affordable European stora...
- [E2E encryption with Cryptomator](https://docs.tagspaces.org//docs/tutorials/e2ee-with-tagspaces-and-cryptomator.md): Tutorial for combining TagSpaces with Cryptomator for end-to-end encrypted note-taking on cloud storage as a privacy-first alternative to Evernote.
- [Syncing files between TagSpaces installations](https://docs.tagspaces.org//docs/tutorials/file-syncing.md): Learn how to sync TagSpaces-tagged files between installations using Dropbox, Google Drive, OneDrive, Syncthing, and Cryptomator for encrypted file...
- [Customizing Folders](https://docs.tagspaces.org//docs/tutorials/folder-customizations.md): Learn how to customize TagSpaces folders with default perspectives, custom thumbnails, and background colors to create tailored file-based applicat...
- [Exposing local folders as object storage with S3Proxy](https://docs.tagspaces.org//docs/tutorials/folders-as-objectstorage-with-s3proxy.md): Learn how to expose local folder as s3 object storage with S3Proxy
- [How to use Garage buckets as locations](https://docs.tagspaces.org//docs/tutorials/garage-storage.md): Tutorial for self-hosting open-source Garage S3-compatible object storage on personal servers or NAS devices and connecting it to TagSpaces for pri...
- [How to start](https://docs.tagspaces.org//docs/tutorials/how-to-start.md): Beginner's guide to TagSpaces covering first launch, understanding locations, and connecting local folders and cloud storage as browsable file syst...
- [Use custom map tile services in TagSpaces Pro](https://docs.tagspaces.org//docs/tutorials/map-tiler-tutorial.md): Guide for configuring custom map tile services including MapTiler and self-hosted OpenStreetMap servers in the TagSpaces Pro Mapique Perspective.
- [Tutorials Overview](https://docs.tagspaces.org//docs/tutorials/overview.md): Index of TagSpaces tutorials covering getting started, collaborative tagging, encryption, object storage providers, web hosting, Docker deployment,...
- [Prepare custom packages](https://docs.tagspaces.org//docs/tutorials/prepare-custom-packages.md): Learn how to prepare custom packages for TagSpaces' desktop app.
- [How to use AWS S3 buckets as locations](https://docs.tagspaces.org//docs/tutorials/s3-bucket-locations.md): Step-by-step guide for creating AWS S3 buckets, configuring CORS policies, and setting up IAM users to connect S3 storage as TagSpaces file locations.
- [MinIO Buckets Hosted on NAS Server](https://docs.tagspaces.org//docs/tutorials/setup-minio-bucket-nas.md): How to set up MinIO buckets on your NAS and connect them to a TagSpaces Pro installation.
- [Setup TagSpaces Custom](https://docs.tagspaces.org//docs/tutorials/setup-tagspaces-custom.md): Setup guide for TagSpaces Custom enterprise edition using AWS Cognito authentication, S3 storage, DynamoDB configuration, and GraphQL API via AWS A...
- [Setup TagSpaces Pro Web](https://docs.tagspaces.org//docs/tutorials/setup-tagspaces-pro-web.md): Setup guide for TagSpaces Pro Web edition using the same installation process as the free web version available since TagSpaces version 5.
- [Install on TagSpaces Web](https://docs.tagspaces.org//docs/tutorials/setup-tagspaces-web.md): Learn how to setup TagSpaces Web on a web server.
- [Collaboratively using tags and tag groups](https://docs.tagspaces.org//docs/tutorials/sharing-tags.md): Learn how to export and import TagSpaces tag groups for sharing tag libraries across users and devices to enable consistent collaborative file tagg...
- [Install TagSpaces Web on Cloudflare](https://docs.tagspaces.org//docs/tutorials/tagspaces-web-cloudflare.md): Step-by-step guide for deploying TagSpaces Web to Cloudflare Pages using Wrangler CLI for free static hosting with HTTPS and global CDN delivery.
- [Install TagSpaces Web with Docker](https://docs.tagspaces.org//docs/tutorials/tagspaces-web-docker.md): Docker deployment guide for TagSpaces Lite Web and Pro Web using Alpine Linux and nginx containers for quick and reproducible self-hosted installat...
- [Setup publicly available TagSpaces Web on Wasabi](https://docs.tagspaces.org//docs/tutorials/tagspaces-web-wasabi.md): Guide for hosting TagSpaces Web application on a public Wasabi S3 bucket to serve a publicly accessible browser-based file management interface.
- [Using TagSpaces with other users or on many devices](https://docs.tagspaces.org//docs/tutorials/using-tagspaces-collaboratively.md): Guide to using TagSpaces collaboratively across multiple users or devices by syncing tagged files via shared network folders or cloud storage servi...
- [How to use Wasabi buckets as locations](https://docs.tagspaces.org//docs/tutorials/wasabi-locations.md): Learn how to create Wasabi S3-compatible storage buckets with no egress fees and connect them to TagSpaces for affordable cloud file management.
- [Internationalization](https://docs.tagspaces.org//docs/ui/i18n.md): TagSpaces internationalization support for 26 languages including English, German, French, Spanish, Chinese, and Japanese, with Transifex contribut...
- [Key Bindings](https://docs.tagspaces.org//docs/ui/keybindings.md): Complete reference of TagSpaces keyboard shortcuts for Windows, Linux, and Mac covering file operations, navigation, search, and document management.
- [Locations Overview](https://docs.tagspaces.org//docs/ui/locations.md): Learn how to add and manage TagSpaces file locations, connecting local folders and S3-compatible cloud storage as browsable file system locations.
- [Settings Overview](https://docs.tagspaces.org//docs/ui/settings.md): Comprehensive guide to TagSpaces settings covering language, themes, default perspectives, tagging methods, thumbnail generation, tag colors, and a...
- [Tag Library](https://docs.tagspaces.org//docs/ui/taglibrary.md): Guide to the TagSpaces tag library for organizing tags into groups including Smart Tags, GTD, Priorities, Ratings, and custom tag groups for struct...
- [User Interface Intro](https://docs.tagspaces.org//docs/ui/userinterface.md): Introduction to the TagSpaces UI covering the left drawer, navigation bar, file browsing area, properties panel, and file preview pane.
- [Preview and Print Files](https://docs.tagspaces.org//docs/viewing-files.md): Preview and print files in TagSpaces using built-in viewers for images, PDFs, audio, video, documents, ebooks, 3D models, and archives without exte...
- [Web Clipping - Collect Everything Online](https://docs.tagspaces.org//docs/web-clipper.md): Use the TagSpaces Web Clipper browser extension for Chrome, Firefox, and Edge to save web pages, screenshots, and bookmarks to your local file system.
- [Overview](https://docs.tagspaces.org//docs/workspaces.md): Understand TagSpaces Pro workspaces for separating file locations and tag libraries by context such as work, personal projects, and hobbies to impr...