summaryrefslogtreecommitdiffstats
path: root/README.md
blob: e0b16dbb9655d3cd9c91adc96119d1a099f6a195 (plain) (blame)
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
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
# combox

Encrypts files and scatters them across storage provided by Google
Drive and Dropbox.

The ideas for this program is based on [`combobox`][1].

Homepage at <https://ricketyspace.net/combox>


[1]: https://bitbucket.org/bgsucodeloverslab/combobox

# etymology

`combox` is a lazy contraction of the word "combo box". `combox` is
pronounced as "combo box".

# runs on

 - GNU/Linux
 - OS X

# using combox

## on GNU/Linux

Install `virtualenv` and python dev. package.

On a Debian based distribution, do:

    # aptitude install virtualenv python-dev

## on OS X

First install [Hombrew][brew.sh]:

    $ ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

Then do:

    $ brew update
    $ brew doctor

[brew.sh]: http://brew.sh/

Next, install python from Hombrew:

    $ brew install python

This will also install `pip`.

Lastly do:

    $ pip install virtualenv


## set up combox

Get the latest copy of combox:

    $ git clone git://ricketyspace.net/combox.git

Setup virtual environment:

    $ cd combox
    $ virtualenv .

Activate the virtual environment:

    $ source bin/activate

Install combox:

    $ python setup.py install

Run combox:

    $ combox

Always make sure that the virtual environment is activated before
running combox. To activate virtual environment, do:

    $ cd path/to/combox
    $ source bin/activate


## combox on Windows

At the moment, combox is not compatible with Windows. If you can make
combox work on Windows, look at
<https://ricketyspace.net/combox/windows/> for info on setting up the
development environment on Windows.

# license

`combox` is licensed under the
[GNU General Public License version 3 or later][gpl]. See COPYING.

The `combox` logo (`graphics/logo/combox-logo.svg`) is under [Public Domain][pd].

[gpl]: https://gnu.org/licenses/gpl-3.0.txt
[pd]: https://creativecommons.org/publicdomain/zero/1.0/

# canonical repo

    $ git clone git://ricketyspace.net/combox.git

# contact

siddharth ravikumar <sravik@bgsu.edu> (gpg id: `0x00B252AF`)