---
id: zalgolib
version: "0.2.2"
license: MIT License Copyright (c) 2022 Yatri Trivedi Copyright (c) 2017 Greg Pritchard Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated… (full text in the JSON record)
license_treatment: permissive
maintenance: dormant
---

# zalgolib — A Python library for a _FULL_ Zalgo experience

License: permissive · Maintenance: dormant · Downloads: 103.6K/mo

## What it is and what it does

Zalgolib is a Python library for generating and removing Zalgo text—text decorated with stacked Unicode combining diacritical marks that create a visually chaotic or "corrupted" effect. It provides two main functions: enzalgofy() adds combining marks to text at a configurable intensity (0–100, representing a rough percentage of marks per character), and dezalgofy() strips those marks by converting to ASCII and back to UTF-8. The library includes curated lists of 40 downward marks, 46 upward marks, and 21 midline marks drawn from the Unicode combining diacritics space.

The package has no external dependencies beyond Python's standard library random module. It is designed to be lightweight and customizable—users can extend the diacritics lists directly in their own code or modify the module itself. The author emphasizes functionality and periodic maintenance, though the project has been dormant since December 2023.

Use it for:

- Generate visually striking or humorous Zalgo text for social media posts, chat messages, or creative writing.
- Strip Zalgo text back to readable ASCII when cleaning user input or text from untrusted sources.
- Experiment with Unicode combining marks and diacritical mark placement for linguistic or typographic research.
- Obfuscate or encode text for novelty or aesthetic purposes in applications or games.
- Extend the diacritics lists to include marks from other Unicode blocks or non-Latin writing systems.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Encodes text with overlapping Unicode diacritical marks to create Zalgo text, and decodes Zalgo text back to plain ASCII by stripping combining marks.

Yes, if you need Zalgo text generation or decoding. The package is lightweight (no external dependencies), permissively licensed, and has no known vulnerabilities. The dormant maintenance status is not a concern for a narrow, self-contained utility. Install if you have an actual use case for Zalgo text; otherwise it is niche.

## Install

pip install zalgolib
uv add zalgolib
poetry add zalgolib

## Installing zalgolib

Before you install: No runtime dependencies beyond the standard library. Dormant since late 2023 (981 days), but the repository is not archived and the codebase is straightforward enough that lack of recent updates poses minimal risk for a utility of this scope.

License in practice: MIT license is permissive; you may use, modify, and distribute the package freely with minimal restrictions, provided you retain the copyright notice.

Quickstart:

pip install zalgolib

from zalgolib import enzalgofy, dezalgofy

zalgo_text = enzalgofy(text='hello', intensity=50)
plain_text = dezalgofy(zalgo_text)

Requires Python 3.7 or later; relies on random.choices() from the standard library.

Verify before relying:

- Whether dezalgofy correctly preserves intentional accented characters in the original text, or whether it strips all combining marks indiscriminately.
- Performance characteristics when processing very large strings or high intensity values.

## Package facts

- License: MIT License Copyright (c) 2022 Yatri Trivedi Copyright (c) 2017 Greg Pritchard Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated… (full text in the JSON record) (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: dormant
- Downloads: 103.6K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

zalgo text generator, unicode diacritics encoder, zalgo encoding decoding, combining marks text, zalgo obfuscation, text diacritical marks, horror text effect, unicode-text, novelty-utility

[View on SkillFed](https://skillfed.io/packages/zalgolib) · [View on PyPI](https://pypi.org/project/zalgolib/)