1UTOX(1) General Commands Manual UTOX(1)
2
6 µTox - Lightweight Tox client
7
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
17 µTox is a free software lighweight X.org graphical Tox client.
18 µ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
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 -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 --allow-root
42 Allow running µTox as root. Default is to refuse.
43 -s <OPTION> or --set <OPTION>
46 Set an option. The available options are "start-on-boot", "show-
47 window" and "hide-window".
48 -u <OPTION> or --unset <OPTION>
51 Unset an option. The available option is "start-on-boot".
52 -v or --verbose
55 Increase debug output level. Multiple -v options increase the
56 verbosity. The maximum is 6.
57 --silent
60 Set the verbosity level to 0, disable all debugging output.
61 --debug <FILE>
64 Write all debug output to the specified file.
65 -h or --help
68 Print a short description of available options.
69 --version
72 Print the version and exit.
73
76 Ctrl+F Toggle friend list online status filter.
77 Ctrl+f Focus on friend list search input field.
80 Ctrl+[num], Alt+[num]
83 Switch to chat [num].
84 Ctrl+Pg{Up,Down}
87 Move up or down in the friend list.
88 Ctrl+Pg{Home,End}
91 Move to first or last friend in the friend list.
92 Esc Unfocus message input field. When unfocused, pressing any key
95 will focus on it again.
96 Pg{Up,Down}
99 Scroll chat log up or down. This keybinding will only work when
100 the message input field is unfocused.
101 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
109 These commands can be used in the chat window.
110 /alias <alias>
112 Sets selected friend's alias to <alias>. It will be displayed
113 instead of that friend's name.
114 /invite <name>
116 Invites <name> to the current groupchat.
117 /sendfile <path>
119 Sends a file located in <path> to the current friend.
120 /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 /me <action>
127 Sends an message/action in the format <name> <action>, for exam‐
128 ple: Tox User says hi
129
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 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 utox_save
141 utox_save is µTox' binary config file, it contains settings such
142 as language, proxy options, DPI or logging.
143 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 Tox_Auto_Accept
150 Default directory for auto-accepted files in portable mode.
151 [public key].txt
153 Those are friends' chat logs. µTox supports only 1v1 chat log‐
154 ging for now.
155 [public key].fmetadata
157 Friend metadata file, currently used for storing aliases.
158 [public key][file number].ftoutfo
160 Current outgoing file transfers' state. Used for resuming trans‐
161 fers across client restarts.
162
165 Please see the list page: https://github.com/uTox/uTox/graphs/contribu‐
166 tors
167
170 Please report bugs on https://github.com/uTox/uTox/issues
171 The source code for µTox can be found at https://github.com/uTox/uTox
173µTox 0.18.1 February 2023 UTOX(1)