# Install opencc with Homebrew, apk, apt, dnf, MacPorts, Nix, pacman, winget, zypper

Simplified-traditional Chinese conversion tool. Version 1.4.0 via Homebrew; verified 2026-07-01.

## Install

```sh
sudo av install brew:opencc
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install opencc
```

  Evidence: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install opencc
```

  Evidence: MacPorts ports tree: textproc/opencc/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- apk (92%):

```sh
sudo apk add opencc
```

  Evidence: Alpine Linux edge package indexes: opencc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz

- Debian apt (92%):

```sh
sudo apt install libopencc-data
```

  Evidence: Debian stable package indexes: libopencc-data from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

- dnf (92%):

```sh
sudo dnf install opencc
```

  Evidence: Fedora Rawhide package metadata: opencc from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst

- Nix (92%):

```sh
nix profile install nixpkgs#opencc
```

  Evidence: nixpkgs package indexes: pkgs/by-name/op/opencc/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

- pacman (92%):

```sh
sudo pacman -S opencc
```

  Evidence: Arch Linux sync databases: opencc from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz

- zypper (92%):

```sh
sudo zypper install libopencc1_2
```

  Evidence: openSUSE Tumbleweed package metadata: libopencc1_2 from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst

### Windows

- winget (92%):

```sh
winget install --id BYVoid.OpenCC -e
```

  Evidence: Windows Package Manager source index: BYVoid.OpenCC from https://cdn.winget.microsoft.com/cache/source.msix

## Package facts

- **Package key:** brew:opencc
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/opencc>
- **Version:** 1.4.0
- **Source summary:** Simplified-traditional Chinese conversion tool
- **Homepage:** <https://opencc.byvoid.com/>
- **Repository:** <https://github.com/BYVoid/OpenCC>
- **Upstream docs:** <https://byvoid.github.io/OpenCC>
- **License:** Apache-2.0
- **Source archive:** <https://github.com/BYVoid/OpenCC/archive/refs/tags/ver.1.4.0.tar.gz>
- **Last updated:** 2026-07-01T22:54:50Z
- **Generated:** 2026-07-08T18:08:21+00:00

## Executables

- opencc (cli)
- opencc_dict (cli)
- opencc_phrase_extract (cli)
- opencc (alias)
- opencc_dict (alias)
- opencc_phrase_extract (alias)

## Dependencies

- marisa

## Build dependencies

- cmake

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 1.4.0
- Package-manager updated: 2026-07-01
- Local data: ok
- Upstream repository: https://github.com/BYVoid/OpenCC
- info: No cached GitHub release or tag data was available.
## Project history and usage

OpenCC, Open Chinese Convert, is a conversion library and CLI for Traditional Chinese, Simplified Chinese, Japanese Shinjitai, regional vocabulary variants, and character/phrase-level Chinese script conversion.

### Project history

BYVoid's project page describes OpenCC as an open source Traditional/Simplified Chinese conversion project with high-quality phrase dictionaries and a C library, originally hosted on Google Code and GitHub. The source header credits Carbo Kuo and contributors from 2010 onward, giving the project a long maintenance history for what could otherwise look like a simple text filter.

The project evolved from a C/C++ conversion library and command-line tool into a multi-ecosystem package. The README lists installation paths through Debian, Ubuntu, Fedora, Arch Linux, Homebrew, WinGet, Bazel, Node.js, and Python, and includes C, C++, Node.js, and Python usage examples.

OpenCC's release history shows the project treating dictionaries and conversion behavior as first-class software. Version 1.1.0 introduced the `ocd2` dictionary format based on Marisa Trie and reduced dictionary size; version 1.3.x rewrote core conversion paths, added Jieba plugin work, and expanded diagnostics such as segmentation and inspection; version 1.4.0 raised the C++ ABI/SOVERSION to avoid silent ABI mismatches.

### Adoption history

OpenCC became a common dependency because script conversion is not just character substitution. The project emphasizes distinctions such as one-simplified-to-many-traditional mappings, variant characters, and regional vocabulary across Mainland China, Taiwan, Hong Kong, and Japanese Shinjitai.

The package's breadth across Python, Node.js, WinGet, Linux distributions, Homebrew, and Bazel makes it useful in desktop tools, web backends, NLP preprocessing, publishing pipelines, chat applications, and input-method ecosystems. OpenCC's own documentation states that it is not a Mandarin/Cantonese translation tool, which helps frame its adoption around orthography and vocabulary variants rather than language translation.

### How it is used

Users run the `opencc` CLI with JSON configurations such as Simplified-to-Traditional, Traditional-to-Simplified, Taiwan phrase, Hong Kong phrase, or Japanese Shinjitai conversion modes. Developers embed the library through C/C++, Python, Node.js, or downstream ports when they need deterministic script conversion inside applications.

Dictionary maintainers and power users use `opencc_dict`, inline dictionaries, JSON/JSONC configuration, resource bundles, and diagnostic modes to inspect segmentation and conversion stages. Those tools matter because many conversion bugs are phrase-boundary or regional-vocabulary bugs rather than simple missing characters.

### Why package nerds care

OpenCC is a deceptively deep package: a text converter with ABI, dictionary format, data-resource packaging, language bindings, prebuilt binaries, and region-sensitive data updates. The interesting packaging work is making the executable, shared library, dictionaries, configs, and bindings agree across platforms.

It is also a good example of data as code. Release notes are dominated by dictionary corrections, phrase additions, normalization behavior, and compatibility work, showing why downstreams need both the binary and the exact data files.

### Timeline

- 2010: Source headers credit the beginning of the Carbo Kuo/contributor copyright span.
- 2016: BYVoid's project page documented OpenCC as a Google Code and GitHub-hosted project with a C library and phrase dictionaries.
- 2020-05-10: OpenCC 1.1.0 introduced the `ocd2` dictionary format and smaller Marisa Trie-backed dictionaries.
- 2026-04-17: OpenCC 1.3.0 added experimental Jieba segmentation plugin work.
- 2026-07-01: OpenCC 1.4.0 raised the C++ ABI/SOVERSION to 1.4 and hardened dictionary handling.

### Related projects

- Related packages include OpenCC's Python and Node.js bindings, opencc-js and other ports, Jieba segmentation integrations, Rime/librime input-method uses, and downstream operating-system packages that split OpenCC data, docs, and shared libraries.

### Sources

- <https://byvoid.com/en/project/opencc/>
- <https://github.com/BYVoid/OpenCC>
- <https://opencc.byvoid.com/>
- <https://raw.githubusercontent.com/BYVoid/OpenCC/master/NEWS.md>
- <https://raw.githubusercontent.com/BYVoid/OpenCC/master/src/opencc.h>


## Security Notes

No matching local secret-handling manifest was found for opencc. Nucleus package metadata is still published here so future coverage has a stable package URL.


## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** opencc
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable

## Other Package-Manager Records

- Debian apt - libopencc-data - 1.1.9+ds1-1: normalized package name match | Debian stable package indexes: libopencc-data from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | simplified-traditional Chinese conversion library - data files | https://github.com/BYVoid/OpenCC
- Debian apt - libopencc-dev - 1.1.9+ds1-1+b1: normalized package name match | Debian stable package indexes: libopencc-dev from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | simplified-traditional Chinese conversion library - development | https://github.com/BYVoid/OpenCC
- Debian apt - libopencc-doc - 1.1.9+ds1-1: normalized package name match | Debian stable package indexes: libopencc-doc from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | simplified-traditional Chinese conversion library - document | https://github.com/BYVoid/OpenCC
- Debian apt - libopencc1.1 - 1.1.9+ds1-1+b1: normalized package name match | Debian stable package indexes: libopencc1.1 from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | simplified-traditional Chinese conversion library - runtime | https://github.com/BYVoid/OpenCC
- Debian apt - opencc - 1.1.9+ds1-1+b1: normalized package name match | Debian stable package indexes: opencc from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | simplified-traditional Chinese conversion tool | https://github.com/BYVoid/OpenCC
- Debian apt - python3-opencc - 1.1.9+ds1-1+b1: normalized package name match | Debian stable package indexes: python3-opencc from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | simplified-traditional Chinese conversion library - Python 3.x | https://github.com/BYVoid/OpenCC
- Nix - opencc: normalized package name match | nixpkgs package indexes: pkgs/by-name/op/opencc/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- Ubuntu apt - libopencc-data - 1.1.7+ds1-1build1: normalized package name match | Ubuntu 24.04 LTS package indexes: libopencc-data from https://archive.ubuntu.com/ubuntu/dists/noble/main/binary-amd64/Packages.gz | simplified-traditional Chinese conversion library - data files | https://github.com/BYVoid/OpenCC
- Ubuntu apt - libopencc-dev - 1.1.7+ds1-1build1: normalized package name match | Ubuntu 24.04 LTS package indexes: libopencc-dev from https://archive.ubuntu.com/ubuntu/dists/noble/main/binary-amd64/Packages.gz | simplified-traditional Chinese conversion library - development | https://github.com/BYVoid/OpenCC
- Ubuntu apt - libopencc-doc - 1.1.7+ds1-1build1: normalized package name match | Ubuntu 24.04 LTS package indexes: libopencc-doc from https://archive.ubuntu.com/ubuntu/dists/noble/main/binary-amd64/Packages.gz | simplified-traditional Chinese conversion library - document | https://github.com/BYVoid/OpenCC
- Ubuntu apt - libopencc1.1 - 1.1.7+ds1-1build1: normalized package name match | Ubuntu 24.04 LTS package indexes: libopencc1.1 from https://archive.ubuntu.com/ubuntu/dists/noble/main/binary-amd64/Packages.gz | simplified-traditional Chinese conversion library - runtime | https://github.com/BYVoid/OpenCC
- Ubuntu apt - opencc - 1.1.7+ds1-1build1: normalized package name match | Ubuntu 24.04 LTS package indexes: opencc from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | simplified-traditional Chinese conversion tool | https://github.com/BYVoid/OpenCC
- apk - opencc - 1.3.1-r0: normalized package name match | Alpine Linux edge package indexes: opencc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Open Chinese Convert | https://opencc.byvoid.com/
- apk - opencc-dev - 1.3.1-r0: normalized package name match | Alpine Linux edge package indexes: opencc-dev from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Open Chinese Convert (development files) | https://opencc.byvoid.com/
- apk - opencc-doc - 1.3.1-r0: normalized package name match | Alpine Linux edge package indexes: opencc-doc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Open Chinese Convert (documentation) | https://opencc.byvoid.com/
- apk - opencc-libs - 1.3.1-r0: normalized package name match | Alpine Linux edge package indexes: opencc-libs from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Open Chinese Convert (libraries) | https://opencc.byvoid.com/


## Related links

- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [marisa](https://www.automicvault.com/pkg/brew/marisa/) - Runtime dependency declared by Homebrew.
- [cmake](https://www.automicvault.com/pkg/brew/cmake/) - Build dependency declared by Homebrew.
- [librime](https://www.automicvault.com/pkg/brew/librime/) - Popular package that depends on this formula.
- [cconv](https://www.automicvault.com/pkg/brew/cconv/) - Shares av.db curated category or tags: chinese, cli, developer-tools, text-processing.
- [dos2unix](https://www.automicvault.com/pkg/brew/dos2unix/) - Shares av.db curated category or tags: cli, developer-tools, text-conversion, text-processing.
- [recode](https://www.automicvault.com/pkg/brew/recode/) - Shares av.db curated category or tags: cli, developer-tools, text-conversion, text-processing.
- [scws](https://www.automicvault.com/pkg/brew/scws/) - Shares av.db curated category or tags: chinese, cli, developer-tools, text-processing.
- [tofrodos](https://www.automicvault.com/pkg/brew/tofrodos/) - Shares av.db curated category or tags: cli, developer-tools, text-conversion, text-processing.
- [align](https://www.automicvault.com/pkg/brew/align/) - Shares av.db curated category or tags: cli, developer-tools, text-processing.
- [bsdconv](https://www.automicvault.com/pkg/brew/bsdconv/) - Shares av.db curated category or tags: cli, developer-tools, text-processing.
- [cmigemo](https://www.automicvault.com/pkg/brew/cmigemo/) - Shares av.db curated category or tags: cli, developer-tools, text-processing.

## Combined YAML source

View the package source record on GitHub. [combined/opencc.yml](https://github.com/automic-vault/db/blob/main/combined/opencc.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
