Difference between revisions of "Custom color schemes"

From Wazeopedia
(replacing https by http in external links (to not display the lock icon))
(All pages about Waze App have been obsoleted - redirection to Waze Help Center proposed)
Line 1: Line 1:
The Waze client is capable of displaying the map using various color schemes. Several color schemes are available in the client by default; users are also able to create their own custom color schemes or install custom color schemes created by others.
+
{{Notice|MsgID=ManualOnHC}}
 
 
{{construction
 
| contact    = http://www.waze.com/forum/viewtopic.php?uid=5415&f=276&t=98718&start=0
 
| contacttype = forum
 
| draft      = no
 
}}
 
 
 
== Default color schemes ==
 
 
 
Thirteen daytime color schemes are available in the Waze client:
 
* Default
 
* Green peace
 
* Minimalism
 
* Vitamin C
 
* The blues
 
* Mochaccino
 
* Snow day
 
* Twilight
 
* Tutti-frutti
 
* Rosebud
 
* Electrolytes
 
* Map editors
 
* Green fields
 
 
 
The daytime color scheme can be changed in Settings - Display Settings - Map Color Scheme.
 
 
 
Waze also includes one night color scheme. This is activated by choosing "Night" mode in the Settings menu, or by leaving "Auto" enabled and using Waze at night.
 
 
 
== Custom color schemes ==
 
 
 
A user can also create custom color schemes using a text editor.
 
 
 
=== Creating custom color schemes ===
 
 
 
Each color scheme is defined by a '''schema file'''. The schema file contains the color and size information for each road type and certain other features, such as Places, water features, map labels, and so forth.
 
 
 
The easiest way to create your own scheme is to start with one of the default schema files. To get to the default schema files, you'll need a file browser for your device (such as iFunBox for use with iOS devices, or ASTRO File Manager for Android).
 
 
 
*In iOS, the day schemes are found in '''User Applications » Waze » Waze.app » skins » default » day''' and its subfolders, and the night scheme is found in '''User Applications » Waze » Waze.app » skins » default » night'''.
 
 
 
{{anchor|Android files}}*In Android, the day schemes are found in '''SD Card (or your root folder) » Waze » skins » default » day''' and its subfolders, and the night scheme is found in '''SD Card (or your root folder) » Waze » skins » default » night'''.
 
 
 
You may wish to copy both directories to your computer to make it easier.
 
 
 
Within the '''day''' folder, there are several subfolders. Each subfolder contains a schema file, as does the '''day''' folder itself. The schema files correspond to the default schemes as follows:
 
* 1: The blues
 
* 2: Mochaccino
 
* 3: Snow day
 
* 4: Twilight
 
* 5: Tutti-frutti
 
* 6: Rosebud
 
* 7: Electrolytes
 
* 8: Map editors
 
* 9: Green peace
 
* 10: Minimalism
 
* 11: Green fields
 
* '''12: Default'''
 
* day folder: Vitamin C
 
 
 
To edit a schema file, open it in a text editor. Each schema file is a list of parameters – most relating to color and size. Color parameters are in #rrggbb hex color format (see [[wikipedia:web colors|web colors]]); some color parameters have two additional digits, controlling the alpha channel (transparency) of that particular feature (#rrggbbaa).
 
 
 
{| class="wikitable"
 
|-
 
! Parameter name !! What it does
 
|-
 
! colspan="2" | General
 
|-
 
| Map.Background || The background of the map.
 
|-
 
| Labels.Color || The color of road name label text.
 
|-
 
| Labels.Bgcolor || The outline/outer glow of all text labels – roads, cities, Places, etc.
 
|-
 
| Console.Foreground || unknown
 
|-
 
| Console.Background || unknown
 
|-
 
! colspan="2" | Road class: Roads and other lines
 
|-
 
| Freeways || Freeway
 
|-
 
| Primary || Major Highway
 
|-
 
| Secondary || Minor Highway
 
|-
 
| Highways || Primary Street
 
|-
 
| Streets || Street, Private Road, Parking Lot Road
 
|-
 
| Ramps || Ramp
 
|-
 
| Exit || unknown/unused at this time
 
|-
 
| 4X4 Trails || Dirt road / 4x4 Trail
 
|-
 
| Railroads || Railroad
 
|-
 
| Runways || Runway/Taxiway
 
|-
 
| Ferry || unused at this time?
 
|-
 
| Private || unused at this time
 
|-
 
| Parking || unused at this time
 
|-
 
| Pedestrian || Pedestrian Boardwalk
 
|-
 
| Trails || Walking Trail
 
|-
 
| Walkway || Stairway
 
|-
 
! colspan="2" | Road parameters
 
|-
 
| Class || Class ("Road")
 
|-
 
| Color || Color of road outline
 
|-
 
| Color1 || Color of road body
 
|-
 
| Color2 || Color of unmunched road body
 
|-
 
| Declutter{{ref|c|0}} || Possibly controls the zoom level at which the road type disappears?
 
|-
 
| Delta1{{ref|b|1}} || Thickness of road outline (in negative pixels)
 
|-
 
| Delta2 || Thickness of unmunched road outline (in negative pixels)
 
|-
 
| Thickness || Overall thickness of road (in nondimensional units)
 
|-
 
! colspan="2" | Area class: Places, cities, and water layer
 
|-
 
| Stations || Most Area Places
 
|-
 
| Cities || Cities (as seen in WME city layer)
 
|-
 
| Airports{{ref|a|2}} || Islands (not user-editable)
 
|-
 
| Hospitals || unknown/unused at this time
 
|-
 
| Malls || unknown/unused at this time
 
|-
 
| Parks || Area Places: Park, possibly others (Forest? Golf course?)
 
|-
 
| Rivers || unknown/unused at this time
 
|-
 
| Lakes || unknown/unused at this time
 
|-
 
| Sea || Water layer (not user-editable) and water-type Area Places (user-editable)
 
|-
 
| Shore || unknown/unused at this time
 
|-
 
! colspan="2" | Area parameters
 
|-
 
| Class || Class ("Area" or "Feature")
 
|-
 
| Color || Color of area polygon
 
|-
 
| Color1 || Color of area border
 
|-
 
| Declutter || unknown
 
|-
 
| Delta1{{ref|b|1}} || Size of area border (in pixels?)
 
|-
 
| Thickness || unknown/unused
 
|-
 
! colspan="2" | Other
 
|-
 
| Navigation.RouteColor || Navigation line to your destination (default: purple)
 
|-
 
| Navigation.PossibleRouteColor || unknown/unused at this time (default: light blue)
 
|-
 
| Navigation.StopPointColor || Navigation line to a stop point (default: pink)
 
|}
 
 
 
{{note|c|0}} What declutter does exactly is unknown. What is ascertainable is that the declutter value is a 32-bit signed integer – the freeway type has a declutter value of 2147483647.
 
 
 
{{note|b|1}} The delta values and their corresponding colors seem to operate differently for roads than they do for areas. For roads, Color1 and Color2 are apparently drawn on top of Color, so the delta values are negative – the Color "border" is apparently actually the bottom layer. For areas, Color1 is apparently drawn only past the edge of the area, so the delta value is positive – the Color1 "border" seems to be an actual border.
 
 
 
{{note|a|2}} Oddly enough. The "airports" (actually islands) layer is the only area layer drawn on top of the sea (water) layer.
 
 
 
=== Installing custom color schemes ===
 
 
 
==== iOS ====
 
Installing custom themes in iOS does not require replacing the default themes, so don't worry about creating a backup.
 
* Get an iOS file manager, such as [http://www.i-funbox.com/ iFunBox].
 
* In the file manager, open "Waze" in User Applications.
 
* In the Waze » Documents folder, if it's not already there, create a new folder named '''skins'''. Inside the skins folder, create a new folder called '''default'''.
 
* To install a day theme,
 
** In the Waze » Documents » skins » default folder, create a folder named '''day'''.
 
** Create a numbered folder inside the '''day''' folder that corresponds with the number of the included skin you would like to replace.
 
*** For example, to replace the "Tutti-frutti" theme, create a folder named '''5'''.
 
** Place your custom schema file inside the numbered folder you just created.
 
* To install a night theme,
 
** In the Waze » Documents » skins » default folder, create a folder named '''night'''.
 
** Place your custom schema file directly inside the '''night''' folder you just created.
 
** Note that this will replace the default night theme; only one night theme can be installed at a given time.
 
* To use an installed theme,
 
** Day schemes: In Settings » Display settings » Map Color Scheme, select the name of the theme you replaced. So, if you placed your schema file in folder '''5''', select "Tutti-frutti" in the app to use your custom scheme (there is currently no known way to rename schemes in the list in the app). Also, ensure that the client is in "day" mode, or leave it in "auto" and wait until daytime.
 
** Night schemes: Set the client to "night" mode or wait until nighttime.
 
* You can replace a schema file for a currently-selected theme even while the client is running, but to use a new version of a theme you are already running, you have to make the client reload the theme. To do this, switch away from and back to that theme. The quickest way to do this is to set the client to day/night mode and back.
 
* To uninstall a custom theme, delete its schema file. You can also temporarily disable a custom theme by renaming the schema file to something other than "schema".
 
 
 
==== Android ====
 
* Choose a scheme you wish to replace from [[#Android files|the built in list above]].
 
* Place the new schema file in the corresponding folder, replacing (or renaming) the original file.
 
* Alternatively you can directly modify the existing schema file ''(open with a text editor)'' with the changes you desire. You may also copy and paste the complete code of the scheme you want into the original schema file, replacing the original content.
 
** If there are sub-folders for specific zoom levels, you will have to either remove or modify the schema files in those directories as well.
 
 
 
=== Example custom color schemes ===
 
{| class="wikitable sortable"
 
|-
 
! Name !! By !! Details !! Screenshot !! Links
 
|-
 
| [[User:PesachZ/Color_schemes/Map_editors|Map Editors]]
 
 
 
{{User:PesachZ/Color_schemes/Map_editors|transcludesection=update}}
 
| [[User:PesachZ|PesachZ]]
 
| {{User:PesachZ/Color_schemes/Map_editors|transcludesection=details}}
 
|{{User:PesachZ/Color_schemes/Map_editors|transcludesection=screenshot}}
 
|{{User:PesachZ/Color_schemes/Map_editors|transcludesection=links}}
 
|-
 
| [[User:Sketch/Color_schemes/Friendly_WME|Friendly WME Theme]]
 
 
 
{{User:Sketch/Color_schemes/Friendly_WME|transcludesection=update}}
 
| [[User:Sketch|Sketch]]
 
| {{User:Sketch/Color_schemes/Friendly_WME|transcludesection=details}}
 
|{{User:Sketch/Color_schemes/Friendly_WME|transcludesection=screenshot}}
 
|{{User:Sketch/Color_schemes/Friendly_WME|transcludesection=links}}
 
|-
 
| [[User:PesachZ/Color_schemes/Map_editors night|Map Editors night]]
 
 
 
{{User:PesachZ/Color_schemes/Map_editors night|transcludesection=update}}
 
| [[User:PesachZ|PesachZ]]
 
| {{User:PesachZ/Color_schemes/Map_editors night|transcludesection=details}}
 
| {{User:PesachZ/Color_schemes/Map_editors night|transcludesection=screenshot}}
 
| {{User:PesachZ/Color_schemes/Map_editors night|transcludesection=links}}
 
|-
 
| [[User:Sketch/Color_schemes/WME_Neon_Night|WME Neon Night Theme]]
 
 
 
{{User:Sketch/Color_schemes/WME_Neon_Night|transcludesection=update}}
 
| [[User:Sketch|Sketch]]
 
| {{User:Sketch/Color_schemes/WME_Neon_Night|transcludesection=details}}
 
|{{User:Sketch/Color_schemes/WME_Neon_Night|transcludesection=screenshot}}
 
|{{User:Sketch/Color_schemes/WME_Neon_Night|transcludesection=links}}
 
|-
 
| [[User:PesachZ/Color_schemes/Night blue|Night Blue]]
 
 
 
{{User:PesachZ/Color_schemes/Night blue|transcludesection=update}}
 
| [[User:PesachZ|PesachZ]]
 
|  {{User:PesachZ/Color_schemes/Night blue|transcludesection=details}}
 
| {{User:PesachZ/Color_schemes/Night blue|transcludesection=screenshot}}
 
| {{User:PesachZ/Color_schemes/Night blue|transcludesection=links}}
 
|-
 
| [[User:DeepSouthDiver/Garminesque day|Garminesque day]]
 
 
 
{{User:DeepSouthDiver/Garminesque day|transcludesection=update}}
 
| [[User:DeepSouthDiver|DeepSouthDiver]]
 
|  {{User:DeepSouthDiver/Garminesque day|transcludesection=details}}
 
| {{User:DeepSouthDiver/Garminesque day|transcludesection=screenshot}}
 
| {{User:DeepSouthDiver/Garminesque day|transcludesection=links}}
 
|-
 
| [[User:DeepSouthDiver/Garminesque night|Garminesque night]]
 
 
 
{{User:DeepSouthDiver/Garminesque night|transcludesection=update}}
 
| [[User:DeepSouthDiver|DeepSouthDiver]]
 
|  {{User:DeepSouthDiver/Garminesque night|transcludesection=details}}
 
| {{User:DeepSouthDiver/Garminesque night|transcludesection=screenshot}}
 
| {{User:DeepSouthDiver/Garminesque night|transcludesection=links}}
 
|-
 
| [[User:Spookyx/New WME Cool Day|New WME Cool Day]]
 
{{User:Spookyx/New WME Cool Day|transcludesection=update}}
 
| [[User:Spookyx|Spookyx]]
 
|  {{User:Spookyx/New WME Cool Day|transcludesection=details}}
 
| {{User:Spookyx/New WME Cool Day|transcludesection=screenshot}}
 
| {{User:Spookyx/New WME Cool Day|transcludesection=links}}
 
|-
 
| [[User:bretmcvey/Serenity|Serenity]]
 
{{User:bretmcvey/Serenity|transcludesection=update}}
 
| [[User:bretmcvey|bretmcvey]]
 
|  {{User:bretmcvey/Serenity|transcludesection=details}}
 
| {{User:bretmcvey/Serenity|transcludesection=screenshot}}
 
| {{User:bretmcvey/Serenity|transcludesection=links}}
 
|- style="vertical-align:top;"
 
| [[User:Dave2084/Colour_Schemes/OS_OpenData|OS OpenData]]
 
 
 
{{User:Dave2084/Colour_Schemes/OS_OpenData|transcludesection=update}}
 
| [[User:Dave2084|Dave2084]]
 
| {{User:Dave2084/Colour_Schemes/OS_OpenData|transcludesection=details}}
 
| {{User:Dave2084/Colour_Schemes/OS_OpenData|transcludesection=screenshot}}
 
| {{User:Dave2084/Colour_Schemes/OS_OpenData|transcludesection=links}}
 
|- style="vertical-align:top;"
 
| [[User:Dave2084/Colour_Schemes/Classic_Google_Maps_UK|Classic Google Maps UK]]
 
 
 
{{User:Dave2084/Colour_Schemes/Classic_Google_Maps_UK|transcludesection=update}}
 
| [[User:Dave2084|Dave2084]]
 
| {{User:Dave2084/Colour_Schemes/Classic_Google_Maps_UK|transcludesection=details}}
 
| {{User:Dave2084/Colour_Schemes/Classic_Google_Maps_UK|transcludesection=screenshot}}
 
| {{User:Dave2084/Colour_Schemes/Classic_Google_Maps_UK|transcludesection=links}}
 
|- style="vertical-align:top;"
 
| [[User:Dave2084/Colour_Schemes/Audi_TT_At_Night|Audi TT At Night]]
 
 
 
{{User:Dave2084/Colour_Schemes/Audi_TT_At_Night|transcludesection=update}}
 
| [[User:Dave2084|Dave2084]]
 
| {{User:Dave2084/Colour_Schemes/Audi_TT_At_Night|transcludesection=details}}
 
| {{User:Dave2084/Colour_Schemes/Audi_TT_At_Night|transcludesection=screenshot}}
 
| {{User:Dave2084/Colour_Schemes/Audi_TT_At_Night|transcludesection=links}}
 
|-
 
| [[User:Chief5232/WME Map Editors Black|WME Map Editors Black]]
 
 
 
{{User:Chief5232/WME Map Editors Black|transcludesection=update}}
 
| [[User:Chief5232|Chief5232]]
 
|  {{User:Chief5232/WME Map Editors Black|transcludesection=details}}
 
| {{User:Chief5232/WME Map Editors Black|transcludesection=screenshot}}
 
| {{User:Chief5232/WME Map Editors Black|transcludesection=links}}
 
|-
 
| Example || Example || Example || Example || Example
 
|-
 
| Example || Example || Example || Example || Example
 
|-
 
| Example || Example || Example || Example || Example
 
|-
 
| Example || Example || Example || Example || Example
 
|}
 

Revision as of 12:23, 1 April 2015

Waze application user manual is no longer hosted on the Waze wiki. Please refer now to the Waze Help Center website.