Advanced installation instructions

Some Python modules may not be easy to install. Here are collected information on how to get them available in your Termux.

Tkinter

Tkinter is splitted of from the python package and can be installed by

We do not provide Tkinter for Python v2.7.x.

Since Tkinter is a graphical library, it will work only if X Windows System environment is installed and running. How to do this, see page Graphical Environment.

Installing Python modules from source

Some modules may not be installable without patching. They should be installed from source code. Here is a quick how-to about installing Python modules from source code.

1. Obtain the source code. You can clone a git repository of your package:

or download source bundle with pip :

2. Optionally, apply the desired changes to source code. There no universal guides on that, perform this step on your own.

3. Optionally, fix the all shebangs. This is not needed if termux-exec is installed and works correctly.

4. Finally install the package:

Troubleshooting

pip doesn’t read config in

All of above are because of platformdirs. Platformdirs aims to replace appdirs, since pip v21.3.0 and virtualenv v20.5.0, they started to use platformdirs instead of appdirs. Appdirs doesn’t do anything else on Android, it just follows freedesktop standards. But platformdirs is different, it takes termux as a simple Android app but not a unix evironment.

It it predictable that all packages using platformdirs can’t behave well on termux, see: [1]. Before PR 72 is merged, the only way to fix it is to patch it manually.

There are two copies of platformdirs we need to patch:

Every time after we upgrade pip or platformdirs, we need to patch it again.

Patch for platformdirs before v2.5.0:

Patch for platformdirs v2.5.0 or later:

We can simply patch it by:

Notice that the two copies may be different versions, so they need different patches. For example, pip v21.3 and v22.0 use platformdirs v2.4, and the lastest version (on 2022-04-02) is v2.5.1.

How to install pillow termux

Pillow and PIL cannot co-exist in the same environment. Before installing Pillow, please uninstall PIL.

Pillow supports these Python versions.

The following instructions will install Pillow with support for most common image formats. See :ref:`external-libraries` for a full list of external libraries supported.

We provide Pillow binaries for Windows compiled for the matrix of supported Pythons in both 32 and 64-bit versions in the wheel format. These binaries include support for all optional libraries except libimagequant and libxcb. Raqm support requires FriBiDi to be installed separately:

We provide binaries for macOS for each of the supported Python versions in the wheel format. These include support for all optional libraries except libimagequant. Raqm support requires FriBiDi to be installed separately:

We provide binaries for Linux for each of the supported Python versions in the manylinux wheel format. These include support for all optional libraries except libimagequant. Raqm support requires FriBiDi to be installed separately:

Pillow can be installed on FreeBSD via the official Ports or Packages systems:

Ports:

Packages:

The Pillow FreeBSD port and packages are tested by the ports team with all supported FreeBSD versions.

Building From Source

You do not need to install all supported external libraries to use Pillow’s basic features. Zlib and libjpeg are required by default.

There are Dockerfiles in our Docker images repo to install the dependencies for some operating systems.

Many of Pillow’s features require external libraries:

Once you have installed the prerequisites, run:

Building on macOS

The easiest way to install external libraries is via Homebrew. After you install Homebrew, run:

To install libraqm on macOS use Homebrew to install its dependencies:

Then see depends/install_raqm_cmake.sh to install libraqm.

Now install Pillow with:

or from within the uncompressed source directory:

Building on Windows

We recommend you use prebuilt wheels from PyPI. If you wish to compile Pillow manually, you can use the build scripts in the winbuild directory used for CI testing and development. These scripts require Visual Studio 2017 or newer and NASM.

Building on Windows using MSYS2/MinGW

To build Pillow using MSYS2, make sure you run the MSYS2 MinGW 32-bit or MSYS2 MinGW 64-bit console, not MSYS2 directly.

Make sure you have Python and GCC installed:

Prerequisites are installed on MSYS2 MinGW 64-bit with:

Now install Pillow with:

Building on FreeBSD

Only FreeBSD 10 and 11 tested

Make sure you have Python’s development libraries installed:

Prerequisites are installed on FreeBSD 10 or 11 with:

Then see depends/install_raqm_cmake.sh to install libraqm.

Building on Linux

If you didn’t build Python from source, make sure you have Python’s development libraries installed.

In Debian or Ubuntu:

In Fedora, the command is:

In Alpine, the command is:

redhat-rpm-config is required on Fedora 23, but not earlier versions.

Prerequisites are installed on recent Red Hat, CentOS or Fedora with:

Note that the package manager may be yum or DNF, depending on the exact distribution.

Prerequisites are installed for Alpine with:

See also the Dockerfile s in the Test Infrastructure repo (https://github.com/python-pillow/docker-images) for a known working install process for other tested distros.

Building on Android

Basic Android support has been added for compilation within the Termux environment. The dependencies can be installed by:

This has been tested within the Termux app on ChromeOS, on x86.

Current platform support for Pillow. Binary distributions are contributed for each release on a volunteer basis, but the source should compile and run everywhere platform support is listed. In general, we aim to support all current versions of Linux, macOS, and Windows.

Continuous Integration Targets

These platforms are built and tested for every change.

These platforms have been reported to work at the versions mentioned.

Contributors please test Pillow on your platform then update this document and send a pull request.

Pillow 5.4.0 cannot be installed on Termux #3526

Comments

valpogus commented Jan 2, 2019

What did you do?

What did you expect to happen?

Pillow is upgraded to version 5.4.0

What actually happened?

running build_ext
Traceback (most recent call last):
File «», line 1, in
File «/data/data/com.termux/files/usr/tmp/pip-install-XXXXXXXX/pillow/setup.py», line 800, in
zip_safe=not (debug_build() or PLATFORM_MINGW), )
File «/data/data/com.termux/files/usr/lib/python3.7/site-packages/setuptools/init.py», line 143, in setup
return distutils.core.setup(**attrs)
File «/data/data/com.termux/files/usr/lib/python3.7/distutils/core.py», line 148, in setup
dist.run_commands()
File «/data/data/com.termux/files/usr/lib/python3.7/distutils/dist.py», line 966, in run_commands
self.run_command(cmd)
File «/data/data/com.termux/files/usr/lib/python3.7/distutils/dist.py», line 985, in run_command
cmd_obj.run()
File «/data/data/com.termux/files/usr/lib/python3.7/site-packages/setuptools/command/install.py», line 61, in run
return orig.install.run(self)
File «/data/data/com.termux/files/usr/lib/python3.7/distutils/command/install.py», line 545, in run
self.run_command(‘build’)
File «/data/data/com.termux/files/usr/lib/python3.7/distutils/cmd.py», line 313, in run_command
self.distribution.run_command(command)
File «/data/data/com.termux/files/usr/lib/python3.7/distutils/dist.py», line 985, in run_command
cmd_obj.run()
File «/data/data/com.termux/files/usr/lib/python3.7/distutils/command/build.py», line 135, in run
self.run_command(cmd_name)
File «/data/data/com.termux/files/usr/lib/python3.7/distutils/cmd.py», line 313, in run_command
self.distribution.run_command(command)
File «/data/data/com.termux/files/usr/lib/python3.7/distutils/dist.py», line 985, in run_command
cmd_obj.run()
File «/data/data/com.termux/files/usr/lib/python3.7/distutils/command/build_ext.py», line 339, in run
self.build_extensions()
File «/data/data/com.termux/files/usr/tmp/pip-install-XXXXXXXX/pillow/setup.py», line 416, in build_extensions
for dirname in _find_library_dirs_ldconfig():
TypeError: ‘NoneType’ object is not iterable

What are your OS, Python and Pillow versions?

I think the error happens in the function _find_library_dirs_ldconfig, where the executable «/sbin/ldconfig» is called. This executable does not exist on Termux, making the function return None.

Previous versions can be installed without a problem (as long as the necessary dev packages are installed).

The text was updated successfully, but these errors were encountered:

Package Request #143

Comments

BandungBB commented Feb 19, 2016

The package zlib is required in order to install Pillow which is an image manipulation application used by pythonists. zlib is available within the desktop version of busybox. It would be wonderful to have it in termux.

The text was updated successfully, but these errors were encountered:

fornwall commented Mar 3, 2016

The zlib library is installed by the Android system so is not needed to add to Termux. If you install a compiler (gcc/clang) you will get the include/zlib.h header files, and should be able to link against the system zlib with

I’m closing this issue, re-open it if there are any problems with the system zlib!

jean commented Jul 22, 2017

So there there is some path configuration issue.

vishalbiswas commented Jul 22, 2017

@jean does running it under termux-chroot succeeds?

jean commented Jul 22, 2017

This works 🙂
LDFLAGS=»-L/system/lib/» CFLAGS=»-I/data/data/com.termux/files/usr/include/» pip install Pillow from
python-pillow/Pillow#1957 (comment)

Now it’s failing on jpeg :-p

jean commented Jul 22, 2017 •

This worked all the way:

erik55 commented Jan 20, 2018 •

In January 2018 on Android 7.0 I had to do

when I wanted to install img2pdf̀

marksteward commented Mar 13, 2018

• ← How to install pil
• How to install pip on linux →