Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
UTOX(1) 		     General Commands Manual			 UTOX(1)

NAME
     A<micro>Tox - Lightweight Tox client

SYNOPSIS
     usage:  utox [--portable] [--theme <THEME>] [--set=<start-on-boot|show-win-
     dow|hide-window>] [--allow-root]
	or: utox --version
	or: utox --help

DESCRIPTION
     A<micro>Tox is a free software lighweight X.org graphical Tox client.

     A<micro>Tox can be used for:
      * 1-to-1 text IM
      * group IM
      * audio calls
      * video calls
      * group audio calls
      * desktop sharing
      * file transfers

OPTIONS
     -t <THEME> or --theme <THEME>
	    Choose a color scheme. Possible options are  default,  dark,  light,
	    highcontrast, zenburn, solarized-light, or solarized-dark.

     -p or --portable
	    Run  in  portable  mode. All data will be saved to the tox folder in
	    the current working directory, see FILES for more details.

     --allow-root
	    Allow running A<micro>Tox as root. Default is to refuse.

     -s <OPTION> or --set <OPTION>
	    Set an option. The available options are "start-on-boot", "show-win-
	    dow" and "hide-window".

     -u <OPTION> or --unset <OPTION>
	    Unset an option. The available option is "start-on-boot".

     -v or --verbose
	    Increase debug output level. Multiple -v options increase  the  ver-
	    bosity. The maximum is 6.

     --silent
	    Set the verbosity level to 0, disable all debugging output.

     --debug <FILE>
	    Write all debug output to the specified file.

     -h or --help
	    Print a short description of available options.

     --version
	    Print the version and exit.

KEYBINDINGS
     Ctrl+F Toggle friend list online status filter.

     Ctrl+f Focus on friend list search input field.

     Ctrl+[num], Alt+[num]
	    Switch to chat [num].

     Ctrl+Pg{Up,Down}
	    Move up or down in the friend list.

     Ctrl+Pg{Home,End}
	    Move to first or last friend in the friend list.

     Esc    Unfocus  message  input field. When unfocused, pressing any key will
	    focus on it again.

     Pg{Up,Down}
	    Scroll chat log up or down.  This keybinding will only work when the
	    message input field is unfocused.

     Home, End
	    Scroll to top or bottom of chat log.  This keybinding will only work
	    when the message input field is unfocused.

CHAT COMMANDS
     These commands can be used in the chat window.

     /alias <alias>
	    Sets selected friend's alias to <alias>. It will  be  displayed  in-
	    stead of that friend's name.

     /invite <name>
	    Invites <name> to the current groupchat.

     /sendfile <path>
	    Sends a file located in <path> to the current friend.

     /topic <topic>
	    Changes  current groupchat's name/topic to <topic>. This command can
	    also be used to edit the current topic by typing /topic and pressing
	    the tab key.

     /me <action>
	    Sends an message/action in the format <name> <action>, for	example:
	    Tox User says hi

FILES
     All  files listed below are located in $HOME/.config/tox. If A<micro>Tox is
     running in portable mode, their location will be ./tox.

     tox_save.tox
	    tox_save.tox is the file that contains the public/private key  pair,
	    name, status and contacts. It's compatible with other Tox clients.

     utox_save
	    utox_save  is  A<micro>Tox' binary config file, it contains settings
	    such as language, proxy options, DPI or logging.

     avatarsThe avatars directory contains other contacts'  avatars.  Files  are
	    named  after  contacts'  public keys (the first 64 characters of the
	    ID).

     Tox_Auto_Accept
	    Default directory for auto-accepted files in portable mode.

     [public key].txt
	    Those are friends' chat logs. A<micro>Tox  supports  only  1v1  chat
	    logging for now.

     [public key].fmetadata
	    Friend metadata file, currently used for storing aliases.

     [public key][file number].ftoutfo
	    Current  outgoing file transfers' state. Used for resuming transfers
	    across client restarts.

CONTRIBUTORS
     Please see the list page: https://github.com/uTox/uTox/graphs/contributors

BUGS
     Please report bugs on https://github.com/uTox/uTox/issues

     The    source    code    for    ^A<micro>Tox     can     be     found     at
     https://github.com/uTox/uTox

A<micro>Tox 0.18.1		   August 2026				 UTOX(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=utox&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help