Wiki source code of Public Beta Guide
Version 4.3 by teamwire001 on 2023/10/09 08:37
Hide last authors
| author | version | line-number | content |
|---|---|---|---|
 |
1.1 | 1 | Thank you for participating in the Teamwire Desktop Public Beta testing. |
| 2 | |||
| 3 | This document provides basic information about the functionality of the new desktop app and how to report any bugs you find. | ||
| 4 | |||
| 5 | |||
| |
4.2 | 6 | {{id name="versions"/}} |
| 7 | |||
| 8 | = Versioning = | ||
| 9 | |||
| |
4.3 | 10 | * 4.0.0-beta.5 |
| 11 | [[win-x64.msi>>https://desktop.teamwire.eu/merge/4.0.0-beta.5/teamwire-4.0.0-beta.5-win-x64.msi]] , [[mac-x64.dmg>>https://desktop.teamwire.eu/merge/4.0.0-beta.5/teamwire-4.0.0-beta.5-mac-x64.dmg]] , [[linux-amd64.deb>>https://desktop.teamwire.eu/merge/4.0.0-beta.5/teamwire-4.0.0-beta.5-linux-amd64.deb]] , [[linux-x86_64.rpm>>https://desktop.teamwire.eu/merge/4.0.0-beta.5/teamwire-4.0.0-beta.5-linux-x86_64.rpm]] | ||
| 12 | |||
| |
4.2 | 13 | * 4.0.0-beta.4 |
| 14 | * 4.0.0-beta.3 | ||
| 15 | * 4.0.0-beta.2 | ||
| 16 | ## ## | ||
| 17 | |||
| |
1.1 | 18 | {{id name="requirements"/}} |
| 19 | |||
| 20 | = System requirements = | ||
| 21 | |||
| 22 | Supported Operating Systems: | ||
| 23 | |||
| 24 | * Microsoft Windows 10 or later | ||
| 25 | ## ## | ||
| 26 | |||
| 27 | {{id name="bugreport"/}} | ||
| 28 | |||
| 29 | = Bug reporting = | ||
| 30 | |||
| 31 | Do you want to report a problem? Go ahead! | ||
| 32 | |||
| 33 | 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: | ||
| 34 | |||
| 35 | * Can the problem be repeatedly reproduced? Yes / No / Sometimes | ||
| |
3.2 | 36 | * Go to View > Toggle Developer Tools and open the "Console" tab in the new screen. Reproduce the behaviour and export the data you see. |
| |
1.1 | 37 | * Describe how to reproduce the behaviour step by step |
| |
3.2 | 38 | * Your logfile (see [[Logfile location>>doc:||anchor="logfile"]]) |
| |
1.1 | 39 | * A screenshot, if necessary |
| 40 | * The version of your Teamwire Desktop Beta app | ||
| 41 | * The version of your operating system (e.g. Windows 10 Pro) | ||
| 42 | |||
| 43 | If you miss a particular feature, please check the current [[list of features>>doc:||anchor="appfeatures"]] to see if it has already been implemented. | ||
| 44 | |||
| 45 | |||
| 46 | {{id name="installdir"/}} | ||
| 47 | |||
| 48 | = Installation directory = | ||
| 49 | |||
| 50 | The installation directory is currently not customizable. By default, the app is installed here: | ||
| 51 | |||
| 52 | * **Windows:** ##%LOCALAPPDATA%\Programs\teamwire-beta\## | ||
| 53 | * **macOS:** ##/Applications/Teamwire Beta.app## | ||
| 54 | * **Linux:** ##/bin/Teamwire Beta## | ||
| 55 | ## ## | ||
| 56 | |||
| 57 | {{id name="userdatadir"/}} | ||
| 58 | |||
| 59 | = User data directory = | ||
| 60 | |||
| 61 | The location of your user data is currently not customizable. By default, your data is stored here: | ||
| 62 | |||
| 63 | * **Windows:** ##%APPDATA%\teamwire-beta\## | ||
| 64 | * **macOS:** ##/Users/[username]/Library/Application Support/teamwire-beta## | ||
| 65 | * **Linux:** ##/home/[username]/.config/teamwire-beta## | ||
| 66 | ## ## | ||
| 67 | |||
| 68 | {{id name="logfile"/}} | ||
| 69 | |||
| 70 | = Logfile location = | ||
| 71 | |||
| 72 | The log file with the file name "logs" is saved in your user data directory. | ||
| 73 | |||
| 74 | * **Windows:** ##%APPDATA%\teamwire-beta\logs## | ||
| 75 | * **macOS:** ##/Users/[username]/Library/Application Support/teamwire-beta/logs## | ||
| 76 | * **Linux:** ##/home/[username]/.config/teamwire-beta/logs## | ||
| 77 | ## ## | ||
| 78 | |||
| 79 | {{id name="troubleshooting"/}} | ||
| 80 | |||
| 81 | = Error: "Sorry. Something went wrong" = | ||
| 82 | |||
| 83 | The error message "Sorry. Something went wrong" is a generic message, since not all exceptions are specifically caught yet. | ||
| 84 | |||
| 85 | In case of sporadic occurrence, you can bypass this message with the **Reload **button. | ||
| 86 | |||
| 87 | If the **Reload **button does not work, you can try one of the following options: | ||
| 88 | |||
| 89 | * Close the app completely (via the task manager if necessary) and restart Teamwire Beta. | ||
| 90 | * Delete all the data in your user data directory. | ||
| 91 | * Uninstall the app completely and install it again. | ||
| 92 | ## ## | ||
| 93 | |||
| 94 | {{id name="config"/}} | ||
| 95 | |||
| 96 | = Configuration / Registry file = | ||
| 97 | |||
| 98 | Some settings and user data can be distributed with a configuration file. | ||
| 99 | |||
| 100 | **Windows** | ||
| 101 | |||
| 102 | * The registry hive is at ##HKEY_CURRENT_USER\SOFTWARE\teamwire-beta\## | ||
| 103 | ## ## | ||
| 104 | |||
| 105 | **macOS and Linux** | ||
| 106 | |||
| 107 | * The configuration file needs to be stored to ##~~/.config/teamwire-beta/teamwire-beta.cfg## | ||
| 108 | * In addition, the JSON schema has been simplified to {{code language="plain text"}}"configurationName": "propertyValue",{{/code}} | ||
| 109 | ## ## | ||
| 110 | |||
| 111 | (% class="lead" %) | ||
| 112 | Supported parameters | ||
| 113 | |||
| |
4.2 | 114 | Desktop App **4.0.0-beta.2** (and newer) supports the following configuration parameters: |
| |
1.1 | 115 | |
| 116 | * ##serverHost## (String), previously BackendServerName | ||
| 117 | * ##proxyURL## (String) | ||
| 118 | ## ## | ||
| 119 | |||
| |
4.2 | 120 | Desktop App **4.0.0-beta.3** (and newer) supports the auto-registration process and the following configuration parameters: |
| |
1.1 | 121 | |
| |
3.2 | 122 | * ##serverHost## (String), previously BackendServerName |
| 123 | * ##proxyURL## (String) | ||
| 124 | * ##firstName## (String) | ||
| 125 | * ##lastName## (String) | ||
| 126 | * ##email## (String) | ||
| 127 | * ##registrationToken## (String) | ||
| 128 | * ##phoneNumber## (String) | ||
| 129 | * ##trustedCertificates## (Array) | ||
| 130 | 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. | ||
| 131 | ## ## | ||
| |
1.1 | 132 | |
| |
3.2 | 133 | You can download a template for Windows registry and the JSON config here: [[configuration-templates.zip>>attach:Public.Applications.Desktop.Public-Beta-Guide.WebHome@configuration-templates-beta3.zip||download="configuration-templates-beta3.zip"]] |
| |
1.1 | 134 | |
| |
3.2 | 135 | |
| |
1.1 | 136 | {{id name="appfeatures"/}} |
| 137 | |||
| 138 | = App Features = | ||
| 139 | |||
| 140 | |||
| 141 | (% style="text-align:center; width:100%" %) | ||
| 142 | |=(% style="width: 25%;" %) |=(% style="text-align: center; width: 15%; background-color: rgb(155, 207, 239);" %)Desktop App (4.0.0) Beta |=(% style="text-align:center; width: 15%;" %)**Desktop App (3.4.2)** | ||
| 143 | |(% colspan="3" style="text-align:left" %)((( | ||
| 144 | == Login and Registration == | ||
| 145 | ))) | ||
| 146 | |(% style="text-align:left" %)Registeration via email and SMS|(% style="background-color:#9bcfef" %) |{{velocity}}$services.icon.render('check'){{/velocity}} | ||
| 147 | |(% style="text-align:left" %)Login via password|(% style="background-color:#9bcfef" %){{velocity}}$services.icon.render('check'){{/velocity}}|{{velocity}}$services.icon.render('check'){{/velocity}} | ||
| |
3.2 | 148 | |(% style="text-align:left" %)Automated registration|(% style="background-color:#9bcfef" %){{velocity}}$services.icon.render('check'){{/velocity}}|{{velocity}}$services.icon.render('check'){{/velocity}} |
| |
1.1 | 149 | |(% style="text-align:left" %)Restrict registration via token|(% style="background-color:#9bcfef" %) |{{velocity}}$services.icon.render('check'){{/velocity}} |
| 150 | |(% style="text-align:left" %)Logout|(% style="background-color:#9bcfef" %){{velocity}}$services.icon.render('check'){{/velocity}}|{{velocity}}$services.icon.render('check'){{/velocity}} | ||
| 151 | |(% colspan="3" style="text-align:left" %)((( | ||
| 152 | == Inbox == | ||
| 153 | ))) | ||
| 154 | |(% style="text-align:left" %)Search for chat title / message / contact|(% style="background-color:#9bcfef" %){{velocity}}$services.icon.render('check'){{/velocity}}|{{velocity}}$services.icon.render('check'){{/velocity}} | ||
| 155 | |(% style="text-align:left" %)Show / Hide archived chat|(% style="background-color:#9bcfef" %){{velocity}}$services.icon.render('check'){{/velocity}}|{{velocity}}$services.icon.render('check'){{/velocity}} | ||
| 156 | |(% style="text-align:left" %)Set and use Push-to-Talk|(% style="background-color:#9bcfef" %) | | ||
| |
4.2 | 157 | |(% style="text-align:left" %)Favourite chats tab|(% style="background-color:#9bcfef" %){{velocity}}$services.icon.render('check'){{/velocity}}| |
| 158 | |(% style="text-align:left" %)Unread chats tab|(% style="background-color:#9bcfef" %){{velocity}}$services.icon.render('check'){{/velocity}}| | ||
| |
1.1 | 159 | |(% colspan="3" style="text-align:left" %)((( |
| 160 | == Chats == | ||
| 161 | ))) | ||
| 162 | |(% style="text-align:left" %)1:1 chat / Group chat / Broadcast chat|(% style="background-color:#9bcfef" %){{velocity}}$services.icon.render('check'){{/velocity}}|{{velocity}}$services.icon.render('check'){{/velocity}} | ||
| 163 | |(% style="text-align:left" %)Federated chats|(% style="background-color:#9bcfef" %) |{{velocity}}$services.icon.render('check'){{/velocity}} | ||
| 164 | |(% style="text-align:left" %)Federated chats: Support for attention messages and Location Feature|(% style="background-color:#9bcfef" %) |{{velocity}}$services.icon.render('check'){{/velocity}} | ||
| 165 | |(% style="text-align:left" %)Voice and video calls|(% style="background-color:#9bcfef" %){{velocity}}$services.icon.render('check'){{/velocity}}|{{velocity}}$services.icon.render('check'){{/velocity}} | ||
| 166 | |(% style="text-align:left" %)Voice and video calls: Share screen / Raise hand / Join ongoing calls / Change background|(% style="background-color:#9bcfef" %){{velocity}}$services.icon.render('check'){{/velocity}}|{{velocity}}$services.icon.render('check'){{/velocity}} | ||
| 167 | |(% style="text-align:left" %)Emergency Alert|(% style="background-color:#9bcfef" %) | | ||
| 168 | |(% style="text-align:left" %)Attention messages|(% style="background-color:#9bcfef" %){{velocity}}$services.icon.render('check'){{/velocity}}|{{velocity}}$services.icon.render('check'){{/velocity}} | ||
| 169 | |(% style="text-align:left" %)Search for message|(% style="background-color:#9bcfef" %){{velocity}}$services.icon.render('check'){{/velocity}}|{{velocity}}$services.icon.render('check'){{/velocity}} | ||
| 170 | |(% style="text-align:left" %)Delete message|(% style="background-color:#9bcfef" %){{velocity}}$services.icon.render('check'){{/velocity}}|{{velocity}}$services.icon.render('check'){{/velocity}} | ||
| 171 | |(% style="text-align:left" %)Attachment: Image / Video / File / Voice message / Interactive (poll)|(% style="background-color:#9bcfef" %){{velocity}}$services.icon.render('check'){{/velocity}}|{{velocity}}$services.icon.render('check'){{/velocity}} | ||
| 172 | |(% style="text-align:left" %)Attachment: Location / Live location|(% style="background-color:#9bcfef" %) | | ||
| 173 | |(% style="text-align:left" %)Viewing a live location: Enable / Disable to show a user’s name in the map view|(% style="background-color:#9bcfef" %){{velocity}}$services.icon.render('check'){{/velocity}}|{{velocity}}$services.icon.render('check'){{/velocity}} | ||
| 174 | |(% style="text-align:left" %)Viewing a live location: Enable / Disable to show a user’s role in the map view |(% style="background-color:#9bcfef" %) |{{velocity}}$services.icon.render('check'){{/velocity}} | ||
| 175 | |(% style="text-align:left" %)Viewing a live location: Select a user to focus in the map view|(% style="background-color:#9bcfef" %){{velocity}}$services.icon.render('check'){{/velocity}}|{{velocity}}$services.icon.render('check'){{/velocity}} | ||
| 176 | |(% style="text-align:left" %)Attachment: Calendar|(% style="background-color:#9bcfef" %){{velocity}}$services.icon.render('check'){{/velocity}} | ||
| 177 | will be attached as file|{{velocity}}$services.icon.render('check'){{/velocity}} | ||
| 178 | will be attached as file | ||
| 179 | |(% style="text-align:left" %)Attachment: Share via Dracoon|(% style="background-color:#9bcfef" %) | | ||
| 180 | |(% style="text-align:left" %)Edit image before sending (incl. auto-blur)|(% style="background-color:#9bcfef" %) | | ||
| 181 | |(% style="text-align:left" %)Download and save attachment|(% style="background-color:#9bcfef" %){{velocity}}$services.icon.render('check'){{/velocity}}|{{velocity}}$services.icon.render('check'){{/velocity}} | ||
| 182 | |(% style="text-align:left" %)Restrict saving attachment|(% style="background-color:#9bcfef" %) |{{velocity}}$services.icon.render('check'){{/velocity}} | ||
| 183 | |(% style="text-align:left" %)Reply to message or attachment|(% style="background-color:#9bcfef" %){{velocity}}$services.icon.render('check'){{/velocity}}|{{velocity}}$services.icon.render('check'){{/velocity}} | ||
| 184 | |(% style="text-align:left" %)Forward message or attachments to new or existing chat|(% style="background-color:#9bcfef" %){{velocity}}$services.icon.render('check'){{/velocity}}|{{velocity}}$services.icon.render('check'){{/velocity}} | ||
| 185 | |(% style="text-align:left" %)Leave / Close / Mute / Archive chat|(% style="background-color:#9bcfef" %){{velocity}}$services.icon.render('check'){{/velocity}}|{{velocity}}$services.icon.render('check'){{/velocity}} | ||
| |
4.2 | 186 | |(% style="text-align:left" %)Favourite chat / Mark chat as read or unread|(% style="background-color:#9bcfef" %){{velocity}}$services.icon.render('check'){{/velocity}}| |
| |
1.1 | 187 | |(% style="text-align:left" %)Show chat admins and members|(% style="background-color:#9bcfef" %){{velocity}}$services.icon.render('check'){{/velocity}}|{{velocity}}$services.icon.render('check'){{/velocity}} |
| 188 | |(% style="text-align:left" %)Edit chat avatar / title / mode / members|(% style="background-color:#9bcfef" %){{velocity}}$services.icon.render('check'){{/velocity}} | ||
| 189 | edit chat avatar will follow|{{velocity}}$services.icon.render('check'){{/velocity}} | ||
| 190 | |(% style="text-align:left" %)Promote members to chat admins|(% style="background-color:#9bcfef" %){{velocity}}$services.icon.render('check'){{/velocity}}|{{velocity}}$services.icon.render('check'){{/velocity}} | ||
| 191 | |(% style="text-align:left" %)Media overview|(% style="background-color:#9bcfef" %) |{{velocity}}$services.icon.render('check'){{/velocity}} | ||
| 192 | |(% style="text-align:left" %)Send chat by email|(% style="background-color:#9bcfef" %) | | ||
| 193 | |(% style="text-align:left" %)Print chat to PDF|(% style="background-color:#9bcfef" %) |{{velocity}}$services.icon.render('check'){{/velocity}} | ||
| 194 | |(% style="text-align:left" %)System messages with time stamps|(% style="background-color:#9bcfef" %){{velocity}}$services.icon.render('check'){{/velocity}}|{{velocity}}$services.icon.render('check'){{/velocity}} | ||
| 195 | |(% colspan="3" style="text-align:left" %)((( | ||
| 196 | == Directory == | ||
| 197 | ))) | ||
| 198 | |(% style="text-align:left" %)View contacts / lists / circles / bots|(% style="background-color:#9bcfef" %){{velocity}}$services.icon.render('check'){{/velocity}} | ||
| 199 | contact details will follow|{{velocity}}$services.icon.render('check'){{/velocity}} | ||
| 200 | |(% style="text-align:left" %)View federated contacts / circles|(% style="background-color:#9bcfef" %) |{{velocity}}$services.icon.render('check'){{/velocity}} | ||
| 201 | |(% style="text-align:left" %)Create / Manage / Delete lists|(% style="background-color:#9bcfef" %) |{{velocity}}$services.icon.render('check'){{/velocity}} | ||
| 202 | |(% style="text-align:left" %)Search for users of other organisations|(% style="background-color:#9bcfef" %) |{{velocity}}$services.icon.render('check'){{/velocity}} | ||
| 203 | |(% style="text-align:left" %)Create chat via a user's profile|(% style="background-color:#9bcfef" %){{velocity}}$services.icon.render('check'){{/velocity}}|{{velocity}}$services.icon.render('check'){{/velocity}} | ||
| 204 | |(% style="text-align:left" %)Phone contact (external) via a user's profile|(% style="background-color:#9bcfef" %) | | ||
| 205 | |(% style="text-align:left" %)Start Teamwire voice and video calls via user's profile|(% style="background-color:#9bcfef" %){{velocity}}$services.icon.render('check'){{/velocity}}|{{velocity}}$services.icon.render('check'){{/velocity}} | ||
| 206 | |(% style="text-align:left" %)Email contact (external) via a user's profile|(% style="background-color:#9bcfef" %){{velocity}}$services.icon.render('check'){{/velocity}}|{{velocity}}$services.icon.render('check'){{/velocity}} | ||
| 207 | |(% colspan="3" style="text-align:left" %)((( | ||
| 208 | == Profile and Settings == | ||
| 209 | ))) | ||
| 210 | |(% style="text-align:left" %)Edit profile info and picture|(% style="background-color:#9bcfef" %) |{{velocity}}$services.icon.render('check'){{/velocity}} | ||
| 211 | |(% style="text-align:left" %)Edit contact details (email and phone number)|(% style="background-color:#9bcfef" %) |{{velocity}}$services.icon.render('check'){{/velocity}} | ||
| 212 | |(% style="text-align:left" %)Change password|(% style="background-color:#9bcfef" %) |{{velocity}}$services.icon.render('check'){{/velocity}} | ||
| 213 | |(% style="text-align:left" %)Manage sessions|(% style="background-color:#9bcfef" %) |{{velocity}}$services.icon.render('check'){{/velocity}} | ||
| 214 | |(% style="text-align:left" %)Enable auto-save received media|(% style="background-color:#9bcfef" %) |{{velocity}}$services.icon.render('check'){{/velocity}} | ||
| 215 | |(% style="text-align:left" %)Manage read receipts|(% style="background-color:#9bcfef" %) |{{velocity}}$services.icon.render('check'){{/velocity}} | ||
| 216 | |(% style="text-align:left" %)Manage notifications (sound, volume, pop-up)|(% style="background-color:#9bcfef" %) |{{velocity}}$services.icon.render('check'){{/velocity}} | ||
| 217 | |(% style="text-align:left" %)Manage notification preview to others|(% style="background-color:#9bcfef" %) |{{velocity}}$services.icon.render('check'){{/velocity}} | ||
| 218 | |(% style="text-align:left" %)Manage "Send message with Enter"|(% style="background-color:#9bcfef" %) |{{velocity}}$services.icon.render('check'){{/velocity}} | ||
| 219 | |(% style="text-align:left" %)Configure proxy settings|(% style="background-color:#9bcfef" %){{velocity}}$services.icon.render('check'){{/velocity}} | ||
| 220 | during login only|{{velocity}}$services.icon.render('check'){{/velocity}} | ||
| 221 | |(% style="text-align:left" %)Configure custom certificate|(% style="background-color:#9bcfef" %) |{{velocity}}$services.icon.render('check'){{/velocity}} | ||
| 222 | |(% style="text-align:left" %)Passcode konfigurieren|(% style="background-color:#9bcfef" %) | | ||
| 223 | |(% style="text-align:left" %)Auto-close session after failing access code 3 times|(% style="background-color:#9bcfef" %){{velocity}}$services.icon.render('check'){{/velocity}}| | ||
| 224 | |(% style="text-align:left" %)Diagnose connection option|(% style="background-color:#9bcfef" %) | | ||
| 225 | |(% style="text-align:left" %)In-App delete account option (Public Cloud only)|(% style="background-color:#9bcfef" %) | | ||
| 226 | |||
| 227 | ## ## |