Skip to content

baseplate-admin/Cross-Platform-Folder-Picker

Repository files navigation

Cross-Platform-Folder-Picker

A (near zero dependency by default) cross platform folder picker

Downloads Pypi Badge

Example GIF

Features

  • Opens a folder dialog using:
    • Default:
      • tkinter for Windows (falls back to ctypes)
      • zenity / kdialog for Linux
      • osascript for macOS
    • Optionally:
      • qt
      • gtk
  • Customize the dialog’s title and icon easily
  • Uses native dialogs where possible for a familiar look & feel
  • Falls back gracefully if native options aren’t available
  • Super simple to use in scripts, CLI tools, or GUI apps

Installation

pip install cross-platform-folder-picker

Usage

from cross_platform_folder_picker import open_folder_picker

folder = open_folder_picker()
print(folder)  # Prints the selected folder path, or None if you cancel

Roadmap

  • Let me know what features or improvements you'd like to see next!

About

A (near zero dependency by default) cross platform folder picker

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages