Thank you for participating in the Teamwire Desktop Public Beta testing.

This document provides basic information about the functionality of the new desktop app and how to report any bugs you find.

Versioning

• 4.0.0-beta.6
  win-x64.msi , mac-x64.dmg , linux-amd64.deb , linux-x86_64.rpm

• 4.0.0-beta.5
• 4.0.0-beta.4
• 4.0.0-beta.3
• 4.0.0-beta.2
   

System requirements

Supported Operating Systems:

• Microsoft Windows 10 or later
   

Bug reporting

Do you want to report a problem? Go ahead!

If certain types of behavior or errors occur repeatedly, please share your experience with us! The following information is extremely helpful for the further development and improvement of the app:

• Can the problem be repeatedly reproduced? Yes / No / Sometimes
• Go to View > Toggle Developer Tools and open the "Console" tab in the new screen. Reproduce the behaviour and export the data you see.
• Describe how to reproduce the behaviour step by step
• Your logfile (see Logfile location)
• A screenshot, if necessary
• The version of your Teamwire Desktop Beta app
• The version of your operating system (e.g. Windows 10 Pro)

If you miss a particular feature, please check the current list of features to see if it has already been implemented.

Installation directory

The installation directory is currently not customizable. By default, the app is installed here:

• Windows: %LOCALAPPDATA%\Programs\teamwire-beta\
• macOS: /Applications/Teamwire Beta.app
• Linux: /bin/Teamwire Beta
   

User data directory

The location of your user data is currently not customizable. By default, your data is stored here:

• Windows: %APPDATA%\teamwire-beta\
• macOS: /Users/[username]/Library/Application Support/teamwire-beta
• Linux: /home/[username]/.config/teamwire-beta
   

Logfile location

The log file with the file name "logs" is saved in your user data directory.

• Windows: %APPDATA%\teamwire-beta\logs
• macOS: /Users/[username]/Library/Application Support/teamwire-beta/logs
• Linux: /home/[username]/.config/teamwire-beta/logs
   

Error: "Sorry. Something went wrong"

The error message "Sorry. Something went wrong" is a generic message, since not all exceptions are specifically caught yet.

In case of sporadic occurrence, you can bypass this message with the Reload button.

If the Reload button does not work, you can try one of the following options:

• Close the app completely (via the task manager if necessary) and restart Teamwire Beta.
• Delete all the data in your user data directory.
• Uninstall the app completely and install it again.
   

Configuration / Registry file

Some settings and user data can be distributed with a configuration file.

Windows

• The registry hive is at HKEY_CURRENT_USER\SOFTWARE\teamwire-beta\
   

macOS and Linux

• The configuration file needs to be stored to ~/.config/teamwire-beta/teamwire-beta.cfg
• In addition, the JSON schema has been simplified to "configurationName": "propertyValue",
   

Supported parameters

Desktop App 4.0.0-beta.2 (and newer) supports the following configuration parameters:

• serverHost (String), previously BackendServerName
• proxyURL (String)
   

Desktop App 4.0.0-beta.3 (and newer) supports the auto-registration process and the following configuration parameters:

• serverHost (String), previously BackendServerName
• proxyURL (String)
• firstName (String)
• lastName (String)
• email (String)
• registrationToken (String)
• phoneNumber (String)
• trustedCertificates (Array)
  This new parameter has been added to solve the problems when connecting to the Backend API through a TLS-protected HTTPS with a self-signed certificate. "trustedCertificates" is a certificates whitelist. It is an array of Base64-encoded SHA256 certificate fingerprints.
   

You can download a template for Windows registry and the JSON config here: configuration-templates.zip

App Features