TagSpaces is a free and open-source platform for organizing, tagging, and managing your local files. It runs completely offline, with no need for cloud services, internet connection, or vendor lock-in. Available for Windows, Linux, and macOS, it also includes a browser extension (Web Clipper) for Firefox, Edge, and Chrome to capture online content as local files.
- 🌍 Website
- 📰 Blog
- 📚 Documentation
- 💬 Community Forum
- 🐛 GitHub Issues
Grab the latest release from the GitHub Releases Page.
Check out the full changelog for recent updates.
- File & Folder Management – Browse, organize, and manage local files in a powerful interface.
- Tagging System – Add tags directly into filenames or use sidecar files for metadata storage.
- Flexible Search – Filter and find files by name or tags using fuzzy search.
- Offline First – 100% offline, serverless, and privacy-focused.
- Cross-platform – Runs seamlessly on Windows, Linux, and macOS.
- Note Taking – Create notes in TXT, Markdown, or HTML.
- To-Do Support – Manage task lists using the built-in HTML editor.
- Media Player – Play common audio and video formats directly within the app.
- Web Clipper – Save web pages or screenshots locally using our browser extension.
- Javascript Framework: React.js
- User Interface Styling: MUI
- Desktop App Framework: Electron
- Boilerplate: Electron React Boilerplate
src/
renderer/ # Core application logic
main/ # Electron main process
locales/ # Language translation files
node_modules/ # TagSpaces extension modules
cordova/ # Deprecated Android build
dll/ # Live reload support for development
docker/ # Docker container setup
internals/ # Flow and ESLint configurations
resources/ # Images and build resources
scripts/ # NPM task-related scripts
test/ # Unit and E2E tests
web/ # Assets for web version
Install the following tools:
git clone https://github.com/tagspaces/tagspaces.git
cd tagspaces
git checkout develop # or 'master' for stable release
npm install
Create a .env file in release/app/ with a custom key to avoid conflicts:
The desktop version of the application uses a web service which is running locally as a separate process. The web service is responsible for the search index creation and the generation of the thumbnails for most of the images formats. A key is required in order for the main application to communicate with the web server. It should be generated from webpack script in the .env file located in release/app folder. This is an example for an .env file.
KEY=a_custom_key
Having a custom key, ensures that another instance of TagSpaces will not communicate with the web service of the initial instance, since it is always running on the same port.
npm run build
npm run start
npm run dev
This will start a development server in background, which watches for changes in background and refreshes the application automatically once you have done some changes in the source code.
Run unit and integration tests:
npm run test-unit
npm run test-playwright
npm run test-playwright-web
Build native apps for each platform:
npm run package-win
npm run package-linux
npm run package-mac
npm run package-mac-arm64The commands will create packages for Windows, Linux, Mac OS and Mac OS with the M1 processor respectively.
⚠️ Run npm run build before packaging.
npm run version-meta
npm run prepare-cordova
npm run package-androidStart the web version locally:
npm run run-web
TagSpaces supports extension modules for opening and editing different file types. Learn more on our Extensions Page.
We welcome contributions! Please review and sign the Contributor License Agreement (CLA) before submitting PRs.
TagSpaces is available in over 20 languages. Help us translate the app by joining our team on Transifex.
Have an idea or a feature request? Share it on our community forum and join the discussion.
If you encounter a bug or need help, open an issue on GitHub.
TagSpaces is not optimized for locations with more than 100,000 files.
TagSpaces is dual-licensed under the AGPL (GNU Affero General Public License) v3 for open-source projects and a commercial license for vendors or resellers. Contact us if you're interested in using TagSpaces under different terms.