Skip to main content

Korean Romanizer with pronunciation rules based on 국립국어원 표기법

Project description

🇰🇷 한국어로 보기

KOROMAN - Korean Romanizer

KOROMAN is a multilingual Romanizer for Korean text, based on the Revised Romanization system (국립국어원 표기법) with additional pronunciation rules. It converts Hangul syllables into Romanized Latin script across multiple languages: JavaScript, Python, and Java.

🌐 Live Demo


📦 Features

  • Supports Revised Romanization of Korean
  • Applies key Korean phonological rules:
    • Liaison (연음화)
    • Nasal assimilation (비음화)
    • Lateralization (유음화)
    • Fortis/tense consonants (경음화)
  • Provides casing options (lower, upper, capitalized)
  • Fully tested in each language

🚀 Getting Started

Python

pip install koroman
from koroman import romanize

# Basic usage
romanize("한글")  # → "hangul"

# With pronunciation rules disabled
romanize("해돋이", use_pronunciation_rules=False)  # → "haedodi"

# With pronunciation rules enabled (default)
romanize("해돋이")  # → "haedoji"

# With different casing options
romanize("한글", casing_option="uppercase")  # → "HANGUL"
romanize("안녕 한글", casing_option="capitalize-word")  # → "Annyeong Hangeul"
romanize("안녕\n한글 로마자 변환", casing_option="capitalize-line")  # → "Annyeong\nHangeul Romaja Byeonhwan"

# Combining options
romanize("해돋이", use_pronunciation_rules=False, casing_option="uppercase")  # → "HAEDODI"

📜 LICENSE

MIT License

2025 ⓒ Donghe Youn (Daissue)

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

koroman-1.0.13.tar.gz (6.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

koroman-1.0.13-py3-none-any.whl (6.1 kB view details)

Uploaded Python 3

File details

Details for the file koroman-1.0.13.tar.gz.

File metadata

  • Download URL: koroman-1.0.13.tar.gz
  • Upload date:
  • Size: 6.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.2

File hashes

Hashes for koroman-1.0.13.tar.gz
Algorithm Hash digest
SHA256 0d2a7c1ae5a68cc247b8a4a78ab958808bfc4250ec10feb26eeb5b9c68153e09
MD5 8b4ad292e177132b819aeee992e71c08
BLAKE2b-256 e74c77d350954890cb8029a46e73b25589c366900508f4ac7229f0de22d0c418

See more details on using hashes here.

File details

Details for the file koroman-1.0.13-py3-none-any.whl.

File metadata

  • Download URL: koroman-1.0.13-py3-none-any.whl
  • Upload date:
  • Size: 6.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.2

File hashes

Hashes for koroman-1.0.13-py3-none-any.whl
Algorithm Hash digest
SHA256 54da0e2951c6331dc5080b4fc181a2aaa0a1a41fc25aa1ce2e0e1c28e6fad7d5
MD5 290d980ee81e302a11b6d1cdac2cc7dc
BLAKE2b-256 186356e7ec52776cad3a2b703b91235e0ebfda7f963d93bd4f0eed051f2342e9

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page