Skip to main content

A simple Textual filesystem picker dialog library.

Project description


Viewing its own directory An example of textual-fspicker being used in a Textual application


This library provides a simple set of filesystem navigation and picking dialogs (actually, as of the time of writing, it only provides two, this is a very early WiP you're seeing). The aim is to provide "ready to go" dialogs that should also be fairly easy to tailor to your own applications.


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

$ pip install textual-fspicker

The library

Right at the moment there's just two dialogs available:

  • FileOpen -- For selecting a file from the filesystem.
  • FileSave -- For selecting a file for saving in the filesystem.
  • SelectDirectory -- For selecting a directory from the filesysrem.

You can see them in action in the demo/test code.

Yes, I know that documentation is lacking right now -- I'm still fleshing out how this will work and what it will provide -- so the best place to see how the code can be used is in that demo/test code.


  • Flesh out what's displayed for directory entries
  • Add lots of styling options for directory entries
  • Settle on a final set of default styles for the dialogs
  • Add a more file-save-oriented dialog
  • Add a directory picking dialog
  • Add file filtering (extensions using Select)
  • Expose the hidden show/hide facility of the navigator in the dialogs
  • Better documentation
  • Test on Windows
  • Add custom mtime formatting
  • Add support for showing different times

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

textual_fspicker-0.0.11.tar.gz (13.3 kB view hashes)

Uploaded Source

Built Distribution

textual_fspicker-0.0.11-py3-none-any.whl (16.8 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page