1
00:00:00,000 --> 00:00:04,875
Meet DinoX. Welcome to DinoX. You can exchange
messages, pictures and files, and make

2
00:00:04,875 --> 00:00:09,923
audio or video calls. You need an XMPP
account. Its address is also called a JID. Bob
at

3
00:00:09,923 --> 00:00:14,741
dinox dot im looks like an email address, but
here it is a chat address. It does not

4
00:00:14,741 --> 00:00:19,788
automatically include an email inbox. Enter
your own XMPP address when setting up DinoX.

5
00:00:19,788 --> 00:00:22,082
Bob and Anna are examples in this guide.

6
00:00:22,782 --> 00:00:27,631
Install the right package. Choose the package
for your system. The provided Ubuntu DEB

7
00:00:27,631 --> 00:00:32,367
is not intended for Debian 13. Use AppImage or
Flatpak there. Both formats also work

8
00:00:32,367 --> 00:00:36,990
independently of RPM packaging, for example on
Fedora or openSUSE. Flatpak must be

9
00:00:36,990 --> 00:00:41,613
installed and needs an additional runtime. An
AppImage must be allowed to run as a

10
00:00:41,613 --> 00:00:46,575
program. Still check processor architecture
and system requirements. On Windows, use the

11
00:00:46,575 --> 00:00:47,477
Windows package.

12
00:00:48,177 --> 00:00:52,185
Understand the two passwords. On first launch,
set the password for the data on this

13
00:00:52,185 --> 00:00:56,146
computer. Enter it twice and keep it safe. It
is not your chat account password. Be

14
00:00:56,146 --> 00:01:00,298
careful: three incorrect entries during normal
unlocking can trigger the security wipe.

15
00:01:00,298 --> 00:01:04,164
Do not keep guessing. Special restore cases
are explained in the written chapter.

16
00:01:04,864 --> 00:01:08,943
Choose or create an account. Already have an
XMPP address? Choose “Sign in”. If not,

17
00:01:08,943 --> 00:01:13,072
choose “Create account” and select a provider.
You do not need to follow both routes.

18
00:01:13,772 --> 00:01:17,844
Create an account with a provider. The
provider operates your account’s server. It

19
00:01:17,844 --> 00:01:21,967
manages sign-in, availability and possibly
message history. Choose a provider whose

20
00:01:21,967 --> 00:01:26,337
terms and service suit you. The list in DinoX
is a selection, not a guarantee of free or

21
00:01:26,337 --> 00:01:28,075
permanently available registration.

22
00:01:28,775 --> 00:01:33,886
Advanced sign-in: server and proxy. For normal
sign-in you usually do not need to enter

23
00:01:33,886 --> 00:01:38,938
anything here. DinoX finds the server from
your XMPP address. A proxy is an additional

24
00:01:38,938 --> 00:01:42,580
intermediary for the connection; it is not
your XMPP provider.

25
00:01:43,280 --> 00:01:47,572
Find your way around the main window. Open
conversations are listed on the left; the

26
00:01:47,572 --> 00:01:52,019
selected chat appears on the right. In a
narrow window DinoX shows these areas one at a

27
00:01:52,019 --> 00:01:54,472
time. Use the back button to return to the
list.

28
00:01:55,172 --> 00:01:59,230
Add a person and open the chat. Select the
single-person icon at the top, then Add

29
00:01:59,230 --> 00:02:03,438
Contact at the bottom. Enter the full address,
here anna at dinox dot im. An alias is

30
00:02:03,438 --> 00:02:07,645
only your own display name for this contact.
If you have several accounts, choose the

31
00:02:07,645 --> 00:02:11,754
correct one first. Sharing online status lets
the person see your availability. Add

32
00:02:11,754 --> 00:02:12,645
saves the contact.

33
00:02:13,345 --> 00:02:17,612
Find an address in a server directory. This is
not a worldwide people search. It works

34
00:02:17,612 --> 00:02:21,780
only if your server offers a searchable
directory and your account is connected. The

35
00:02:21,780 --> 00:02:24,212
server controls the available fields and
results.

36
00:02:24,912 --> 00:02:29,469
What does a contact request mean?. A contact
request asks permission to see your online

37
00:02:29,469 --> 00:02:34,078
status. It does not decide message encryption.
Check the address and accept according to

38
00:02:34,078 --> 00:02:38,479
the access you want to grant. You can
separately choose whether the chat uses OMEMO,

39
00:02:38,479 --> 00:02:40,364
OpenPGP or no end-to-end encryption.

40
00:02:41,064 --> 00:02:45,054
The lock and the three message modes. The lock
shows this chat’s setting. Select it to

41
00:02:45,054 --> 00:02:48,904
open the choices. Message encryption is
separate from the secure connection to your

42
00:02:48,904 --> 00:02:52,013
server. The devices involved must also support
the selected method.

43
00:02:52,713 --> 00:02:57,426
OMEMO: inspect devices and verify keys. A
contact may use several devices, each with its

44
00:02:57,426 --> 00:03:02,032
own key. Accepted or Trusted means DinoX may
use that key. Verified additionally means

45
00:03:02,032 --> 00:03:06,531
you deliberately checked its fingerprint. A
green symbol alone does not replace that

46
00:03:06,531 --> 00:03:07,121
comparison.

47
00:03:07,821 --> 00:03:12,036
Work with messages. Actions depend on whether
the message is yours, its type and support

48
00:03:12,036 --> 00:03:15,437
at the other client. Open actions on the
message you want to work with.

49
00:03:16,137 --> 00:03:20,331
Set up notifications and sounds. Preferences,
General contains notifications and a

50
00:03:20,331 --> 00:03:24,832
separate message-sound option. If
notifications are globally disabled, enabling
the chat

51
00:03:24,832 --> 00:03:29,333
bell will not override that. Also check your
operating system’s notification permissions

52
00:03:29,333 --> 00:03:33,732
and do-not-disturb mode. Completely quitting
DinoX stops ongoing alerts. Minimizing to

53
00:03:33,732 --> 00:03:36,187
the system tray can instead leave DinoX
running.

54
00:03:36,887 --> 00:03:40,950
Organise, mute and remove contacts. The bell
at the top controls alerts for this

55
00:03:40,950 --> 00:03:45,418
particular chat. Muting suppresses alerts
while messages still arrive. It does not block

56
00:03:45,418 --> 00:03:49,633
the contact. To block or remove a contact,
open conversation details or the contact

57
00:03:49,633 --> 00:03:54,000
menu. These actions have different effects,
explained separately in the written guide.

58
00:03:54,700 --> 00:03:59,077
Find saved groups and server rooms. The group
icon opens your saved groups. Search for a

59
00:03:59,077 --> 00:04:03,403
name such as Treff in the search field. This
first list contains your saved groups, not

60
00:04:03,403 --> 00:04:07,779
every group worldwide. If you know the full
room address, you can enter it directly. The

61
00:04:07,779 --> 00:04:10,316
magnifying glass opens the server’s room
directory.

62
00:04:11,016 --> 00:04:15,147
Find rooms on your account’s server. In Browse
Rooms, leave public search switched off

63
00:04:15,147 --> 00:04:19,326
first. DinoX queries rooms advertised by your
account’s group service. This is a server

64
00:04:19,326 --> 00:04:23,361
query, not merely a search on your computer.
Hidden and private rooms may be absent.

65
00:04:23,361 --> 00:04:26,387
Choose a suitable room and complete joining
with your nickname.

66
00:04:27,087 --> 00:04:31,728
Search public groups across servers. Enable
public search and enter at least two

67
00:04:31,728 --> 00:04:36,718
characters, such as a topic. DinoX queries the
external search.jabber.network service,

68
00:04:36,718 --> 00:04:41,765
which receives your search term. It finds
public rooms in that service’s index; despite

69
00:04:41,765 --> 00:04:45,478
the switch label, it is not a complete list of
all XMPP servers.

70
00:04:46,178 --> 00:04:50,823
Join or create a group. A group has its own
address, for example treff@gruppen.dinox.im.

71
00:04:50,823 --> 00:04:55,258
Ask for the complete room address and any
password. The part after @ may differ from

72
00:04:55,258 --> 00:04:59,587
your account address. Public rooms and private
groups have different access rules.

73
00:05:00,287 --> 00:05:04,336
Manage and leave groups. Management functions
depend on your permissions. Members,

74
00:05:04,336 --> 00:05:08,631
moderators and owners have different rights.
An invitation does not override the room’s

75
00:05:08,631 --> 00:05:09,273
access rules.

76
00:05:09,973 --> 00:05:14,615
Notify only for mentions in a group. In a
group, the bell offers all messages, mentions

77
00:05:14,615 --> 00:05:19,311
only or no notifications. Mentions only is
useful in busy public rooms. Reset to default

78
00:05:19,311 --> 00:05:23,899
restores the default behaviour. The selection
applies only to the open group, so check

79
00:05:23,899 --> 00:05:25,287
its name at the top first.

80
00:05:25,987 --> 00:05:30,128
Prepare microphone, speakers and camera. DinoX
distinguishes call devices from

81
00:05:30,128 --> 00:05:34,481
recorded-message devices. A working voice
message does not automatically prove the

82
00:05:34,481 --> 00:05:39,152
correct call microphone is selected. System
Default uses the operating system’s selected

83
00:05:39,152 --> 00:05:39,524
device.

84
00:05:40,224 --> 00:05:44,570
Check devices before a conversation. Device
tests are further down on the same settings

85
00:05:44,570 --> 00:05:48,917
page. Check speakers, microphone and camera
preview before calling someone. These tests

86
00:05:48,917 --> 00:05:53,314
do not call anyone. Check system permissions,
the camera cover and the selected devices.

87
00:05:53,314 --> 00:05:55,712
Refresh the device list if something is
missing.

88
00:05:56,412 --> 00:06:00,857
Call someone and answer a call. For a live
conversation, open the contact and select the

89
00:06:00,857 --> 00:06:05,252
phone at the top. Choose an audio or video
call. The other person must accept. The call

90
00:06:05,252 --> 00:06:09,293
window contains microphone, camera, device
selection and the red hang-up button.

91
00:06:09,293 --> 00:06:13,638
Switching back to the chat is not a reliable
way to end a call. The buttons beside the

92
00:06:13,638 --> 00:06:15,406
text field instead record messages.

93
00:06:16,106 --> 00:06:20,242
Record a voice message. The microphone at the
bottom of the chat immediately starts a

94
00:06:20,242 --> 00:06:24,477
voice recording. This is a message for later
listening, not a call. The recording panel

95
00:06:24,477 --> 00:06:28,760
shows time and input level. Send ends and
sends the recording; Discard or Escape cancels

96
00:06:28,760 --> 00:06:32,604
it. There is no separate pre-send playback
step. After five minutes, sending is

97
00:06:32,604 --> 00:06:35,622
triggered automatically. Check the recipient
before recording.

98
00:06:36,322 --> 00:06:40,682
Record a video message. The video icon beside
it immediately starts a video message with

99
00:06:40,682 --> 00:06:44,993
picture and sound. Check camera, microphone
and camera cover first. Send ends and sends

100
00:06:44,993 --> 00:06:49,353
the recording. Cancel discards it. Sending is
triggered automatically after two minutes.

101
00:06:49,353 --> 00:06:53,565
Recipients can watch later and need not be
online while you record. For a video call,

102
00:06:53,565 --> 00:06:55,200
use the phone at the top instead.

103
00:06:55,900 --> 00:07:00,385
Share files, pictures and recordings. Open the
right chat first. The paperclip is for

104
00:07:00,385 --> 00:07:04,976
attachments; the microphone and camera beside
the input record messages. Start calls at

105
00:07:04,976 --> 00:07:06,453
the top of the chat instead.

106
00:07:07,153 --> 00:07:11,471
Play voice and video messages. Play received
audio and video messages from the message

107
00:07:11,471 --> 00:07:15,639
itself. If Download is offered first, the file
must be transferred to your computer

108
00:07:15,639 --> 00:07:19,957
before playback. You can then start or pause
it and, where offered, change position or

109
00:07:19,957 --> 00:07:24,224
speed. The written chapter explains reloading,
downloading again and requesting a new

110
00:07:24,224 --> 00:07:24,475
copy.

111
00:07:25,175 --> 00:07:29,544
Group calls and inviting another person. A
group call connects several people. Invite

112
00:07:29,544 --> 00:07:34,067
Contact in a text group menu initially invites
someone to the room; Add Participant in a

113
00:07:34,067 --> 00:07:37,459
call window concerns the active call. These
actions are different.

114
00:07:38,159 --> 00:07:42,407
Use video effects and turn them off. Effects
change your outgoing camera image. Check

115
00:07:42,407 --> 00:07:46,656
the preview and status: Applying is not yet
Active. If effects are unavailable in the

116
00:07:46,656 --> 00:07:48,805
current environment, the indicator says so.

117
00:07:49,505 --> 00:07:53,990
What is a feed, and which route do I need?. A
feed is a list of new posts, such as news

118
00:07:53,990 --> 00:07:58,269
or software releases. You can read posts, send
a post to a chat or publish your own

119
00:07:58,269 --> 00:07:59,919
posts. These are separate tasks.

120
00:08:00,619 --> 00:08:05,931
Read a web feed and share an article. You need
the feed URL, not just a website’s home

121
00:08:05,931 --> 00:08:11,366
page. An example is
https://git.dinox.im/dinoxim/monocles-chat/releases.rss.
The content

122
00:08:11,366 --> 00:08:12,972
comes from that publisher.

123
00:08:13,672 --> 00:08:18,017
Automatically post new web articles to a chat.
This automation runs only while DinoX is

124
00:08:18,017 --> 00:08:22,313
running and the selected account is connected.
It is not a server-hosted bot. Existing

125
00:08:22,313 --> 00:08:26,558
articles are skipped when enabling it; new
articles are then checked, with up to five

126
00:08:26,558 --> 00:08:27,407
queued per check.

127
00:08:28,107 --> 00:08:32,936
Subscribe to another person’s XMPP feed. Enter
the publisher’s XMPP address here. Leave

128
00:08:32,936 --> 00:08:37,709
the advanced node setting unchanged for a
personal feed. A PubSub service with another

129
00:08:37,709 --> 00:08:39,763
node requires the operator’s details.

130
00:08:40,463 --> 00:08:45,201
Publish your own posts: who can read them?.
Your first published post creates a personal

131
00:08:45,201 --> 00:08:49,886
feed on the XMPP server if supported. Give
readers the selected account’s XMPP address.

132
00:08:49,886 --> 00:08:52,793
They need a feed-capable client and access
permission.

133
00:08:53,493 --> 00:08:57,966
Accounts, profile and availability. DinoX can
manage several XMPP accounts. Contacts,

134
00:08:57,966 --> 00:09:02,598
keys and connection rules belong to individual
accounts. Check the address before making

135
00:09:02,598 --> 00:09:06,229
changes. Use the plus in the account overview
to add another account.

136
00:09:06,929 --> 00:09:11,569
Login protection (MITM): understand status and
choices. This additional protection helps

137
00:09:11,569 --> 00:09:15,998
prevent a sign-in being relayed over another
connection. Technically, this is called

138
00:09:15,998 --> 00:09:20,375
channel binding. It protects this account’s
sign-in; OMEMO and OpenPGP protect your

139
00:09:20,375 --> 00:09:20,850
messages.

140
00:09:21,550 --> 00:09:25,817
DNSSEC, DANE and the server certificate. DinoX
must find the correct server and check

141
00:09:25,817 --> 00:09:30,084
its identity. DNSSEC validates protected
information about server addresses. DANE can

142
00:09:30,084 --> 00:09:34,151
additionally specify which server certificate
is accepted. These settings are per

143
00:09:34,151 --> 00:09:36,410
account and do not change message encryption.

144
00:09:37,110 --> 00:09:42,057
Tor, bridges and your own SOCKS5 proxy. Tor
routes connections through the Tor network.

145
00:09:42,057 --> 00:09:46,720
A SOCKS5 proxy is an intermediary you specify.
Neither replaces an XMPP account or

146
00:09:46,720 --> 00:09:51,554
message encryption. Integrated Tor is an
application-wide setting and can override an

147
00:09:51,554 --> 00:09:52,691
account’s own proxy.

148
00:09:53,391 --> 00:09:57,907
Appearance, language and notifications. These
settings affect DinoX on this computer.

149
00:09:57,907 --> 00:10:02,583
Individual chats can have their own settings.
Scroll down on long pages; the tabs at the

150
00:10:02,583 --> 00:10:03,805
bottom switch sections.

151
00:10:04,505 --> 00:10:08,694
Back up data and move to another computer. The
backup covers the local DinoX data

152
00:10:08,694 --> 00:10:13,194
directory and its accounts. It is not a backup
of the entire XMPP server. Keep the file

153
00:10:13,194 --> 00:10:15,314
separately from the computer it protects.

154
00:10:16,014 --> 00:10:20,167
Clean up storage, change the password and
reset data. These actions affect the local

155
00:10:20,167 --> 00:10:24,321
DinoX data directory. Make a backup before
resetting. Selecting an account elsewhere

156
00:10:24,321 --> 00:10:27,090
does not restrict these general actions to
that account.

157
00:10:27,790 --> 00:10:32,184
Botmother, AI assistant and Telegram. A bot
processes messages or performs configured

158
00:10:32,184 --> 00:10:36,474
tasks. You do not need these features for
normal chatting. Local Botmother requires

159
00:10:36,474 --> 00:10:40,247
DinoX to be running; a separately hosted
CloudBot is a different service.

160
00:10:40,947 --> 00:10:45,994
MQTT: read device values and send commands.
MQTT is often used for sensors and home

161
00:10:45,994 --> 00:10:50,676
automation. The broker is the intermediary
server. A topic is a named message

162
00:10:50,676 --> 00:10:55,966
destination, such as home/temperature. You
need the operator’s details; an XMPP account

163
00:10:55,966 --> 00:10:58,885
alone is not access to an unrelated MQTT
broker.

164
00:10:59,585 --> 00:11:03,826
Keyboard shortcuts, updates and application
information. The built-in shortcut overview

165
00:11:03,826 --> 00:11:08,115
shows the keys available in your build. About
DinoX gives the version number, useful for

166
00:11:08,115 --> 00:11:12,161
reporting a problem. An update check reports a
new version but does not replace the

167
00:11:12,161 --> 00:11:13,819
package manager for every package.

168
00:11:14,519 --> 00:11:18,948
When something does not work. Note the DinoX
version, operating system, package and

169
00:11:18,948 --> 00:11:23,591
exact steps to the problem. A picture of the
affected setting helps; exclude passwords,

170
00:11:23,591 --> 00:11:27,754
private keys and tokens. Describe what you
expected and what you actually saw.