My favorites | Sign in
Project Home Downloads Wiki Issues Source
READ-ONLY: This project has been archived. For more information see this post.
Search
for
TraceBookPluginManual  
This page describes the installation and usage of the TraceBook import plugin for JOSM.
Phase-Deploy, Phase-Support
Updated Mar 24, 2011 by js.schrifterz@googlemail.com

Introduction

The TraceBook import plugin for JOSM enables JOSM to read TraceBookTrack (*.tbt) files which are created by our TraceBook application for android mobile devices. This is the user manual page. The developer information can be obtained here

Known Bugs and Limitations

The plugin can not:

  • save a modified track
  • manipulate media information
  • delete track information/whole tracks
Use the TraceBook app on your device for those actions or delete folders manually.

Download/Installation

1. Installing the precompiled jar

  • Download the jar from our Download Page
  • Windows users: Copy the jar file to "yourusername\Appdata\Roaming\JOSM\plugins"
  • Linux users: Copy the jar file to "/home/yourusername/.JOSM/plugins"
  • when in doubt refer to the JOSM Plugin installation guide for your os

2. Building/Installing from source

(advanced users only!)

  • Checkout the TraceBookImport source from here
  • for compiling you need at least: java6, svn command line tool, ant
  • if you wish to build for a newer version of JOSM (>3966) replace the josm-tested.jar in "lib" with the newer one
  • if you meet all the requirements, navigate to the location where you checked out the source and type "ant install". The plugin will be automatically build and installed into your JOSM installation.

Final steps:

  • Start up JOSM
  • open the menu "Edit -> Preferences"

  • open the tab "Plugins"
  • select TraceBookPlugin
  • click "OK" and restart JOSM

Usage

After successful installation, just bring up the file open dialog. In the file extension filter select "TraceBookTrack (*.tbt)" and navigate to the place where your tracks are stored (in most cases the Phone or SDcard). Open the folder of the track you want to open, select the *.tbt file and click "open". After a short progress dialog ,depending how big your track is, you should see a standard osm layer view and an additional layer with the media you attached. The osm layer behaves just like the usual JOSM osm layer, with the limitations that currently changes can not be saved to the file. You can still manipulate and upload your data though. The media layer is read only too, and can be used as reference when tagging the osm data.

The text, audio and video markers will be opened by your default system viewer.

  • For audio comments you need a player on your system that is capable and linked to playing *.m4a files
  • For video comments you need a player on your system that is capable and linked to playing *.mp4 files
  • For text comments you need a player on your system that is capable and linked to playing *.txt files

Powered by Google Project Hosting