Skip to main content


A location is a folder on your local file system, which will serve as a root for listing sub folders, files and documents. Typical locations are for example the folder where you collect your photos or folders where you store documents, ebooks or music.

Hint: Do not choose very large directories such as your home folder as a location root folder, as this may lead to performance issues. The reason for this is that TagSpaces is indexing the whole location every time you open it and the indexing can just take time if the location contains many files. On modern computers with SSD harddrives having a location with up to 60000 files is usually not a problem. The current upper limit for files indexed in a locations is 200000.

The location manager is can be opened by clicking the case button (1) from the vertical navigation, or by pressing the CTRL+1 key combination. Once opened, you will see a list of the currently configured locations. Here you can open any location by clicking its name. You can add new locations, by clicking on the Connect new location button (2). This button will open the Connect a Location dialog, which is very similar to the Edit Location dialog. The torch icon (3) indicates Startup Location, which is the location loaded automatically on the application start.

Clicking second time on a location name, will trigger the loading of the sub directories in this locations, once loaded this folder will be listed in the folder navigation area (5)

Location manager

The location with the cloud icon (6) in front of its name is located in the AWS S3 compatible cloud storage. See cloud locations for more details.

The location with the light green background color (4) is the currently opened location. The 3-dot button located on the most right part of every location in the location manager will open the context menu for this location. This menu contains the following menu entries:

  • Edit Location - will open the Edit Location dialog where you can change the location properties such as name or path.
  • Refresh Location Index - will trigger the indexing process manually, this menu entry is visible only for the currently opened location
  • Move up - will move the location visually up in the location manager
  • Move down - will move the location visually down in the location manager
  • Remove location - will remove the location permanently from the app. This operation will not affect your files, it only removes its reference in TagSpaces.
  • Show in File Manager - will open the path in your file system to which this location point in the default file manager of your operating system
  • Close Location - will simply close this location if it is currently opened.

Location types#

In TagSpaces there two type of locations, regular (local) and cloud based (AWS S3 Object Storage). The type can be selected in the create and edit location dialogs.

Regular Locations#

Regular locations are pointing to a folder located on your local computer. This could be also a folder where you sync locally your Dropbox files or a folder from a connected network drive.

Note: Be careful with connected huge folder located on network drive, depending on the speed of the network, this could lead to performance issues.

Edit properties of a regular location

The regular locations have the following properties:

  • Location name - this is the name of location as displayed in the location manager
  • Location path - the path from your computer, to which this location points
  • Startup location - turning this switch on will make the location load automatically on application start. You can set only one location to be a startup one.
  • Open this location in read-only mode - switches the interface of TagSpaces to read-only mode
  • Enable full text search for TXT, MD and HTML files - activates the indexing of the content of text, markdown and HTML files.
  • Switch to manual index creation with persisted search index - disables the automatic indexing of a location on its opening. The application will try to open a previously created index located in a file tsi.json from the .ts folder of the location. This is useful on locations with many files, where the content does not change very often.
  • Watch for external changes in this location - once switched on TagSpaces will watch the folder to which the location points and all its sub folders for changes and reflect them in the application.

Cloud Locations#

These location are pointing to AWS S3 compatible stores (also known as buckets) located in the Internet.

Cloud locations are available only in the Pro and Enterprise editions of TagSpaces.

Edit properties of a cloud location

In addition to the regular locations, the cloud locations have the following properties:

  • Location Path - the path in the bucket to which this location points
  • Access Key - the access key of a user, who has the rights to open this bucket
  • Secret Access Key - the secret access key of the user
  • Bucket Name - the name of the bucket to which this location points
  • Region - the AWS region, where the bucket is hosted. The dropdown is located on the right from the bucket name.

Note: Watch for external changes in this location is disabled because it is not available for cloud locations.

In our tutorial section you can find a complete manual on how to create a new AWS S3 bucket and connect it as location in TagSpaces.

Object storages as locations#

With this feature TagSpaces PRO is going into direction of supporting the Cloud as file storage. In general it enables you to creating a location pointing to a remote object storages or buckets on AWS S3, DigitalOcean Spaces or Minio infrastructure. By doing this you get a fully functional file organizer, browser and navigator for this bucket, directly in TagSpaces. You don't have to download separately and eventually to upload them back in order to preview, edit or annotate them.

You can recognize object storage location by the cloud icon in front of their name, as seen in the next screenshot.

Screenshot showing configuration of a AWS S3 hosted location
Screenshot showing configuration of a AWS S3 hosted location

In order to connect such location you will need to know the bucket name, the access key, the secret access key and the data center location for the particular bucket. If you have a location with a deep folder structure you can also specify the internal path to the files you want to manage in this location.

Tutorial: For detailed instructions on how to connect an AWS S3 location to TagSpaces, read this tutorial from the documentation.

A bucket in AWS S3
A screenshot of a bucket in AWS S3

Comparing to user interfaces provided by AWS visible on the previous screenshot, TagSpaces gives you the following features on top:

  • Direct preview of the files
  • Direct editing of HTML, MD and other text based files
  • Direct streaming of the supported audio and video formats
  • Showing thumbnails of the files
  • Tagging and Search

Using this feature you are creating basically a Dropbox or an Evernote replacement, where you have the full control on your files and data.

Note: If your bucket contains many files and the initial opening with indexing takes a lot of time you can make use of the enabling the manual indexing for this location.

Software architecture for connecting cloud locations
Software architecture for connecting cloud locations

Advanced Features#

Monitor for changes in locations#

This features is useful, when you have locations placed on a network drive or pointing to a folder synced with for example Dropbox, where changes to these folders happens in background while TagSpaces is running. This can happen if you work collaboratively with someone on a network or your Dropbox syncs files from other devices. In such cases TagSpaces monitors the folder pointed by the location with all its sub-folders for changes, such as file creations, deletions or renames and reflects these changes in the user interface of the app.

Location with activated watcher and enabled manual indexing
Location with activated watcher and enabled manual indexing

This option can be activated manually for every location individually in the location properties dialog, as displayed in the screenshot.

Note: This feature is not available on locations pointing to a S3 compatible object storage.

Manual indexing#

For locations containing many files, it may make sense to disable the automatic indexing taking place on the opening of this location. You can activate this options for every location individually on its creation or on its properties screen as seen in the previous screenshot. The properties dialog is accessible from the context menu of any location. Enabling this options will speed up the loading of the location, especially on network based locations (W/LAN or S3 object stores). Instead of the indexing, the application will try to load a previously generated index file tsi.json located in the root folder of the location. If you do not have such persisted index file, you can create one manually with the command "Refresh Location Index" from the location context menu, as seen on the following screenshot.

Starting the manual index generation for given location
Starting the manual index generation for given location

Tag extraction from location#

In the content menu of every tag group in the PRO version, there is an entry called "Collect Tags From Current Location", which does exactly this. It analyses the index of the current location and identifies tags with unique names, which are then added to the tag group from which the operation was started.

Starting the tag extraction
Starting the tag extraction

Custom location IDs#

Work in progress