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
  33 [2]: http://code.google.com/p/pybluez/
  34
  35 [3]: http://www.freedesktop.org/wiki/Software/DBusBindings
  36
  37 [4]: https://sourceforge.net/projects/pywin32/
  38
  39
  40 Cross compilation for Windows on Linux
  41 ======================================
  42
  43 You need Wine with installed all dependencies (see above section where
  44 to get them).
  45
  46 Building installer for wammu for Python is easy:
  47
  48     wine c:\\python25\\python setup.py build --skip-deps bdist_wininst
  49
  50 However this way user needs to also install all dependencies, what is
  51 really not comfortable. This should be solved using py2exe [5]:
  52
  53     wine c:\\python25\\python setup.py build --skip-deps py2exe
  54
  55 But except of this, you need to do a bit of manual tuning. To make
  56 py2exe work in Wine, you need to fix it's binary using PE Tools
  57 (described in bug report on Wine [w1]) and copy some extra libraries
  58 which are missing to dist directory (python25.dll and libraries from
  59 wxPython). See script admin/make-release which automates this copying.
  60
  61 Then you can use InnoSetup[6] to build installer for Wammu:
  62
  63     wine c:\\Program\ Files\\Inno\ Setup\ 5/\\ISCC.exe wammu.iss
  64
  65 [5]: http://www.py2exe.org/
  66
  67 [6]: http://www.jrsoftware.org/isinfo.php
  68
  69 [w1]: http://bugs.winehq.org/show_bug.cgi?id=3591