winget install --id=tagspaces.tagspaces -e TagSpaces is a free, non-locking, open source application for organizing and managing your local files with the help of tags. It features note taking and some to-do app capabilities. The application is available for Windows, Linux, Mac OS and Android. We provide a web clipper extension for Firefox and Chrome for easy collecting of online content as local files.
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.
Grab the latest release from the GitHub Releases Page.
Check out the full changelog for recent updates.
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-arm64
The 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-android
Start 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.