bobosm/MANUAL.md

Bobsm prospective manual

Warning: Features described in this document may not have been implemented, refer to the code to see if they are actually implemented ;)

Download OSM data

Press d key to download OSM data in the current bbox.

A loading indicator will appear at bottom left of the canvas.

It's possible that the bbox you're trying to download is too large, a error will appear at the center of the screen if that's the case.

Layer management

Default OSM Dynamic Data layer

The default layer is called "OSM Dynamic Data", it's used to draw downloaded OSM data. You can edit this layer.

GPS Trace layer

You can load a GPS trace from the terminal,

bobosm trace load ./my-trace.gpx

The bobosm CLI will connect via IPC to the main bobosm instance and import the trace into view.

Navigation

To navigate in the map, you can use vim style

Edit mode

To enter edit mode, press e

A edit mode indicator icon will appear at the bottom right.

The edit mode is only available at high zoom.

Nodes handle will appears.

New objects

• n n, will create a node and select it
• n w, will create a way and wait for you to start drawing it
• n r, will create a new relation available in the relations list.

Tags edition

In edit mode, you can select a note and press t, it will write a file tags.osm.txt.

You can open this file with any text editor you like, after saving it, the nodes will

OSM Session management

You can login with your OSM.org account using the CLI.

Initialize the OAuth2 login.

bobosm session login

View the status of the session

bobosm session status

Logout with

bobosm session logout

Changeset management

Upload the changeset

You can upload your changeset,

Pressing the sequence c c

Your default text editor will appear, you can then preview the changes included in the changeset

The osmChange XML file will be writen in the local state to allow previewing if needed. At the top you can type the tags of the changeset, the comment tag is required, source is welcomed. At the bottom of this file, a list of new of affected objects are printed with comments starting with //

Then save and quit the editor.

Your changeset will be then uploaded.

Depending on the result a sucess of failure message will appear at bottom center of your screen.

Discard the changes

You can revert the changes using c d

IPC with bobosm CLI

You can use bobosm CLI to connect to a existing graphical instance of bobosm.

bobosm canvas-info

Is equivalent to:

bobosm -S /run/user/1000/bobosm-ipc.1000.2640.sock canvas-info