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