Skip to main content

Retrieves common Windows folders as Unicode strings

Project description


PyPi Build status Coverage License

WinPath is a python module for retrieving common Windows system paths as Unicode strings. It is especially useful in cases where the default path to a system file has been changed by the user. i.e When a user has changed the default path to their Documents folder.

WinPath is a fork of the original WinPaths module by Ryan Ginstrom. It includes bug fixes for issues present in the WinPaths module and allows its inclusion in platform agnostic projects.


Install and update using pip:

pip install -U winpath

A Simple Example

WinPath can be imported and used within your own project like so.

The following example assumes that the user has chosen to sync their Documents directory with Onedrive.

import sys
import winpath

if sys.platform == "win32": # WinPath will only work on Windows
    my_documents = winpath.get_my_documents()
    print(my_documents) # C:\\Users\\username\\Onedrive\\Documents

Available Functions

  • get_local_appdata: Path to %LOCALAPPDATA%

  • get_appdata: Path to %APPDATA%

  • get_desktop: Path to the logged in user's desktop folder

  • get_programs: current user -> Start menu -> Programs

  • get_admin_tools: current user -> Start menu -> Programs -> Admin tools

  • get_common_admin_tools: all users -> Start menu -> Programs -> Admin tools

  • get_common_appdata: Path to program data folder

  • get_common_documents: Path to public documents folder

  • get_cookies: Path to internet explorer cookies folder

  • get_history: Path to internet explorer history folder

  • get_internet_cache: Path to internet explorer cache folder

  • get_my_pictures: Path to the logged in user's pictures folder

  • get_my_documents: Path to the logged in user's documents folder

  • get_program_files: Path to Windows program files folder

  • get_program_files_common: Path to Windows' program files -> common files folder

  • get_system: Path to Windows' System32 folder

  • get_windows: Path to Windows folder

  • get_favorites: Path to the logged in user's favorites folder

  • get_startup: current user -> start menu -> programs -> startup

  • get_recent: Path to the logged in user's recently used files folder


This project is licensed under the terms of the MIT license.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

winpath-202002.2.tar.gz (8.5 kB view hashes)

Uploaded source

Built Distribution

winpath-202002.2-py3-none-any.whl (5.1 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page