1                           Installing TilEm
2                          ------------------
3
4To compile TilEm, you will need:
5
6  * a standard C compiler
7
8  * the GTK+ library, version 2.6.0 or later
9
10  * the libticalcs2 library (part of the TiLP project), and its
11    dependencies (libticables2, libtifiles2, and libticonv)
12
13Some OS distributions package the "development files" separately from
14the libraries themselves; you need both.  If you are using Debian (or
15a related distribution, such as Ubuntu or Mint), install the packages
16'build-essential', 'libticalcs-dev', and 'libgtk2.0-dev'.
17
18If these packages aren't available from your package manager, you'll
19need to compile them yourself; see the TiLP website for more
20information (http://lpg.ticalc.org/prj_tilp/).
21
22Mac OS X has not been tested by the TilEm team, but if TiLP works,
23TilEm should, too.  Please let us know if you do get it to work.
24
25Once the above dependencies are installed, open a terminal and 'cd' to
26the directory containing this INSTALL file.  Then run
27
28   ./configure
29
30which will check whether you have all of the necessary software
31installed, and figure out how to compile TilEm for your particular
32system.  If configure is successful, you can then run
33
34   make
35
36to compile TilEm.  Finally, you can run
37
38   sudo make install
39
40to install it (or run 'make install' as the superuser.)  The program
41will be installed in '/usr/local/bin/', and data files will be
42installed in '/usr/local/share/tilem2/'.  Alternatively, you can run
43
44   make install-home
45
46to install TilEm in your own home directory ('$HOME/bin/', with data
47files stored in '$HOME/.local/share/tilem2/'), which does not require
48superuser privileges.  (If $HOME/bin didn't exist already, you might
49have to run 'export PATH=$HOME/bin:$PATH', or log out and log back in,
50before running TilEm.)
51
52Once TilEm is installed, start it by running 'tilem2', or through your
53system's applications menu.
54