A web based graphical user interface for Tox
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
data implemented TLS support; switched websockets framework Nov 18, 2014
html Add UI for accepting friend requests (sending is already functional, … Aug 14, 2015
server Ensure that the file handles exist in toxCallbacks.go Aug 18, 2015
.gitignore Support for avatar images Jun 22, 2015
COPYING
README.md Added setup information to README.md Jan 3, 2016
TODO.md
screenshot.png Add screenshot to README.md Jun 21, 2015

README.md

WebTox

WebTox is a web-based Tox client written in go (server-side) and html5 (client-side).

WebTox isn't ready yet! Please don't use WebTox if you don't know the risks of using unstable software.

Screenshot of WebTox

When you should(n't) use WebTox

You should use WebTox if

  • you would like to use Tox on any currently unsupported plattform that comes with support for web-based applications.
  • you are able to install it on your Raspberry Pi or any similar hardware.
  • you want to install it locally because you like web applications. ;)

You should not use WebTox if

  • you don't trust the server you would like to install it on.
  • you just want to use Tox as a normal desktop application and don't care about the technical details.
  • you have never heard of "Port Forwarding" and "DynDNS".

If WebTox does not fit your requirements, try out one of the recommended Tox clients for your plattform.

How to run

If you are unfamiliar with Go, please start by reading How to Write Go Code.

First of all, you have to install toxcore.

If you haven't set up your go environment yet, here is how to do so:

mkdir -p ~/go
export GOROOT=~/go
export PATH=$PATH:~/go/bin
echo "export GOPATH=~/go/" >> ~/.bash_profile
echo "export PATH=$PATH:~/go/bin" >> ~/.bash_profile

The easiest way to run WebTox is using the go tools:

go get github.com/codedust/WebTox
go get github.com/codedust/go-tox
go get github.com/codedust/go-httpserve
go get github.com/mattn/go-sqlite3

WebTox can now be started simply by running go run *.go from within the server directory. Next, visit http://localhost:8080/ and you are done.

Contributing

Yay! Thanks. Any contribution is helpful. If you plan to start a huge change, it might be the best to create a Github Issue first.

License

WebTox is released under the GNU General Public License v3.