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.
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 or sidecar files
- Descriptions — annotate any file or folder with rich markdown descriptions
- 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 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
| Product | Description |
|---|---|
| TagSpaces Lite | Free, open-source desktop app for Windows, macOS, and Linux |
| TagSpaces Pro | Extended desktop app with advanced features for power users |
| TagSpaces Pro Web | Self-hosted web app for managing files on object storage (S3) |
| TagSpaces Custom | Enterprise solution with user management and custom branding |
| Web Clipper | Free, open-source browser extension for Chrome, Firefox, Edge, Brave and Opera |
See It in Action
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