{"id":27899,"library":"koreanize-matplotlib","title":"Koreanize Matplotlib","description":"Automatically sets Korean font configurations for matplotlib, handling missing glyphs and avoiding font warnings. Current version 0.1.1, released as a lightweight wrapper; low cadence.","status":"active","version":"0.1.1","language":"python","source_language":"en","source_url":"https://github.com/ychoi-kr/koreanize-matplotlib","tags":["korean","matplotlib","font","localization"],"install":[{"cmd":"pip install koreanize-matplotlib","lang":"bash","label":"standard install"}],"dependencies":[],"imports":[{"note":"Wildcard import may clobber matplotlib style settings","wrong":"from koreanize_matplotlib import *","symbol":"koreanize_matplotlib","correct":"import koreanize_matplotlib"}],"quickstart":{"code":"import matplotlib.pyplot as plt\nimport koreanize_matplotlib\n\nplt.plot([1,2,3], [4,5,6])\nplt.title('한글 제목')\nplt.show()","lang":"python","description":"Simply import koreanize_matplotlib before plotting to enable Korean font support."},"warnings":[{"fix":"Move import to top of script, before any matplotlib usage.","message":"Import order: koreanize_matplotlib must be imported before any matplotlib font operations. If imported after plt has been used, font may not be applied correctly.","severity":"gotcha","affected_versions":">=0.1.0"},{"fix":"If you manually set 'font.family' later, ensure it includes a Korean font.","message":"The library only sets a default Korean font; custom font configurations or rcParams overrides will take precedence and may break Korean rendering.","severity":"gotcha","affected_versions":">=0.1.0"},{"fix":"Replace 'koreanize_matplotlib.enable()' with just 'import koreanize_matplotlib'.","message":"The function 'koreanize_matplotlib.enable()' is deprecated in favor of simple import side effect.","severity":"deprecated","affected_versions":"0.1.0 to 0.1.1"}],"env_vars":null,"last_verified":"2026-05-09T00:00:00.000Z","next_check":"2026-08-07T00:00:00.000Z","problems":[{"fix":"Install a Korean font: 'sudo apt-get install fonts-nanum' or download Noto Sans CJK.","cause":"No Korean font (e.g., NanumGothic, Noto Sans CJK) is installed.","error":"RuntimeError: Cannot find any Korean font installed on the system."},{"fix":"Use 'import koreanize_matplotlib' only (no explicit enable call).","cause":"Using koreanize_matplotlib.enable() on version 0.1.1 where it was removed.","error":"AttributeError: module 'koreanize_matplotlib' has no attribute 'enable'"},{"fix":"Delete matplotlib cache: rm -rf ~/.cache/matplotlib; or force rebuild with 'matplotlib.font_manager._load_fontmanager(try_read_cache=False)'.","cause":"Matplotlib cache does not include the Korean font after installation.","error":"UserWarning: findfont: Font family ['NanumGothic'] not found."}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}