os.path.getmtime may return float in newer Pythons; compensate in test case
[joel/kofoto.git] / INSTALL.txt
1  _  __      __       _
2 | |/ /___  / _| ___ | |_ ___
3 | ' // _ \| |_ / _ \| __/ _ \
4 | . \ (_) |  _| (_) | || (_) |
5 |_|\_\___/|_|  \___/ \__\___/
6
7
8 INSTALLATION
9 ============
10
11 A. Unix
12 -------
13
14    Prerequisites
15    -------------
16
17    Kofoto depends on the following third-party softwares:
18
19      * Python 2.4 or newer. Found at:
20
21            http://www.python.org
22
23      * GTK+ 2.4 or newer. Found at:
24
25            http://www.gtk.org
26
27      * Glade 2.6. Found at:
28
29            http://glade.gnome.org
30
31      * PyGTK for GTK+ 2.4 or newer (including Glade bindings). Found
32        at:
33
34            http://www.pygtk.org
35
36      * Python Imaging Library. Found at:
37
38            http://www.pythonware.com/products/pil/
39
40      * PySQLite 1.0.x (not 1.1.x or 2.x) for SQLite 2.8. Found at:
41
42            http://www.pysqlite.org
43
44    On a Debian GNU/Linux machine, installing the packages
45    python-glade2, python-gtk2, python-imaging and python-sqlite should
46    do.
47
48
49    Installing and running Kofoto
50    -----------------------------
51
52    1. Install the prerequisites, if necessary.
53    2. Unpack the kofoto-*.tar.gz archive.
54    3. Run "python setup.py install" in the created directory to
55       install Kofoto at the default location. See
56       http://www.python.org/doc/current/inst/inst.html for more
57       information.
58    4. Run gkofoto or "kofoto --help".
59
60
61 B. Windows standalone
62 ---------------------
63
64    1. Run kofoto-x.y-win32-standalone.exe and complete the wizard.
65    2. Double-click the Kofoto shortcut at the desktop or in the start
66       menu.
67
68 C. Windows with separately installed dependencies
69 -------------------------------------------------
70
71    Prerequisites
72    -------------
73
74    Kofoto depends on the following third-party softwares:
75
76      * Python 2.4 (or newer). Found at:
77
78            http://www.python.org
79
80      * GTK+ 2.4 (or newer) runtime environment. Found at:
81
82            http://gladewin32.sourceforge.net
83
84      * PyGTK for GTK+ 2.4 (or newer). Found at:
85
86            http://www.mapr.ucl.ac.be/~gustin/win32_ports/pygtk.html
87
88      * Python Imaging Library. Found at:
89
90            http://www.pythonware.com/products/pil/
91
92      * PySQLite 1.0.x (not 1.1.x or 2.x). Found at:
93
94            http://www.pysqlite.org
95
96
97    Installing and running Kofoto
98    -----------------------------
99
100    1. Install the prerequisites, if necessary.
101    2. Run the kofoto-*.win32.exe Windows installer and complete the
102       wizard.
103    3. Double-click the Kofoto shortcut at the desktop or in the start
104       menu.