---
id: cron-descriptor
version: "2.1.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# cron-descriptor — A Python library that converts cron expressions into human readable strings.

License: permissive · Maintenance: active · Popularity: top 1,000 on PyPI

## Install

pip install cron-descriptor
uv add cron-descriptor
poetry add cron-descriptor

## Description

# Cron Descriptor

[![Python tests](https://github.com/Salamek/cron-descriptor/actions/workflows/python-test.yml/badge.svg)](https://github.com/Salamek/cron-descriptor/actions/workflows/python-test.yml)
[![Donate](https://img.shields.io/badge/Donate-PayPal-green.svg)](https://www.paypal.me/salamek)

A Python library that converts cron expressions into human readable strings. Ported to Python from https://github.com/bradyholt/cron-expression-descriptor.

**Author**: Adam Schubert (https://www.salamek.cz)  
**Original Author & Credit**: Brady Holt (http://www.geekytidbits.com)  
**License**: [MIT](http://opensource.org/licenses/MIT)

## Features         
 * Supports all cron expression special characters including * / , - ? L W, #
 * Supports 5, 6 (w/ seconds or year), or 7 (w/ seconds and year) part cron expressions
 * Provides casing options (Sentence, Title, Lower, etc.)
 * Localization with support for ~31 languages
 * Supports Python 3.9 - 3.13

## Installation
Using PIP
```bash
pip install cron-descriptor
```

## Usage example

### Simple
```python
from cron_descriptor import get_description, ExpressionDescriptor

print(get_description("* 2 3 *...

## AI interpretation — verify before relying

Converts cron expressions into human-readable descriptions in multiple languages, supporting standard cron syntax with special characters and 5–7 part expressions.

Verdict: A stable, actively maintained library for cron expression translation with broad language support and minimal dependencies. MIT licensing and top-1000 popularity make it a low-friction choice for scheduling documentation and user-facing cron interpretation.

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