Tha_14/toxic
1
0
Fork 0
mirror of https://github.com/Tha14/toxic.git synced 2024-12-23 11:13:24 +01:00
Code Issues Projects Releases Wiki Activity
A Tox-based instant messaging and video chat client
1,411 Commits 20 Branches 34 Tags 18 MiB
C 95.5%
Makefile 1.8%
Objective-C 1%
Shell 1%
Python 0.6%
Other 0.1%
d1036c8538
Go to file
Dominyk Tiller d1036c8538 Darwin Build 
Explains/Better Enables building on the OS X Platform. I’ve written a
Darwin.mk file for the purpose, given one is referenced in the Makefile
but doesn’t actually exist yet. I presume this is due to Toxic’s recent
move away from configure scripts?

Anyhow. It’s not perfect, and it could be prettier, but it should fix
2014-12-18 03:49:52 +00:00
build implement group titles 2014-11-14 22:15:59 -05:00
cfg Darwin Build 2014-12-18 03:49:52 +00:00
doc update settings and docs with peerlist-toggle keybinding 2014-10-08 03:08:08 -04:00
misc update DHTnodes 2014-11-20 02:57:42 -05:00
sounds replace call sounds 2014-10-01 19:38:09 -04:00
src handle errors for name functions 2014-11-15 22:39:24 -05:00
.gitignore Update .gitignore: remove autotools 2014-06-24 12:37:43 +02:00
.travis.yml travis.yml: Remove asciidoc 2014-10-12 23:35:48 -04:00
COPYING Put back license 2014-06-24 17:48:49 +02:00
README.md Darwin Build 2014-12-18 03:49:52 +00:00

README.md

Toxic Build Status

Toxic is a Tox-based instant messenging client which formerly resided in the Tox core repository, and is now available as a standalone application.

Toxic Screenshot

Installation

Dependencies

Base
Audio
  • libtoxav (libtoxcore compiled with audio support)
  • openal (for Debian based systems, 'libopenal-dev')
Sound notifications
  • openal (for Debian based systems, 'libopenal-dev')
  • openalut (for Debian based systems, 'libalut-dev')
Desktop notifications
  • libnotify (for Debian based systems, 'libnotify-dev')
Documentation
  • Asciidoc (only required for regenerating manpages)
    • Run make doc in the build directory after editing the asciidoc files to regenerate the manpages.
    • NOTE FOR DEVELOPERS: asciidoc files and generated manpages will need to be commited together.

Compiling

  1. cd build/
  2. make PREFIX="/where/to/install"
  3. sudo make install PREFIX="/where/to/install"

Compilation Notes

  • You can add specific flags to the Makefile with USER_CFLAGS="" and/or USER_LDFLAGS=""
  • You can pass your own flags to the Makefile with CFLAGS="" and/or LDFLAGS="" (this will supersede the default ones)
  • Additional features are automatically enabled if all dependencies are found, but you can disable them by using special variables:
    • DISABLE_X11=1 → build toxic without X11 support (needed for focus tracking)
    • DISABLE_AV=1 → build toxic without audio call support
    • DISABLE_SOUND_NOTIFY=1 → build toxic without sound notifications support
    • DISABLE_DESKTOP_NOTIFY=1 → build toxic without desktop notifications support

OS X Compile

Using Homebrew: brew install openal-soft freealut libconfig && brew install https://raw.githubusercontent.com/Tox/homebrew-tox/master/Formula/libtoxcore.rb && brew install https://raw.githubusercontent.com/Homebrew/homebrew-x11/master/libnotify.rb.

You can omit libnotify if you intend to build without desktop notifications enabled.

Packaging

  • For packaging purpose, you can use DESTDIR="" to specify a directory where to store installed files
  • DESTDIR="" can be used in addition to PREFIX="":
    • DESTDIR="" is meant to specify a directory where to store installed files (ex: "/tmp/build/pkg")
    • PREFIX="" is meant to specify a prefix directory for binaries and data files (ex: "/usr/local")

Troubleshooting

If your default prefix is "/usr/local" and you receive the following:

error while loading shared libraries: libtoxcore.so.0: cannot open shared object file: No such file or directory

you can attempt to correct it by running sudo ldconfig. If that doesn't work, run:

echo '/usr/local/lib/' | sudo tee -a /etc/ld.so.conf.d/locallib.conf
sudo ldconfig

Precompiled binaries

You can download precompiled binaries from jenkins:

Settings

Running Toxic for the first time creates an empty file called toxic.conf in your home configuration directory ("~/.config/tox" for Linux users). Adding options to this file allows you to enable auto-logging, change the time format (12/24 hour), and much more. You can view our example config file here.