Skip to content
Help
Getting started

Getting started

A quick guide for first-time JamoMoa users.

1. Install

Grab the latest DMG from the Download page and drag the app into Applications. That’s it.

If macOS blocks the first launch, open System Settings ▸ Privacy & Security and click “Open Anyway” once.

2. First launch

JamoMoa runs as a menu-bar accessory app by default — no Dock icon, just a small ㅈ status item on the right side of the menu bar.

Click it to see:

  • Show JamoMoa — opens the drop/review main window
  • Check for Updates… — manual update check
  • Settings… — opens Preferences
  • Quit — exits the app

Want a Dock icon? Turn on Settings ▸ UI ▸ Show in Dock. The menu-bar status item stays visible in either mode.

3. Compose and decompose names

This is the core of JamoMoa. Drop a file or folder onto the main window and it builds a preview list — nothing on disk changes yet.

  1. Open the main window and drop files or folders onto it, or use the Open… button.
  2. JamoMoa scans recursively and shows every entry with its status: Needs normalization (split-apart NFD), Composed, Decomposed, or Plain (nothing to do).
  3. Each row offers the action that fits its current form:
    • A split-apart (NFD) name shows Compose → rewrites it to composed NFC.
    • An already-composed (NFC) name shows Decompose → rewrites it back to NFD.
  4. Use the bottom bar to do the whole list at once: Compose All / Decompose All. A live count (Working… (500/50000)) appears for large batches.

Conversion is two-way and reversible: anything you compose you can decompose again, and vice versa. NFC ⇆ NFD is a lossless mapping, so the bytes round-trip exactly.

Remove (and Remove All) only drops rows from the list — it never deletes from disk. That’s why the button says “remove”, not “delete”.

You can also copy a row’s name to the clipboard with the copy button (shaped by the copy options below).

4. The Settings window

Settings… (from the menu-bar item, or ⌘, when the Dock icon is on) opens Preferences, organized into tabs:

  • General — app behavior: Launch at login, Automatically check for updates, Always on top, the global Hotkey recorder, and Export / Import / Reset for all your settings.
  • Features — how names are handled: recurse into dropped folders, and how a name is shaped when copied (compose to NFC, include the extension).
  • UI — how the app looks: Language, Appearance (Light / Dark / System), and Show in Dock.
  • Quick Options — choose which options appear in the main window’s quick bar, and drag to reorder them.
  • Developer — an optional log window (off by default; see below).
  • About — app icon, version, Check for Updates…, View Help, View Licenses, copyright.

5. Quick options

The collapsible Quick Options bar at the bottom of the main window mirrors the most-used Features toggles so you don’t have to open Settings:

  • Add folder contents too — when a folder is dropped, add its files and subfolders recursively
  • Always on top — float the main window above other apps
  • Compose name — copy the composed (NFC) name to the clipboard; off copies the name as-is on disk (no transformation)
  • Include extension — copy a file’s extension along with the name (folder names are always copied whole)

Pick which of these show in the bar, and their order, under Settings ▸ Quick Options.

6. Global hotkey

Under Settings ▸ General ▸ Hotkeys you can record a system-wide shortcut that brings the main window forward from anywhere — handy for a menu-bar app whose window is usually out of sight. The default is empty, so nothing is intercepted until you opt in.

7. Language and appearance

Settings ▸ UI ▸ Display has pickers for Language (System / 한국어 / English / 日本語 / Tiếng Việt) and Appearance (System / Light / Dark). Appearance applies instantly; changing the language needs a relaunch (macOS caches the bundle language at process start), and JamoMoa offers to relaunch for you.

8. Back up your settings

Settings ▸ General can Export all your settings to a .plist file, Import them on another Mac, or Reset everything to defaults (with a confirmation). Only real preferences are saved — window positions and other system state are left out.

9. Developer mode (optional)

Turn on Settings ▸ Developer ▸ Enable Developer Mode to unlock a log window (open it with Open Log Window). It records every compose / decompose / copy event with a timestamp, shows decomposed names spelled out jamo-by-jamo so byte-level differences are visible, and can be searched and saved to a text file. The log persists across launches. Most users never need this.

FAQ