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>]
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 -s <OPTION> or --set <OPTION>
43 Set an option. The available options are "start-on-boot", "show-
44 window" and "hide-window".
45 -s <OPTION> or --set <OPTION>
48 Unset an option. The available option is "start-on-boot".
49 -v or --verbose
52 Increase debug output level. Multiple -v options increase the
53 verbosity. The maximum is 3.
54 --silent
57 Set the verbosity level to 0, disable all debugging output.
58 -h or --help
61 Print a short description of available options.
62 --version
65 Print the version and exit.
66
69 These commands can be used in the chat window.
70 /alias <alias>
72 Sets selected friend's alias to <alias>. It will be displayed
73 instead of that friend's name.
74 /invite <name>
76 Invites <name> to the current groupchat.
77 /sendfile <path>
79 Sends a file located in <path> to the current friend.
80 /topic <topic>
82 Changes current groupchat's name/topic to <topic>. This command
83 can also be used to edit the current topic by typing /topic and
84 pressing the tab key.
85 /me <action>
87 Sends an message/action in the format <name> <action>, for exam‐
88 ple: Tox User says hi
89
92 All files listed below are located in $HOME/.config/tox. If µTox is
93 running in portable mode, their location will be ./tox.
94 tox_save.tox
96 tox_save.tox is the file that contains the public/private key
97 pair, name, status and contacts. It's compatible with other Tox
98 clients.
99 utox_save
101 utox_save is µTox' binary config file, it contains settings such
102 as language, proxy options, DPI or logging.
103 avatars
105 The avatars directory contains other contacts' avatars. Files
106 are named after contacts' public keys (the first 64 characters
107 of the ID).
108 Tox_Auto_Accept
110 Default directory for auto-accepted files in portable mode.
111 [public key].txt
113 Those are friends' chat logs. µTox supports only 1v1 chat log‐
114 ging for now.
115 [public key].fmetadata
117 Friend metadata file, currently used for storing aliases.
118 [public key][file number].ftoutfo
120 Current outgoing file transfers' state. Used for resuming trans‐
121 fers across client restarts.
122
125 Please see the list page: https://github.com/uTox/uTox/graphs/contribu‐
126 tors
127
130 Please report bugs on https://github.com/uTox/uTox/issues
131 The website for µTox can be found at https://utox.io/ and source code
133 can be found at https://github.com/uTox/uTox
134µTox 0.17.0 February 2019 UTOX(1)