Sie sind hier

Tagster Documentation


On the first start of Tagster a setup screen comes up.


Figure 1: The setup dialog.

You just need to type in your full name, nick name and email address for user identification and then click 'Ok'.

Additional settings will be available after clicking on the 'Advanced' button.


Figure 2: The extended setup dialog.

Extra Information

  • Data Directory

    Specifies the directory where all application data is stored.
  • User ID

    The internally used unique user ID (This has to be an URI).
  • User registry

    Defines the URL to the user registry service for automatically joining a peer-to-peer network. We provide a registry service at

Network Settings

These values define the ports Tagster uses for network connections.

  • Data Port

    port used for direct data exchange between peers.
  • DHT Port

    port used for the index overlay communication.
  • Start DHT Gateway on port

    if activated a local gateway service will be started on the specified port.
  • Default Gateway

    Predefined gateways to use if an automatic lookup fails. The '+' button allows to up to 5 gateways.

Location of the configuration

The configuration file '.tagster' is by default stored in the users home directory. To use a different configuration file provide the file's path and name as first parameter at program start. This is useful if different instances/configurations of Tagster should be started.

To modify a configuration you currently have to modify the configuration file by hand. This should only be done by experienced users. In most cases it is easier to delete the configuration and use the setup dialog to set the values again. Deleting the configuration will not delete you data.


Data browsing

Tagster's browsing view has 3 main areas namely the tag view, the resource view, and the user view.

The tag view displays a list of tags. Depending on the context this can be

  • all tags of the user (another selected user)
  • all tags of the currently selected resource
  • all tags a selected user has assigned to the selected resource

The resource view shows all resources that have the currently selected tags assigned. For each resource the name and location is shown. More resource details are available for display via a popup menu that is shown after a click on the icon right of the table column headings. Resources of other can be displayed too and are usually marked with a gray background.

If a resource is selected the tag view and the tag editor at the bottom of the resource view will be updated to show all associated tags.

The user view is similar to the tag view and displays a list of users that

  • have tagged the currently selected resource (with the currently selected tag)


Figure 3: The main browsing window.


Tagging files

Clicking on the Tag register changes to the tagging perspective which pretty much looks like a common file open/save dialog. The main difference is the text field at the bottom which allows to specify the tags that shall be assigned to the selected files. Multiple files or even directories can be selected to tag files in a batch. The selected directories will be recursively examined and all files contained therein tagged too.

During tagging all file names will be split up into parts and used as tags right away.


Figure 4: The tagging dialog.

Joining a user network

To join a network with others user, you have to specify a valid user registry in the setup dialog. Everything else is done automatically and does not require any further user interaction.

It is only possible to join a single network. Thus, when different user registries are available you can only choose one of the respective networks to connect to. 


All data that is tagged will be publically available in the whole network. There is no mechanism to prevent the publication or to mark something as private data. Therefore, you should only tag data that is save for others to see. Tagging means sharing!