1. Home
  2. IP Video Telephony
  3. GXV33xx Series
  4. GXV3380
  5. Customization
  6. GXV33XX Series - GUI Customization Web Tool Guide
  1. Home
  2. IP Video Telephony
  3. GXV33xx Series
  4. GXV3370
  5. Customization
  6. GXV33XX Series - GUI Customization Web Tool Guide
  1. Home
  2. IP Video Telephony
  3. GXV33xx Series
  4. GXV3350
  5. Customization
  6. GXV33XX Series - GUI Customization Web Tool Guide

GXV33XX Series - GUI Customization Web Tool Guide

  • Updated on December 28, 2021

Grandstream GXV33XX IP Multimedia series Phones allow users to customize the GUI desktop layout as well as GUI configurations on the phone, offering users with flexibility and control. The GUI configuration includes displaying/hiding applications, configuring parameters on the phone with specific requirements, controlling the display appearance, enabling/disabling some functions and much more.

This document describes how to use the Grandstream Graphical GUI Customization Web Tool to customize the GXV3350/GXV3370/GXV3380 GUI settings and applications. This tool allows users to do the following configurations on the GXV33XX IP Multimedia Phone for Android:

  • Turn on/off applications
  • Set up parameters
  • Personalize phone display
  • Turn on/off certain functions on applications

The Grandstream Graphical GUI Customization Tool is available through the following link:



GXV33XX LCD GUI customization tool is available as a web service, users need to access to below URL in order to generate the GXV Customization file that will be uploaded to the phone: http://tools.grandstream.com:8081

First you will need to select the phone model by clicking on the GXV33XX phone:

Figure 1: GUI Config Tool Web Interface

The GUI Config Web Tool contains 7 sections that will be used to build the customization file that is going to be generated in the end using the “Export Configurations” button shown in the following figure (all three models have the same sections and in the later steps we have selected the GXV3370).

Users can also import generated customization file using the “Import Configurations” button:

Figure 2: GUI Config Tool Web Interface

Steps below explains how to generate and upload the customization file to the GXV33XX:

  1. Access GUI Config Tool link.
  2. Set up the parameters and application configurations.
  3. Generate the GXV33XX custom file “GXV33XXcust” by clicking on “Export Configuration” button.
  4. Put the generated custom file “GXV33XXcust” on your HTTP/HTTPS/TFTP server.
  5. Go to GXV33XX Web GUI 🡪 Maintenance 🡪 Upgrade 🡪 Config File 🡪 CUST File.
  6. Set the Download mode and enter the customization file path under “GUI Customization File URL”.
  7. Reboot the phone to trigger the upgrade.
  8. After booting up, GXV33XX LCD shall display the customized GUI.


Config Settings

Under the GXV33XX Config tool web interface 🡪 Config Settings, the user can choose what Settings to enable/disable from the web tool. See the following figure.

Figure 3: Config Settings

In this section, users have the following Settings that can be enabled or disabled:

  • Contact Settings
  • Background Settings
  • Layout Settings
  • Call Settings
  • Screensaver Settings
  • Language and Keyboard
  • Taskbar Settings

For instance, if the user unchecks “Contact Settings”, the related tab will be disabled and greyed as shown on figure below:

Figure 4: Disabling Contact Settings

Contacts Settings

The “Contacts Settings” section on the Config Web Tool, as can be seen, provides the parameters for Contacts Import/Export, phonebook download and LDAP/Call History configuration for the GXV33XX.

Figure 5: Contacts Settings Page

Background Settings

In the Background Settings page, the admin can select screen image from the available ones or import it by clicking on “Upload” under “Select image”.

Figure 6: Background Settings Page


To prevent the user from changing the background image on the device, admin needs to check “Not allow changing wallpaper” option in the Background Settings Page.

Layout Settings

This settings page gives the admin the ability to set the graphic design wanted, by changing and modifying the visual structure of the GXV33XX user interface. See the following figure.

Figure 7: Layout Settings Page

Under this section, the administrator can do the following operations:

  • The number of desktop pages can be increased by clicking on or decreased by clicking on .


The maximum of desktop pages allowed is 9 pages for GXV3370 and GXV3380 (including Dialpad) and 8 on GXV3350 as Dialpad page isn’t supported on this model.

  • The administrator can enable/disable Displaying the Dialpad and specify the App install Screen number (only for GXV3370 and GXV3380).
  • The administrator can also upload an android 3rd Party application using the “Add 3rd Party App” option. By clicking “Upload” button, and entering “Display Name” in the pop-up window, then uploading the apk file, finally clicking “Add”. The 3rd-party application with the icon and name will be displayed on the panel.
  • The administrator can change the applications and widgets location on the pages, and in order to move an application to another page, the administrator can drag and drop the needed applications to “No more applications” bar in the bottom in order to be able to put them in a different desktop page. Please, refer to the following figures:
Figure 8: Changing App’s Location – I
Figure 9: Changing App’s Location – II
  • In addition to the available built-in apps and the 3rd party app, the admin can add widgets to the GUI of the GXV33XX by clicking on “Add Widget button” button. Please, refer to the following figure:
Figure 10: Adding Widget
  • Users can also configure shortcuts in the right of the layout. Please, refer to the following figure:
Figure 11: App Shortcut

Call Settings

This is the page where the administrator can set One-Way Call Function Button (Hold, Start Video, Transfer…etc.) which will be will be directly displayed in the call screen, as well as Conference Call Function Buttons which will be directly displayed in the conference call screen, with 4 items by default.

Please, refer to the following figures:

Figure 12: Call Settings Page on GXV3350

Figure 13: Call Settings Page on GXV3370/GXV3380


On the GXV3350 we can add only 2 items to the Displayed Items section, while on the GXV3370/GXV3380 up to 4 items could be added, as shown in the figure above.

Screensaver Settings

This is the page where the administrator can configure screensaver parameters, such as the source of the screensaver (Default, local or from internet), screensaver start time, Turn off LCD Time, and the Interval between pictures. Please, refer to the following figure:

Figure 14: Screensaver Settings Page

Language and Keyboard Settings

This section is used for disabling language setting or for choosing the phone’s display language among the languages available under “Language Settings” and can upload a custom language file. The admin has also 4 Keyboard choices: “Android Keyboard(AOSP)”, “Google Pinyin IME”, “Japanese IME” or “Custom Input Method” (To allow the admin to upload a customized Keyboard) available under “Default Input Method”.


You can upload a keyboard APK file when “Default Input Method” is set to “Custom Input Method”.

Figure 15: Language and Keyboard Settings Page

Taskbar Settings

Admin can disable or customize the taskbar in the top of the screen by clicking on “Edit” to choose the wanted functions in order to allow the user to easily enable/disable multiple programs and quickly switch among them by clicking the appropriate icon on the taskbar. See following figure.

Figure 15: Taskbar Settings Page

Was this article helpful?

Need Support?
Can’t find the answer you’re looking for? Don’t worry we’re here to help!
Contact Support

Leave a Comment

We use cookies in order to give you the best possible experience on our website. By continuing to use this site, you agree to our use of cookies.