User Documentation

TagSpaces is a free, open-source, cross-platform file manager that organizes files with tags and descriptions, working offline without accounts or internet.

ProFeature, CenteredImage, CenteredVideo, FullScreenImage, } from “@site/src/components/CommonBlocks”;

<WebPageStructuredData />

TagSpaces Documentation

Welcome to the official documentation for TagSpaces — the privacy-focused file organizer that keeps you in control of your data.

What is TagSpaces?

TagSpaces is an open-source, cross-platform application for organizing your files, photos, notes, and documents using tags and descriptions. It works entirely on your local file system — no cloud accounts, no databases, no vendor lock-in.

Whether you are managing a personal photo collection, building a knowledge base, or organizing project files across a team, TagSpaces gives you a flexible, future-proof way to find and navigate your content.

<FullScreenImage caption=“TagSpaces in action — browsing a folder with tagged files” src=“/media/home-screen.avif” />

Why TagSpaces? — Offline First by Design

Your files, your rules. Most file organizers depend on proprietary databases or cloud services. TagSpaces takes an offline-first approach — everything runs locally on your device, with no server required:

• Works offline — no internet connection or login required
• No database — tags are stored in filenames or lightweight sidecar files, so your metadata travels with your files
• Syncs with anything — use Dropbox, Google Drive, Nextcloud, Syncthing, or any sync tool — TagSpaces just works on top
• No vendor lock-in — your tags are readable by any file manager or search tool on any operating system
• Open source — the core application is free and community-driven

Key Features

• Tagging — add tags to files and folders using [filenames](https://docs.tagspaces.org/tagging#storing-tags-in-file-names or [sidecar files](https://docs.tagspaces.org/tagging#storing-tags-in-sidecar-files
• Descriptions — annotate any file or folder with rich [markdown descriptions](https://docs.tagspaces.org/files#file-description
• Search — full-text and tag-based search with AND, OR, and NOT operators
• Multiple views — browse your files in grid, list, gallery, kanban, map, or calendar perspectives
• File preview — built-in viewers for images, PDFs, videos, ebooks, office documents, and more
• Editing — integrated editors for Markdown, HTML, plain text, and JSON
• AI integration — local, offline AI features powered by Ollama for descriptions, tagging, and chat
• Many UI Themes — six light and six dark [themes](https://docs.tagspaces.org/ui/userinterface#dark-mode-and-themes with automatic OS detection
• Thumbnails — automatic thumbnail generation for dozens of file types
• Web Clipper — save web pages, fragments, and screenshots with the browser extension

Common Use Cases

• File organization — bring order to documents, downloads, and project files with tags
• Photo management — browse, tag, and describe your photo library with the gallery perspective
• Note-taking — create and edit markdown or HTML notes with full WYSIWYG support
• Knowledge management — build a personal wiki with linked documents and descriptions
• Bookmark management — save and organize web bookmarks as local files
• eBook library — organize and preview your EPUB collection
• Geo-tagging — place files on a map using the Mapique perspective

Products

See It in Action

<CenteredVideo caption=“TagSpaces introduction” src=“https://www.tagspaces.org/content/v6/tagspaces-lite-demo.mp4” posterUrl=“https://www.tagspaces.org/content/v6/tagspaces-lite-demo.avif” maxWidth=“100%” autoPlay showCaption />

More videos are available on our YouTube channel.

Technology

TagSpaces is built with modern web technologies:

• Frontend: React, Redux, TypeScript, MUI
• Desktop: Electron for Windows, macOS, and Linux
• Web: AWS SDK for JavaScript for S3-compatible object storage
• CLI: tscmd for automation and AI agentic workflows