Skip to main content

App Settings

To access the settings dialog, just click on the gears icon at the bottom left part of the app.

Access the settings of the app

The settings dialog has four tabs, which will be described bellow.


Most of the TagSpaces' common settings can be accessed from the General tab.

Setting - General Tab

  • Interface language - TagSpaces has been translated to a variety languages. Choose your preference here
  • Theme selector - Here the user interface theme can be selected.
  • Check for new version on startup - You will be notified when a new version is available.
  • Use sidecar files for tagging - once activated, tags assigned to files will not be embedded in their file names, but in so called sidecar files, located in hidden .ts sub folder of the folder where the current file is located.
  • Enable thumbnails generation - will generate and store persistent thumbnails in the hidden .ts sub folder of the folder where current file is located.
  • Default tag background color - Allows you to change to default background color of any newly created tags. Existing tags will not be affected.
  • Default tag text color- Allows you to change to default text color of any newly created tags. Existing tags will not be affected.
  • Move deleted files or folders to trash bin - After activating it, all files deleted in TagSpaces will be send to the Trash, Trashbin or Recylcebin depending on your operating system. From these locations, you files can be easily recovered in case of a unintended deletion.
  • Show files/directories with a dot(.) in front of the name - This will allow the browsing of hidden files in UNIX-like systems (Linux, macOS, BSD, etc.)
  • Max search results - This is the limit of the maximum files and folders, which can be shown in the perspectives and respectively the maximum count of search results.

File types

Here you can choose which viewer and editor to launch for each supported file type.

Adjusting the file associations

When you click on a file type's viewer dropdown, you will be offered a list of all installed viewer plugins (1).


To learn more about file previews, refer to the Viewing Files section.

When you click on a file type's editor dropdown, you will be offered a list of all installed editor plugins (2).


To learn more about file previews, refer to the Editing Files section.

Clicking on the colored area (3) in the most right part of every files type will open a color selection dialog where you can adjust the color of the current file type.

To add a formerly unrecognized extension, just use the Add New File Type button (4).

Key bindings

Under the key bindings tab, you can view and edit all the available key bindings, excluding those assigned to tags.

Most of the keybindings are configurable. To change them, Open the Settings. In the setting dialog, open the tab KEY BINDINGS.

Changing the key bindings

Here you can see all the keyboard shortcuts by default in TagSpaces, and what actions they perform. You also have the ability to change keyboard shortcuts by clicking on the field in which they were written. Before changing any of the binding, please read the following short instructions:

  • For modifier keys you can use shift, ctrl, alt, option, meta, command and mod. The last one is special modifier allowing us to refer to the control and command key on Windows/Linux and macOS operating systems respectively.
  • Other special keys are backspace, tab, enter, return, capslock, esc, escape, space, pageup, pagedown, end, home, left, up, right, down, ins and del.
  • Any other key you should be able to reference by name like a, /, $, *, =.
  • You can assign many keys to a single operation, simply by separating them by ,.

To learn more about the key bindings, refer to the this section of the documentation.


In this area we have collected settings which are relevant for some advanced use cases.

Advanced settings area

  • Enable mobile mode - switches the app in mobile mode, which can be useful on small screens or app window sizes
  • Enable generating thumbnails and search index in a separate process - since v4 the app generates thumbnails and search index in a separate process, here you can disable it and use the main app for that. This will have a negative impact on the performance
  • Show warning on opening files externally - showing a warning on opening files with external programs is a way to prevent you executing potentially malicious files (e.g. opening an .exe file on Windows will execute it)
  • Enable location tags - PRO enabling this will give the options to store tag groups outside in the location itself (out of the tag library). Learn more here.
  • Geo tagging format - PRO here you have the ability to choose the geo tagging format. The apps offers the following formats
    • PlusCode - is geo codding format offering a short text representation so geo coordinate with latitude: 47.741687 and longitude 7.342313 will be encoded in 8FV9P8RR+MW.
    • MGRS - is another geo codding format, where the geo tags looks like this 4QFJ12345678.
  • Map tile servers - PRO TagSpaces uses OpenStreetMap based maps to represent maps in the geotagging capabilities of the application. Here you add custom OpenStreetMap compatible map tile server. On the OpenStreetMap wiki there is a list of common map server. With this functionality you can also add your own map tile server, in case you want to have completely Internet independent geo-tagging system.

Please respect the policies and the terms of usage of any given map service provider!

Beside this in the advanced setting tab you will find two buttons:

  • Restore default settings - which restores the initial settings of the app, including connected location and tag library, so be careful before confirming. You can also export the locations and the tag library and then import them after a reset.
  • Reload application - this will just reload the application, similar to hitting the reload button in a browser.