1UTOX(1)                     General Commands Manual                    UTOX(1)
2
3
4

NAME

6       µTox - Lightweight Tox client
7
8

SYNOPSIS

10       usage:  utox [--portable] [--theme <THEME>] [--set=<start-on-boot|show-
11       window|hide-window>] [--allow-root]
12          or: utox --version
13          or: utox --help
14
15

DESCRIPTION

17       µTox is a free software lighweight X.org graphical Tox client.
18
19       µTox can be used for:
20        * 1-to-1 text IM
21        * group IM
22        * audio calls
23        * video calls
24        * group audio calls
25        * desktop sharing
26        * file transfers
27
28

OPTIONS

30       -t <THEME> or --theme <THEME>
31              Choose a color  scheme.  Possible  options  are  default,  dark,
32              light,  highcontrast,  zenburn,  solarized-light,  or solarized-
33              dark.
34
35
36       -p or --portable
37              Run in portable mode. All data will be saved to the  tox  folder
38              in the current working directory, see FILES for more details.
39
40
41       --allow-root
42              Allow running µTox as root. Default is to refuse.
43
44
45       -s <OPTION> or --set <OPTION>
46              Set an option. The available options are "start-on-boot", "show-
47              window" and "hide-window".
48
49
50       -u <OPTION> or --unset <OPTION>
51              Unset an option. The available option is "start-on-boot".
52
53
54       -v or --verbose
55              Increase debug output level. Multiple -v  options  increase  the
56              verbosity. The maximum is 6.
57
58
59       --silent
60              Set the verbosity level to 0, disable all debugging output.
61
62
63       --debug <FILE>
64              Write all debug output to the specified file.
65
66
67       -h or --help
68              Print a short description of available options.
69
70
71       --version
72              Print the version and exit.
73
74

KEYBINDINGS

76       Ctrl+F Toggle friend list online status filter.
77
78
79       Ctrl+f Focus on friend list search input field.
80
81
82       Ctrl+[num], Alt+[num]
83              Switch to chat [num].
84
85
86       Ctrl+Pg{Up,Down}
87              Move up or down in the friend list.
88
89
90       Ctrl+Pg{Home,End}
91              Move to first or last friend in the friend list.
92
93
94       Esc    Unfocus  message  input  field. When unfocused, pressing any key
95              will focus on it again.
96
97
98       Pg{Up,Down}
99              Scroll chat log up or down.  This keybinding will only work when
100              the message input field is unfocused.
101
102
103       Home, End
104              Scroll  to top or bottom of chat log.  This keybinding will only
105              work when the message input field is unfocused.
106
107

CHAT COMMANDS

109       These commands can be used in the chat window.
110
111       /alias <alias>
112              Sets selected friend's alias to <alias>. It  will  be  displayed
113              instead of that friend's name.
114
115       /invite <name>
116              Invites <name> to the current groupchat.
117
118       /sendfile <path>
119              Sends a file located in <path> to the current friend.
120
121       /topic <topic>
122              Changes  current groupchat's name/topic to <topic>. This command
123              can also be used to edit the current topic by typing /topic  and
124              pressing the tab key.
125
126       /me <action>
127              Sends an message/action in the format <name> <action>, for exam‐
128              ple: Tox User says hi
129
130

FILES

132       All files listed below are located in  $HOME/.config/tox.  If  µTox  is
133       running in portable mode, their location will be ./tox.
134
135       tox_save.tox
136              tox_save.tox  is  the  file that contains the public/private key
137              pair, name, status and contacts. It's compatible with other  Tox
138              clients.
139
140       utox_save
141              utox_save is µTox' binary config file, it contains settings such
142              as language, proxy options, DPI or logging.
143
144       avatars
145              The avatars directory contains other  contacts'  avatars.  Files
146              are  named  after contacts' public keys (the first 64 characters
147              of the ID).
148
149       Tox_Auto_Accept
150              Default directory for auto-accepted files in portable mode.
151
152       [public key].txt
153              Those are friends' chat logs. µTox supports only 1v1  chat  log‐
154              ging for now.
155
156       [public key].fmetadata
157              Friend metadata file, currently used for storing aliases.
158
159       [public key][file number].ftoutfo
160              Current outgoing file transfers' state. Used for resuming trans‐
161              fers across client restarts.
162
163

CONTRIBUTORS

165       Please see the list page: https://github.com/uTox/uTox/graphs/contribu
166       tors
167
168

BUGS

170       Please report bugs on https://github.com/uTox/uTox/issues
171
172       The source code for µTox can be found at https://github.com/uTox/uTox
173
174
175
176µTox 0.18.1                      February 2023                         UTOX(1)
Impressum