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.

The latest documentation can be found here.

This project was spun off from the python-tdl project, and is now it's own module.

The recommended way to install is by using pip.

With Python installed, run the following command to install libtcod-cffi:

python -m pip install libtcod-cffi

This is good enough for most Python installations. See the requirements section if you're building from source.

This module was designed to be backwards compatible with the original libtcod module that is distributed with libtcod. If you had code that runs on the original module you can use this library as a drop-in replacement like this:

import tcod as libtcod

Guides and Tutorials for the original library should also work with this one.

• Python 2.7+, Python 3.3+, or PyPy 5.4+
• Windows, Linux, or Mac OS X
• The cffi Python module must be version 1.8 or higher
• The numpy Python module should be 1.11 or higher.

• Python pycparser module must be 2.14 or higher
• MinGW gcc.exe must be on Windows path for use with pycparser. An equivalent program must be installed on other OS's
• Mac OS X requires sdl2, which can be installed using the homebrew command: "brew install sdl2"
• Linux requires the packages: libsdl2-dev, libffi-dev, and python-dev

libtcod-cffi is distributed under the Simplified 2-clause FreeBSD license. Read LICENSE.txt for more details.