Skip to content

Settings Menu

Eduardo Moreno edited this page Feb 23, 2019 · 94 revisions

Note: Screenshots may look slightly different to what you see as they were taken whilst using X11 as opposed to EGL rendering. However they are accurate as at the Alpha2 (January 2019) release.


Handedness of traffic

Which side of the road do you drive on in your region?

  • Left-hand drive
  • Right-hand drive

Safety Warning

☐ Don't show again


☑ Show clock

Toggle display of the clock on the Crankshaft home screen (requires reboot).

☐ Start with classic gui

☐ Use big clock in classic gui (only if Show Clock enabled)

☐ Hide menu toggle button

☐ Show cursor (needs reboot)

Transparency Tile GUI


Brightness Day


Brightness Night


Media player defaults

☐ auto play

Auto playback last played song on startup if available

☐ Show player window on auto play


Frame rate

  • 30 FPS
  • 60 FPS

Sets the refresh rate of the screen in Frames Per Second

Note: Some users have reported issues using 60 FPS.


  • 480p
  • 720p ^
  • 1080p ^

Change this according to the resolution of your display.

^ 720p and 1080p modes require activation within Android Auto's developer mode (hidden by default) on your phone.


Layer index: 1

Overrides how the Android Auto video feed is drawn. Typically 1 or 2 in EGL mode or 0 in X11 mode. This is set automatically by Crankshaft.

Margin width: 0

Margin height: 0

Sets the video output overscan. HDMI screens should be left at 0, VGA screens can use this to eliminate clipping or black bars.

Android Auto Screen DPI


This changes the size of the objects on the screen (Android Auto, not the main gui), soft buttons, cards, etc ... Larger values will increase the size.


Audio channels

☑ Music channel

☑ Speech channel

Disable audio channel if you need custom audio routing e.g. via A2DP or AUX.

Output backend

RT audio / Qt

This setting may help with audio stuttering when using Android Auto over WiFI.

Pulseaudio input / Output Device

This will select the devices used by PulseAudio. Make sure you save the settings upon initial setup and/or if you change your audio hardware. This is needed to get the volume bars working.

Note: If PulseAudio did not detect any audio hardware, you get the note in the box. If audio hardware was detected, but not defined as PulseAudio's default hardware in /etc/pulse/client.conf, not selected is shown.

Playback Volume


Sets the audio volume

Note: To prevent an ineffective initial volume level, if the current volume is lower than STARTUP_VOL_MIN (in /boot/crankshaft/ during startup, volume is reset to 50% as a failsafe.

Capture Volume


Set the volume for your audio input device (mic).

Note: To prevent an ineffective initial volume level, if the current volume is lower than STARTUP_VOL_MIN (in /boot/crankshaft/ during startup, volume is reset to 50% as a failsafe.

If audio device is changed pulseaudio daemon will restart - reconnect bluetooth is needed to work again!



☑ Enable touchscreen

Toggle touch screen input for the Raspberry Pi.

☐ Show cursor (needs reboot!)

Enable a cursor for use with touch pad remote controls

Button Controls Android Auto

  • ☐ Play [X]
  • ☐ Pause [C]
  • ☐ Toggle play [B]
  • ☐ Next track [N]
  • ☐ Enter [Enter]
  • ☐ Previous track [V]
  • ☐ Home [H]
  • ☐ Phone [P]
  • ☐ Call end [O]
  • ☐ Voice command [M]
  • ☐ Left [Left]
  • ☐ Right [Right]
  • ☐ Up [Up]
  • ☐ Down {Down]
  • ☐ Scroll wheel [1] / [2]
  • ☐ Back [Esc]

Allows mapping of keyboard keys to Android Auto actions.

Button Controls Media Player

☐ Enable Controls

  • Play [X]
  • Pause [C]
  • Toggle Play [B]
  • Home [H]
  • Next track [N]
  • Previous track [V]
  • Next album [A]
  • Previous album [L]

Allows mapping of keyboard keys to Crankshaft Media Player actions.

BT / WiFi

Bluetooth settings

☐ Set pairable for 120 seconds after startup

If checked and a Bluetooth adapter was selected under the CS HW tab, Crankshaft broadcasts that it is open for Bluetooth pairing requests for 2 minutes after startup. Beyond the initial 2 minute period, pairing mode can be enabled by tapping the BT-Pairing button located at the top, right of the Crankshaft home screen

[Remove all paired devices]

Removes all Bluetooth pairs to clean up the system. Pushing save is not needed.

Wifi Setup

  • Country Code

Select the code that reflects the WiFi radio regulations in your area

☑ Enable

Start system in Hotspot Mode

☐ Enable

Show network info on mainscreen

Wifi Mode

◦ Client Mode • Run Hotspot

Force Client Network To Use

not available

Network Information

IP-Address (eth0) X.X.X.X

IP-Address (wlan0) X.X.X.X

SSID: CRANKSHAFT-NG|<Your Phone/Router>

Password (default) 1234567890

CS Base

System Information

  • Version
  • Build Date
  • Free Memory
  • CPU Frequency
  • CPU Temp

NOTE: This information is not realtime.

CSSTORAGE Information

Displays details of your USB storage device labeled CSSTORAGE (if present during boot)

Screen Orientation

  • Normal / 180°

Start Mode Openauto

  • EGL / X11

Sets the graphics display mode OpenAuto should use.

Boot Screen

  • Animation
  • Classic
  • Custom

System Updates

[Check Now] Notify on main screen if available


Screen Off Timeout

120 Seconds

Minutes of inactivity before the screen goes black if no device is connected. Connecting a device will prevent this timeout from activating. Disconnecting your device will restart it.

Note: If your screen goes to sleep tap the screen to reactivate and restart the timer. Also other inputs like keyboard can wake up the screen by hitting the "anykey" :-)

☐ Disable

Permanently disable the timeout

☐ use screensaver

Allows the use of a screensaver instead of just turning off the screen

Shutdown Timeout

60 Minutes

If a device does not connect to Crankshaft, the number of minutes before Crankshaft will automatically shut down. Connecting a device will prevent this timeout from activating. Disconnecting your device will restart it.

☐ Disable

Disable the shutdown timeout

Changes in this tab needs reboot to take effect!

CS Env

GPIO Settings (only working if enabled)

☑ Enable GPIO

  • Dev Mode 4

  • Invert Pin 15

  • X11 Pin 13

Standalone GPIO Settings (working if set)

  • Android Pin ---

  • Ignition Pin ---

  • Delay 60

  • Rearcam Pin ---

  • DayNight-Pin ---

  • Unused ---


  • Disabled
  • Enabled

[Create Log]

Create a file for submission with any issues you need to create

Custom Brightness Command


Auto Day / Night

Note: Requires configured realtime clock (RTC) hardware.

  • Start Day 8

The hour when Day mode starts

  • Start Night 18

The hour when night mode starts

☑ Disable


System time



[Set current time now!]

[NTP Sync]

Hardware Setup

Set up additional hardware attached on top (HAT) devices you may have installed, including selected digital to analogue converters (DAC) and realtime clocks (RTC).


Raspberry Pi - Onboard

This list contains the DAC devices Crankshaft can set up. If a supported DAC is detected, it will be pre-selected from this list.

To set it up your DAC, check the box Exec setup on save and save.

Note: If you select custom the default input and output devices are removed from Pulseaudio /etc/pulseaudio/client.conf and volume control sliders will not work because Crankshaft doesn't know which device should be controlled. The config for Crankshaft-supported DACs will be removed from /boot/config.txt.



This list contains the RTC devices Crankshaft can set up. If a supported RTC is detected, it will be pre-selected from the list. To set it up select your RTC, check the box Exec setup on save and save.

Note: If you select none the RTC config will be removed.



To set your timezone after selecting it, check the box Exec setup on save and save.


  • none
  • enabled

Toggle RPi-Cam module

☐ FlipX

☐ FlipY

Rotation ° 0

Resolution 720

Adjust RPi-Cam (reversing camera) settings


  • none
  • builtin
  • external

Here you can select the internal Raspberry Pi Bluetooth adaptor, an external Bluetooth adapter, or none.


  • disabled
  • enabled (This can cause damaged sdcard - use at your own risk!)

Provides the option to overclock (OC) your MicroSD card to potentially improve system performance.


  • none
  • enabled (tsl2561)

Enable a device using the AMS TSL2561 Ambient Light Sensor, if such a device is connected to your system

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.