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 libicu-dev
  29
  30 The following packages are needed (they are included by default in Debian Sid, but not in other distributions). They
  31 must be installed too:
  32   # sudo apt-get install libcurl4-gnutls-dev libgtk2.0-dev
  33
  34 The following packages are also used, but they can each be disabled with configure options, if desired:
  35   # sudo apt-get install libsqlite3-dev nettle-dev libmapnik-dev libgeoclue-2-dev libgexiv2-dev libgps-dev libmagic-dev libbz2-dev libzip-dev liboauth-dev
  36
  37 Actual Build
  38 ------------
  39
  40 If you downloaded Viking from Git, you have to:
  41   $ ./autogen.sh
  42
  43 Next, or if you downloaded a tarball, you have to:
  44   $ ./configure
  45   $ make
  46
  47 Check output of "./configure --help" for configuration options.  In
  48 particular, it is possible to disable some features, like
  49 --disable-google in order to disable any Google stuff.
  50
  51 If you wish to install Viking, you have to (as root):
  52   # make install
  53
  54 For detailed explanation on the install on Unix like systems,
  55 see the INSTALL file.
  56
  57 Examples
  58 ========
  59
  60 See test/ subdirectory for examples.
  61
  62 Documentation
  63 =============
  64
  65 See doc/ and help/ subdirectories for documentation.
  66 You can also access user manual via Help menu entry.