Join GitHub today
GitHub is home to over 20 million developers working together to host and review code, manage projects, and build software together.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
|Failed to load latest commit information.|
Introduction ============ This Application is intended for use as a simple Geocaching tool. It has functionality roughly equivalent to a low cost handheld GPS receiver. You can use it to find your way towards any point given in GPS coordinates or imported from a GPX file. This application is not supposed to be used for car navigation, as it only tells you the direction in which the target position lies relative to your current position and the distance, it doesn't take into account any map data. Installation ============ For non Arch Linux users: Dependencies: python >= 2.6 (3.0 is not backwards compatible so < 3.0) gpsd > 2.94 (version 2.94 has a broken python interface) pygtk >= 2.17.0 (earlier versions might work but haven't been tested) Install: run as root: 'python setup.py install' you can use the options listed under 'python setup.py --help install' and 'python setup.py --help' For Arch Linux users: Recommended: Get lotse from AUR To build from git: run 'python setup.py sdist' get the md5sum of dist/lotse-*.tar.gz and put it into the PKGBUILD then run 'makepkg -cf' and install 'pacman -U lotse-*.pkg.tar.xz' How to use it ============= First you need to make sure that gpsd is running, this is crucial as lotse will only show an error message and quit if gpsd is not running on your computer. Refer to 'man gpsd' or other adequate documentation on how to get gpsd up and running. You should then check whether gpsd is running correctly by issuing 'xgps' this should give you some info about your GPS, you might need to install 'gpsd-clients' depending on your distribution. AFTER HAVING VERIFIED THAT GPSD WORKS FOR YOU You can launch lotse from the menu (it should be under 'Accesories') or you can run 'lotse' from the command line. Going to coordinates: --------------------- First, you need to create a waypoint for your target, so go to the Waypoint tab. If you have a GPX File (for example from your Geocaching Website) you can just click on import, choose the file and then select the waypoint you want to go to. (You need to highlight it and then click 'select') If you have the coordinates for example on paper or as text, copied from some place, you need to click 'Add', this will create an 'Unnamed' waypoint defaulting to your current position. Click on the lat/lon field and enter your coordinates, the way you have written them down, chances are lotse will interpret them correctly. Supported formats include (but aren't limited to): 48° 45′ 20.6″ N, 9° 11′ 24.8″ E 48.755722°, 9.190222° Then highlight the waypoint and click 'select' switch to the Goto tab, the black arrow points to the target while the red arrow indicates north your walking direction is always up on the display. Note, that GPS can only calculate your heading (the direction you are walking in, while you are not standing still). Tip: If you have a compass you can use the target 'Direction' Advanced use of the 'Radar' --------------------------- You can left click on the radar for a context menu, with which you can create a new waypoint at the location your mouse would be when translated to real world coordinates, or select the nearest waypoint. Creating a GPX Log ------------------ To create a GPX log you can use the Log tab, remember to end the filename with .gpx Contact ======= For bug reports or help requests contact me using the email niklas(_at.)komani.de