Hybrid Font - Noto Sans SC + Inter

KernelSU/Magisk systemless font module that maps Android Latin font files to Inter and common Simplified Chinese fallback font files to Noto Sans SC.

Documentation

• 中文文档
• Research notes

Contents

• Build
• Release
• Install
• Safe First Test
• Compatibility Notes
• ColorOS 16 Notes
• Font Mapping
• Sources

Build

python -m pip install -r requirements.txt
python tools/build.py

The build writes two flashable zips:

• dist/hybridfont_notosc_inter-v1.2.1.zip: full compatibility package.
• dist/hybridfont_notosc_inter-v1.2.1-safe-disabled.zip: conservative package with the module disabled by default and without DroidSansFallback* replacements.

Release

GitHub Actions publishes releases automatically when a version tag is pushed:

git tag v1.2.1
git push origin v1.2.1

The tag must match module/module.prop version as v<version>. For example, version=1.2.1 requires v1.2.1.

The release workflow can also be started manually from the GitHub Actions page. If no tag is provided, it uses v<module.prop version>.

Install

Install the generated zip from KernelSU Manager or Magisk. On KernelSU, /system file replacement requires a mounting metamodule such as meta-overlayfs, because KernelSU delegates system overlays to metamodules.

For first tests on any ROM, use the safe-disabled package. After installation, confirm the module appears in KernelSU Manager, enable it manually, then reboot.

Reboot after installation.

Safe First Test

Use this package first:

dist/hybridfont_notosc_inter-v1.2.1-safe-disabled.zip

This package is disabled by default and avoids the wider fallback replacements that are more likely to vary between ROMs. It is intended for first tests on any device or ROM.

Recommended flow:

1. Flash the safe-disabled package in KernelSU Manager.
2. Reboot once while the module is still disabled.
3. Confirm the module appears in KernelSU Manager.
4. Enable the module manually.
5. Reboot again and test system UI, launcher, browser, WeChat, settings, and lock screen.

If boot fails or SystemUI crashes, enter KernelSU safe mode or recovery and create this file:

/data/adb/modules/hybridfont_notosc_inter/disable

You can also remove the module directory:

/data/adb/modules/hybridfont_notosc_inter

This module does not write real system partitions, so the expected failure mode is a recoverable module boot issue rather than a hard brick.

Compatibility Notes

The v1.1.0 Zygisk experimental package is deprecated because global file-access hooks can break WebView or embedded web content in some apps.

For detection-sensitive environments, use the overlay package with your root solution's module unmount/hide features or a dedicated FontLoader-style compatibility module instead of the deprecated Zygisk package.

ColorOS 16 Notes

ColorOS 16 can break WebView or browser text rendering if a module replaces the ROM's whole font*.xml fallback chain. This module does not mount fonts.xml, /system/etc/fonts.xml, /system/etc/font_fallback.xml, or any other system font XML file by default.

The package still includes a root-level fonts.xml as a reference for MFGA-style mapping, but KernelSU/Magisk will not overlay it onto /system unless another module explicitly does so.

For ColorOS 16, use this module as the font resource package. If you need XML mapping, let MFGA handle the ROM-specific font XML layer and use FontLoader as a companion compatibility module when Android 12+ app font loading issues appear. Avoid stacking multiple modules that replace the same font*.xml files.

Font Mapping

Latin:

• Roboto-*.ttf is generated from Inter static instances.
• Inter weights: Thin 100, ExtraLight 200, Light 300, Regular 400, Medium 500, SemiBold 600, Bold 700, ExtraBold 800, Black 900.

Simplified Chinese:

• 100.ttf, 200.ttf, 300.ttf, 350.ttf, 400.ttf, 500.ttf, 600.ttf, 700.ttf, 800.ttf, and 900.ttf are generated from Noto Sans SC static instances.
• NotoSansCJKsc-*.otf is generated from Noto Sans SC static instances.
• NotoSansCJK-VF.ttf, NotoSansCJKsc-VF.ttf, DroidSansFallback.ttf, and DroidSansFallbackFull.ttf are included for common fallback paths.
• Noto Sans SC weights: Thin 100, ExtraLight 200, Light 300, DemiLight 350, Regular 400, Medium 500, SemiBold 600, Bold 700, ExtraBold 800, Black 900.

The full package contains 9 Inter upright weights, 9 Inter italic weights, and 10 Noto Sans SC weights. The conservative safe package contains the same weight set, but skips DroidSansFallback* compatibility files.

Device ROMs differ. If a ROM uses vendor-specific font names, add those names to tools/build.py and rebuild.

Sources

• KernelSU module guide: https://kernelsu.org/guide/module.html
• Magisk developer guide: https://topjohnwu.github.io/Magisk/guides.html
• FontLoader: https://github.com/JingMatrix/FontLoader
• MFGA: https://github.com/Numbersf/MakeFontsGreatAgain
• Android custom font fallback: https://source.android.com/docs/core/fonts/custom-font-fallback
• Inter: https://github.com/google/fonts/tree/main/ofl/inter
• Noto Sans SC: https://github.com/google/fonts/tree/main/ofl/notosanssc