romanize

A CLI tool to convert Japanese text (kanji, hiragana, katakana) to romaji.

Installation

pip install -e .

Usage

Direct input

romanize "日本語"
# Output: nihongo

Pipe input

echo "東京都渋谷区" | romanize
# Output: toukyoutoshibuyakushibuyaku

File input

romanize -f input.txt -o output.txt

Style options

# Hepburn (default) - most readable
romanize -s heppburn "日本語"
# Output: nihongo

# Kunrei-shiki
romanize -s kunrei "日本語"
# Output: nihongo

Options

Option	Description
-s, --style	Romanization style: heppburn (default) or kunrei
-o, --output	Output file (default: stdout)
-f, --file	Input file
-h, --help	Show help

Requirements

• Python >= 3.8
• pykakasi >= 2.3.0
• click >= 8.0.0