Skip to main content
Python Software Foundation 20th Year Anniversary Fundraiser  Donate today!

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.

Files for winpath, version 202002.2
Filename, size File type Python version Upload date Hashes
Filename, size winpath-202002.2-py3-none-any.whl (5.1 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size winpath-202002.2.tar.gz (8.5 kB) File type Source Python version None Upload date Hashes View

Supported by

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