Cross-Platform-Folder-Picker

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

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!

Metadata

Release files for cross-platform-folder-picker 0.0.6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for cross-platform-folder-picker 0.0.6
File	Size	Uploaded
cross_platform_folder_picker-0.0.6.tar.gz	602.4 kB	Jul 25, 2025	Details

Built distribution (wheel)

Table of built distributions (wheels) for cross-platform-folder-picker 0.0.6
File	Interpreter	ABI	Platform	Reset
cross_platform_folder_picker-0.0.6-py3-none-any.whl 11.3 kB Jul 25, 2025	Python 3	none	any	Details

Total release size: 613.6 kB

Release files / cross_platform_folder_picker-0.0.6.tar.gz

Download URL	cross_platform_folder_picker-0.0.6.tar.gz
Size	602.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`3d6dd72a8a5917670fab494366ca4b0f06f7f8b3db73537070f8d89fb317c117`
BLAKE2b-256 checksum How to use checksums	`a953b17094f554f8e18260702803d9cd5894c65c9104b3753e3c3af0e7ac9f4d`
Upload date	Jul 25, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.12.9`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/baseplate-admin/Cross-Platform-Folder-Picker
Publishing commit: github.com/baseplate-admin/Cross-Platform-Folder-Picker/tree/7082ab2fabcae79f2a7851047b9b4b4591743556

Workflow

Publishing configuration: github.com/baseplate-admin/Cross-Platform-Folder-Picker/blob/7082ab2fabcae79f2a7851047b9b4b4591743556/.github/workflows/CI.yaml
Publishing logs: github.com/baseplate-admin/Cross-Platform-Folder-Picker/actions/runs/16526803274/attempts/1

Artifact

Subject: cross_platform_folder_picker-0.0.6.tar.gz
SHA-256 checksum: 3d6dd72a8a5917670fab494366ca4b0f06f7f8b3db73537070f8d89fb317c117 Verifying attestations

Release files / cross_platform_folder_picker-0.0.6-py3-none-any.whl

Download URL	cross_platform_folder_picker-0.0.6-py3-none-any.whl
Size	11.3 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`b7821b0782a0c1ff91afbc910d6f5f0fbb4b6f8fe71c7a1b3901c353024a6609`
BLAKE2b-256 checksum How to use checksums	`62eb6d581a521fe222ece5fb1f913af0ea1560c3fcc3c81888f55e5b8e7eb946`
Upload date	Jul 25, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.12.9`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/baseplate-admin/Cross-Platform-Folder-Picker
Publishing commit: github.com/baseplate-admin/Cross-Platform-Folder-Picker/tree/7082ab2fabcae79f2a7851047b9b4b4591743556

Workflow

Publishing configuration: github.com/baseplate-admin/Cross-Platform-Folder-Picker/blob/7082ab2fabcae79f2a7851047b9b4b4591743556/.github/workflows/CI.yaml
Publishing logs: github.com/baseplate-admin/Cross-Platform-Folder-Picker/actions/runs/16526803274/attempts/1

Artifact

Subject: cross_platform_folder_picker-0.0.6-py3-none-any.whl
SHA-256 checksum: b7821b0782a0c1ff91afbc910d6f5f0fbb4b6f8fe71c7a1b3901c353024a6609 Verifying attestations