Skip to main content

The official Python port of libtcod.

Project description


VersionsBadge ImplementationBadge LicenseBadge

PyPI Documentation Status Codecov Updates


This is a Python cffi port of libtcod.

This library is hosted on GitHub.

Any issues you have with this module can be reported at the GitHub issue tracker.


This module was designed to be backward compatible with the original libtcodpy module distributed with libtcod. If you had code that runs on libtcodpy then you can use this library as a drop-in replacement. This installs a libtcodpy module so you’ll only need to delete the libtcodpy/ folder that’s usually bundled in an older libtcodpy project.

Guides and Tutorials for libtcodpy should work with the tcod module.

The latest documentation can be found here:


Detailed installation instructions are here:

For the most part it’s just:

pip3 install tcod


  • Python 3.7+

  • Windows, Linux, or MacOS X 10.9+.

  • On Linux, requires libsdl2 (2.0.10+).


You can find the most recent changelog here.


python-tcod is distributed under the Simplified 2-clause FreeBSD license.

Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

tcod-15.0.0.tar.gz (756.7 kB view hashes)

Uploaded source

Built Distributions

tcod-15.0.0-cp36-abi3-win_amd64.whl (1.5 MB view hashes)

Uploaded cp36

tcod-15.0.0-cp36-abi3-win32.whl (1.3 MB view hashes)

Uploaded cp36

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page