An open Cantonese dictionary for iOS and Android built with Flutter

go to github download

wordshk dictionary for Android and iOS

wordshk app logo


Download on the App Store
Get it on Google Play
Get it on F-Droid


  1. Install Flutter by following the official doc:

  2. Download and install Android Studio to develop for Android:

  3. Start Android Studio, and go through the ‘Android Studio Setup Wizard’. This installs the latest Android SDK, Android SDK Command-line Tools, and Android SDK Build-Tools, which are required by Flutter when developing for Android.

  4. Run flutter doctor to confirm your installation is working. You should see some output like below.
    At a minimum you should have [✓] Flutter and [✓] Android toolchain to develop for Android, the other check marks are optional.

[✓] Flutter (Channel stable, 3.19.3, on Ubuntu 20.04.6 LTS 6.2.0-1019-azure, locale C.UTF-8)
[✓] Android toolchain - develop for Android devices (Android SDK version 34.0.0)
[✗] Chrome - develop for the web (Cannot find Chrome executable at google-chrome)
[✗] Linux toolchain - develop for Linux desktop
[!] Android Studio (not installed)
[✓] Connected device (1 available)
[✓] Network resources

If you want to build for iOS, you are required to use a Mac. You will need the latest version of Xcode as well.

  1. Run the at the root of this project to install the Rust backend.

  2. Run flutter run to run the app, or

    • flutter build appbundle to create an Android app bundle
    • flutter build apk to build an Android APK
    • flutter build ios to build for iOS

Normalize jyutping syllable audios

  1. Open Adobe Audition, run the “Match Loudness” with these settings:

    • ITU-R BS.1770-3 Loudness
    • Target Loudness: -16 LUFS
    • Tolerance: 2 LU
    • Max True Peak Level: -2 dBTP
    • Look-ahead Time: 12ms
    • Release Time: 200ms
  2. Export the files with matched loudness
    With export settings as follows:

    • Format MP3
    • Sample Type: Same as source
    • Format settings: MP3 24 Kbps CBR (Constant type)
  3. Change directory into assets/jyutping_female or assets/jyutping_male.

  4. Run This script does three things:

    1. Trim silence at the beginning and end of all mp3 files
    2. Pad the end of jap6sing1 syllables so they are not too short
    3. Peak normalize jap6sing1 syllables to make they as loud as other syllables


Software: Copyright © 2022 Xiang Li, licensed under the MIT license.
Dictionary: Copyright © 2014-2022 Hong Kong Lexicography Limited.”, “wordshk”, “粵典” are trade names of Hong Kong Lexicography
Limited. Permission by Hong Kong Lexicography Limited must be obtained to
promote or distribute materials containing these names. In particular,
notwithstanding any permission (if applicable) to redistribute the source code
of this project and/or its derivative works by the copyright owner(s), unless
you obtain explicit permission from Hong Kong Lexicography Limited, you are
required to remove all mentions of “”, “wordshk”, “粵典” from
your redistributions.

The dictionary contents published by is copyrighted by Hong Kong
Lexicography Limited. You may be eligible to obtain a license from

excellent projects related to AlienKevin/wordshk_app recommend downloading