[[TranslatedPages]]
[[PageOutline(2-4,Table of Content)]]

= Plugin -> Rovas Connector =

== Introduction
This plugin makes it possible for volunteer JOSM users to track their editing time and have a work report created in [https://rovas.app/ Rovas] (an application of the community economic system [https://merit.world/ NEO]) when uploading a job into the OSM database.


== Benefits
=== direct
* **track time** spent editing in JOSM,
* make a permanent record of the editing time for each changeset, in the form of **automatically created Rovas work report**,
* **earn the NEO currency Chron** for the JOSM work. Use the currency to reward other volunteers, or convert it in Rovas into Euros.

=== indirect
* One of the NEO rules is that the time reported in each work report must be verified. To do so, Rovas selects two verifiers and sends them verification requests that include links to a Web page (such as osmcha.org), showing the changes made in the changeset. This allows each changeset to be seen by at least two users, increasing the likelihood of detecting any mapping errors. This should lead to **improvement of the data quality** in the OSM database. 
* having a reliable and verified record of time spent by OSM mappers can **improve funding of the whole OSM ecosystem**. For example, the total labor time, tallied from the individual work reports as shown on the [https://rovas.app/openstreetmap/ Openstreetmap project page in Rovas] can be used to provide potential sponsors with verified data about mapping effort exerted by volunteer mappers. The time record can also serve as an instrument to incentivize commercial consumers of the OSM data to reciprocate and reward the OSM community with much needed funds. These can be used to improve the server infrastructure or financially support mapping efforts across the globe.


== Installation and configuration
1. To use the plugin, you must have an account in Rovas. Conveniently, Rovas provides an option to register with one of several OpenID identity providers, including Openstreetmap.
1. Next, in the Plugins screen of the JOSM preferences, select the Rovas Connector plugin and activate it.
1. From the **Rovas API** pane of [https://rovas.app/user your profile], copy the API key and API token into the similarly named fields in the Rovas Connector plugin configuration page. Click a checkbox to confirm that you are not paid by a firm for your JOSM work. The **Timer tolerance** setting in the plugin preferences determines the length of idle time between user actions that is counted as active. The **Project ID** field will typically be left with the default value.
[[Image(josm_rc_prefs.png,link=,600px,align=center)]]


== Using the plugin
The plugin timer is initiated at the moment JOSM is started. The counter (elapsed time) is updated every time a layer is added, or a change is made (a node is moved, added or deleted...). The plugin-provided info block shows the elapsed time. The value can be reset to 0, or an arbitrary time by clicking the **Reset timer** button.

[[Image(josm_rc_timer.png,link=,600px,align=center)]]

After edits are uploaded to OSM and the preferences for the plugin are complete, a dialog box is shown, allowing the user to create a report in Rovas:

[[Image(josm_rc_save.png,link=,600,align=center)]]

The Rovas [https://rovas.app/rules rules page] describes in detail what happens when a work report is created.

== Developer contact
Please report issues and suggestions in the [https://gitlab.com/JOSM/plugin/RovasConnector/-/issues project issue tracker]