https://github.com/davep/textual-fspicker

A Textual widget library for picking things in the filesystem
https://github.com/davep/textual-fspicker

filesystem filesystem-library framework library python terminal textual textual-dialog textual-framework textual-widget toolkit tui ui

Last synced: 6 months ago
JSON representation

A Textual widget library for picking things in the filesystem

• Host: GitHub
• URL: https://github.com/davep/textual-fspicker
• Owner: davep
• License: mit
• Created: 2023-05-11T21:05:01.000Z (almost 3 years ago)
• Default Branch: main
• Last Pushed: 2025-09-23T08:29:42.000Z (6 months ago)
• Last Synced: 2025-09-24T11:58:13.635Z (6 months ago)
• Topics: filesystem, filesystem-library, framework, library, python, terminal, textual, textual-dialog, textual-framework, textual-widget, toolkit, tui, ui
• Language: Python
• Homepage: https://textual-fspicker.davep.dev/
• Size: 2.08 MB
• Stars: 66
• Watchers: 3
• Forks: 8
• Open Issues: 9
• Metadata Files:
  • Readme: README.md
  • Changelog: ChangeLog.md
  • Contributing: CONTRIBUTING.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

• awesome-textualize-projects - Fspicker - A Textual widget library for picking things in the filesystem. (Community / Third Party Applications)

README

          
# textual-fspicker

[![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/davep/textual-fspicker/style-and-lint.yaml)](https://github.com/davep/textual-fspicker/actions)

[![GitHub commits since latest release](https://img.shields.io/github/commits-since/davep/textual-fspicker/latest)](https://github.com/davep/textual-fspicker/commits/main/)

[![GitHub Issues or Pull Requests](https://img.shields.io/github/issues/davep/textual-fspicker)](https://github.com/davep/textual-fspicker/issues)

[![GitHub Release Date](https://img.shields.io/github/release-date/davep/textual-fspicker)](https://github.com/davep/textual-fspicker/releases)

[![PyPI - License](https://img.shields.io/pypi/l/textual-fspicker)](https://github.com/davep/textual-fspicker/blob/main/LICENSE)

[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/textual-fspicker)](https://github.com/davep/textual-fspicker/blob/main/pyproject.toml)

[![PyPI - Version](https://img.shields.io/pypi/v/textual-fspicker)](https://pypi.org/project/textual-fspicker/)

## Introduction

This library provides a simple set of filesystem navigation and picking

dialogs. The aim is to provide "ready to go" dialogs that should also be

fairly easy to tailor to your own applications.

![Opening a file](https://raw.githubusercontent.com/davep/textual-fspicker/main/.images/file-open.png)

![Saving a file](https://raw.githubusercontent.com/davep/textual-fspicker/main/.images/file-save.png)

## Installing

The package can be installed with `pip` or related tools, for example:

```sh

$ pip install textual-fspicker

```

## Using the library

Please see [the main documentation for the

library](https://textual-fspicker.davep.dev/) for details on how to use it.

## TODO

See [the TODO tag in

issues](https://github.com/davep/textual-fspicker/issues?q=is%3Aissue+is%3Aopen+label%3ATODO)

to see what I'm planning.

[//]: # (README.md ends here)