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.0.tar.gz (6.5 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.0-py3-none-any.whl (6.1 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for koroman-1.0.0.tar.gz
Algorithm Hash digest
SHA256 46336d72edd436c5a4cb5ae4305a02554cac205692a236d6a46d7dc2bb37d46a
MD5 4a3a484f9641d88ad3df75d4869280ff
BLAKE2b-256 90d21093b116e7af3a1c41c71ebc9aa62d9c2498a58e15d067dc2986f7e0373d

See more details on using hashes here.

File details

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

File metadata

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

File hashes

Hashes for koroman-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 121da86837da738558117ef875d67206e1e9b9658c2fa17818963d77b2373e7e
MD5 64895a1c9367ed7a8a624e71251749cd
BLAKE2b-256 e6c9337360911e774bddaa78ac5ab4663d79dc2daf5786795e6ee2a43388fd30

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