gitwtfhub

wtf is luoshu?

xgl34222220-ops/luoshu — explained in plain English

Analysis updated 2026-05-18

54ShellAudience · developerComplexity · 4/5LicenseSetup · hard

TL;DR

A root module for Android that combines separately chosen Chinese, English, and digit fonts into one composite system font, managed through a bundled native app.

Mindmap

mindmap
  root((repo))
    What it does
      Combines fonts
      System-wide Chinese font
    Tech stack
      Shell
      Android
      Python
    Use cases
      Custom fonts
      Rooted devices
    Audience
      Root users
      Android tinkerers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Apply a custom Chinese font system-wide on a rooted Android device without losing English or digit glyph quality

REASON 2

Mix and match separate fonts for Chinese, English, and digits into one working system font

REASON 3

Safely test and roll back font changes on a Magisk, KernelSU, or APatch rooted phone

What's in the stack?

ShellAndroidPythonNode.js

How it stacks up

xgl34222220-ops/luoshunelsonwerd/idea-to-ship-skillstotvs/engpro-advpl-tlpp-skills
Stars545454
LanguageShellShellShell
Setup difficultyhardmoderateeasy
Complexity4/53/53/5
Audiencedevelopervibe coderdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · hard Time to first run · 1h+

Requires a rooted Android device with Magisk, KernelSU, SukiSU Ultra, APatch, or Mountify.

You can use and modify the code, but if you distribute it or a modified version, you must release the source code under the same GPL v3 license.

Wtf does this do

LuoShu is a module for modern Android devices that changes how system text fonts are displayed by combining separately chosen fonts for Chinese characters, English letters, and digits into one composite font. It takes the Chinese font you pick as the base, then copies the matching glyphs and measurements from your chosen English and digit fonts into that same composite file, and maps the result to the system's text font slot. This keeps full Chinese character coverage while stopping English or digit fonts that happen to include Chinese glyphs from taking over the Chinese display. The module itself no longer ships a WebUI. All configuration happens through a native Android app that comes bundled with the module package, earlier Lite or app-less variants have been removed. LuoShu scans TTF, OTF, and TTC font files placed in a folder on the device, and supports common TrueType glyf outlines, CFF, CFF2, TTC, and variable fonts, reading real weight ranges where available. Before generating a composite font it checks that each chosen font actually covers the glyphs it is responsible for, then validates file headers, character coverage, and outlines on the finished result. Identical font combinations are cached by hash, keeping up to three results by default. Font module ZIP files can be imported from a designated folder, and the app does not execute any scripts bundled inside them. The module explicitly does not touch emoji, icon, or symbol fonts, and cannot affect fonts bundled inside individual apps, private font engines used by games or readers, web fonts loaded through CSS, or text rendered as images or vector paths. It targets recent Android versions including Android 16, ColorOS 16, and HyperOS 3, and works with several popular root solutions including Magisk, KernelSU, SukiSU Ultra, APatch, and Mountify. Installation involves flashing the module ZIP through a root manager, rebooting, installing the bundled app, adding font files, picking a font for each of the three categories in the app, generating the composite font, and rebooting again for it to take effect. The project is released under the GNU GPL version 3.

Yoink these prompts

Prompt 1
Explain how LuoShu combines Chinese, English, and digit fonts into one composite Android system font
Prompt 2
Help me flash and configure the LuoShu Magisk module on my rooted Android 16 phone
Prompt 3
What devices and root managers does LuoShu currently support and test against

Frequently asked questions

wtf is luoshu?

A root module for Android that combines separately chosen Chinese, English, and digit fonts into one composite system font, managed through a bundled native app.

What language is luoshu written in?

Mainly Shell. The stack also includes Shell, Android, Python.

What license does luoshu use?

You can use and modify the code, but if you distribute it or a modified version, you must release the source code under the same GPL v3 license.

How hard is luoshu to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is luoshu for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.