| 0C-UPDATE(1) | User Commands | 0C-UPDATE(1) |
NAME¶
0c-update - manage settings, vocabulary and models of the 0c Zhuyin input method
SYNOPSIS¶
0c-update command [options]
DESCRIPTION¶
0c-update is the command-line front end of the 0c (靈犀注音) Zhuyin input method. It reads and changes the user's settings and personal vocabulary, manages the optional neural models and starts the input engine.
On a system installation that is managed by the package manager, installing, updating and removing 0c is done with the distribution's package manager; the self-update commands of the upstream packages (check, install, rollback, uninstall, schedule and similar) are refused.
Most commands accept -json to print a machine-readable result.
COMMANDS¶
- status
- Show the installed version, the state of the engine and a summary of the current settings.
- settings
- List all settings with their current values and allowed values.
- set key value [key value ...] [-apply] [-notify]
- Change settings. With -apply, a running engine is handed over to a new one so that the change takes effect immediately. Run 0c-update settings for the list of keys. Keys fixed by a built-in input style must be changed on a custom copy of that style (see profile).
- profile select|copy|rename|delete id [--name name] [-apply]
- Choose an input style. Built-in styles (for example 0c, microsoft, macos) are fixed; copy creates an editable custom style.
- vocab command [arguments]
- Manage the personal vocabulary: add, list, remove and undo custom words and phrases, and keep or forget learned phrases. Run 0c-update vocab without arguments for the full list of commands.
- models status|download|cancel|remove
- Manage the optional neural selection and punctuation models in the user's data directory. download fetches the pinned models from Hugging Face (about 260 MB), verifies every file and pairs them with the installed dictionary. The models need Python 3 with the numpy and onnxruntime modules. Without models the statistical engine is used.
- api status|enable [-port port]|disable|token -regen|test
- Control the local HTTP API used by AI assistants; see 0c-mcp(1).
- engine
- Start the input engine if it is not running.
- open-settings [page]
- Open the settings application. If the settings application is not installed, this command reports that it cannot be found.
FILES¶
- ~/.local/share/0c/settings.json
- User settings.
- ~/.local/share/zuin/
- Personal vocabulary, learned phrases, downloaded models and API token.
- /usr/share/0c/data/
- System dictionary.
SEE ALSO¶
| 2026-11-02 | 0c-ime 0.2.8 |