1. Features and Objectives
Module Purpose
The Boot Animation module allows configuration of startup animation content on devices by uploading a ZIP package in a specified format. Configurations can be deployed based on device model or group.
Objectives
Standardize device startup screens to establish a unified brand image;
Support diversified customization to meet multi-device and multi-client needs;
Provide templates and guidelines to simplify animation creation and deployment;
Centralized configuration management with automatic application on devices to improve operational efficiency.
Primary Operations
Add Rule: Select "Model" or "Group", enter a rule name, and upload a compliant animation ZIP package;
Publish: After the rule is created, the system will automatically push the configuration to compatible devices. The new animation will play on device startup.
Secondary Operations
Edit: Supports replacing the ZIP package. Once saved, the updated animation will be pushed to devices automatically;
Delete: After a rule is deleted, the associated devices will revert to the default animation or be eligible to bind another rule.
Typical Use Cases
This module is applicable to all iMin devices, including Mobile POS, Desktop POS/KDS, Printer, Scale, and more. Each device can only be bound to one boot animation rule.
When bound to a "Group", devices will match animation resources based on their model;
Devices with unmatched models within a group will not receive the configuration;
KC provides templates and packaging guidelines to ensure ZIP file compliance.
Resource Requirements & Limitations
Image Format: PNG
Image Resolution: Follow your device screen specifications
Number of Images: Recommended range is 10–250
Note: For Swan 2 series, no more than 40 images is recommended (the system will prompt)
Single Image Size: ≤500KB
ZIP File Size: ≤10MB
Naming Rules:
Use English letters or numbers for ZIP and folder names; nested folders are not supported;
Image files must use a continuous 5-digit numeric format (e.g., 00000, 00001, ..., 00249)
Device Push Logic
For KMA and IMA devices that are online, the configuration will be pushed immediately;
For KMA devices that are offline, the configuration will be sent when the device reconnects;
For IMA devices, the configuration has a validity period. If the device does not come online within that period, the configuration will expire.
2. Main Operations
2.1 Add Rule
Description
The "Add Rule" function allows users to configure custom boot animations for iMin devices. By uploading a compliant ZIP package of animation resources, users can display corporate branding or store visuals during device startup—ensuring a unified visual style and enhancing brand perception.
The system supports creating boot animation rules by Device Model or Device Group. When selecting a group, the system automatically matches the animation resource to each device model within the group. Devices lacking model information or not supported will not receive the configuration.
Boot animation packages must be created and uploaded according to KC’s official template guidelines. File format and resolution must match the device model to ensure proper playback.
Steps
Enter Creation Page
On the "Boot Animation" module page, click the [Add Rule] button in the top-right corner to open the rule creation popup.
Fill in Basic Information
Rule Name (Required): Custom name, recommended to include brand or store name;
Target Scope (Required): Choose between Model or Group:
Model: Rule will apply only to the selected device model;
Group: The system will detect all models within the group and generate separate upload areas for each.
Upload Animation ZIP (Required):
A valid animation ZIP package must be uploaded for each model;
All upload fields must be completed—otherwise the system will block submission;
The ZIP content must follow KC’s file naming and size specifications (templates and guidelines available for download);
If the resource exceeds limits (e.g., Swan 2 supports up to 40 images), the system will display an error.
Submit Rule
Click [Submit], and the system will validate file compatibility and model mapping;
If validation passes, the rule status will be set to Unpublished, awaiting manual publishing;
Devices that do not support animations or lack required information will be excluded automatically.
Notes
This feature is available for all iMin devices, but only takes effect when the device has model information and supports boot animations;
If "Group" is selected, the system dynamically generates upload areas based on the actual device models in the group:
Each model must have a corresponding animation ZIP uploaded, or the rule cannot be submitted;
Upload areas cover Swan, POS, Printer, KDS, and other device types;
Animation resources must strictly follow KC platform specifications. Typical requirements include:
PNG image format; filenames must follow a five-digit numeric sequence from
00000.pngto00249.png;Single image ≤ 500KB, ZIP ≤ 10MB;
Nested directories within the ZIP are not supported;
Once submitted, the system will determine immediate delivery based on device type and online status (see Publishing section);
To modify resources or supported models, use the Edit function to update the rule.
2.2 Publish
Description
The "Publish" operation is used to officially deploy a created boot animation rule to compatible devices. Before publishing, rules remain in the “Unpublished” status. Only after successful publishing will devices receive boot animation configuration commands. The system determines the delivery strategy based on device online status, type, and whether model information is available.
This operation is suitable for scenarios where animation resources need to be pushed to devices immediately or after rule testing is confirmed correct.
Steps
Access the Publish Operation
In the "Boot Animation" module rule list, click the [Publish] button on the target rule row;
A confirmation window will pop up showing the basic information of the rule.
Confirm and Publish
Carefully verify the rule name, applicable scope (model or group), and animation resource;
Click [Confirm Publish], and the system will begin the delivery operation;
The rule status will be updated to "Published", and compatible devices will receive the configuration and display the new animation on the next reboot.
View Status
After publishing, you can view the status label ("Published" / "Unpublished") in the rule list;
To view animation details or update resources, use the Edit function.
Notes
The publish operation is irreversible. Please ensure the animation content and target scope are accurate;
If the rule scope is "Group", the system will map devices based on their model information:
Configuration will only be delivered to devices that match a supported model;
Devices without model info or without animation support will be automatically skipped;
Delivery behavior depends on device type:
KMA / IMA online: configuration delivered immediately;
KMA offline: configuration will be sent automatically once the device is online;
IMA offline: configuration has a validity period and will expire if the device remains offline too long;
To update animation resources after publishing, use the Edit function to upload a new ZIP package and submit again; the system will re-push the updated resource;
Each device can only be bound to one animation rule. If multiple rules exist, the most recently published one will take effect.
3. Secondary Operations
3.1 Edit
Description
The Edit function is used to update the content of an existing boot animation rule. When animation resources need to be replaced or the rule name needs to be modified, this can be done via the editing interface. The system supports editing the Rule Name and Uploaded ZIP Animation Resources, but the Applicable Scope (model or group) cannot be changed.
After saving, the system will immediately trigger the delivery process to update the animation resources, automatically replacing the existing configuration on the device.
Steps
Open the Edit Page
In the "Boot Animation" module, locate the target rule;
Click the [Actions] button at the end of the rule row, then select [Edit] to open the edit page.
Edit Content
The Model/Group field is read-only and cannot be modified;
You may update the following:
Rule Name: Supports renaming; it's recommended to keep it relevant to brand/model;
Upload ZIP File: Replace with a new animation ZIP package that complies with KC platform specifications.
A new ZIP file must be uploaded, or the system will prevent saving;
After uploading, the file name will be displayed; click the icon to delete and re-upload if needed.
Save Changes
Once confirmed, click [Save]. The system will:
Update the rule content;
Deliver the latest animation resources to compatible devices, replacing the previous configuration;
Keep the rule status unchanged—no need to publish again.
Notes
The model or group is bound during rule creation and cannot be modified;
ZIP upload is mandatory. If no new resource is uploaded, the system will return an error;
Once replaced, the system will automatically deliver the new animation resources:
KMA/IMA online devices: configuration takes effect immediately;
KMA offline devices: resources will be sent once the device reconnects;
IMA offline devices: configuration is valid for a limited time and will expire if not delivered in time;
After replacement, the original animation will be overwritten and cannot be recovered;
If only the ZIP content needs to be updated, you may retain the original rule name and applicable scope.
3.2 Delete Rule
Description
The Delete function is used to permanently remove a boot animation rule. When an animation configuration is no longer applicable or needs to be recreated, you can use the "Delete" operation to revoke its application on devices. Once deleted, the system will automatically clear the animation configuration on related devices, restoring them to the default boot screen.
This action is irreversible. Please ensure the rule is no longer needed before proceeding.
Steps
Initiate Deletion
In the boot animation rule list, click the [Actions] button on the target rule;
Select [Delete] to open the confirmation dialog.
Confirm Deletion
A confirmation popup will appear showing the rule name to be deleted;
Click [Confirm] to execute the deletion.
System Processing
Once deleted, the rule will be removed from the list;
The system will determine whether to immediately issue a clear command based on device type and status;
Devices previously associated with the rule will automatically revert to the default boot animation.
Notes
Deletion is non-reversible—make sure the rule is no longer in use before deleting;
Once deleted, devices that had the rule applied will no longer display the custom animation and will revert to the default;
Delivery logic is as follows:
KMA/IMA online devices: clear command is issued immediately;
KMA offline devices: will receive the clear command once back online;
IMA offline devices: clear command has a validity period—if the device remains offline past the expiry, the command becomes invalid;
If you plan to reuse the same animation later, please reconfigure it using Add Rule;
All deletion actions are recorded in system logs for future auditing.
4. Configuration Item Description
The configuration items in the Boot Animation module define the rule name, applicable scope, and uploaded animation resources. The details of each field are as follows:
Field Name | Required | Description |
Rule Name | Yes | Custom name for the current rule. It's recommended to include brand or usage keywords for easy identification and maintenance. |
Applicable Scope | Yes | Choose either Device Model or Device Group as the rule target: - Device Model: The rule only applies to devices of the selected model; - Device Group: The system will detect device models within the group and push the corresponding animation resource. Once submitted, the scope cannot be changed. |
Upload Animation ZIP | Yes | Upload an animation ZIP package based on the KC-provided template specifications. - For rules targeting "Device Model", only one resource package needs to be uploaded; - For rules targeting "Device Group", a ZIP package must be uploaded for each included model in the group. All uploads are required. Files must follow naming and size conventions or submission will fail. |
Delivery Rules
The delivery of boot animation resources depends on device status and type. The system handles delivery using the following logic:
KMA Devices
If online: Configuration is delivered and applied immediately;
If offline: Configuration will be cached and delivered automatically when the device reconnects.
IMA Devices
If online: Configuration is delivered and applied immediately;
If offline: Instructions have a validity period. If the device does not come online within this period, the command becomes invalid.
GMA Devices
Not supported for boot animation configuration.
Behavior Upon Activation
Once the rule is published, all applicable devices will display the configured boot animation upon next reboot;
If a device already has a boot animation rule applied, it will be overwritten by the newly published rule;
Upon deletion of a rule, affected devices will revert to the factory default boot animation;
If the rule is in an Unpublished state, it will not be delivered or applied to any device.