====== µTox ======

**µTox** is a lightweight, cross-platform client for Tox. 

| Repository:         | https://github.com/uTox/uTox                   |
| Maintainers:        | [[https://github.com/GrayHatter/|GrayHatter]]  |
| Language:           | C                                              |
| Operating Systems:  | Windows, Linux, OSX, BSD, Android              |
| Current Version:    | 0.17.2                                         |
| Status:             | Active                                         |

===== History =====

[[https://www.reddit.com/r/linux/comments/2c4xh3/utox_a_lightweight_tox_client_libre_secure_p2p/| Reddit Post about µTox]]
[[https://github.com/uTox/uTox/commits/develop| Commit History]]

===== Features =====

==== Audio features ====

uTox supports audio notifications for received messages and the option to turn them off or on.

uTox supports audio calls for both contacts and group chats using [[https://github.com/TokTok/c-toxcore/blob/master/toxav/toxav.h|ToxAV]].

==== Video features ====

uTox supports video calls and desktop sharing, adjustable in the settings.


==== Messaging ====

uTox supports messaging for contacts and group chats and [[include:clients_features#message_splitting|message splitting]] for messages that are larger than 1372 bytes. uTox does not support emoticons or text formatting.

Typing notifications are shown to and from contacts, if the feature is enabled in the settings.

It is possible to message offline contacts, in which case the message will be stored and sent once both users are online.

uTox has support for chat history, with the option to enable or disable the feature.


==== File transfers ====

uTox has support for file transfer and file resuming.

uTox has support for inline images using its built-in screenshot tool (see [[#screenshots|screenshots]]).


==== Group chats ====

uTox has support for persistent group chats, but file transfers and typing notifications in group chats aren't possible yet until the feature is implemented by [[users:toxcore|c-toxcore]].


==== Profile & Contact Management ====

uTox has support for avatars and setting custom aliases for contacts.

uTox supports encryption of its Tox profile and save files using a password.

[[users:toxlinks|Tox URIs]] are supported.


==== General ====

uTox has support for translations, including 27 languages.

uTox has support for SOCKS5 proxies. For an example of a proxy configuration, see [[users:tox_over_tor_tot|Tox over Tor]].

uTox has support for themes, including the built-in Default, Light, Dark, High contrast, Zenburn, Solarized-light, Solarized-dark, and custom themes.

==== Screenshots ====
{{users:utox.png?380| µTox }}
{{ users:utox_inline_feature_2.png?380| A screenshot of uTox's inline images }}

{{page>include:clients_features#features}}

===== Installation =====
====Windows====

Latest binaries are provided [[https://tox.chat/download.html|here]].
====OSX====
OSX builds are posted on the [[https://github.com/uTox/uTox/releases|releases]] section of the github repo by publicarray.

If you want to build from source, OSX specific instructions can be found [[https://github.com/uTox/uTox/blob/develop/docs/COCOA.md#how-to-compile-utox|here]].

====Linux====

=== Arch Linux ===

Should be available in the ''community'' repo, to install:

<code>
# pacman -S utox
</code>

=== Debian, Ubuntu, Linux Mint ===

<code>
# apt-get install utox
</code>

=== openSUSE ===

uTox is available in openSUSE Factory.

To install in openSUSE 15.2 or newer:

<code>
# zypper in utox
</code>

If your distribution is not listed, or you want / need to compile uTox, there are provided instructions [[https://github.com/uTox/uTox/blob/develop/docs/INSTALL.md|on GitHub]].
====FreeBSD====

=== Binary ===

Use pkg utility to install binary package:
  pkg install uTox

=== Compiling ===

Update ports tree:
  portsnap fetch update

Compile and install client with all dependencies:
  cd /usr/ports/net-im/uTox
  make install clean

===== Usage =====
{{ users:utox.png?380px|A conversation over uTox}}
uTox is about as basic and self-explanatory as Tox clients come. The first time you open it you're directed to the Add Friend page where you can add your first friend. Once you've added some people, you can open up your chat session with them by Left-clicking on their names.

==== Adding and Removing Friends ====
  * Adding a friend is done through the Add Friend menu, which is presented to the user first.
  * Removing a friend is done by right-clicking on the friend's name and selecting Remove Friend.

==== Copy-Paste and Clearing Message History ====
   * Copy-Paste is done by highlighting text and right-clicking. It can be copied with or without a username. Pretty familiar.
   * Clearing the message history is done by right-clicking on a friend's name and selecting "Clear History."

==== Sending a Screenshot ====
   * The little square button to the left of the "Send" button takes a screenshot of the current screen and sends it.
   
==== Initiating Voice or Video calling ====
   * The phone button at the top-right of the µTox window initiates a voice request. The recipient will be prompted to accept the voice session.
   * The videocamera button at the top-right of the µTox window initiates a voice request. The recipient will be prompted to accept the video session.

==== File Transfers ====
   * The paperclip button at the top-right of the µTox window starts a file transfer by prompting you to select a file. The file transfer request is sent as soon as the file is selected. Files are only transferred with the recipient's approval.

===== Other clients =====

{{page>include:clients_others}}