NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI · #38 most downloaded on PyPI
A small Python package for determining appropriate platform-specific dirs, e.g. a `user data dir`.
Last release today
25 Sep 2026
Ships fairly regularly
a new release about every 5 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
5 years old
79 releases · first in 2021
One column per quarter.
Fix CI by @gaborbernat in https://github.com/platformdirs/platformdirs/pull/125
Full Changelog: https://github.com/platformdirs/platformdirs/compare/2.6.2...3.0.0
BREAKING Point macOS user_config_dir() and site_config_dir() at */Library/Application Support to mirror the data dirs, and drop the trailing slash from user_config_dir() and user_data_dir() PR #137 - by @ThomasWaldmann
BREAKING Point macOS ~platformdirs.user_config_dir and ~platformdirs.site_config_dir at */Library/Application Support to mirror the data dirs, and drop the trailing slash from ~platformdirs.user_config_dir and ~platformdirs.user_data_dir 137 - by ThomasWaldmann
@amacf made their first contribution in https://github.com/platformdirs/platformdirs/pull/123
Full Changelog: https://github.com/platformdirs/platformdirs/compare/2.6.1...2.6.2
Add typing-extensions as a dependency on Python < 3.8 PR #123 - by @amacf
Bump pypa/gh-action-pypi-publish from 1.6.1 to 1.6.4 by @dependabot in https://github.com/platformdirs/platformdirs/pull/116
Full Changelog: https://github.com/platformdirs/platformdirs/compare/2.6.0...2.6.1
Detect Termux via $PREFIX when $SHELL is unset PR #115 - by @Freed-Wu
[pre-commit.ci] pre-commit autoupdate by @pre-commit-ci in https://github.com/platformdirs/platformdirs/pull/107
Full Changelog: https://github.com/platformdirs/platformdirs/compare/2.5.4...2.6.0
Point user_log_dir() at user_state_dir() on Linux per the XDG spec PR #108 - by @lordwelch
Point ~platformdirs.user_log_dir at ~platformdirs.user_state_dir on Linux per the XDG spec 108 - by lordwelch
Full Changelog: https://github.com/platformdirs/platformdirs/compare/2.5.3...2.5.4
Full Changelog: https://github.com/platformdirs/platformdirs/compare/2.5.3...2.5.4
[pre-commit.ci] pre-commit autoupdate by @pre-commit-ci in https://github.com/platformdirs/platformdirs/pull/80
Full Changelog: https://github.com/platformdirs/platformdirs/compare/2.5.2...2.5.3
- Treat Android shells as Unix PR #72
Treat Android shells as Unix PR #72
- Work out of the box under Nuitka standalone builds PR #68
Work out of the box under Nuitka standalone builds PR #68
- Support the Termux subsystem PR #63 - by @YariKartoshe4ka
Support the Termux subsystem PR #63 - by @YariKartoshe4ka
- BREAKING Drop Python 3.6 support PR #52
BREAKING Drop Python 3.6 support PR #52
- Add user_documents_dir() PR #39 - by @JuneStepp
Add user_documents_dir() PR #39 - by @JuneStepp
- Add user_runtime_dir() for $XDG_RUNTIME_DIR PR #37 - by @whonore
Add user_runtime_dir() for $XDG_RUNTIME_DIR PR #37 - by @whonore
Add ~platformdirs.user_runtime_dir for $XDG_RUNTIME_DIR 37 - by whonore
- Unix: fall back to the default when the $XDG_* environment variable is empty PR #30 - by @papr
Unix: fall back to the default when the $XDG_* environment variable is empty PR #30 - by @papr
Sphinx-based dedicated documentation
Add pathlib.Path -returning *_path API alongside the string variants PR #27 - by @papr
Add Android support PR #18
Add type annotations PR #20 - by @domdfcoding
BREAKING Drop Python 2.7 and 3.5 support PR #14 - by @domdfcoding
Add pathlib.Path-returning *_path API alongside the string variants 27 - by papr
Add Android support 18
Add type annotations 20 - by domdfcoding
BREAKING Drop Python 2.7 and 3.5 support 14 - by domdfcoding
- No user-facing changes
No user-facing changes
- BREAKING Rename appdirs to platformdirs as part of the friendly fork
BREAKING Rename appdirs to platformdirs as part of the friendly fork
BREAKING Remove support for end-of-life Pythons 2.6, 3.2, and 3.3
BREAKING Correct the config directory on macOS
Add support for Python 3.7, 3.8, and 3.9
On this page
Changelog
Unreleased (2026-09-26)
4.11.15 (2026-09-26)
4.11.14 (2026-09-25)
4.11.13 (2026-09-25)
4.11.12 (2026-09-22)
4.11.11 (2026-09-19)
4.11.10 (2026-09-18)
4.11.9 (2026-09-16)
4.11.8 (2026-09-08)
4.11.7 (2026-09-01)
4.11.6 (2026-09-01)
4.11.5 (2026-08-27)
4.11.4 (2026-08-24)
4.11.3 (2026-08-13)
4.11.2 (2026-08-10)
4.11.1 (2026-08-07)
4.11.0 (2026-07-21)
4.10.1 (2026-07-18)
4.10.0 (2026-05-28)
4.9.6 (2026-04-09)
4.9.4 (2026-03-05)
4.9.2 (2026-02-16)
4.9.1 (2026-02-14)
4.9.0 (2026-02-14)
4.8.0 (2026-02-14)
4.7.1 (2026-02-13)
4.7.0 (2026-02-12)
4.6.0 (2026-02-12)
4.5.1 (2025-12-05)
4.5.0 (2025-10-08)
4.4.0 (2025-08-26)
4.3.8 (2025-05-07)
4.3.7 (2025-03-19)
4.3.6 (2024-09-17)
4.3.5 (2024-09-17)
4.3.4 (2024-09-17)
4.3.3 (2024-09-13)
4.3.2 (2024-09-08)
4.3.1 (2024-09-07)
4.3.0 (2024-09-07)
4.2.2 (2024-05-15)
4.2.1 (2024-04-23)
4.2.0 (2024-01-31)
4.1.0 (2023-12-04)
4.0.0 (2023-11-10)
3.11.0 (2023-10-02)
3.10.0 (2023-07-29)
3.9.1 (2023-07-15)
3.9.0 (2023-07-15)
3.8.1 (2023-07-06)
3.8.0 (2023-06-22)
3.7.0 (2023-06-20)
3.6.0 (2023-06-18)
3.5.3 (2023-06-09)
3.5.2 (2023-06-09)
3.5.1 (2023-05-11)
3.5.0 (2023-04-27)
3.4.0 (2023-04-26)
3.3.0 (2023-04-25)
3.2.0 (2023-03-25)
3.1.1 (2023-03-10)
3.1.0 (2023-03-03)
3.0.0 (2023-02-06)
2.6.2 (2022-12-28)
2.6.1 (2022-12-29)
2.6.0 (2022-12-06)
2.5.4 (2022-11-12)
2.5.3 (2022-11-06)
2.5.2 (2022-04-18)
2.5.1 (2022-02-19)
2.5.0 (2022-02-09)
2.4.1 (2021-12-26)
2.4.0 (2021-09-25)
2.3.0 (2021-08-30)
2.2.0 (2021-07-29)
2.1.0 (2021-07-25)
2.0.2 (2021-07-13)
2.0.0 (2021-07-12)
Nothing published for this version
Nothing published for this version
Nothing published for this version
Your coding agent can read these notes before it upgrades. Set up the MCP server →