README

   1 Viking is a free/open source program to manage GPS data. You can
   2 import, plot and create tracks, routes and waypoints, show OSM
   3 and other maps, generate maps (using Mapnik),
   4 see real-time GPS position, Geotag Images,
   5 control items, upload/download OSM Traces and more.
   6 It is written mainly in C with some C++ and uses the GTK+2 toolkit.
   7
   8 Website: http://viking.sf.net/
   9
  10
  11 Obtaining Viking
  12 ================
  13
  14 You can download tarball of latest released version at
  15 http://sourceforge.net/projects/viking/files
  16
  17 You can also retrieve the latest development version on the official
  18 Git repository:
  19   $ git clone git://git.code.sf.net/p/viking/code viking
  20
  21 Installing Viking
  22 =================
  23
  24 Dependencies
  25 ------------
  26
  27 On debian Sid, following packages must be installed before building:
  28   # sudo apt install gtk-doc-tools  gnome-doc-utils libpng-dev libgtk-3-dev libgexiv2-dev libgps-dev libbz2-dev libmagic-dev
  29 nettle-dev libzip-dev libicu-dev
  30
  31 The following packages are needed (they are included by default in Debian Sid, but not in other distributions). They
  32 must be installed too:
  33   # sudo apt-get install libcurl4-gnutls-dev libgtk2.0-dev
  34
  35 The following packages are also used, but they can be disabled with configure option, if desired:
  36   # sudo apt-get install libsqlite3-dev nettle-dev libmapnik-dev
  37
  38 Actual Build
  39 ------------
  40
  41 If you downloaded Viking from Git, you have to:
  42   $ ./autogen.sh
  43
  44 Next, or if you downloaded a tarball, you have to:
  45   $ ./configure
  46   $ make
  47
  48 Check output of "./configure --help" for configuration options.  In
  49 particular, it is possible to disable some features, like
  50 --disable-google in order to disable any Google stuff.
  51
  52 If you wish to install Viking, you have to (as root):
  53   # make install
  54
  55 For detailed explanation on the install on Unix like systems,
  56 see the INSTALL file.
  57
  58 Examples
  59 ========
  60
  61 See test/ subdirectory for examples.
  62
  63 Documentation
  64 =============
  65
  66 See doc/ and help/ subdirectories for documentation.
  67 You can also access user manual via Help menu entry.