1UTOX(1) General Commands Manual UTOX(1)
2
6 µTox - Lightweight Tox client
7
10 usage: utox [--portable] [--theme <default|dark|light|highcontrast|zen‐
11 burn|solarized-light|solarized-dark>] [--set=<start-on-boot|show-win‐
12 dow|hide-window>] [--allow-root]
13 or: utox --version
14 or: utox --help
15
18 µTox is a free software lighweight X.org graphical Tox client.
19 µTox can be used for:
21 * 1-to-1 text IM
22 * group IM
23 * audio calls
24 * video calls
25 * group audio calls
26 * desktop sharing
27 * file transfers
28
31 -t <THEME> or --theme <THEME>
32 Choose a color scheme. Possible options are default, dark,
33 light, highcontrast, zenburn, solarized-light, or solarized-
34 dark.
35 -p or --portable
38 Run in portable mode. All data will be saved to the tox folder
39 in the current working directory, see FILES for more details.
40 --allow-root
43 Allow running µTox as root. Default is to refuse.
44 -s <OPTION> or --set <OPTION>
47 Set an option. The available options are "start-on-boot", "show-
48 window" and "hide-window".
49 -u <OPTION> or --unset <OPTION>
52 Unset an option. The available option is "start-on-boot".
53 -v or --verbose
56 Increase debug output level. Multiple -v options increase the
57 verbosity. The maximum is 3.
58 --silent
61 Set the verbosity level to 0, disable all debugging output.
62 -h or --help
65 Print a short description of available options.
66 --version
69 Print the version and exit.
70
73 These commands can be used in the chat window.
74 /alias <alias>
76 Sets selected friend's alias to <alias>. It will be displayed
77 instead of that friend's name.
78 /invite <name>
80 Invites <name> to the current groupchat.
81 /sendfile <path>
83 Sends a file located in <path> to the current friend.
84 /topic <topic>
86 Changes current groupchat's name/topic to <topic>. This command
87 can also be used to edit the current topic by typing /topic and
88 pressing the tab key.
89 /me <action>
91 Sends an message/action in the format <name> <action>, for exam‐
92 ple: Tox User says hi
93
96 All files listed below are located in $HOME/.config/tox. If µTox is
97 running in portable mode, their location will be ./tox.
98 tox_save.tox
100 tox_save.tox is the file that contains the public/private key
101 pair, name, status and contacts. It's compatible with other Tox
102 clients.
103 utox_save
105 utox_save is µTox' binary config file, it contains settings such
106 as language, proxy options, DPI or logging.
107 avatars
109 The avatars directory contains other contacts' avatars. Files
110 are named after contacts' public keys (the first 64 characters
111 of the ID).
112 Tox_Auto_Accept
114 Default directory for auto-accepted files in portable mode.
115 [public key].txt
117 Those are friends' chat logs. µTox supports only 1v1 chat log‐
118 ging for now.
119 [public key].fmetadata
121 Friend metadata file, currently used for storing aliases.
122 [public key][file number].ftoutfo
124 Current outgoing file transfers' state. Used for resuming trans‐
125 fers across client restarts.
126
129 Please see the list page: https://github.com/uTox/uTox/graphs/contribu‐
130 tors
131
134 Please report bugs on https://github.com/uTox/uTox/issues
135 The website for µTox can be found at https://utox.io/ and source code
137 can be found at https://github.com/uTox/uTox
138µTox 0.17.1 January 2020 UTOX(1)