setproctitle

A Python module to customize the process title

setproctitle Permissive license BSD-3-Clause AGING ★ 559 v1.3.7 released 2025-09-05

Install

setproctitle on PyPI

pip

pip install setproctitle

uv

uv add setproctitle

poetry

poetry add setproctitle

Package facts

License	BSD-3-Clause (permissive)
Python support	supports the current Python release (>=3.8)
Install friction	medium — platform-specific wheel
Runtime dependencies	none
Maintenance	aging — 342 days since the last release
Last repo commit	2025-11-06
First released	2009-12-05
Popularity	one of the top 1,000 most-downloaded packages on PyPI (30-day window, as of 2026-08-13)
Known vulnerabilities	none known (OSV.dev, checked 2026-08-13)

Evidence: setproctitle-1.3.7-cp310-cp310-macosx_10_9_universal2.whl; setproctitle-1.3.7-cp310-cp310-macosx_11_0_arm64.whl; setproctitle-1.3.7-cp310-cp310-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl; setproctitle-1.3.7-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl; setproctitle-1.3.7-cp310-cp310-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl; setproctitle-1.3.7-cp310-cp310-musllinux_1_2_aarch64.whl; setproctitle-1.3.7-cp310-cp310-musllinux_1_2_ppc64le.whl; setproctitle-1.3.7-cp310-cp310-musllinux_1_2_x86_64.whl; setproctitle-1.3.7-cp310-cp310-win32.whl; setproctitle-1.3.7-cp310-cp310-win_amd64.whl; setproctitle-1.3.7-cp311-cp311-macosx_10_9_universal2.whl; setproctitle-1.3.7-cp311-cp311-macosx_11_0_arm64.whl; setproctitle-1.3.7-cp311-cp311-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl; setproctitle-1.3.7-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl; setproctitle-1.3.7-cp311-cp311-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl; setproctitle-1.3.7-cp311-cp311-musllinux_1_2_aarch64.whl; setproctitle-1.3.7-cp311-cp311-musllinux_1_2_ppc64le.whl; setproctitle-1.3.7-cp311-cp311-musllinux_1_2_x86_64.whl; setproctitle-1.3.7-cp311-cp311-win32.whl; setproctitle-1.3.7-cp311-cp311-win_amd64.whl

Development Status :: 5 - Production/StableIntended Audience :: DevelopersLicense :: OSI Approved :: BSD LicenseOperating System :: MacOS :: MacOS XOperating System :: Microsoft :: WindowsOperating System :: POSIX :: BSDOperating System :: POSIX :: LinuxProgramming Language :: CProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9Topic :: Software Development

About setproctitle

from the package's own PyPI description — quoted content, verbatim

A Python module to customize the process title

.. image:: https://github.com/dvarrazzo/py-setproctitle/workflows/Tests/badge.svg :target: https://github.com/dvarrazzo/py-setproctitle/actions?query=workflow%3ATests :alt: Tests

:author: Daniele Varrazzo

The setproctitle module allows a process to change its title (as displayed by system tools such as ps, top or MacOS Activity Monitor).

Changing the title is mostly useful in multi-process systems, for example when a master process is forked: changing the children's title allows to identify the task each process is busy with. The technique is used by PostgreSQL_ and the OpenSSH Server_ for example.

The procedure is hardly portable across different systems. PostgreSQL provides a good multi-platform implementation__: this package was born as a wrapper around PostgreSQL code.