# Configure POS Home Settings

### Downloading the Default poshomesettings.xml File

Download the default file and rename it to poshomesettings.xml by removing any suffixes.

[**Default poshomesettings for Q1**](https://ftp.wizarpos.com/advanceSDK/poshomesettings_Q1_default.xml)

[**Default poshomesettings for Q1V2**](https://ftp.wizarpos.com/advanceSDK/poshomesettings_Q1V2_default.xml)

[**Default poshomesettings for Q2/Q2A7/Q2P**](https://ftp.wizarpos.com/advanceSDK/Q2_Q2A7_Q2P-poshomesettings.xml)

[**Default poshomesettings for Q3**](https://ftp.wizarpos.com/advanceSDK/Q3-poshomesettings.xml)

[**Default poshomesettings for Q3K**](https://ftp.wizarpos.com/advanceSDK/poshomesettings_Q3K_default.xml)

[**Default poshomesettings for Q3PRO**](https://ftp.wizarpos.com/advanceSDK/Q3PRO-poshomesettings.xml)

[**Default poshomesettings for Q3Mini**](https://ftp.wizarpos.com/advanceSDK/Q3mini-poshomesettings.xml)

[**Default poshomesettings for Q8PRT**](https://ftp.wizarpos.com/advanceSDK/Q8PRT-poshomesettings.xml)

### File Description

* **For Q1 Models:** Use the 'android' style.

{% code overflow="wrap" lineNumbers="true" %}

```xml
<?xml version="1.0" encoding="utf-8"?>
<!--
style: launcher theme, Q1 default is 'android'.
indicatorColor: Page indicator color of the selected page.
itemBackground: The style 'android' does not support this feature.
pageStatus: page indicator location, up / down
topBackgroundColor: the background color of favoritebar
versionCode: When update, the versionCode should larger/equals than the previous in the system.
-->
<desktop
    style="android"
    indicatorColor="4FA2FF"
    itemBackground="false"
    pageStatus="down"
    topBackgroundColor="00BFFF"
    versionCode="2" >

    <!--
    Some special application you want to define.
    cols: How many cols display in one page, Q1 default is 4.
    iconheight: Q1 default is 96.
    iconwidth: Q1 default is 96.
    rows: How many rows display in one page, Q1 default is 3.
    -->
    <applications
        cols="4"
        iconheight="96"
        iconwidth="96"
        rows="3" >

        <!--
        class: app class name, if only one entrance of the package, it can be empty.
        col: at which column.
        package: app package name.
        page: at which page.
        row: at which row.
        columnSpan: icon item span columns, default is 1.
        type: app or clock, default is app. Type clock will display a digital clock in home screen.
        -->
        <application
            class=""
            col="1"
            columnSpan="2"
            package="com.moji.mjweather"
            page="3"
            row="1"
            type="app" />
    </applications>
    <!--
    Define favorite bar.
    cols: How many columns.
    -->
    <favoritebar cols="3" >

        <!--
        class: app class name, if only one entrance of the package, it can be empty.
        col: at which column
        package: app package name
        -->
        <application
            class="com.example.testEditText.FirstActivity"
            col="3"
            package="com.example.testEditText" />
        <application
            class=""
            col="2"
            package="cn.kuwo.player" />
        <application
            class=""
            col="1"
            package="com.sohu.inputmethod.sogou" />
    </favoritebar>
    <!-- Define hidden applications. -->
    <hiddenapplications>

        <!--
        package: app package name, if only set this, all the entrance of this package will be hide; if only one entrance, just set package name.
        class: app class name, if only one entrance of the package, it can be empty.
        -->
        <application
            class=""
            package="com.example.realfullscreensample" />
    </hiddenapplications>

</desktop>
```

{% endcode %}

* **For Q1V2 Models:** Use the 'clarity' style.

{% code overflow="wrap" lineNumbers="true" %}

```xml
<?xml version="1.0" encoding="utf-8"?>
<!--
style: launcher theme, Q1V2 default is 'clarity'.
indicatorColor: Page indicator color of the selected page.
itemBackground: Whether set icon item background color.
pageStatus: page indicator location, up / down
versionCode: When update, the versionCode should larger/equals than the previous in the system.
-->
<desktop
    style="clarity"
    indicatorColor="4FA2FF"
    itemBackground="true"
    pageStatus="down"
    versionCode="2" >

    <!--
    Some special application you want to define.
    cols: How many cols display in one page, Q1V2 default is 2.
    iconheight: Q1V2 default is 72.
    iconwidth: Q1V2 default is 72.
    rows: How many rows display in one page, Q1V2 default is 3.
    -->
    <applications
        cols="2"
        iconheight="72"
        iconwidth="72"
        rows="3" >

        <!--
        backgroundColor: icon item background color.
        class: app class name, if only one entrance of the package, it can be empty.
        col: at which column.
        package: app package name.
        page: at which page.
        row: at which row.
        columnSpan: icon item span columns, default is 1.
        type: app or clock, default is app. Type clock will display a digital clock in home screen.
        -->
        <application
            backgroundColor="20A2DE"
            class=""
            col="1"
            columnSpan="2"
            package="com.moji.mjweather"
            page="3"
            row="1"
            type="app" />
    </applications>
    <!-- This feature was removed in style 'clarity'. -->
    <favoritebar cols="0" />
    <!-- Define hidden applications. -->
    <hiddenapplications>

        <!--
        package: app package name, if only set this, all the entrance of this package will be hide; if only one entrance, just set package name.
        class: app class name, if only one entrance of the package, it can be empty.
        -->
        <application
            class=""
            package="com.example.realfullscreensample" />
    </hiddenapplications>

</desktop>
```

{% endcode %}

* **For Q2/Q2A7/Q3/Q3K Models:** Use the 'metro' style.

{% code overflow="wrap" lineNumbers="true" %}

```xml
<?xml version="1.0" encoding="utf-8"?>
<!--
style: launcher theme, Q2/Q2A7/Q3/Q3K default is 'metro'.
indicatorColor: The RGB value of the page indicator color of the selected page.
itemBackground: Whether set icon item background color.
pageStatus: page indicator location, up / down
title: Merchant or store name, or other.
titleGravity: title location, left / center / right.
topBackgroundColor: the RGB value of the background color of title and favoritebar
versionCode: When update, the versionCode should larger than the previous in the system.
-->
<desktop
    style="metro"
    indicatorColor="4FA2FF"
    itemBackground="true"
    pageStatus="down"
    title="WizarPOS"
    titleGravity="left"
    topBackgroundColor="00BFFF"
    versionCode="2" >

    <!--
    Some special application you want to define.
    cols: How many cols display in one page, default is 2.
    iconheight: Q2/Q2A7 default is 144, Q3 default is 96, Q3K default is 72.
    iconwidth: Q2/Q2A7 default is 144, Q3 default is 96, Q3K default is 72.
    rows: How many rows display in one page, Q2/Q2A7 default is 4, Q3/Q3K default is 3.
    -->
    <applications
        cols="2"
        iconheight="144"
        iconwidth="144"
        rows="4" >

        <!--
        backgroundColor: icon item background color.
        class: app class name, if only one entrance of the package, it can be empty.
        col: at which column.
        package: app package name.
        page: at which page.
        row: at which row.
        columnSpan: icon item span columns, default is 1.
        type: app or clock, default is app. Type clock will display a digital clock in home screen.
        -->
        <application
            backgroundColor="20A2DE"
            class=""
            col="1"
            columnSpan="2"
            package="com.moji.mjweather"
            page="3"
            row="1"
            type="app" />
    </applications>
    <!--
    Define favorite bar.
    cols: How many columns.
    -->
    <favoritebar cols="3" >

        <!--
        class: app class name, if only one entrance of the package, it can be empty.
        col: at which column
        package: app package name
        -->
        <application
            class="com.example.testEditText.FirstActivity"
            col="3"
            package="com.example.testEditText" />
        <application
            class=""
            col="2"
            package="cn.kuwo.player" />
        <application
            class=""
            col="1"
            package="com.sohu.inputmethod.sogou" />
    </favoritebar>
    <!-- Define hidden applications. -->
    <hiddenapplications>

        <!--
        package: app package name, if only set this, all the entrance of this package will be hide; if only one entrance, just set package name.
        class: app class name, if only one entrance of the package, it can be empty.
        -->
        <application
            class=""
            package="com.example.realfullscreensample" />
    </hiddenapplications>

</desktop>
```

{% endcode %}

### Updating Process via TF Card or Thumb Drive

1. **Folder Creation:**
   * On a TF Card: Create a folder named **'\wizarpos\homesettings\homesettings\_XXX\\**'. 'XXX' is typically 'wizarpos', matching the **'ro.wp.logo**' property value. Or the same with Thumb Drive as below.
   * On a Thumb Drive: Create a folder named **'\cloudpos\\**'. This is supported in PosSysAssistant app versions greater than 2.11.8.
2. **Copying the File:**
   * Copy **'poshomesettings.xml**' into the folder you created.
   * The update process is similar to installing an APK from a TF card or thumb drive.

### Update via WizarView

1. **Upload to WizarView:**
   * In WizarView, add a new parameter file named **'poshomesettings.xml**'.
   * Navigate to Applications > Application.
   * Click the '+' icon, then fill in the details in the pop-up edit window.
   * Select 'param' type, input package name (**'com.wizarpos.android.home**') and parameter file name (**'poshomesettings.xml**').
   * Click the 'Commit' button.
2. **Configuring the File:**
   * In Applications > Application, click the 'Search' button.
   * Select the parameter file from the list.
   * Click the 'config' icon and select 'Upload'.
   * Choose the file for upload and click 'Commit'.
3. **Pushing the Configuration:**
   * Follow the WizarView user manual for configuring and pushing the configuration to a terminal.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://smartpossdk.gitbook.io/cloudpossdk/faq/firmware/configure-pos-home-settings.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.