{"id":21222091,"url":"https://github.com/mrthearman/filedialogs","last_synced_at":"2025-07-10T13:33:07.686Z","repository":{"id":62589126,"uuid":"349514774","full_name":"MrThearMan/filedialogs","owner":"MrThearMan","description":"Simple Windows file dialogs for opening, saving and browsing folders.","archived":false,"fork":false,"pushed_at":"2025-07-07T20:00:57.000Z","size":3220,"stargazers_count":6,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-07-07T21:29:38.080Z","etag":null,"topics":["filesystem","python","windows"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/windows-filedialogs/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MrThearMan.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2021-03-19T18:08:28.000Z","updated_at":"2025-07-07T20:01:00.000Z","dependencies_parsed_at":"2022-11-03T16:48:36.361Z","dependency_job_id":"209224cb-7874-4797-8755-ba8b33cf6714","html_url":"https://github.com/MrThearMan/filedialogs","commit_stats":{"total_commits":9,"total_committers":2,"mean_commits":4.5,"dds":"0.33333333333333337","last_synced_commit":"0432a59841f0caa5e183ba7080aa36a64f8cba6c"},"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/MrThearMan/filedialogs","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MrThearMan%2Ffiledialogs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MrThearMan%2Ffiledialogs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MrThearMan%2Ffiledialogs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MrThearMan%2Ffiledialogs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MrThearMan","download_url":"https://codeload.github.com/MrThearMan/filedialogs/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MrThearMan%2Ffiledialogs/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264585372,"owners_count":23632647,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["filesystem","python","windows"],"created_at":"2024-11-20T22:39:38.905Z","updated_at":"2025-07-10T13:33:07.038Z","avatar_url":"https://github.com/MrThearMan.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# File dialogs for Windows\n\n[![Coverage Status][coverage-badge]][coverage]\n[![GitHub Workflow Status][status-badge]][status]\n[![PyPI][pypi-badge]][pypi]\n[![GitHub][licence-badge]][licence]\n[![GitHub Last Commit][repo-badge]][repo]\n[![GitHub Issues][issues-badge]][issues]\n[![Downloads][downloads-badge]][pypi]\n[![Python Version][version-badge]][pypi]\n\n```shell\npip install windows-filedialogs\n```\n\n---\n\n**Documentation**: [https://mrthearman.github.io/filedialogs/](https://mrthearman.github.io/filedialogs/)\n\n**Source Code**: [https://github.com/MrThearMan/filedialogs/](https://github.com/MrThearMan/filedialogs/)\n\n**Contributing**: [https://github.com/MrThearMan/filedialogs/blob/main/CONTRIBUTING.md](https://github.com/MrThearMan/filedialogs/blob/main/CONTRIBUTING.md)\n\n---\n\nImplements easy Windows file dialog functions. Requires the [pywin32](https://pypi.org/project/pywin32/) module.\n\n### Basic use:\n\n```python\nfrom filedialogs import save_file_dialog, open_file_dialog, open_folder_dialog\n\nopen_path = open_file_dialog()\nif open_path:\n    with open(open_path, \"r\") as f:\n        ...\n\nsave_path = save_file_dialog()\nif save_path:\n    with open(save_path, \"w\") as f:\n        ...\n\nopen_folder = open_folder_dialog()\nif open_folder:\n    with open(os.path.join(open_folder, ...), \"w\") as f:\n        ...\n```\n\n## Documentation:\n\n#### *open_file_dialog*\n* title: str - Dialog title. Default is no title.\n* directory: str - Directory to open file dialog in. Default is the current working directory.\n* default_name: str - Default file name on dialog open. Default is empty.\n* default_ext: str - Default file extension on dialog open. Default is no extension.\n* ext: list[tuple[str, str | tuple[str, ...]]] - List of available extensions as (description, extension) tuples. Default is (\"All files\", \"*\").\n* multiselect: bool - Allow multiple files to be selected. Default is False.\n\nReturns: Path to a file to open if multiselect=False. List of the paths to files which should be opened if multiselect=True. None if file open dialog canceled.\n\nRaises: IOError - File open dialog failed.\n\n---\n\n#### *save_file_dialog*\n* title: str - Dialog title. Default is no title.\n* directory: str - Directory to open file dialog in. Default is the current working directory.\n* default_name: str - Default file name on dialog open. Default is empty.\n* default_ext: str - Default file extension on dialog open. Default is no extension.\n* ext: list[tuple[str, str | tuple[str, ...]]]  - List of available extensions as (description, extension) tuples. Default is (\"All files\", \"*\").\n\nReturns: Path file should be save to. None if file save dialog canceled.\n\nRaises: IOError - File save dialog failed.\n\n---\n\n#### *open_folder_dialog*\n* title: str - Dialog title. Default is no title.\n* encoding: str - Encoding for the folder. Default is Latin-1.\n\nReturns: Path to folder. None if no folder selected.\n\n---\n\n[coverage-badge]: https://coveralls.io/repos/github/MrThearMan/filedialogs/badge.svg?branch=main\n[status-badge]: https://img.shields.io/github/actions/workflow/status/MrThearMan/filedialogs/test.yml?branch=main\n[pypi-badge]: https://img.shields.io/pypi/v/windows-filedialogs\n[licence-badge]: https://img.shields.io/github/license/MrThearMan/filedialogs\n[repo-badge]: https://img.shields.io/github/last-commit/MrThearMan/filedialogs\n[issues-badge]: https://img.shields.io/github/issues-raw/MrThearMan/filedialogs\n[version-badge]: https://img.shields.io/pypi/pyversions/windows-filedialogs\n[downloads-badge]: https://img.shields.io/pypi/dm/windows-filedialogs\n\n[coverage]: https://coveralls.io/github/MrThearMan/filedialogs?branch=main\n[status]: https://github.com/MrThearMan/filedialogs/actions/workflows/test.yml\n[pypi]: https://pypi.org/project/windows-filedialogs\n[licence]: https://github.com/MrThearMan/filedialogs/blob/main/LICENSE\n[repo]: https://github.com/MrThearMan/filedialogs/commits/main\n[issues]: https://github.com/MrThearMan/filedialogs/issues\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmrthearman%2Ffiledialogs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmrthearman%2Ffiledialogs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmrthearman%2Ffiledialogs/lists"}