Prepare for a release.
[wammu.git] / INSTALL
blobfa29378d6fc04f2e96155a7537beef0e38df695d
1 Wammu installation
2 ==================
4 It uses standard distutils, so:
5 python setup.py build
6 su
7 python setup.py install
9 You need python-gammu and wxPython [1] (Unicode enabled build) installed to
10 run and install this program. If you want support for scanning Bluetooth
11 devices, you need PyBluez [2]. For incoming events notifications, you
12 need dbus-python [3].
14 For Windows you also have to install Pywin32 [4].
16 If you want to obey dependency checking at build time for any reason,
17 you can use --skip-deps option.
19 [1]: http://wxpython.org/
20 [2]: http://code.google.com/p/pybluez/
21 [3]: http://www.freedesktop.org/wiki/Software/DBusBindings
22 [4]: https://sourceforge.net/projects/pywin32/
25 Cross compilation for Windows on Linux
26 ======================================
28 You need Wine with installed all dependencies (see above section where
29 to get them).
31 Building installer for wammu for Python is easy:
33 wine c:\\python25\\python setup.py build --skip-deps bdist_wininst
35 However this way user needs to also install all dependencies, what is
36 really not comfortable. This should be solved using py2exe [5]:
38 wine c:\\python25\\python setup.py build --skip-deps py2exe
40 But except of this, you need to do a bit of manual tuning. To make
41 py2exe work in Wine, you need to fix it's binary using PE Tools
42 (described in bug report on Wine [w1]) and copy some extra libraries
43 which are missing to dist directory (python25.dll and libraries from
44 wxPython). See script admin/make-release which automates this copying.
46 Then you can use InnoSetup[6] to build installer for Wammu:
48 wine c:\\Program\ Files\\Inno\ Setup\ 5/\\ISCC.exe wammu.iss
50 [5]: http://www.py2exe.org/
51 [6]: http://www.jrsoftware.org/isinfo.php
53 [w1]: http://bugs.winehq.org/show_bug.cgi?id=3591
55 # vim: et ts=4 sw=4 sts=4 tw=72 spell spelllang=en_us