NewYour coding agent can read the release notes before it upgrades.Set up the MCP server β
PyPI, #42 most downloaded on PyPI
A small Python package for determining appropriate platform-specific dirs, e.g. a `user data dir`.
Latest stable
4.14.8
Last release 2 days ago
20 Nov 2026
Release timing varies
gaps range from 8 days to 2 months
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
6 years old
101 releases Β· first in 2021
Drag across the ruler to compare, or tap a release to open it.
Fix Android detection when python-for-android is present. #277 by @tmolitor-stud-tu and @gaborbernat.
<a name="release-4-2-2-fixed"></a>
python-for-android is present. #277 by @tmolitor-stud-tu and @gaborbernat.Fix Android detection when python-for-android is present. 277 - by tmolitor-stud-tu and gaborbernat.
Your coding agent can read these notes before it upgrades. Set up the MCP server β
Allow working without ctypes. #275 by @youknowone.
<a name="release-4-2-1-fixed"></a>
Add convenience methods to iterate over both user and site dirs and paths. #258 by @SpaceshipOperations and @gaborbernat.
<a name="release-4-2-0-added"></a>
<a name="release-4-2-0-documentation"></a>
Add convenience methods to iterate over both user and site dirs and paths. 258 - by SpaceshipOperations and gaborbernat.
Fix two typos referencing XDG_DATA_DIR. 256 - by Freed-Wu.
Drop support for EOL Python 3.7. #246 by @hugovk.
<a name="release-4-1-0-added"></a>
<a name="release-4-1-0-documentation"></a>
Drop support for EOL Python 3.7. 246 - by hugovk.
Fix Linux ~platformdirs.user_log_dir example in README. 245 - by dbohdan.
Revert site_cache_dir on UNIX to /var/cache instead of /var/tmp. #239 by @andersk.
<a name="release-4-0-0-changes"></a>
Revert ~platformdirs.site_cache_dir on UNIX to /var/cache instead of /var/tmp. 239 - by andersk.
Detect Homebrew-installed software on macOS. #232 by @singingwolfboy.
<a name="release-3-11-0-added"></a>
Detect Homebrew-installed software on macOS. PR #232 - by @singingwolfboy .
Detect Homebrew-installed software on macOS. 232 - by singingwolfboy.
Add site_runtime_dir. #212 by @kemzeb.
<a name="release-3-10-0-added"></a>
Optionally create the opinionated log subdirectory in user_log_dir on Unix. #208 by @kemzeb.
<a name="release-3-9-1-fixed"></a>
Optionally create the opinionated log subdirectory in ~platformdirs.user_log_dir on Unix. 208 - by kemzeb.
Add user_desktop_dir and user_desktop_path. #200 by @lukacat10.
<a name="release-3-9-0-added"></a>
user_desktop_dir and user_desktop_path. #200 by @lukacat10.Add user_desktop_dir() and user_desktop_path() . PR #200 - by @lukacat10 .
Add ~platformdirs.user_desktop_dir and ~platformdirs.user_desktop_path. 200 - by lukacat10.
Provide a fallback for user_runtime_dir on BSD. #201 by @RayyanAnsari.
<a name="release-3-8-1-fixed"></a>
user_runtime_dir on BSD. #201 by @RayyanAnsari.Provide a fallback for ~platformdirs.user_runtime_dir on BSD. 201 - by RayyanAnsari.
π PyPI release π Full Changelog
Return /var/run/user/$uid from user_runtime_dir on \*BSD. #194 by @kemzeb.
<a name="release-3-7-0-added"></a>
Return /var/run/user/$uid from ~platformdirs.user_runtime_dir on *BSD. 194 - by kemzeb.
Add user_downloads_dir. #192 by @cofiem.
<a name="release-3-6-0-added"></a>
Add support for Python 3.12 by @gaborbernat.
π PyPI release π Full Changelog
Define getuid on all non-Windows platforms so user_runtime_dir works beyond Linux. #183 by @gaborbernat and @mtelka.
<a name="release-3-5-1-fixed"></a>
getuid on all non-Windows platforms so user_runtime_dir works beyond Linux. #183 by @gaborbernat and @mtelka.Define getuid on all non-Windows platforms so ~platformdirs.user_runtime_dir works beyond Linux. 183 - by gaborbernat and mtelka.
Add user_music_dir. #173 by @kemzeb.
<a name="release-3-5-0-added"></a>
Add user_videos_dir. #169 by @kemzeb.
<a name="release-3-4-0-added"></a>
Add user_pictures_dir. #167 by @kemzeb.
<a name="release-3-3-0-added"></a>
Add the ensure_exists option to create directories when they are missing. #155 by @smsearcy.
<a name="release-3-2-0-added"></a>
Add the ensure_exists option to create directories when they are missing. 155 - by smsearcy.
Point site_cache_dir at /var/tmp instead of write-protected /var/cache on Unix. #148 by @efiop.
<a name="release-3-1-1-fixed"></a>
Point ~platformdirs.site_cache_dir at /var/tmp instead of write-protected /var/cache on Unix. 148 - by efiop.
Add site_cache_dir. #145 by @efiop.
<a name="release-3-1-0-added"></a>
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
<a name="release-3-0-0-fixed"></a>
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. #137 by @ThomasWaldmann and @gaborbernat.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 and gaborbernat.
Add typing-extensions as a dependency on Python < 3.8. #123 by @amacf and @gaborbernat.
<a name="release-2-6-2-packaging"></a>
typing-extensions as a dependency on Python < 3.8. #123 by @amacf and @gaborbernat.Add typing-extensions as a dependency on Python < 3.8. 123 - by amacf and gaborbernat.
Detect Termux via $PREFIX when $SHELL is unset. #115 by @Freed-Wu.
<a name="release-2-6-1-fixed"></a>
Detect Termux via $PREFIX when $SHELL is unset. PR #115 - by @Freed-Wu .
Detect Termux via $PREFIX when $SHELL is unset. 115 - by Freed-Wu.
Point user_log_dir at user_state_dir on Linux per the XDG spec. #108 by @lordwelch.
<a name="release-2-6-0-changes"></a>
user_log_dir at user_state_dir on Linux per the XDG spec. #108 by @lordwelch.Point ~platformdirs.user_log_dir at ~platformdirs.user_state_dir on Linux per the XDG spec. 108 - by lordwelch.
π PyPI release π Full Changelog
Declare support for Python 3.11. #103 by @hugovk.
<a name="release-2-5-3-added"></a>
Treat Android shells as Unix. #72 by @Blocked.
<a name="release-2-5-2-fixed"></a>
Work out of the box under Nuitka standalone builds. #68 by @gaborbernat and @Clouder0.
<a name="release-2-5-1-fixed"></a>
Work out of the box under Nuitka standalone builds. 68 - by gaborbernat and Clouder0.
Support the Termux subsystem. #63 by @YariKartoshe4ka.
<a name="release-2-5-0-added"></a>
Drop Python 3.6 support. #52 by @gaborbernat.
Add user_documents_dir. #39 by @JuneStepp, Jeremy Stepp and @gaborbernat.
<a name="release-2-4-0-added"></a>
user_documents_dir. #39 by @JuneStepp, Jeremy Stepp and @gaborbernat.Add user_documents_dir() . PR #39 - by @JuneStepp , Jeremy Stepp and @gaborbernat .
Add ~platformdirs.user_documents_dir. 39 - by JuneStepp, Jeremy Stepp and gaborbernat.
Add user_runtime_dir for $XDG_RUNTIME_DIR. #37 by @whonore and @gaborbernat.
<a name="release-2-3-0-added"></a>
user_runtime_dir for $XDG_RUNTIME_DIR. #37 by @whonore and @gaborbernat.Add ~platformdirs.user_runtime_dir for $XDG_RUNTIME_DIR. 37 - by whonore and gaborbernat.
Unix: fall back to the default when the $XDG_* environment variable is empty. #30 by @papr and @gaborbernat.
<a name="release-2-2-0-fixed"></a>
$XDG_* environment variable is empty. #30 by @papr and @gaborbernat.Unix: fall back to the default when the $XDG_* environment variable is empty. 30 - by papr and gaborbernat.
Add pathlib.Path-returning *_path API alongside the string variants. #27 by @papr.
<a name="release-2-1-0-added"></a>
pathlib.Path-returning *_path API alongside the string variants. #27 by @papr.Add pathlib.Path-returning *_path API alongside the string variants. 27 - by papr.
Add Android support. 18 - by gaborbernat and YariKartoshe4ka.
Add type annotations. 20 - by domdfcoding.
Drop Python 2.7 and 3.5 support. 14 - by domdfcoding and gaborbernat.
@Julian made their first contribution in #10
@gaborbernat made their first contribution in #7
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-10-20)
4.13.5 (2026-10-19)
4.13.4 (2026-10-17)
4.13.3 (2026-10-16)
4.13.2 (2026-10-16)
4.13.1 (2026-10-15)
4.13.0 (2026-10-10)
4.12.4 (2026-10-07)
4.12.3 (2026-10-03)
4.12.2 (2026-09-29)
4.12.1 (2026-09-28)
4.12.0 (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)
Stop expanding user paths twice for two macOS directory lookups. #1 by @ofek.
<a name="release-v2-0-0a3-fixed"></a>
<a name="release-v2-0-0a3-performance"></a>
Stop expanding user paths twice for two macOS directory lookups. 1 - by ofek.
Resolve platform-dependent functions at import to speed up directory lookups. 1 - by ofek.
π PyPI release π Full Changelog
Remove support for end-of-life Pythons 2.6, 3.2, and 3.3 by @Julian.
Remove support for end-of-life Pythons 2.6, 3.2, and 3.3 - by @Julian .
Add support for Python 3.7, 3.8, and 3.9 - by @Julian .
Introduce platformdirs as a friendly fork of appdirs - by @Julian .
On this page
Changelog
Unreleased (2026-11-20)
4.14.8 (2026-11-20)
Fixed
Performance
4.14.7 (2026-11-17)
Fixed
4.14.6 (2026-11-17)
Fixed
Performance
Packaging
4.14.5 (2026-11-04)
Fixed
4.14.4 (2026-11-04)
4.14.3 (2026-11-01)
Fixed
4.14.2 (2026-10-31)
Fixed
4.14.1 (2026-10-30)
Fixed
4.14.0 (2026-10-28)
Added
Fixed
4.13.7 (2026-10-28)
Fixed
Documentation
4.13.6 (2026-10-27)
Packaging
4.13.5 (2026-10-19)
Packaging
4.13.4 (2026-10-17)
Fixed
4.13.3 (2026-10-16)
4.13.2 (2026-10-16)
Fixed
4.13.1 (2026-10-15)
Fixed
4.13.0 (2026-10-10)
Fixed
4.12.4 (2026-10-07)
Fixed
4.12.3 (2026-10-03)
Fixed
4.12.2 (2026-09-29)
Fixed
4.12.1 (2026-09-28)
Fixed
4.12.0 (2026-09-26)
Added
Fixed
Documentation
Security
4.11.15 (2026-09-26)
Fixed
4.11.14 (2026-09-25)
Added
Fixed
Documentation
Security
4.11.13 (2026-09-25)
Fixed
4.11.12 (2026-09-22)
Fixed
Documentation
4.11.11 (2026-09-19)
Security
4.11.10 (2026-09-18)
Fixed
4.11.9 (2026-09-16)
Added
Fixed
4.11.8 (2026-09-08)
Fixed
4.11.7 (2026-09-01)
4.11.6 (2026-09-01)
Added
4.11.5 (2026-08-27)
Added
Fixed
Documentation
4.11.4 (2026-08-24)
Fixed
Documentation
4.11.3 (2026-08-13)
Added
Fixed
4.11.2 (2026-08-10)
Fixed
4.11.1 (2026-08-07)
Fixed
4.11.0 (2026-07-21)
Added
4.10.1 (2026-07-18)
Performance
4.10.0 (2026-05-28)
Added
Fixed
4.9.6 (2026-04-09)
Fixed
4.9.4 (2026-03-05)
Fixed
4.9.2 (2026-02-16)
4.9.1 (2026-02-14)
4.9.0 (2026-02-14)
Added
Fixed
4.8.0 (2026-02-14)
Added
Fixed
4.7.1 (2026-02-13)
Fixed
4.7.0 (2026-02-12)
Fixed
4.6.0 (2026-02-12)
Fixed
Documentation
4.5.1 (2025-12-05)
Fixed
4.5.0 (2025-10-08)
Added
Documentation
4.4.0 (2025-08-26)
Fixed
4.3.8 (2025-05-07)
Documentation
4.3.7 (2025-03-19)
Added
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)
Fixed
4.3.1 (2024-09-07)
4.3.0 (2024-09-07)
Added
4.2.2 (2024-05-15)
Fixed
4.2.1 (2024-04-23)
Fixed
4.2.0 (2024-01-31)
Added
Documentation
4.1.0 (2023-12-04)
Added
Documentation
4.0.0 (2023-11-10)
Changes
3.11.0 (2023-10-02)
Added
3.10.0 (2023-07-29)
Added
3.9.1 (2023-07-15)
Fixed
3.9.0 (2023-07-15)
Added
3.8.1 (2023-07-06)
Fixed
3.8.0 (2023-06-22)
3.7.0 (2023-06-20)
Added
3.6.0 (2023-06-18)
Added
3.5.3 (2023-06-09)
Added
3.5.2 (2023-06-09)
3.5.1 (2023-05-11)
Fixed
3.5.0 (2023-04-27)
Added
3.4.0 (2023-04-26)
Added
3.3.0 (2023-04-25)
Added
3.2.0 (2023-03-25)
Added
3.1.1 (2023-03-10)
Fixed
3.1.0 (2023-03-03)
Added
3.0.0 (2023-02-06)
Fixed
2.6.2 (2022-12-28)
Packaging
2.6.1 (2022-12-29)
Fixed
2.6.0 (2022-12-06)
Changes
2.5.4 (2022-11-12)
2.5.3 (2022-11-06)
Added
2.5.2 (2022-04-18)
Fixed
2.5.1 (2022-02-19)
Fixed
2.5.0 (2022-02-09)
Added
2.4.1 (2021-12-26)
Added
2.4.0 (2021-09-25)
Added
2.3.0 (2021-08-30)
Added
2.2.0 (2021-07-29)
Fixed
2.1.0 (2021-07-25)
Added
2.0.2 (2021-07-13)
2.0.0 (2021-07-12)
v2.0.0a3 (2021-05-13)
Fixed
Performance
v2.0.0a2 (2021-05-13)
v2.0.0a1 (2021-05-13)
Added
Remove support for end-of-life Pythons 2.6, 3.2, and 3.3 - by Julian.
Add support for Python 3.7, 3.8, and 3.9 - by Julian.
Introduce platformdirs as a friendly fork of appdirs - by Julian.
One column per quarter.