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