The Prefs Tab

General Preferences

The Preferences tab allows users to control various options for the application as a whole and individual tabs within the application. The preferences are organized into a set of sub-tabs, each of which has preferences for a particular aspect of the application. The screen shot below shows the Preferences tab with the General preferences selected. This is what you'll see when you first choose the Prefs Tab.

The table below describes each of the preferences.

Preference Description
Wake on Tab change Lets the user determine whether clicking on a tab should cause a refresh and consequently wake up the car if it is sleeping. If this box is unchecked, clicking on a tab while in sleep mode will not refresh the data (meaning it will be stale). This allows the user to look at the last data displayed in a tab without waking the car up.
Idle Threshold Allows the user to set the Idle Threshold. This determines how long VisibleTesla will look for inactivity before entering Sleep or Daydream mode. The default is 15 minutes. It can be set to anywhere between 1 and 90 minutes.
Load data for Controls how much data should be loaded. You can load the last 7, 14, or 30 days, the last week, the last month, all of your data, or none of your data. If you select to load none of your data, the graph will start out empty and add data points as usual. Normally this preference will be honored the next time VisibleTesla is launched. Changing this preference will not cause existing graph data to reload. However, if you change this preference before going to the Graphs tab, it will be honored immediately.
Email for notifications This is the email address to which all notifications will be sent. This includes the Unplugged? command in the Scheduler Tab.
Overview Range Type Let's you select which range you'd like to be displayed in the Overview Tab. The choices are Rated, Ideal, and Estimated.
Charge Time Type Let's you select how to display the remaining charge time in the Charge Tab. If you select Remaining, you'll be presented with the number of hours, minutes, and seconds until the charge is complete. If you select Complete At, you'll be presented with the time at which the charge will be complete. For example, if it is currently 10:05:53 and there are 3 hours and 5 minutes remaining, the Charge Tab will show 13:05:53.
Submit Anonymous Data This is an opt-in program that allows you to submit anonymized charge statistics back to so that they can be shared with the community. No information will be shared unless you explicitly enable this option. Please refer to the documentation on Charge Monitoring and Exporting Data.
Include Location If you have chosen to share anonymous charge data, you have additional control over what is shared. In particular, you can choose whether or not you want to share where the charge took place. If you choose to include location information using the Include Location check box, then a modified version of your charge location is sent along with your submission. Since most people frequently charge at home, this modified location will prevent your home address from showing up repeatedly in the public information. If it did, the relationship between UUID and owner might be determined. Instead, each time you submit data, your location is randomized. Your actual home location will never be one of these randomized locations. Just how much the location is altered is determined by the Coarse/Fine slider.
Coarse/Fine This slider determines how much your location is randomized before it is submitted to (assuming you opted in). If you think of a latitude (or longitude) as a number with some number of decimal places, the slider determines how much information after the decimal point will be preserved. For example, if you choose 3, then the third decimal place and beyond will be modified. If you choose 1, then the first decimal place and beyond will be modified. There are normally 6 digits after the decimal place, so there is no option to submit unmodified data.

Note: If you charge at a supercharger this randomization doesn't really help since supercharger locations are public and the fact that you used a supercharger is noted in your submission. In this case, the actual supercharger location is submitted.

Location Preferences


Preference Description
Collect Location Data Checking this box causes VisibleTesla to store location data that it collects from the Location Tab or the Graph Tab. This option is required is you want to use the Trips tab.
Seconds Between Stored Samples Location data can come in quite rapidly when viewing the Locations tab. VisibleTesla doesn't store every single piece of data. You can specify the minimum time between samples using this slider. Note that this does not impact how frequently data comes into VisibleTesla. It only specifies how much data is stored.
Distance Between Stored Samples Location data can come in quite rapidly when viewing the Locations tab. VisibleTesla doesn't store every single piece of data. You can specify the minimum distance between location samples using this slider. Note that this does not impact how frequently data comes into VisibleTesla. It only specifies how much data is stored.
Stream when possible Checking this box tells VisibleTesla to stream location data opportunistically even when not on the Location Tab. When the car is not moving this will have no net effect. When the car is moving, additional location data will be captured. On very short trips or when the app is daydreaming, you may not see additional data.

Graphs Preferences


Preference Description
Ignore Graph Gaps Checking this box causes VisibleTesla treat gaps in graph data specially. In particular, lines will not be displayed when between points that are far apart indicating gaps in the data.
Minutes constituting a gap Sets the threshold for how far apart points need to be to constitute a gap in the data. This can range from 10 minutes to an hour.
Limit Vampire Stats If you enable this preference, statistics relating to Vampire loss will only be collected during the specified period. This can be useful if you just want to look at overnight losses, or just losses during the day.

Scheduler Preferences


Preference Description
"Safe" includes: These checkboxes allow the user to determine what sorts of power safety checks should apply to commands in the Scheduler UI that may consume significant power. You may select Minimum Battery Power or Vehicle Plugged-In or both or neither.

Vehicle Data Overrides

VisibleTesla gives you the ability to override certain information that comes from Tesla's servers. For example, you can change the color of your car or the kind of wheels it has. This can be useful to explore different looks, but it can also come in handy if Tesla's servers report the wrong information. This can happen if you change options on your car after it is delivered. A typical example of this is that you change the wheels form 19's to 21's. You may even change them on a seasonal basis. .

The options listed below allow you to override these settings and remember them across different runs of the application. The Active checkbox for each option indicates whether that option is actually in force. For example, if you set the color to Blue, it won't actually take effect unless you check the Active box. The setting of the Active checkboxes is remembered, so next time you start the app, overrides will still be active.

Note: Changes to the override settings may not take effect until you quit and relaunch the app.


Override Description
Wheels Allows you to specify the type of wheels to be displayed. From Car means that the setting should not be overriden.
Color Allows you to specify the car color. From Car means that the setting should not be overriden.
Units Allows you to specify the units to use when displaying speed, distances, and temperatures. From Car means that the setting should not be overriden.
P85+? Allows you to specify whether the car is actually a P85+. Some P85's that were upgraded to P85+ are not described properly by Tesla's servers. This allows you to fix that. From Car means that the setting should not be overriden.
Roof Type Allows you to specify the type of roof to display. Note that if you choose a Panoramic roof and you don't actually have one, it will always show as closed. From Car means that the setting should not be overriden.

Advanced Preferences

There are a variety of advanced preferences that most users should never have to use. They are described in the table below.

Preference Description
Proxy Settings
Enable Proxy Allows the user to specify an HTTP proxy (not SOCKS) to be used for all operations. To use this feature, check the "Enable Proxy" checkbox and fill in valid settings for "Proxy Host" and "Proxy Port". Your network administrator will provide these settings to you. You must quit and restart VisibleTesla for these settings to take effect.
REST Services Settings
Enable REST Services VisibleTesla makes very limited functionality available via web services. Please read about it in the Other Topics documentation. These services are turned off by default. There are three preference settings:
  1. Enable REST Services: To enable this functionality, you must check this box. If you don't, all requests will be ignored.
  2. Port: The service will be available on port 9090 unless you change the value in the field. If you do change the value, it will not take effect until VisibleTesla restarts.
  3. Password: You must set an authorization code (password) in order to access the service. Enter your code into the field and then press the Set button. Your new code will not be set unless you press the button. Once you do, the new code will be in force immediately.
If you are not comfortable with the direct use of web services, please leave this functional disabled.
Custom Page Source This is the URL of a directory which contains custom HTML pages designed by you. It is up to you to host these files at this URL. The URL may refer to a local folder or a URL on a web server. You can use a public Dropbox folder as a web server if you'd like. Local folders are specified with URLs of the form: file:///PATH_TO_FOLDER. These pages will be served up by VisibleTesla's built-in web server under the URL: See the Other Topics page for details.
API Keys
Use custom Google API key If you are not a Google Maps developer, please ignore this option. Using this options provides no new functionality. If you are a developer with a valid API key issued by Google, you may enter it here and it will be used by the application instead of the default key. This may provide you with higher usage limits on Google Maps related actions. If you check this box and supply an invalid key, the Location tab and the Trips tab will fail without notice. If you are a developer and want to learn more about the Google Maps API and how to get a key, please refer to Google's documentation.
Use custom MailGun key Advanced users may supply their own API key for MailGun. This is the service used to send notifications via email. It is up to you to set up an account with MailGun and agree to their terms of service. Supplying your own key provides no new functionality. It does, however, provide better privacy and may help to avoid usage limits. If you don't supply your own key, a default account is used and logging information is available to the author of VisibleTesla who administers the account. Please do not use this setting unless you are comfortable acquiring your own MailGun key.
Font Scaling
Font Scale Users who are experiencing problems with fonts being too large and not displaying properly may use the new Font Scale setting to adjust the font size. Set the font scale to a value lower than 100% to reduce VisibleTesla's font size. Some experimentation may be necessary to find the right scaling. You must quit and restart VisibleTesla before the setting will take effect.
Offer Experimental Versions If this box is checked, the app will offer experimental versions as part of the normal process of checking for updates. The box is not checked by default. If an experimental version is available and this box is not checked, it will not be offered to the user.
Log Level This setting does not affect the operation of the application. It determines how much diagnostic information about the application should be stored. You need never change this unless requested to do so by the developer as part of diagnosing a problem with VisibleTesla.
Show App Files VisibleTesla stores its data files in a location appropriate to the platform. This location differs between Mac, Linux, and Windows. In normal operation you should never need to know or care where these files are. The only time you might care is if you encounter a problem. In that case, the files stored in this folder may help in finding the problem. Pressing the Show App Files button will take you to these files.

The Advanced preferences tab is broken up into the sections mentioned above. The screen shot below shows the "Other preferences" section.