======qTox======

**qTox** is a client written for the [[users:toxcore]], authored by Tux3.

| Repository        | https://github.com/qTox/qTox | 
| Maintainers       | tux3                         |
| Language          | C++                          |
| Graphical Toolkit | Qt                           |
| Operating Systems | Linux, Windows, OS X         |
| Status:           | Active                       |

===== Features =====

==== Audio features ====

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

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

==== Video features ====

qTox supports video calls and [[#screen_sharing|desktop sharing]], adjustable in the settings.


==== Messaging ====

qTox supports messaging for contacts and group chats, with emoticons, text formatting, and [[include:clients_features#message_splitting|message splitting]] for messages that are larger than 1372 bytes.

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.

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

qTox has support for spell checking using [[https://github.com/qTox/qTox/blob/master/INSTALL.md#optional-dependencies|Sonnet]].
==== File transfers ====

qTox has support for file transfer.

qTox has partial support for inline images, but it is a preview for saved images only.

qTox has support for pausing and resuming file transfers, but broken file transfers will not be resumed.
==== Group chats ====

qTox 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 ====

qTox has support for avatars, [[include:clients_features#changing_nospam | changing nospam]], setting custom aliases for contacts, and contact blocking.

qTox supports multiple profiles, importing / exporting profiles, and encrypting profiles and save files with a password.

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


==== General ====

qTox has support for translations, including 42 languages (see [[https://github.com/qTox/qTox/blob/master/translations/README.md|translations]]).

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

qTox has support for themes, including the built-in themes:
  * Default
  * Blue
  * Olive
  * Red
  * Violet
  * Dark
  * Dark blue
  * Dark olive
  * Dark red
  * Dark violet

===== Video Tutorials =====
==== Screen sharing ====
{{users:qtox_screen_share.mp4| Video tutorial of qTox screen sharing}}
<sub>[[https://wiki.tox.chat/_media/users/qtox_screen_share.mp4|Full size]]</sub>


{{page>include:clients_features#features}}

===== Installation =====

==== Windows ====

[[:Binaries#Windows]]

==== Linux ====

=== Arch ===

PKGBUILD is available in the ''community'' repo, to install:

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

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

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

=== Fedora ===

qTox is available in the [[https://rpmfusion.org/|RPM Fusion]] repo, to install:

<code>
# dnf install qtox
</code>

=== Gentoo ===

qTox is available in Gentoo.

To install:

<code>
# emerge qtox
</code>

=== openSUSE ===

qTox is available in openSUSE Factory.

To install in openSUSE 15.0 or newer:

<code>
# zypper in qtox
</code>

To install in openSUSE 42.3:

<code>
# zypper ar -f https://download.opensuse.org/repositories/server:/messaging/openSUSE_Leap_42.3 server:messaging
# zypper in qtox
</code>

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

=== Binary ===

Use pkg utility to install binary package:
  pkg install qTox

=== Compiling ===

Update ports tree:
  portsnap fetch update

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

==== macOS / OS X ====

=== Binaries ===

Binaries are provided on the [[https://tox.chat/download.html|Tox website]].

=== Compiling ===

If you want / need to compile qTox on macOS / OS X, latest instructions are provided [[https://github.com/qTox/qTox/blob/master/INSTALL.md|on GitHub]].

{{page>include:clients_others}}