Beetle·Launcher
YouTube Owners LAB

Installing

You only do this once. The exact commands are on the download tab of the home page.

It is easier from a phone

Put your phone on the same Wi-Fi as the car, connect to wireless ADB with one of these apps and install the APK straight from it. No computer, no cable.

  • atvTools — iPhone and iPad. Paid, about US$1, iOS 14 or newer.
  • Bugjaeger — Android. Free.
Bugjaeger is Android only. On iPhone use atvTools.

From a computer

  • Download the APK. Anyone can get the release from the download page; test builds need a download key.
  • Grant one permission. WRITE_SECURE_SETTINGS — needed to turn on accessibility and notification access. On this car wireless ADB stays on once granted.
  • Make Beetle Launcher the home app. You do this under Settings › System › General.

On this car wireless ADB stays on once it is granted. AdbKick is for the Sealion 7 — do not use it here.

AutoLaunch has been merged into AdbKick. AdbKick manual →

After that it checks for new versions on its own. It follows release builds only. You can also check by hand under Settings › About › About.

The screens

Swipe left and right between pages. Drag to reorder them under Settings › Display › Pages.

DashboardThe first page, where tiles go. Press and hold to edit; each tile stays in the cell where you put it. Tiles and layout are also set under Settings › Display › Dashboard.
Control switchesCar-function switches grouped into tabs. Choose which ones show under Settings › Car › Car functions › Edit items.

Captures from the Sealion 7 build (Beetle theme) — not photos of a car

Settings by menu

Open it from the settings button on the dock. The left column holds 8 groups; the row along the top of each is its tabs. Below follows the app's own order — 122 items as of release 2.22.

01

Display

Everything about how the home screen looks. Choose the overall design under Theme, then adjust that theme's colours, font, background and page-1 tiles under Dashboard, the swipe order under Pages, and the bar at the bottom (or top) under Dock.

Settings › Display ›Theme

Where you choose the launcher's overall design. Picking one under Theme changes the dashboard, dock and cluster together. Built-in themes you do not use can be removed with Delete themes. My car info panel and Theme-colour ambient keep the same value whatever theme you use.

Theme

Picks the theme. The dashboard and dock switch to that theme's look. On the Seal the cluster follows too: if it was on the stock cluster it changes to the Beetle cluster, unless you have put navigation on the cluster. Looks and tile positions are saved per theme.

Delete themes

Pick one or more built-in themes you do not use and remove them from the list. Beetle and custom themes are not offered. A deleted theme cannot be brought back; if you delete the one in use, the launcher switches to Beetle.

My car info panel

Shows or hides the info panel in the middle of the My car tile — how far you can go, money saved, your time together, and a one-line note. Tap the panel to move to the next one. Turn it off and the gear and car picture go back to their old places. Applies to every theme.

Theme-colour ambient

Sets the interior ambient lighting to the car colour closest to the current theme's signature colour. Only shown on the Seal, which has ambient lighting. Turning it off restores the colour and on/off state from before.

Settings › Display ›Dashboard

The current theme's name is at the top; the rows below are that theme's settings. Some rows only exist in some themes (background only in Beetle and Sunshine, no brightness in Mobile Suit). Speed tile gauges picks what the speed tile shows and how; Units picks the units for tyre pressure, torque and speed. Tile layout turns page-1 tiles on or off and sets their width. In the Mobile Suit theme the Cockpit cameras settings follow at the bottom — each window (front, left, right, rear) has its own values, and a window you have not touched uses the camera menu's values.

Reset this theme

Returns the current theme to how it shipped. Only what you changed in this theme is lost; other themes are untouched.

Auto text colour

Picks light or dark text automatically, to suit the background.

Font

The typeface for the whole launcher. It changes as soon as you pick one.

Tile style

How the tiles are drawn.

OptionsOutlineBox onlyNone

Top clock · date

Whether to show the clock and date at the top of the first page.

Clock

Whether times are shown on a 24-hour or 12-hour clock.

Options24-hour12-hour

Wallpaper

Picks the dashboard background picture. Only the Beetle and Sunshine themes have this row; other themes use their own background.

Full screen

Hides the Android status bar and uses the whole screen.

Hide the stock dock in other apps too

Hides the stock bottom dock even while another app such as TMAP is in front. While it is hidden, swipe up from the bottom edge to bring it back briefly. It cannot be changed while wireless ADB is closed. This row only appears on Android 10 head units.

Gauges

Needle motion

How quickly the gauge needles follow the value.

Speedometer

How the speed itself is shown.

OptionsDigitalAnalog

GPS speed

Speed measured by satellite. It differs from the car's own speed by a few km/h.

OptionsHiddenDigitalAnalog

Motor power

A dashboard gauge. On this car it draws motor power (kW), not RPM. If the car reports no value the dial hides itself.

OptionsHiddenDigitalAnalog

Regen braking

Whether the dashboard speed tile shows a regenerative-braking dial. If the car reports no value the dial hides itself.

OptionsHiddenAnalog

Units

Tire pressure

Whether tyre pressure is shown in bar, psi or kPa.

OptionsbarpsikPa

Speed

Whether speed is shown in km/h or mph.

Optionskm/hmph

Settings › Display ›Pages

The order of the pages you swipe between on home. The first two pages (Dashboard and Car functions, or Background home and Car functions in the Sunshine theme) are fixed and cannot be moved. The pages after them — Apps, Drive log and so on — can be reordered by dragging the ≡ handle. There are no on/off switches here: a page appears when its feature is turned on in its own settings.

Settings › Display ›Dock

The bar that is always on screen. Each of the climate, control and media rows can go to the bottom dock or a top dock, and you can add a row of car-function buttons and app icons. The dock's size, colour and row placement are saved per theme.

Dock row placement

Bottom

For each dock row — climate, control, media and car functions — choose whether it sits in the bottom dock or in a separate dock at the top of the screen.

OptionsBottomTop

Car functions in the dock

Car function row

Whether the dock carries a row of vehicle-function buttons. “Edit items” picks which ones.

Dock size

How tall the dock is.

OptionsSmallNormalLarge

Dock color

Dock colour. “Default” is the usual colour. Only shown in the Beetle theme, and saved per theme.

Show apps in dock

Whether app icons sit in the dock.

Icon labels

Whether names appear under the icons.

Media app

Which app the music controls talk to.

Dock apps

“Edit apps” picks what goes in the dock.

02

Cluster

Settings for putting the launcher’s cluster on the instrument cluster and styling it. Only shown on cars that have a cluster display.

Settings › Cluster ›Cluster

This group appears or disappears depending on whether the head unit has a second display for the cluster (Display 1), not on the model. The 2026 ATTO 3 has no such display, so the group is not there at all; on the Seal it appears only while the Beetle cluster is on. “Cluster display” puts the launcher’s cluster up; “Keep cluster view”, “Hold cluster” and “Stay above TMap” are ways of taking the screen back when the stock cluster or TMAP covers it. The background rows (background type, solid colour, darken photo, per-mode background) are always shown on the ATTO 3 and Dolphin; on the Seal only for the gauge cluster with the Beetle or Sunshine theme. The available-area test puts a ruler on the cluster for 30 seconds so you can see which part is actually visible; the full-screen test does the same after switching to full mode, then switches back. The now-playing test shows the track strip for 10 seconds. Among the gauges, the speedometer is digital or analog and the others are hidden or analog, up to five including the speedometer. The Seal’s cluster-screen choice and cluster layout are in the Navigation tab.

Cluster background per mode

Cluster display

On puts the launcher’s cluster screen on the instrument cluster; off hands it back to the stock cluster. Same setting as the dock’s Cluster button.

Now-playing strip

Whether the track now playing also shows on the cluster.

Now-playing position

Where on the cluster the track info appears: the centre or one of the four corners. The default is the centre. The top strip is drawn by the car itself, so things placed there can be covered.

OptionsCentreTop leftTop rightBottom leftBottom right

Cluster display mode

Whether the launcher’s cluster uses the cluster’s Small (small navigation) mode or its All mode. If TMAP turns on with it in All, try Small.

OptionsSmallAll

Keep cluster view

When the car flips the cluster back to its own mode — the right-hand steering-wheel button does this — put our mode back once.

Hold cluster

When another app covers the cluster, put our screen back a moment later. Nothing arbitrates that screen — whatever drew last is what you see — so putting it back is the only defence.

Stay above TMap

Draws the cluster as an overlay window so it sits on top of TMAP's own cluster.

Sport flame

The cluster catches fire in Sport mode. It redraws at 20fps, so turn it off if it costs too much.

Background type

Whether the cluster background is a solid colour or the stock background. A per-drive-mode photo, if set, shows first.

OptionsSolidStock background

Solid color

The colour used when the background is set to a flat colour.

Darken photo

Darkens the background photo so the numbers on top of it stay readable.

Options0%20%40%60%80%

Cluster gauges

Speedometer

How the speed itself is shown.

OptionsDigitalAnalog

GPS speed

Speed measured by satellite. It differs from the car's own speed by a few km/h.

OptionsHiddenAnalog

Motor RPM

Motor revolutions.

OptionsHiddenAnalog

Motor torque

Motor torque.

OptionsHiddenAnalog

Motor temperature

Motor temperature.

OptionsHiddenAnalog

Regen braking

Whether the cluster shows regenerative braking.

OptionsHiddenAnalog

03

Vehicle

What page 2’s car functions show, and the drive and charge logs.

Settings › Vehicle ›Car functions

Shows, for each category of page-2 car functions, how many are shown and how many hidden; functions this car does not support are not counted. “Edit items” lists them by category tab: for each one choose whether it shows, whether it is pinned to the top (★), and whether it goes on the dock. Automations are sequences that switch several functions on and off at once. “Add sequence” walks you through a name, a trigger (gear P, R or D; speed above or below a value; night or day; charging starts or ends; start-up; or manual only), the switches to turn on and the switches to turn off. A sequence runs once at the moment its trigger happens, and can also be run by tapping it in the Automation tab on page 2. “Load examples” adds examples such as parking, motorway, night and car wash, switched off. Use the switch in the list to enable one, and Edit or Delete to change it.

Style

How the page-2 controls are drawn.

OptionsBoxesIcons

Automation

Edit

Changes that automation sequence’s name, trigger, and the switches it turns on and off.

Settings › Vehicle ›Drive log

Turning on “Drive log” adds a Drive log page to home. “Speed”, “Power use”, “Route (GPS)” and “Cost” each switch one item in the log on or off. “Charge price” is shared by the drive-log cost, the charge log, the taxi meter and the My car tile, so it stays visible even with the log off. Turning on “Charge log” adds a Charging tab to the same page that records every charge. “Clear log” cannot be undone.

Drive log

Adds a Drive log page to home that groups each trip, start to switch-off, by day.

Speed

Keeps average and top speed and the speed graph in the drive log.

Energy use

Records power use in the drive log.

Route (GPS)

Records the route in the drive log. It shows exactly where you went, so it can be turned off on its own.

Cost

Shows what each trip cost in electricity, using the charging price below.

Charge price

Enter the price per kWh and charging cost is worked out for you.

Petrol price

Price of a litre of petrol, used for the “Money saved” figure on the My car tile: what this month’s distance would have cost in petrol, minus the electricity used.

Clear records

Deletes that whole log. This cannot be undone.

Charging log

Charging log

Adds a Charging tab to the drive log page that records every charge.

Battery capacity

The car's battery capacity in kWh, used to work out kWh from the percentage gained when consumption cannot be read.

04

Sound & voice

The launcher's announcement sounds.

Settings › Sound & voice ›Sound

Sounds that play when something happens: drive mode and gear changes, starting the car, and pressing a switch. Rows with a bar set the volume; all the way left is off. Greeting appears only when a Gemini key is set under System › API keys.

When drive mode changes

Mode voice

Says the drive mode out loud when it changes.

Sport exhaust sound

Plays an exhaust note in Sport mode.

Lower music during mode announcement

Ducks the music while the announcement plays. An app cannot go louder than the system volume, so the only way to be heard is to make the music quieter.

When shifting

Gear voice

Says the gear out loud when you change it.

On startup

Greeting

Greets you once when you start the car. On the day's first start between 4 a.m. and 11 a.m. it reads out the battery level and range; at other times it greets you to suit the time of day and the weather. Shown only when a Gemini key is set.

When pressing a switch

Switch feedback

Whether pressing a car-control switch plays a click sound or says what changed (“ventilation level 2”).

OptionsSoundVoice

Switch volume

How loud the switch feedback is. All the way left is off.

05

Nav & media

The navigation app, cluster options, and the internet radio and TV lists used by the media center.

Settings › Nav & media ›Navigation

Chooses which navigation app to use and what goes in the column on the right of the navigation screen. The chosen app shows inside the nav centre, opened from the dock or the apps page. Turning on Right column adds rows for Slot 1 to Slot 4, and each slot can be Empty, the media center or a dashboard tile (up to three tiles). When the car model is Seal or ATTO 3 (facelift), the cluster rows are here too; on the Seal, choosing the Beetle cluster adds rows for the turn-signal camera, the background and the cluster layout (drag elements to set their position and size). All the cluster rows are test features still being checked in real cars.

Navigation

Picks the navigation app shown in the nav centre. Installed stock navigation and navigation apps are listed; for anything else, “Other app…” lists every installed app. The chosen app is shown inside the launcher screen, which needs wireless ADB to be open.

Show media centre track on stock cluster

Sends the track playing in the media center to the media area of the stock instrument cluster.

Cluster screen (beta)

A test feature shown only when the car model is Seal or ATTO 3 (facelift). On the Seal you choose what the cluster shows — Stock, Navigation or Beetle cluster; on the ATTO 3 (facelift), turning it on puts the Beetle cluster on the cluster screen. It shares its setting with the Cluster button on the dock.

Turn-signal camera

Shown only on the Seal while the Beetle cluster is in use. When on, the stock camera on the side you are indicating is shown inside the Beetle cluster.

Wallpaper

Chooses the Seal Beetle cluster's background: Blank or Design background. Shown only with the Beetle and Sunshine themes; other themes always use their design background.

OptionsBlankDesign background

Cluster enemies

Shown only when the Seal's Beetle cluster uses the mobile-suit face. When on, enemy craft appear inside the cluster frame and close in and fire as you drive faster.

Right column

When on, the right 20% of the navigation screen becomes a column. Its four slots, top to bottom, can hold the media center or dashboard tiles. Shown only once a navigation app is chosen.

Settings › Nav & media ›Internet radio

The list of stations. Listening happens on the Radio tab of the media center (the Media button on the dock). Below, each station has a row with its name and address, marked “added” or “edited” where that applies, and its own Fix and Delete buttons. Addresses can be a stream URL, .pls or .m3u8.

Stations

Add station

Add one by hand with a name and a URL.

Import from file

Reads beetle-radio.txt from the Download folder into the list. A line of the form “id=URL” changes a built-in station's address; “name|URL” adds a station.

Reset to default list

Drops your edits to built-in entries and brings back any you hid. Entries you added yourself are kept.

Fix

Edits that entry's name and address. Built-in entries can be put back with Default. Delete, next to it, removes an entry you added and hides a built-in one.

Settings › Nav & media ›Internet TV

The list of channels. Watching happens on the TV tab of the media center. When a channel starts, a “do not watch while driving” notice covers the picture for a moment. Below, each channel has a row with its name and address and its own Fix and Delete buttons. Addresses are .m3u8 links.

Channels

Add channel

Add one by hand with a name and a URL.

Import from file

Reads beetle-tv.txt from the Download folder into the list. A line of the form “id=URL” changes a built-in channel's address; “name|URL” adds a channel.

Reset to default list

Drops your edits to built-in entries and brings back any you hid. Entries you added yourself are kept.

Fix

Edits that entry's name and address. Built-in entries can be put back with Default. Delete, next to it, removes an entry you added and hides a built-in one.

06

System

Permissions and defaults the launcher needs to run properly in the car. Right after installing, start with System setup.

Settings › System ›Normal

Pick the model at the top; below it are hardware usage, the day you got the car, start-up behaviour, language, region, default home and split screen. “Launcher autostart” starts off on the ATTO 3.

Vehicle

Model

Picks ATTO 3, ATTO 3 (facelift), Dolphin or Seal. The car picture on the dashboard tiles follows it. “Auto” uses what the car reports.

First day with the car

Enter the day you took delivery of the car. The «days together» count on the My car tile starts from this day as day 1.

Hardware usage

“View” opens a window with CPU, GPU and memory use, refreshed every second. Values the system will not give are shown as “—”.

Launcher autostart

At boot, or when the screen comes back on, brings Beetle Launcher to the front if the stock home is showing. It does not cover another app, such as navigation, that is already in front.

Pre-start camera on boot

Starts the turn-signal camera ahead of time when the car starts. If the turn-signal camera is off this does nothing. Needs wireless ADB.

Delay after boot

When “Pre-start camera on boot” is on, picks when the first attempt is made (now, 30 s, 1, 2 or 5 min). If it cannot attach it keeps retrying at growing intervals.

Language

Locked to Korean on the release build. Hold “English” for five seconds to unlock it and switch to English; Region below can then be changed too.

OptionsKoreanEnglish

Region

Chooses domestic (Korea) or overseas behaviour; navigation hand-off, the default radio and TV lists and the support QR codes follow it. On the release build it can be changed only after the language lock is released.

OptionsKoreaOverseas

Default home = Beetle Launcher

An indicator showing whether Beetle Launcher is the default home right now. If it is off, the home key does not come to the launcher.

Hand to another app

Sets the default home (the row reads “Set Beetle Launcher as home” while another app is home). “System chooser” opens Android's home-app picker; “Set via ADB” makes Beetle Launcher the home through wireless ADB. Either one also turns on re-applying it after each boot.

Split screen

Split screen ready

An indicator: whether this car can split the screen right now.

Split-screen support

This car cannot put the home app into split screen. Hand the home role back to the stock launcher and Beetle Launcher can go into a split.

Settings › System ›System setup

Work down the list right after installing. ① Press “Run” on Self-grant and choose “Always allow” on the car's “Allow USB debugging” prompt. ② If the Accessibility or Notification access light is off, press “On”. ③ Under System › Normal, set Beetle Launcher as the default home. Wireless ADB has only a light here, no button.

Self-grant

Connects over wireless ADB and grants the launcher permissions such as WRITE_SECURE_SETTINGS. When “Allow USB debugging” appears on the car screen, choose “Always allow”. Do this before accessibility and notification access.

Accessibility service

The permission the launcher uses to tap through stock screens for you. “On” registers it; if self-grant has not been done yet, it runs self-grant over wireless ADB first.

Wireless ADB

An indicator only: whether wireless ADB is open right now. There is no button to switch it on here.

Notification access (track info)

The permission used to read the title and cover of the track that is playing. “On” registers it; self-grant has to be done first.

Settings › System ›API keys

Weather needs no key. There is a row for the Gemini key, a row for moving keys by QR, and a group that backs the keys up outside the app so they can be recovered after a reinstall.

Gemini key

Enter a Gemini API key. “QR” reads just this key from a QR picture. With a key set, a start-up “Greeting” row appears under Settings › Sound.

All at once via QR image

“My keys as QR” shows the keys you have entered as a QR code. Put a photo of it into the other car's picture folder and press “Read” to load all the keys at once.

API key backup

Keep outside the app

Backs up your API keys outside the app. It also does this by itself each time a key is saved; the line underneath says whether a backup exists.

Restore from backup

Loads the API keys kept outside the app. Only empty keys are filled in. If it cannot read them, run self-grant under Settings › System first.

Delete backup

Deletes the key backup kept outside the app.

07

About

Version, updates and your agreement record, plus the support QR codes.

Settings › About ›About

The installed version and build, the last install result, this car's tag and device details, your agreement record, what the launcher does to the car, and update checks. When reporting a problem, a photo of this screen carries the version and tag.

Version

The version installed right now.

Build

The commit that build came from.

Tag

An eight-character tag made the first time the app ran (followed by your nickname if you set one). Include it in a photo when you report something so the car can be told apart. It is not personal data such as the VIN.

Vehicle SDK

The state of the connection to the car's SDK.

Default home

Which app is the default home right now (Beetle Launcher, not set, or the other app's name).

Device

The head unit's maker, model and Android version.

Display

This screen's size and density.

Your agreement

Agreement record

When you agreed and to what. “Read it again” shows the text you saw at the time.

What it does to the car

Reads · presses · never does

What this launcher reads from the car, what it taps, and what it never does.

★Freeze recovery

Shown only if the screen ever froze for more than 25 seconds and the launcher handed home back to the stock launcher; it shows when that last happened. To use Beetle Launcher as home again, take it back under System › Normal.

Release update

Checks for a new release. The download runs in the background and you are asked before it installs. On a test build it takes you back to the release.

Debug build update

Fetches a test build. It needs the developer password and a download key, and is never fetched automatically.

Settings › About ›Support

Just two QR codes for support. With the region set to Korea they are Naver Pay and KakaoPay; overseas, Buy Me a Coffee and Ko-fi. The head unit has no payment app, so scan them with your phone.

08

Log

Present only on the ATTO 3 release build. Where the home and back buttons go, and sending or clearing logs.

Settings › Log ›Log

On the release build this tab has three groups: where the home key and backing out take you, the current network address, and logs (nickname, tag, server address, send, cluster probe, clear). On test builds the tab is called “Debug” and more diagnostic rows follow.

Dock Home/Back buttons

Home button

When the home key brings Beetle Launcher up, whether to stay on Beetle Launcher or pass on to the stock home.

OptionsBeetle LauncherStock home

Back button

When you back out of or close another app and Beetle Launcher shows again, whether to stay on Beetle Launcher or pass on to the stock home.

OptionsBeetle LauncherStock home

Network

Address

The network and IP address the car is using now, one line per path (Wi-Fi, USIM data, …); addresses that cannot be reached from outside are marked so. Shows “none” when there is no connection.

Log

Nickname

A name put at the front of log file names (up to 16 characters). It also appears after the tag on the About screen.

Tag

An eight-character tag made the first time the app ran (followed by your nickname if you set one). Include it in a photo when you report something so the car can be told apart. It is not personal data such as the VIN.

Log server address

Where logs are sent. It starts with the address built into the app; you can change it or clear it. When cleared, logs are only saved as a file on the unit.

Cluster probe

Reads cluster-side settings and system details and shows them in a window. Nothing is changed; part of it is read over wireless ADB, so “Allow USB debugging” may appear.

Clear logs

Deletes the stored logs and starts collecting afresh straight away.

When it does not work

The home button still opens the stock screen

The default-home setting has been cleared. If “Default home app = Beetle Launcher” under Settings › System › General is off, tap “Switch back to Beetle Launcher” just below it.

Wireless ADB keeps turning itself off

Run self-grant once under Settings › System › System prep and turn on the row that switches it on when the launcher starts. Accessibility must be on.

The weather is empty

There is no weather key. Add one under Settings › System › API keys. Everyone gets their own.

It will not update

Check under Settings › About › About — it tells you why it failed. This car blocks installs from a file manager. Put the phone on the car's Wi-Fi and install the APK from the download page with atvTools (iPhone) or Bugjaeger (Android) over wireless ADB.

Anything else

Which screen, what you did, what happened — with those three the cause can usually be found without the car. → Report a bug