Differences

This shows you the differences between two versions of the page.

--- manual:advanced:customization:config [2025/10/15 15:47] – mstupka
+++ manual:advanced:customization:config [2025/10/17 16:08] (current) – mstupka
@@ Line 85: / Line 85: @@
 === Label style ===
 You can set the text color, background, highlighted background, border and highlighted border of a label.
+**An example of transparent label background:**
+map_items_labels_color_text=#0A0A0A\\
+map_items_labels_color_bg_normal=#4CF0F0F0\\
+map_items_labels_color_border_normal=#19F0F0F0\\
+map_items_labels_color_bg_highlight=#4CF0F0F0\\
+map_items_labels_color_border_highlight=#19F0F0F0\\
+See the difference (default and customized):
+{{:manual:advanced:customization:cfg_item_label_default.png?nolink&150|}} {{:manual:advanced:customization:cfg_item_label_custom.png?nolink&150|}}
 ==== Points ====
 === New point name time format ===
@@ Line 92: / Line 104: @@
 === Center on point ===
 By default, the points are centered when tapped, and their detail panel appears. Here you can switch the centering off.
-==== Tracks ====
+=== Simplify visible points ===
-=== Fill color of chart with... ===
+Here, you can define the map zoom level from which the point icons are simplified to a dot. The default is 10; 0 means that simplification is turned off.
-Custom settings of track/route chart line colors.
+==== Tracks & routes ====
-==== Route planner ====
+=== Fill color of ... chart ===
-=== Route, interpolation step ===
+Custom settings of track/route chart line colors - altitude, cadence, gradient, heart-rate, speed, sensor speed and temperature. The color is defined both for a **track/route [[..:..:user_guide:tracks:about#elevation_chart|detail]]** and for **[[..:..:user_guide:tools:dashboards|dashboards]]**.
-Definition of distance between interpolated points on route for manual route drawing - affects slope/elevation coloring of the route line. Minimum 1m.
+=== Customize altitude threshold ===
+This allows modifying the altitude threshold of all tracks in case the phone's GPS shows deviations or the calculated elevation gain seems exaggerated. When the option is turned on, a new control appears in a track detail [[..:..:user_guide:tracks:about#editing_info|edit screen]].
-==== Tools ====
+=== Track previews during import ===
-=== Hardware buttons when 'screen lock' ===
+When turned off, the import is a bit faster, especially when you import multiple tracks.
-When enabled, hardware buttons can control the app even when the screen is locked.
+=== Simplify visible tracks ===
-=== Scroll to zoom ===
+Defines a map zoom level from which the number of visualized track points is reduced. 22 is the default.
-When enabled, it is possible to zoom the map by scrolling controller (e.g. mouse when run on a PC)
+=== Track selection highlight ===
-=== Record sensors data ===
+When turned on, a track or route tapped on the map is highlighted with a changed color.
-When enabled, all the phone sensors data are recorded in a file in Locus/data/sensors directory.
+==== Import & export ====
-=== Enable TTS over BT SCO ===
+=== Width of exported photos ===
-When enabled, TTS audio is played over a Bluetooth SCO module.
+Defines the width of photos attached to points, exported to KML. 60 px is the default.
-==== Tweaks ====
+==== Navigation/guidance ====
-=== Smooth interface ===
+=== Auto GPS on navigation ===
-Enables animations and other tweaks for more comfortable experience. We recommend to use this only on fast devices.
+When navigation or guidance is started, the app turns GPS on, although it is turned off.
-=== Allow login over Google Play Services ===
+=== Guidance path symbol ===
-When switched off, only an email login to Locus Store or Live Tracking is possible. Recommended when MicroG service is used.
+This parameter allows you to define the shape and size of the guiding line very precisely. Best to explain it on the default parameter.
-FIXME TO BE CONTINUED... FIXME
-===== Configuration file =====
-  * Since version 2.3.2 Locus Map offers advanced configuration options through //config.cfg// file stored in **Locus Map root directory** in your phone **memory**
-  * This file is automatically created during Locus Map first start (if it does not exist from its previous installation). Data are loaded at start and stored back to file in the end, so even if this file allows changing some settings that are also changeable in the application, settings will not be lost.
-<WRAP center round info>
-As this method has become obsolete and is quite user unfriendly, settings included in this configuration file are going to be moved gradually to the **Expert settings** section above.
-</WRAP>
-==== Examples of some parameters ====
-=== guiding_path_map_symbol ===
-This parameter allows to define very precisely the shape and size of the guiding line. Best is to explain it on the default parameter.
 Basic values are: **-8.0|-2.0|7.0|0.0|-8.0|2.0**
-Imagine squared paper. Each two numbers mean X and Y coordinates. So draw them. Result will be as in the picture below. The same way you may draw whatever symbol you want.
+Imagine a paper with a grid. Each of the two numbers means the X and Y coordinates. So draw them. The result will be as in the picture below. In the same way, you may draw whatever symbol you want.
 {{ :manual:advanced:customization:config_file_guiding_arrow.png?nolink |}}
-==== Examples of some settings ====
+**Examples:**\\
-----
-=== guiding_path_symbol ===
 {{:manual:advanced:customization:cfg_exmpl_guideline.png?nolink|}}
 guiding_path_symbol=-20|0|-20|-10|0|-10|0|-20|20|0|0|20|0|10|-20|10
@@ Line 149: / Line 139: @@
 {{:manual:advanced:customization:cfg_exmpl_guideline2.png?nolink|}}
 guiding_path_symbol=-11|0|-14|-5|5|0|-14|5
+=== Line/text background color ===
+Allows setting the background color for the guidance line and texts.
+==== Route planner ====
+=== Route planner - interpolation saving ===
+When turned on, interpolation steps for manual segments are saved within the planned route.
+=== Routeplanner - interpolation step ===
+Definition of distance between interpolated points on route for manual route drawing - affects slope/elevation coloring of the route line. Minimum 1m, recommended 100m.
+==== Geocaching ====
+=== Offline logging of trackables ===
+Support for logging trackables offline. To log the trackable online, use the log manager in the geocaching tools.
+==== Hardware controlling ====
+=== Hardware buttons over 'screen lock' ===
+When enabled, hardware buttons can control the app even when the screen is locked.
+=== Scroll to zoom ===
+When enabled, it is possible to zoom the map by a scrolling controller (e.g. mouse when running on a PC)
-**example of transparent label background:**
+In this section, also **KEY-CODEs** for various events can be configured: **Screen on/off, GPS on/off, Map centering on/off, Map rotation on/off, Map zoom in/out** and **Screen lock toggle**.
+==== Tools ====
+=== GPS auto-off ===
+A system for turning the GPS off automatically to save battery consumption, e.g., during long-distance hikes. \\ {{ :manual:advanced:customization:expert02.jpg?nolink |}}
+  * **GPS update interval**  - sets the time interval of GPS switching on and locating the device. Values of more than 60 seconds save battery life.
+  * **Min accuracy**  - sets the minimum GPS locating accuracy to keep GPS on. When the accuracy is lower due to too few detectable satellites, the GPS turns off.
+  * **Max search time**  - sets the maximum time of GPS signal searching. If the GPS fix is not secured within this period, the GPS turns off.
+  * **Keep auto-off enabled** - keeps GPS auto-off enabled even if Locus Map is active and the screen is on.
+<WRAP center round important>
+This option is **not available/reliable on devices running OS Android 12+** due to the system restrictions of certain automatic actions running in the background.
+</WRAP>
+=== Notify of disabled GPS ===
+When turned on, the app notifies when the system's GPS is switched off.
+=== Enable online search (old) ===
+Adds the obsolete online search based on the Google Places service to the offer of search methods.
+=== Record sensors data ===
+When enabled, all the phone sensors' data are recorded in a file in the Locus/data/sensors directory.
+==== Units ====
+=== Coordinates, high precision ===
+Adds two decimal places to the coordinate values. Useful when a sub-meter external GNSS unit is connected.
+=== Altitude, high precision ===
+Adds two decimal places to the altitude values. Useful when a sub-meter external GNSS unit is connected.
+=== Angle, high precision ===
+Adds two decimal places to the angle and gradient values.
+==== Tweaks ====
+=== Hardware acceleration ===
+Turn on to accelerate rendering of points and tracks on the map.
+=== Login over Google Play Services ===
+When switched off, only an email login to Locus Store or Live Tracking is possible. Recommended when MicroG service is used. Deactivating results in logging you out of your Locus account.
+=== Set a custom camera app ===
+Enables the use of any installed custom camera app for use within Locus Map. Just insert its package name.
+=== Set a translation app ===
+Select from the system chooser or installed translation apps.
+==== Development ====
+These options are for development only and are considered risky for ordinary app usage.
+=== Log to file ===
+App records all its processes into logs in the Locus/logs directory.
+=== Draw map tile bounds ===
+Displays map tile bounds, including related information above the map.
+=== WakeLock when GPS on ===
+Keeps partial wakelock enabled while using GPS.
-map_items_labels_color_text=#0A0A0A\\
+===== Configuration file =====
-map_items_labels_color_bg_normal=#4CF0F0F0\\
-map_items_labels_color_border_normal=#19F0F0F0\\
-map_items_labels_color_bg_highlight=#4CF0F0F0\\
-map_items_labels_color_border_highlight=#19F0F0F0\\
-**see the difference (default and customized)**
+  * Locus Map offers advanced configuration options through //config.cfg// file stored in **Locus Map root directory**
-{{:manual:advanced:customization:cfg_item_label_default.png?nolink&150|}} {{:manual:advanced:customization:cfg_item_label_custom.png?nolink&150|}}
+  * This file is automatically created at the Locus Map first start (if it does not exist from its previous installation). Data is loaded on app start and stored back to the file when the app is closed, so even if this file allows changing some settings that are also changeable in the application, the settings won't be lost.
-----
-[[http://www.w3schools.com/tags/ref_colorpicker.asp|Colorpicker]]
+<WRAP center round info>
-----
+As this method has become obsolete and is quite user-unfriendly, settings included in this configuration file are moved gradually to the **Expert settings** section mentioned above.
+</WRAP>

knowledge base

User Tools

Site Tools

Differences