User Tools

Site Tools


manual:advanced:customization:config

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
manual:advanced:customization:config [2025/10/16 16:14] mstupkamanual:advanced:customization:config [2026/09/01 15:25] (current) – [Units] mstupka
Line 3: Line 3:
 ---- ----
 ===== Expert settings ===== ===== Expert settings =====
-<WRAP center round info> 
-This section is IN CONTINUOUS DEVELOPMENT</WRAP> 
  
 Settings that are not essential for running the app and overall user experience. Some of these settings were removed from the general settings because of weak usage, some were found redundant, and some have a purpose only for advanced Locus Map users. Settings that are not essential for running the app and overall user experience. Some of these settings were removed from the general settings because of weak usage, some were found redundant, and some have a purpose only for advanced Locus Map users.
Line 11: Line 9:
   * tap **Expert settings**   * tap **Expert settings**
   * Expert settings appear at the bottom of the Locus Map general settings    * Expert settings appear at the bottom of the Locus Map general settings 
 +
 +----
  
 ==== UI/UX ==== ==== UI/UX ====
Line 27: Line 27:
 === Display tips&tricks === === Display tips&tricks ===
 Displays information boxes in various parts of the app, highlighting key features and usage instructions. Displays information boxes in various parts of the app, highlighting key features and usage instructions.
 +=== Separate GPS and Compass screens === 
 +Normally, the GPS and Compass share the same double-tabbed screen. By turning this on, you assign an individual screen for each feature. Useful if you have a low-powered device. 
 +=== Compass in light color === 
 +By default, the Compass screen is black. By turning this on, you change the color to shades of white. 
 +=== Close after adding a point === 
 +Automatically closes the [[..:..:user_guide:points:quick_add|Quick add point]] dialog after a new point is added.
 ==== Maps ==== ==== Maps ====
 +=== Local map server ===
 +The app can serve the map currently displayed on the main screen to nearby devices sharing the same network. The Locus Map web is the most obvious recipient. 
 +=== Show zoom range in map list ===
 +Supported zoom levels are displayed for each map in the list of online maps.
 === Hold map center timeout === === Hold map center timeout ===
 Defines the period of time in seconds before your location is automatically centered on the map screen in case the **[[manual:user_guide:maps_mainscr_ctrl#controlling_the_map|Hold map center]]** is active. Defines the period of time in seconds before your location is automatically centered on the map screen in case the **[[manual:user_guide:maps_mainscr_ctrl#controlling_the_map|Hold map center]]** is active.
Line 53: Line 62:
 === Map scale font size === === Map scale font size ===
 Here, you can define the font size for the map scale label Here, you can define the font size for the map scale label
-=== Show date&time in toolbar ===+=== Show date&time on the top ===
 When activated, the top information panel item "time&battery status" also shows time and date. When activated, the top information panel item "time&battery status" also shows time and date.
 ==== Map-screen content ==== ==== Map-screen content ====
Line 70: Line 79:
 === Heading line color/background === === Heading line color/background ===
 Definition of the style of the [[manual:user_guide:maps_settings#heading_line|Heading line]] Definition of the style of the [[manual:user_guide:maps_settings#heading_line|Heading line]]
-=== Time circles color, background, text size ===+=== Time circles color, background, text size, value format ===
 Definition of the style of the [[manual:user_guide:maps_settings#time_circles|Time circles]] Definition of the style of the [[manual:user_guide:maps_settings#time_circles|Time circles]]
 === Distance circles color, background, text size, color/background when no GPS === === Distance circles color, background, text size, color/background when no GPS ===
Line 76: Line 85:
 === Entries above/below auxiliary lines === === Entries above/below auxiliary lines ===
 Select parameters displayed above and/or below various lines in app - route planner, two-finger measurement, etc. - distance, bearing, time of arrival, elevation, time to target, and ETA&time to target. Select parameters displayed above and/or below various lines in app - route planner, two-finger measurement, etc. - distance, bearing, time of arrival, elevation, time to target, and ETA&time to target.
-=== Tile hunters grid ===+=== Tile Hunter grid ===
 Activates the option to select a tile hunter's grid (StatsHunters) in the map content panel grid selection (referring to zoom 14). Activates the option to select a tile hunter's grid (StatsHunters) in the map content panel grid selection (referring to zoom 14).
-=== Heading without GPS === +=== Headings without GPS === 
-Enables rotating and displaying the heading line even when the GPS is off.+Enables rotating and displaying the heading line and 'Show view' even when the GPS is off.
 ==== Map labels ==== ==== Map labels ====
 === Draw popup labels by zoom === === Draw popup labels by zoom ===
 Defines the zooms in which the track/route/point popup labels are displayed. "0" is the default and shows the labels always. "1-22 'include'" defines the zoom range. Defines the zooms in which the track/route/point popup labels are displayed. "0" is the default and shows the labels always. "1-22 'include'" defines the zoom range.
 === Label style === === Label style ===
-You can set the text color, background, highlighted background, border and highlighted border of a label.+You can set the text color, background, highlighted background, borderand highlighted border of a label.
  
-**An example of transparent label background:** +An example of customized map label
- +
-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|}} {{:manual:advanced:customization:cfg_item_label_default.png?nolink&150|}} {{:manual:advanced:customization:cfg_item_label_custom.png?nolink&150|}}
Line 100: Line 101:
 === New point name time format === === New point name time format ===
 Defines the format of the time used in a new point's name. Default is yyyy-MM-dd HH:mm:ss. Defines the format of the time used in a new point's name. Default is yyyy-MM-dd HH:mm:ss.
 +=== Quick add point time format ===
 +Date/time format for the {t} tag in the [[..:..:user_guide:points:quick_add|Quick add point]] feature (default: yyyy-MM-dd 'at' HH:mm).
 === Default icons === === Default icons ===
 You can set the default icon for a new [[..:..:user_guide:points:add:|point]], [[..:..:user_guide:tracks:recording#recording_is_on|waypoint]] (entered during track recording) and [[..:..:user_guide:tracks:planning#via_points|via-point]] (entered during route planning) You can set the default icon for a new [[..:..:user_guide:points:add:|point]], [[..:..:user_guide:tracks:recording#recording_is_on|waypoint]] (entered during track recording) and [[..:..:user_guide:tracks:planning#via_points|via-point]] (entered during route planning)
 === Center on point === === Center on point ===
 By default, the points are centered when tapped, and their detail panel appears. Here you can switch the centering off. By default, the points are centered when tapped, and their detail panel appears. Here you can switch the centering off.
 +=== Hide point after move ===
 +When you move a point from a folder to a different folder in your Library, the point will be hidden from the map. 
 === Simplify visible points === === Simplify visible points ===
 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. 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.
 ==== Tracks & routes ==== ==== Tracks & routes ====
-=== Fill color of ... chart === 
-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]]**. 
 === Customize altitude threshold === === 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]]. 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]].
Line 117: Line 120:
 === Track selection highlight === === Track selection highlight ===
 When turned on, a track or route tapped on the map is highlighted with a changed color. When turned on, a track or route tapped on the map is highlighted with a changed color.
 +=== Beep on recorded point ===
 +When turned on, a short beep is played on each successfully recorded track point.
 +=== Show area in track statistics ===
 +Displays a box with the measured area covered by the track in the track stats.
 ==== Import & export ==== ==== Import & export ====
 === Width of exported photos === === Width of exported photos ===
 Defines the width of photos attached to points, exported to KML. 60 px is the default.  Defines the width of photos attached to points, exported to KML. 60 px is the default. 
 +=== Compress single file export ===
 +When you export multiple items in one file, it is also compressed into a ZIP archive.
 +=== Auto-overwrite import folders ===
 +Here, you can define pipe-separated folder names whose points are always overwritten when importing duplicates, e.g. favorites|geocaching.
 ==== Navigation/guidance ==== ==== Navigation/guidance ====
 === Auto GPS on navigation === === Auto GPS on navigation ===
 When navigation or guidance is started, the app turns GPS on, although it is turned off. When navigation or guidance is started, the app turns GPS on, although it is turned off.
 +=== Voice announcement times ===
 +Here you can set the time in seconds when the navigation commands are announced before a turn. Enter pipe-separated values. The default is 15|35|300.
 +
 === Guidance path symbol === === Guidance path symbol ===
 This parameter allows you to define the shape and size of the guiding line very precisely. Best to explain it on the default parameter. This parameter allows you to define the shape and size of the guiding line very precisely. Best to explain it on the default parameter.
Line 139: Line 153:
 {{:manual:advanced:customization:cfg_exmpl_guideline2.png?nolink|}}  {{:manual:advanced:customization:cfg_exmpl_guideline2.png?nolink|}} 
 guiding_path_symbol=-11|0|-14|-5|5|0|-14|5 guiding_path_symbol=-11|0|-14|-5|5|0|-14|5
-=== Line/text color === +=== Line/text background color === 
-FIXME to be added...+Allows setting the background color for the guidance line and texts.
 ==== Route planner ==== ==== Route planner ====
 === Route planner - interpolation saving === === Route planner - interpolation saving ===
Line 150: Line 164:
 === Offline logging of trackables === === Offline logging of trackables ===
 Support for logging trackables offline. To log the trackable online, use the log manager in the geocaching tools. Support for logging trackables offline. To log the trackable online, use the log manager in the geocaching tools.
-==== Hardware controlling ==== +=== Offlinizer max image size ==
-<WRAP center round todo 60%> +Here you can define the maximum size of a single image downloaded by the [[..:..:user_guide:geocaching:tools#geocaching_offlinizer|GC offlinizer]]. 
-to be continued... +=== Draw lines to geocache waypoints === 
-</WRAP> +Draws thin lines between a geocache and its waypoints on the map. 
- +=== Waypoint line width === 
-==== Tools ==== +Set the width of the cache - waypoint lines in dp  (1 dp is the default). 
-=== Hardware buttons when 'screen lock' ===+=== Hide waypoints below zoom === 
 +Define the zoom limit above which the GC waypoints are hiddenZoom 12 is the default
 +=== Geocaching icon pack === 
 +When a [[manual:advanced:customization:icons#geocaching_icons|custom GC icon pack]] is available, it displays here in the list.  
 +==== Hardware controls ==== 
 +=== Hardware buttons over 'screen lock' ===
 When enabled, hardware buttons can control the app even when the screen is locked. When enabled, hardware buttons can control the app even when the screen is locked.
 === Scroll to zoom === === Scroll to zoom ===
-When enabled, it is possible to zoom the map by scrolling controller (e.g. mouse when run on a PC) +When enabled, it is possible to zoom the map by scrolling controller (e.g. mouse when running on a PC)
-=== Record sensors data === +
-When enabled, all the phone sensors data are recorded in a file in Locus/data/sensors directory. +
-=== Enable TTS over BT SCO === +
-When enabled, TTS audio is played over a Bluetooth SCO module. +
-==== Tweaks ==== +
-=== Smooth interface === +
-Enables animations and other tweaks for more comfortable experience. We recommend to use this only on fast devices. +
-=== Allow 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.+
  
-FIXME TO BE CONTINUED... FIXME+In this section, the **keys** for various events can also be configured: **Screen on/off, GPS on/off, Map centering on/off, Map rotation on/off, Map zoom in/out** and **Screen lock toggle** - press a hardware button to map it for each action comfortably. 
 +=== Compass orientation offset === 
 +Define a degree offset to apply to the raw hardware compass reading to correct possible misalignment. 
 +=== Compass sensor filter strength === 
 +Adjust the smoothing factr for the hardware compass sensor (1 = no smoothing, 50 = max smoothing, 10 = default)
  
-===== Configuration file =====+==== 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>
  
-  * Since version 2.3.Locus Map offers advanced configuration options through //config.cfg// file stored in **Locus Map root directory** in your phone **memory**+=== Notify of disabled GPS === 
 +When turned on, the app notifies when the system's GPS is switched off. 
 +=== Keep GPS alive by toast === 
 +A "hack" attempting to keep GPS and the app running in the background despite the system battery optimization. Only partly functional. 
 +=== Separate NMEA records === 
 +When turned on, the app saves each day's NMEA data as a separate incremented file instead of one continuous file. 
 +=== Cursor speed without GPS === 
 +Useful for the app testing - simulated speed in m/s is applied to the map cursor when GPS is off.  0 = disabled. 
 +=== Sound notification max length === 
 +Here you can set a maximum duration for sound and song notifications (default: 5s. 0s = unlimited)  
 +=== Compass respects sensor settings === 
 +When enabled, compass orientation is controlled by Settings > Compass. When disabled, the internal device orientation sensor is always used. 
 +=== Keep screen on after gesture wake === 
 +When the screen is turned on by a proximity gesture, disable the automatic turn off if the timer is idle. 
 +=== Enable online search (old) === 
 +Adds the obsolete online search based on Google Places and other 3-rd party services to the offer of search methods. 
 +=== Record sensor 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. 
 +=== High precision mode === 
 +Adds two decimal places to the altitude, angle, distance and gradient values. 
 +==== Bugfixes ==== 
 +=== Limit geodetic line detail === 
 +Reduces computation o very long geodetic lines to prevent rare crashes on some devices. 
 +==== 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. You can find it in the URL of the Google Play page of the app:\\ {{:manual:advanced:customization:expert03.jpg?nolink |}}\\ 
  
-  * This file is automatically created on the Locus Map first start (if it does not exist from its previous installation). Data is loaded at start and stored back to the file in the end, so even if this file allows changing some settings that are also changeable in the application, the settings will not be lost. +=== Set a translation app === 
- +Select from the system chooser or installed translation apps.
-<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>+
manual/advanced/customization/config.1760624092.txt.gz · Last modified: by mstupka