summaryrefslogtreecommitdiff
path: root/README.md
blob: e35dc9dd18b5400132886737765dee1f68876d5a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
Pixelated User Agent
====================

The Pixelated User Agent is the mail client of the Pixelated ecosystem, it is composed of two parts, a web interface written in javascript and an API written in python that glues that interface with the Pixelated or LEAP Provider.

>**The Pixelated User Agent is still in early development state!**

>Some things may not yet work the way you expect it to.
>Setting up the service is still rather troublesome and so far it only serves limited functionality.

![High level architecture User Agent](https://pixelated-project.org/drawings/architecture-user-agent.svg)

## Getting started for development

First of all, you should have an account on a LEAP/Pixelated provider with email support.
  * You can use one of the demo accounts at [Try Pixelated](https://try.pixelated-project.org:8080/auth/login).
  * There are some other LEAP providers on the [Bitmask page](https://bitmask.net), but they don't support email currently.

Requirements:
  * vagrant
  * virtualbox

Clone the repository:

    git clone https://github.com/pixelated-project/pixelated-user-agent.git

From the root folder, set up the vagrant machine:

    vagrant up source

You can log into the machine using:

    vagrant ssh
    
From here on you can run the tests for the UI by going to the web-ui folder or for the API by going to the service folder and running:

    ./go test
    
You can also run the mail client with:

    pixelated-user-agent --host 0.0.0.0

Then point your browser to [http://localhost:3333](http://localhost:3333) to see it running.

## Getting started as an user

For people that just want to try the user agent, we have debian packages available in our [repository](http://packages.pixelated-project.org/debian/). To use it you have to add it to your sources list:

```shell

echo "deb http://packages.pixelated-project.org/debian wheezy-snapshots main" > /etc/apt/sources.list.d/pixelated.list
echo "deb http://packages.pixelated-project.org/debian wheezy-backports main" >> /etc/apt/sources.list.d/pixelated.list
echo "deb http://packages.pixelated-project.org/debian wheezy main" >> /etc/apt/sources.list.d/pixelated.list

apt-key adv --keyserver pool.sks-keyservers.net --recv-key 287A1542472DC0E3

apt-get update

apt-get install pixelated-user-agent
```