emdee/toxygen
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

docs update

Browse source
This commit is contained in:
ingvar1995 2016-06-28 21:47:49 +03:00
parent 7a77b56560
commit ff196d8d92
8 changed files with 20 additions and 17 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

13
README.md
View file

@ -1,5 +1,5 @@
# Toxygen
Toxygen is cross-platform [Tox](https://tox.chat/) client written on Python
Toxygen is cross-platform [Tox](https://tox.chat/) client written in Python3
[![Release](https://img.shields.io/github/release/xveduk/toxygen.svg?style=flat)](https://github.com/xveduk/toxygen/releases/latest)
[![Open issues](https://img.shields.io/github/issues/xveduk/toxygen.svg?style=flat)](https://github.com/xveduk/toxygen/issues)
@ -15,10 +15,16 @@ Toxygen is cross-platform [Tox](https://tox.chat/) client written on Python
- [x] 1v1 messages
- [x] File transfers
- [x] Audio
- [x] Plugins support
- [x] Chat history
- [x] Emoticons
- [x] Stickers
- [x] Screenshots
- [x] Name lookups (toxme.io support)
- [x] Save file encryption
- [x] Profile import and export
- [x] Faux offline messaging
- [x] Faux offline file transfers
- [x] Inline images
- [x] Message splitting
- [x] Proxy support
@ -31,13 +37,10 @@ Toxygen is cross-platform [Tox](https://tox.chat/) client written on Python
- [x] Typing notifications
- [x] Changing nospam
- [x] File resuming
- [x] Save file encryption
- [x] Plugins support
- [x] Read receipts
- [x] Faux offline messaging
- [ ] Video
- [ ] Group chats
- [ ] Desktop sharing
- [ ] Group chats
###Downloads
[Releases](https://github.com/xveduk/toxygen/releases)

2
docs/compile.md
View file

@ -7,4 +7,4 @@ Install PyInstaller:
``pyinstaller --windowed --icon images/icon.ico main.py``
Don't forget to copy /images/, /sounds/, /translations/, /styles/, /smileys/, /stickers/ to /dist/main/
Don't forget to copy /images/, /sounds/, /translations/, /styles/, /smileys/, /stickers/ (and /libs/libtox.dll on Windows) to /dist/main/

6
docs/contributing.md
View file

@ -1,5 +1,3 @@
#Issues
Help us find all bugs in Toxygen! Please provide following info:
@ -15,8 +13,8 @@ Want to see new feature in Toxygen? [Ask for it!](https://github.com/xveduk/toxy
Developer? Feel free to open pull request. Our dev team is small so we glad to get help.
Don't know what to do? Improve UI, fix [issues](https://github.com/xveduk/toxygen/issues) or implement features from our TODO list.
You can find our TODO's in code and [here](/README.md). Also you can implement plugins for Toxygen.
You can find our TODO's in code, issues list and [here](/README.md). Also you can implement [plugins](/docs/plugins.md) for Toxygen.
#Translations
Help us translate Toxygen! Translate can be created using pyside-lupdate and QT Linguist.
Help us translate Toxygen! Translation can be created using pyside-lupdate (``pyside-lupdate toxygen.pro``) and QT Linguist.

2
docs/install.md
View file

@ -28,7 +28,7 @@
Dependencies:
1. Install Python3.4:
1. Install latest Python3.4:
``sudo apt-get install python3``
2. [Install PySide](https://wiki.qt.io/PySide_Binaries_Linux) (recommended) or [PyQt4](https://riverbankcomputing.com/software/pyqt/download)
3. Install [toxcore](https://github.com/irungentoo/toxcore/blob/master/INSTALL.md) with toxav support in your system (install in /usr/lib/)

6
docs/plugin_api.md
View file

@ -1,6 +1,6 @@
#Plugins API
In Toxygen plugin is single python module (.py file) and directory with data associated with it.
In Toxygen plugin is single python (supported Python 3.0 - 3.4) module (.py file) and directory with data associated with it.
Every module must contain one class derived from PluginSuperClass defined in [plugin_super_class.py](/src/plugins/plugin_super_class.py). Instance of this class will be created by PluginLoader class (defined in [plugin_support.py](/src/plugin_support.py) ). This class can enable/disable plugins and send data to it.
Every plugin has it's own full name and unique short name (1-5 symbols). Main app can get it using special methods.
@ -37,11 +37,11 @@ Other methods:
About import:
import statement will not work in case you import module that wasn't previously imported by main program and user use precompiled binary. It's recommended to use imp module and dynamic import instead.
import statement will not work in case you import module that wasn't previously imported by main program and user use precompiled binary. It's recommended to use dynamic import instead.
About GUI:
It's strictly recommended to support both PySide and PyQt4 in GUI.
It's strictly recommended to support both PySide and PyQt4 in GUI. Plugin can not have GUI at all.
Exceptions:

4
docs/plugins.md
View file

@ -10,9 +10,11 @@ Check [Plugin API](/docs/plugin_api.md) for more info
Toxygen comes without preinstalled plugins.
1. Put plugin and directory with it's data into /src/plugins/
1. Put plugin and directory with its data into /src/plugins/
2. Restart Toxygen
##Note: /src/plugins/ should contain plugin_super_class.py and __init__.py
#Plugins list
WARNING: It is unsecure to install plugin not from this list!

2
docs/smileys_and_stickers.md
View file

@ -1,6 +1,6 @@
#Smileys
Toxygen support smileys. Smiley is small picture which replaces some combination of symbols. If you want to create your own smiley pack, create directory in src/smileys/. This directory must contain images with smileys and config.json. Example of config.json:
Toxygen support smileys. Smiley is small picture which replaces some symbol or combination of symbols. If you want to create your own smiley pack, create directory in src/smileys/. This directory must contain images with smileys and config.json. Example of config.json:
{":)": "one.png", ":(": "two.png"}

2
src/smileys.py
View file

@ -30,7 +30,7 @@ class SmileyLoader(util.Singleton):
self._curr_pack = pack_name
path = self.get_smileys_path() + 'config.json'
try:
with open(path) as fl:
with open(path, encoding='utf8') as fl:
self._smileys = json.loads(fl.read())
fl.seek(0)
tmp = json.loads(fl.read(), object_pairs_hook=OrderedDict)