INSTALL

   1 Wammu installation
   2 ==================
   3
   4 Packages for Linux
   5 ==================
   6
   7 Many distributions come with prebuilt Wammu binaries, if you can use
   8 them, it is definitely the easiest thing. There are also binary packages
   9 of latest release built for many distributions available on Wammu web
  10 site <http://wammu.eu/download/wammu/>.
  11
  12
  13 Building from Sources
  14 =====================
  15
  16 It uses standard distutils, so:
  17
  18     python setup.py build
  19     sudo python setup.py install
  20
  21 You need python-gammu and wxPython [1] (Unicode enabled build) installed to
  22 run and install this program. If you want support for scanning Bluetooth
  23 devices, you need PyBluez [2]. For incoming events notifications, you
  24 need dbus-python [3].
  25
  26 For Windows you also have to install Pywin32 [4].
  27
  28 If you want to obey dependency checking at build time for any reason,
  29 you can use --skip-deps option.
  30
  31 [1]: http://wxpython.org/
  32 [2]: http://code.google.com/p/pybluez/
  33 [3]: http://www.freedesktop.org/wiki/Software/DBusBindings
  34 [4]: https://sourceforge.net/projects/pywin32/
  35
  36
  37 Cross compilation for Windows on Linux
  38 ======================================
  39
  40 You need Wine with installed all dependencies (see above section where
  41 to get them).
  42
  43 Building installer for wammu for Python is easy:
  44
  45     wine c:\\python25\\python setup.py build --skip-deps bdist_wininst
  46
  47 However this way user needs to also install all dependencies, what is
  48 really not comfortable. This should be solved using py2exe [5]:
  49
  50     wine c:\\python25\\python setup.py build --skip-deps py2exe
  51
  52 But except of this, you need to do a bit of manual tuning. To make
  53 py2exe work in Wine, you need to fix it's binary using PE Tools
  54 (described in bug report on Wine [w1]) and copy some extra libraries
  55 which are missing to dist directory (python25.dll and libraries from
  56 wxPython). See script admin/make-release which automates this copying.
  57
  58 Then you can use InnoSetup[6] to build installer for Wammu:
  59
  60     wine c:\\Program\ Files\\Inno\ Setup\ 5/\\ISCC.exe wammu.iss
  61
  62 [5]: http://www.py2exe.org/
  63 [6]: http://www.jrsoftware.org/isinfo.php
  64
  65 [w1]: http://bugs.winehq.org/show_bug.cgi?id=3591
  66
  67 # vim: et ts=4 sw=4 sts=4 tw=72 spell spelllang=en_us