toxygen/README.md

123 lines
3.5 KiB
Markdown
Raw Normal View History

2016-07-27 16:53:50 +02:00
# Toxygen
2024-02-07 16:34:15 +01:00
Toxygen is powerful cross-platform [Tox](https://tox.chat/) client
written in pure Python3.
2016-03-16 17:06:15 +01:00
2022-09-27 20:39:33 +02:00
### [Install](/docs/install.md) - [Contribute](/docs/contributing.md) - [Plugins](/docs/plugins.md) - [Compile](/docs/compile.md) - [Contact](/docs/contact.md)
2016-05-12 21:52:47 +02:00
2024-02-06 19:07:32 +01:00
### Supported OS: Linux and Windows (only Linux is tested at the moment)
2016-07-27 16:53:50 +02:00
2016-08-19 19:12:51 +02:00
### Features:
2016-03-29 20:19:29 +02:00
2017-07-15 11:28:19 +02:00
- 1v1 messages
- File transfers
- Audio calls
- Video calls
2018-01-24 21:42:03 +01:00
- Group chats
2017-07-15 11:28:19 +02:00
- Plugins support
- Desktop sharing
- Chat history
- Emoticons
- Stickers
- Screenshots
- Name lookups (toxme.io support)
- Save file encryption
- Profile import and export
- Faux offline messaging
- Faux offline file transfers
- Inline images
- Message splitting
2024-02-06 19:07:32 +01:00
- Proxy support - runs over tor
2017-07-15 11:28:19 +02:00
- Avatars
- Multiprofile
- Multilingual
- Sound notifications
- Contact aliases
- Contact blocking
- Typing notifications
- Changing nospam
- File resuming
- Read receipts
2024-02-08 08:39:15 +01:00
- uses gevent
2022-09-27 20:39:33 +02:00
- NGC groups
2024-02-08 09:37:57 +01:00
- PyQt5, PyQt6, PySide2, PySide6 via qtpy
2016-03-16 17:06:15 +01:00
2016-07-27 16:53:50 +02:00
### Screenshots
2016-05-12 21:52:47 +02:00
*Toxygen on Ubuntu and Windows*
2016-03-30 23:23:10 +02:00
![Ubuntu](/docs/ubuntu.png)
![Windows](/docs/windows.png)
2016-03-29 20:19:29 +02:00
2024-02-06 19:07:32 +01:00
Windows was working but is not currently being tested. AV was working
but is not currently being tested: we're unsure of handling the AV devices
from the commandline. We need to get a working echobot that supports SOCKS5;
we were working on one in https://git.plastiras.org/emdee/toxygen_wrapper
2022-09-27 14:52:32 +02:00
## Forked
2016-08-19 19:12:51 +02:00
2022-11-23 20:23:21 +01:00
This hard-forked from the dead https://github.com/toxygen-project/toxygen
2022-09-27 14:52:32 +02:00
```next_gen``` branch.
2022-11-05 02:16:25 +01:00
2022-10-11 18:36:09 +02:00
See ToDo.md to the current ToDo list.
2024-02-06 19:07:32 +01:00
## Wechat
2022-11-20 19:44:17 +01:00
You can have a [weechat](https://github.com/weechat/qweechat)
console so that you can have IRC and jabber in a window as well as Tox.
There's a copy of qweechat in ```thirdparty/qweechat``` backported to
PyQt5 and integrated into toxygen. Follow the normal instructions for
adding a ```relay``` to [weechat](https://github.com/weechat/weechat)
2022-11-20 02:11:51 +01:00
```
2024-02-08 09:37:57 +01:00
/relay add ipv4.ssl.weechat 9000
2022-11-20 19:44:17 +01:00
/relay start ipv4.ssl.weechat
```
or
```
/relay add weechat 9000
/relay start weechat
```
2022-11-23 20:23:21 +01:00
and use the Plugins/Weechat Console to start weechat under Toxygen.
2023-12-11 03:18:11 +01:00
Then use the File/Connect menu item of the Console to connect to weechat.
2022-11-23 20:23:21 +01:00
Weechat has a Jabber plugin to enable XMPP:
2022-11-20 19:44:17 +01:00
```
/python load jabber.el
/help jabber
2022-11-20 02:11:51 +01:00
```
2022-11-23 20:23:21 +01:00
so you can have Tox, IRC and XMPP in the same application!
2024-02-08 08:39:15 +01:00
See docs/ToxygenWeechat.md
2022-11-20 02:11:51 +01:00
2024-02-06 19:07:32 +01:00
## Install
To install read the requirements.txt and look at the comments; there
may be things that need installing by hand or decisions to be made
on supported alternatives.
https://git.plastiras.org/emdee/toxygen_wrapper needs packaging
on pypi as it is a dependency. Just download and install it from
https://git.plastiras.org/emdee/toxygen_wrapper
2023-12-11 03:18:11 +01:00
2024-02-06 19:07:32 +01:00
This is being ported to Qt6 using qtpy https://github.com/spyder-ide/qtpy
2024-02-09 10:38:24 +01:00
It now runs on PyQt5 and should run on PyQt6, and may run on PySide2 and
2024-02-07 16:34:15 +01:00
PySide6 - YMMV. You will be able to choose between them by setting the
environment variable QT_API to one of: pyqt5 pyqt6 pyside2 pyside6.
2024-02-06 19:07:32 +01:00
2024-02-07 16:34:15 +01:00
To install it, look in the Makefile for the install target and type
2024-02-06 19:07:32 +01:00
```
make install
```
You should set the PIP_EXE_MSYS and PYTHON_EXE_MSYS variables and it does
```
${PIP_EXE_MSYS} --python ${PYTHON_EXE_MSYS} install \
2024-02-08 09:37:57 +01:00
--no-deps \
2024-02-06 19:07:32 +01:00
--target ${PREFIX}/lib/python${PYTHON_MINOR}/site-packages/ \
--upgrade .
```
and installs into PREFIX which is usually /usr/local
2023-12-11 16:39:28 +01:00
2024-02-03 05:34:10 +01:00
Up-to-date code is on https://git.plastiras.org/emdee/toxygen
2024-02-06 19:07:32 +01:00
## MultiDevice
2024-02-03 05:34:10 +01:00
Work on this project is suspended until the
[MultiDevice](https://git.plastiras.org/emdee/tox_profile/wiki/MultiDevice-Announcements-POC) problem is solved. Fork me!