Installation¶
unMessage’s installation is done in three steps:
- Install requirements
- Use a virtual environment
- Install unMessage
Requirements¶
Install the following requirements via package manager:
$ # If using Debian/Ubuntu
$ sudo apt-get install build-essential gcc libffi-dev libopus0 \
libsodium-dev libssl-dev portaudio19-dev python-dev python-tk
$ # If using Fedora
$ sudo dnf install gcc libffi-devel libsodium-devel \
openssl-devel opus portaudio-devel python-devel \
redhat-rpm-config tkinter
If you have tor installed, make sure its version is at least
0.2.7.1
:
$ tor --version
If you must update it or do not have it installed, check the version provided by the package manager:
$ # If using Debian/Ubuntu
$ apt-cache show tor
$ # If using Fedora
$ dnf info tor
If the version to be provided is not at least 0.2.7.1
, you will
have to set up Tor’s package repository. Once you have a repository
which can provide an updated tor, install it:
$ # If using Debian/Ubuntu
$ sudo apt-get install tor
$ # If using Fedora
$ sudo dnf install tor
Using a Virtual Environment¶
Install virtualenv, pip and setuptools:
$ # If using Debian/Ubuntu
$ sudo apt-get install python-virtualenv
$ # If using Fedora
$ sudo dnf install python-virtualenv
Use a virtual environment:
$ virtualenv ~/unmessage-env # create
$ . ~/unmessage-env/bin/activate # activate
(unmessage-env)$ # prompt shows which environment is active
Update setuptools, pip and virtualenv:
(unmessage-env)$ pip install --upgrade setuptools
(unmessage-env)$ pip install --upgrade pip
(unmessage-env)$ pip install --upgrade virtualenv
Make sure that the update installs at least pip 8
and
setuptools 19.4
.
Installing¶
Finally, install unMessage:
(unmessage-env)$ pip install unmessage
Launch unMessage with any of the commands:
(unmessage-env)$ unmessage-gui # graphical user interface (GUI)
(unmessage-env)$ unmessage-cli # command-line interface (CLI)
(unmessage-env)$ unmessage # last interface used
Make sure to activate the virtual environment whenever you wish to use unMessage:
$ . ~/unmessage-env/bin/activate
As well as deactivate it when you are done:
(unmessage-env)$ deactivate
Updating¶
pip can also be used to update unMessage:
(unmessage-env)$ pip install --upgrade unmessage
Usage¶
unMessage offers usage instructions for both interfaces: Graphical User Interface (GUI) and Command-line Interface (CLI).
Persistence¶
All files used by unMessage are saved in ~/.config/unMessage/