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.

Notes:
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 openweathermap.org, it requires a GPS connection and an Internet connection. AGAMA transfers the coordinates of your position via the Internet to the openweathermap.org 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

Tip:
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.

Notes:
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)

Notes:
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.

Tip:
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.