Skip to main content

Annotating files and folders

In addition to the tagging, in the TagSpaces PRO you have the ability to annotate every file or folder with a description. This is useful in particular if you want to add some more textual content to given a file or folder. This description information is managed in the properties area of every entry, and can be opened by clicking on the i-button, marked with (1) on the following screenshot.

file and folder properties interfaces
Screenshot showing file with added description

The properties area reveals the following information:

  • Name - the name of the current file or folder, click on the rename button will make the name editable
  • Tags - shows all the tags (sidecar and file name based) of the current entry. You can add new tags by selecting them from the dropdown menu or drag & drop them here from the tag library. Removing tag is possible with the (x) button placed on every tag.
  • Description - shows the description of the current file or folder if available
  • Path - showing the path of the file or folder, clicking the move button will allow you to move this file
  • Date modified - shows the last modified data and time of the entry
  • Size - shows the size if the current file in byes, it is displayed only for files

The file and folder descriptions which is marked with (2) on the previous screenshot, can be edited by clicking the edit button or just clicking directly on the description area. The descriptions text can contain markdown allowing you to add basic formatting, links and lists to the content.

The descriptions is indexed by the search algorithm and considered in the search results. If a given file or folder has a descriptions, the first few words from it a displayed in the grid perspective, as marked with (3) on the previous screenshot.

Hint: Editing file and folders descriptions is available in TagSpaces PRO. The community edition supports only displaying existing descriptions for both files and directories.

File description#

For adding the description to a given file, TagSpaces PRO use the same sidecar file as the one used for the sidecar files. This file is called exactly like the original file but with .json at the end in the hidden .ts folder of current folder.

~ some-folder
โ”œโ”€โ”€ .ts
โ”‚ โ”œโ”€โ”€ file5.png.json - contains tags and description for file.png
โ”‚ โ”œโ”€โ”€ file6.docx.json - contains tags and description for file6.docx
โ”‚ โ””โ”€โ”€ tsm.json
โ”œโ”€โ”€ file5.png
โ””โ”€โ”€ file6.docx

Folder description#

For adding the description to a given folder, TagSpaces PRO creates a sidecar file called tsm.json in the hidden .ts folder of current folder. This is file contains also the tags for this specific folder.

~ some-folder
โ”œโ”€โ”€ sub-folder1
โ”‚ โ”œโ”€โ”€ .ts
โ”‚ โ”‚ โ””โ”€โ”€ tsm.json - contains tags and description for sub-folder1
โ”‚ โ”œโ”€โ”€ file1.jpg
โ”‚ โ””โ”€โ”€ file2.pdf
โ”œโ”€โ”€ .ts
โ”‚ โ””โ”€โ”€ tsm.json - contains tags and description some-folder
โ”œโ”€โ”€ file3.png
โ””โ”€โ”€ file4.docx

Custom folder colors#

With this feature every folder opened in TagSpaces can have its own background color. In addition to tagging you can use colors to mark folders used for particular use case or area of work. For example you can differentiate your personal folders from your work folders with color or you can mark folders containing sensitive or important information.

Folder colors in action
Folder colors in action