AGAMA Car Launcher

Instruction. Version 2.5.0

AGAMA Car Launcher is an application, which replaces the main screen of your Android device (hereinafter in the instructions launcher or Agama). It is designed for convenient control of the system in the car. The Agama launcher is ready for use immediately after installation, and its initial configuration takes no more than 2 minutes. Nevertheless, Agama has deep integration with many Android services and third-party applications and allows you to customize the main screen of your car very flexibly depending on your preferences and the style of the surrounding interior.
The first launch of the launcher will warn you that you are using a TRIAL version. You can simply close this window and continue to use all the features of Agama. The trial version of the launcher has no restrictions in comparison with the full version and differs only in this information window. Thanks to this, you can evaluate all the features of the launcher and check its operation on your device even before the purchase.

Agama starts working immediately after installation, but as it is configured, the launcher may ask for permission to provide access to certain Android functions. Please grant the launcher the necessary rights so that it can work fully.

Permissions that the launcher will need to work:
1. Access to device location data: for speedometer, odometer and weather
2. Access to the system settings of the device: to change the brightness of the screen
3. Access to photos, multimedia and files on the device: for the player to work and save settings
4. Access to notifications for 3 AGAMA services:
4.1. AGAMA Music Service: for information on the music track and player interaction
4.2. AGAMA Navigation Service: for information from the navigator
4.3. AGAMA Notification Service: for information on the number of notifications
License activation is only possible through Google services. To purchase a license, click the BUY button and then follow the instructions of Google payment services. Google itself provides you with possible payment methods and processes payments. The Agama developer does not have access to this data and

under no circumstances receives information about your credit cards and other payment information. The purchase of a license is carried out in a single payment, the license is valid for an unlimited time.

After making the payment, the full version of Agama will be activated. The purchase information is stored in your Google account and can be restored at any time even after the removal of Agama. The full version can be activated on other devices with one Google account. For example, you can buy a license on a mobile device, and then activate it on the device in the car, provided that there is one Google account on different devices.

To activate an already purchased license on the device, just click the "BUY" button (as in the case with the purchase). The system will check if the license has already been purchased for this account, then the full version will be activated immediately, no additional payment will be required.

Possible questions:
1. Question: Is paying a license a one-time payment?
Answer: Yes, it is a one-time payment. Pay once and get a license forever.
2. Question: I can’t activate the license, it says "Your version does not work with Google payment services" or "Billing error"
Answer: You need to install the application from Google Play, check that the latest updates to the Google Play Games or Google Play services are installed
3. Question: I do not have Google Play on the device. How do I activate the full version?
Answer: You cannot activate it otherwise currently. Alternative purchase and activation methods are not supported.
AGAMA has 5 customizable buttons for launching applications (the 6th APPS button launches the application menu and cannot be changed). Each button has its own submenu. Thus, you can configure up to 23 applications to run. All submitted application lists.

Initially, the AGAMA buttons are not configured and will not produce any action. To configure the button, make a long click on it. In the menu that appears, you can change the icon of the button, the name of the button and designate the application that will be launched when you click on it. To configure applications in the submenu, click the "+" button.

1. The application assigned to the button automatically takes first place in the submenu of this button.
2. Sometimes they can only be displayed due to the fact that yesterday. Vivid such programs will not be visible in the application menu and, therefore, they cannot be assigned to a button. In some cases, these shortcuts to launch will help you.
AGAMA has flexible design options. AGAMA, or by a long click on the brightness icon. Editing topics has two modes: “LIGHT” and “EXPERT”.

The "LIGHT" mode has a minimal and sufficient set of tools for adjusting the color gamut. We recommend this setting mode for most users.

The EXPERT mode has more complex and flexible settings, allows you to change the color of almost any element.
AGAMA has 6 information icons. Depending on your choice, any 2 icons (and only 2 icons!) Can be displayed in the main interface of the main screen. Select “Connection Information”, check two icons from the list provided.
AGAMA can display the current weather in your area. Information is provided by, it requires a GPS connection and an Internet connection. AGAMA transfers the coordinates of your position via the Internet to the service and in response receives the name of your area, current weather and 5-day weather forecast with 3 hour intervals. If there is a GPS signal and an intervention connection, the weather information is updated every hour, as well as when the launcher starts and exits the "sleep" mode. If there is no Internet connection or GPS, the launcher will display information from the weather forecast that was received during the last connection to the service.

It is impossible to change the source of weather information, as well as the frequency of its updates. If this information does not suit you, or your device does not have a permanent Internet connection, you can hide the weather information and replace it with a notification counter. You can do this in the launcher settings in the "Notifications" menu item. The notification counter shows the number of notifications in the status bar of the android system
AGAMA has integration with Google Voice. When you click on the button with the microphone, the Google voice search built into the Android system is launched. It is currently not possible to assign another voice assistant to this button. In the AGAMA settings, this "quick button" can be replaced by:

1. Parking time - the indicator counts the time since the car stopped (GPS speed = 0)
2. Quick launch of the camera - a special icon in the form of a camera, on the click of which the application launch with the camera can be assigned
AGAMA can control the system volume of Android. To do this, you can use the buttons with the image "+" and "-" on the main screen, or swipe around the screen, simulating the rotation of the volume knob. In the AGAMA settings, you can turn off the volume control on the swipe, or the volume control from the shell completely.

Note: AGAMA can only adjust Android system volume. Unfortunately, many head units have their own external amplifier, the volume of which is not connected with Android and is regulated only through the MCU (handles or buttons on the device itself). In this case, AGAMA cannot control the volume of the MCU and control will only be possible in the ways provided by the device manufacturers.
AGAMA can control the brightness of the screen (not on all devices). To do this, Agama must have access to change the system settings of Android. Change the brightness by pressing the brightness button (icon of the sun or moon) in the lower right of the screen. There are 3 modes: day, night and automatic mode (indicated by the additional letter "A" on the icon). In automatic mode, the screen brightness switches automatically to day or night mode, depending on the time of sunrise and sunset. The time of sunset and sunrise is determined by the GPS coordinates and updated once a day, the Internet is not needed for this.

In the launcher settings in the "Screen brightness" section, you can separately set the screen brightness for day and night, as well as turn off the automatic brightness mode.

Some devices do not support screen brightness control. In this case, you can use the brightness adjustment by applying a mask (configured in the agama settings). This method of controlling brightness affects only the launcher itself and does not apply to other applications.
Agama has the function of sleep mode, which can be activated by an event: turning off the external power, turning off the screen (set in the settings). Hibernation affects only the launcher itself, "freezing" its internal processes, and does not affect the Android system in any way.

When going into sleep mode, the following occurs:
- The connection between the launcher and the GPS module of the device is disconnected
- Agama background services stop and close (music service, navigation service, notification service)
- Interface update methods stop

When you exit sleep mode, the following occurs:
- The connection of the launcher with the GPS module of the device is turned on
- Agama Background Services Launched
- Launcher launcher animation starts
- Updated all interface data
- Weather updated

Many modern head units do not turn off when the ignition is turned off, but go into hibernation mode with minimal energy consumption. At the same time, when the ignition is turned on, the OS instantly “wakes up” and is ready for operation. For this mode, we recommend using "sleep mode when the screen turns off" in the settings of Agama. At the same time, when the ignition is turned on, the launcher will appear on the screen with a beautiful starting animation, and all data will be updated.
Agama can replace your standard launcher (home screen) on the device and can be called up by pressing the "Home" button.

There are several ways to set the launcher as the default home screen:
1. Immediately after installing Agama, click the "Home" button, then the system will ask which launcher you want to install by default. Choose Agama
2. In the Android setting, go to the "Applications" - "Application Settings" - "Main Application" - select the Agama launcher (may vary in different versions of Android)
3. In the Android settings in the search bar, enter: "Main application", "Home screen" or "Desktop" (depending on the version of Android). Next, go to the default launcher settings and select Agama.
4. In the Agama settings, go to the "Install launcher as a home screen" item. Agama will try to open the Android settings menu to select the default launcher.

In order to remove Agama as a home screen, do one of the following:
1. One of the above methods, go to the default launcher selection menu and select another launcher
2. Uninstall the Agama application. You can do this from the Android settings, or from the Google Play application
Sometimes, when loading Android, the launcher may not be in the foreground, but hidden by other launched applications (for example, Radio). The "Run on top of all windows" mode is necessary so that after launching the launcher or leaving the launcher from the "sleep" mode, agama always appears on the screen above. This is achieved in a simple way. After starting the system, Agama monitors the "focus" of its window (whether it is on top or not) and if the focus is lost, the launcher imitates pressing the "Home" button and again returns focus. Focus tracking stops when you click on the launcher screen, or 30 seconds after the start.

The "over all windows" mode is only possible when the launcher is set as the default home screen.
AGAMA does not have its own built-in player, but the launcher is able to receive information from third-party players and control their playback. This is achieved through the integration of the launcher and player through the notification center of the Android system. A third-party player transfers information about the music track to the notification center (the top curtain in android, called by swipe down from the status bar), agama intercepts this information and displays it in its interface. Therefore, if the player does not transmit information to the notification center, then Agama will not be able to get data on the track being played. For example, many stock players installed by default on the device do not transmit such information and therefore do not work with Agama. To configure the player by default, long-click on the bottom panel with the player on the Agama main screen. From the list of programs, select your music player.

AGAMA is tested and interacts well with players: Poweramp, Spotify, Stellio, Yandex.Music, AIMP, VLC, MX Player, jetAudia, PCRadio and many others.

In the default player selection list, you will also be offered the option of a Poweramp Direct Integration player. This mode directly integrates the Agama launcher with the Poweramp player, expanding their interaction functionality. If you are using a Poweramp player, we recommend this particular communication mode.

1. Agama will display information on the frequency of the FM receiver and switch radio stations if the developer of the Radio application made sure that his application interacted with the Android notification center. From a software point of view, the Radio application is the same player and can work as well.
2. Agama can work simultaneously with several music players. At the same time, he will display information and control the player that is currently active. Selecting a default player is needed for control priority if no player is active.
AGAMA does not have its own built-in navigator, the launcher is able to receive information from external applications with navigation: Google Maps, Sygic, Yandex.Navigation, 2GIS.

To configure the navigator, follow these steps:
- Turn on the navigator widget in the launcher interface
- Long click on the widget - launch the widget settings window
- Select a navigator from the list with which you will work
- Go to notification settings and check access to notifications for AGAMA Navigation service.
- Close the settings window. If everything is configured correctly, the inscription "IS CONNECTED" will appear on the widget

To start route guidance, follow these steps:
- Launch the navigator
- Get directions
- Minimize the navigator to work in the background
- Make sure that the navigator sends route information to the upper tray (curtain with notifications)

1. Navigator widget works on Android 5.0 and higher
AGAMA has the function of automatically switching embedded widgets depending on external events. To enable the auto switch mode, click on the central widget, then on the "AUTO" button. You can also customize widget switching scripts based on events. To configure, make a long click on the "AUTO" button
AGAMA has a built-in function to automatically launch third-party applications at startup. To configure autorun, go to the application menu and make a long click on the icon of the application that you want to start automatically. Next, you will be prompted to select the period of time after which the application should be launched after starting AGAMA. Do not set the autorun of two or more applications at the same time, we recommend setting a minimum of 5 second break between starts, which will reduce the load on the system. You can install up to 5 applications in autorun.

1. The android system does not know how to run applications in the background, so applications always run on top of the launcher. If you want Agama to return to the main screen after auto starting applications, set the Agama application to autorun and set the launch time longer than other applications.