Skip to main content

Enable Configuration

Configuration Method​

Modify the following configuration items through the FlyOS-FAST system configuration page or sys-config.conf:

###########################
# Klipper Screen: 0: no screen, 1: open screen
klipper_screen=0

###########################
# Fly Screen: 0: no screen, 1: open screen
fly_screen=1

After saving, restart the system for the configuration to take effect.

System Configuration Entry: FlyOS-Fast System Configuration Guide

OTA System Upgrade

For older systems upgraded via OTA, the fly_screen configuration item may not exist in sys-config.conf. To enable FLY Screen, manually add the following near the screen display configuration:

###########################
# Fly Screen: 0: no screen, 1: open screen
fly_screen=1

Configuration Description​

  • klipper_screen=1 enables KlipperScreen.
  • fly_screen=1 enables FLY Screen.
  • To use FLY Screen, set klipper_screen to 0.
  • If both klipper_screen=1 and fly_screen=1 are enabled, the system defaults to KlipperScreen.
  • For Fly-WiScreen 7-inch serial screen, enable moon2uart=1 according to the WiScreen documentation; do not use fly_screen to replace the serial screen service.

FlyScreen.conf Configuration​

FlyScreen reads the FlyScreen.conf configuration file after installation.

SystemConfiguration File Path
FlyOS-FAST/usr/share/printer_data/config/FlyScreen.conf
Other Hosts/home/<username>/printer_data/config/FlyScreen.conf

Default configuration example:

[FlyScreen]
language=zh_CN.json
font_path=HarmonyOS_SansSC_Medium.ttf
reverse_button=false
# about_developer_label=
Configuration ItemDefault ValueDescription
languagezh_CN.jsonSets the interface language file, located in the language directory of the FlyScreen project
font_pathHarmonyOS_SansSC_Medium.ttfSets the interface font file, located in the fonts directory of the FlyScreen project
reverse_buttonfalseSets whether to reverse button display or operation direction, usually keep default
about_developer_labelEmptyCustom developer description in the "About" page; if commented or left empty, uses built-in description

To customize the About page text, remove the leading # and fill in the content:

about_developer_label=Maintained by XXX

After saving, restart the FlyScreen service:

sudo systemctl restart FlyScreen.service

Common Issues​

Logo appears at startup, but the operation interface does not load​

  1. Enter the FlyOS-FAST system configuration page.
  2. Select FLY Screen or KlipperScreen based on actual needs.
  3. When using FLY Screen, confirm the following:
klipper_screen=0
fly_screen=1
  1. Save the configuration and restart the system.

FLY Screen does not display even when both are enabled​

This is normal priority behavior. When both klipper_screen=1 and fly_screen=1 are enabled, the system defaults to KlipperScreen. To display FLY Screen, disable KlipperScreen:

klipper_screen=0
fly_screen=1

WiScreen 7 Serial Screen does not display​

WiScreen 7 serial screen uses moon2uart. Please refer to the WiScreen 7 configuration and update documentation, and ensure the serial screen configuration is:

moon2uart=1
klipper_screen=0
fly_screen=0

WiScreen 7 Documentation: Fly-WiScreen 7-inch Screen

Loading...