Awesome Open Source
Awesome Open Source

⚠️ THIS PROJECT IS NOT OFFICIALLY SUPPORTED! ALL CODE IN HERE IS IN DEVELOPMENT AND LIKELY TO CHANGE WITHOUT WARNING. USE AT YOUR OWN RISK. ⚠️


Coax

A (barely working) native Wire GUI client for Unix

In here you find the source code of Coax, a native client for Wire. The repository consists of a single Cargo workspace which contains several libraries which may or may not be useful individually. Together they form a client with a GTK+ UI for Unix-like operating systems.

Build instructions

Building the whole client depends on recent versions of

  • Rust nightly + Cargo
  • libsodium
  • sqlite
  • Gtk+
  • OpenSSL

Here are the instructions for some OSes:

  • On macOS, do brew install glib cairo pango gdk-pixbuf gtk+3 atk gnome-icon-theme pkg-config

On startup a configuration file coax.toml is written to $HOME/.config/coax/.

Assuming that you have all non-Rust dependencies installed, you can build the client (nightly toolchain required):

$ rustup override set nightly-2018-04-10
$ cargo build

To run it, do cd coax-gtk and then either cargo run to just run the client, or make install to install it as a desktop application.

Motivation

This client is meant to be hackable with a small and (hopefully) easy to understand code base written in a compiled language (Rust). It may be useful for testing purposes. It can not replace any of the existing Wire clients. Its feature set is currently severely limited and basically just allows for sending and receiving text messages.

Features

Not much is supported right now. In particular this client is currently NOT SECURE. There is no TLS cerificate pinning, nor is it possible to compare identity keys.

  • [x] Receive messages
  • [x] Send messages
  • [ ] Everything else

Outline

This workspace consists of the following libaries:

coax-net: Basic networking support (e.g. TLS connections) plus a tiny subset of HTTP/1.1.

coax-ws: Implements a subset of RFC 6455 (websocket protocol).

coax-data: Storage support based on SQLite.

coax-api: Wire API types with JSON serialisation.

coax-api-proto: Protocol buffers API corresponding to Wire's generic-message-proto.

coax-client: Client for Wire's HTTP API.

coax-actor: Higher level client which also utilises local storage and asynchronous notifications over websockets.

coax-gtk: A simplistic GUI to test the whole stack interactively.

License

All code in here is subject to the terms and conditions of the GNU General Public License version 3.

Contributing

Contributions to any part of this project are very much welcome. However it is necessary to sign a contributor agreement first. The actual agreement can be found here:

https://github.com/wireapp/wire/raw/master/assets/Wire%20Contributor%20Agreement.pdf

When you submit your first pull request CLAssistant will present you a link to a submission form. Once the agreement has been submitted your contribution and any possible future ones will be gladly considered for inclusion into this project.


Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
rust (4,309
unix (208
gtk (155
experimental (42

Find Open Source By Browsing 7,000 Topics Across 59 Categories