TagSpaces — Take Back Control of Your Files
An open-source, offline-first file organizer with tagging, note-taking, and multi-format preview — for Windows, macOS, Linux, Android, and the web.
Get Started | Downloads | Live Demo | Documentation | Discussions
TagSpaces helps you organize files, photos, notes, and documents using tags — without requiring a cloud account, a database, or an internet connection. Your files stay where they are. Your tags and metadata travel with them as plain JSON sidecar files or embedded in filenames.
Why TagSpaces?
| 🏷️ Tag Everything | Add color-coded tags to any file or folder. Search and filter instantly. |
| 🔒 Privacy by Default | No login, no backend, no tracking. Your data never leaves your device. |
| 📂 Works With Your Files | Not a database — TagSpaces works with your existing folder structure and file formats. |
| 🌐 Works Offline | Full functionality without internet. Sync with any service you choose (Dropbox, Syncthing, NAS, S3). |
| 📝 Built-in Editors | Create and edit Markdown notes, HTML documents, and more — directly in the app. |
| 🖼️ Preview Everything | PDF, images, video, audio, ePub, 3D models, fonts, emails — 50+ file formats with built-in viewers. |
Getting Started
The quickest way to try TagSpaces:
| Option | Description |
|---|---|
| Live Demo | Try it in your browser — no installation needed |
| Download Lite | Free, open-source desktop app (Windows, macOS, Linux) |
| Web Clipper | Browser extension for Chrome, Firefox, and Edge |
| Docker | Self-host the web version on your own server |
Key Features
- 🏷️ File & folder tagging — rename-based or sidecar JSON, your choice
- 📝 Markdown & rich-text editor — with frontmatter support and internal links
- 🗂️ Kanban boards — turn folders into drag-and-drop task boards (Pro)
- 🗺️ Mapique perspective — geo-tag files and visualize them on a map (Pro)
- 📅 Calendar perspective — browse files by date (Pro)
- 🖼️ Gallery perspective — visual browsing for photos and media (Pro)
- 🤖 Local AI integration — chat with Ollama, auto-tag, summarize content (Pro)
- ☁️ S3-compatible storage — connect AWS S3, Wasabi, Garage, s3proxy or Cloudflare R2
- 🔍 Full-text search — find files by name, tag, content, or description
- 📦 Web Clipper — save web pages as markdown, HTML, MHTML, PNG, or bookmarks
- 🔧 CLI tool (tscmd) — tag, describe, index, and generate thumbnails from the terminal
Downloads
Desktop App (TagSpaces Lite — free, open source)
| Platform | Download |
|---|---|
| Windows | Installer (64-bit) |
| macOS | Apple Silicon (DMG) · Intel (DMG) |
| Linux | AppImage · Debian (.deb) · tar.gz |
| Web | Self-hosted package · Docker setup |
Browser Extensions (free)
| Browser | Link |
|---|---|
| Chrome / Brave / Opera | Chrome Web Store |
| Firefox | Mozilla Add-ons |
| Edge | Edge Add-ons |
CLI Tool
npm install -g @tagspaces/shell
Repositories
| Repository | Description | License |
|---|---|---|
| tagspaces | Main desktop & web application | AGPL-3.0 |
| browser-extensions | Web Clipper for Chrome, Firefox, and Edge | AGPL-3.0 |
| tagspaces-common | Shared libraries, CLI tool (tscmd) | MIT |
| tagspaces-extensions | File viewer/editor extensions | MIT |
| documentation | Documentation website source | — |
Get Involved
- 🌍 Translate — Help translate TagSpaces into your language via Transifex
- 🐛 Report Issues — Bug reports and feature requests
- 💬 Discussions — Ask questions, share workflows, give feedback
- 💻 Contribute Code — PRs welcome
Connect
| Channel | Link |
|---|---|
| Website | tagspaces.org |
| Documentation | docs.tagspaces.org |
| Mastodon | @tagspaces@fosstodon.org |
| X | @tagspaces |
| YouTube | TagSpaces Channel |
| TagSpaces | |
| contactus@tagspaces.org |
Founded in 2012 in Munich, Germany. Open source since day one.