Download Latest Version tkfilebrowser-2.3.2.zip (71.5 kB)
Email in envelope

Get an email when there's a new version of tkFileBrowser

Home / 2.1.1
Name Modified Size InfoDownloads / Week
Parent folder
sha512sums.txt 2017-09-12 157 Bytes
0
tkfilebrowser-2.1.1.tar.gz 2017-09-12 41.0 kB
0
Totals: 2 Items   41.2 kB 0

tkfilebrowser

tkfilebrowser is an alternative to tkinter.filedialog that allows the user to select files or directories. The GUI is written with tkinter but the look is closer to GTK and the application uses GTK bookmarks (the one displayed in nautilus or thunar for instance). This filebrowser supports new directory creation and filtype filtering.

This module contains a general FileBrowser class which implements the filebrowser and the following functions, similar to the one in filedialog:

  • askopenfilename that allow the selection of a single file
  • askopenfilenames that allow the selection of multiple files
  • askopendirname that allow the selection a single folder
  • askopendirnames that allow the selection of multiple folders
  • asksaveasfilename that returns a single filename and give a warning if the file already exists

Requirements

  • Linux
  • Python 2.7 or 3.x with tkinter + ttk and python-psutil

Installation

  • Ubuntu: use the PPA ppa:j-4321-i/ppa

    $ sudo add-apt-repository ppa:j-4321-i/ppa
$ sudo apt-get update
$ sudo apt-get install python(3)-tkfilebrowser

  • Archlinux:

    the package is available on AUR

  • With pip:

$ pip install tkfilebrowser

Documentation

  • Optional keywords arguments common to each function

    • parent: parent window
    • title: the title of the filebrowser window
    • initialdir: directory whose content is initially displayed
    • initialfile: initially selected item (just the name, not the full path)
    • filetypes list: [("name", "*.ext1|*.ext2|.."), ...] only the files of given filetype will be displayed, e.g. to allow the user to switch between displaying only PNG or JPG pictures or dispalying all files: filtypes=[("Pictures", "*.png|*.PNG|*.jpg|*.JPG'), ("All files", "*")]
    • okbuttontext: text displayed on the validate button, if None, the default text corresponding to the mode is used (either "Open" or "Save")
    • cancelbuttontext: text displayed on the button that cancels the selection.
    • foldercreation: enable the user to create new folders if True (default)

  • askopendirname

    Allow the user to choose a single directory. The absolute path of the chosen directory is returned. If the user cancels, an empty string is returned.

  • askopendirnames

    Allow the user to choose multiple directories. A tuple containing the absolute path of the chosen directories is returned. If the user cancels, an empty tuple is returned.

  • askopenfilename

    Allow the user to choose a single file. The absolute path of the chosen file is returned. If the user cancels, an empty string is returned.

  • askopenfilenames

    Allow the user to choose multiple files. A tuple containing the absolute path of the chosen files is returned. If the user cancels, an empty tuple is returned.

  • asksaveasfilename

    Allow the user to choose a file path. The file may not exist but the path to its directory does. If the file already exists, the user is asked to confirm its replacement.

    Additional option:
    • defaultext: extension added to filename if none is given (default is none)

Changelog

  • tkfilebrowser 2.1.1
    • Fix error if LOCAL_PATH does not exists or is not writtable
  • tkfilebrowser 2.1.0
    • Add compatibility with tkinter.filedialog keywords 'master' and 'defaultextension'
    • Change look of filetype selector
    • Fix bugs when navigating without displaying hidden files
    • Fix color alternance bug when hiding hidden files
    • Fix setup.py
    • Hide suggestion drop-down when nothing matches anymore
  • tkfilebrowser 2.0.0
    • Change package name to tkfilebrowser to respect PEP 8
    • Display error message when an issue occurs during folder creation
    • Cycle only through folders with key browsing in "opendir" mode
    • Complete only with folder names in "opendir" mode
    • Fix bug: grey/white color alternance not always respected
    • Add __main__.py with an example
    • Add "Recent files" shortcut
    • Make the text of the validate and cancel buttons customizable
    • Add possibility to disable new folder creation
    • Add python 2 support
    • Add horizontal scrollbar
  • tkFileBrowser 1.1.2
    • Add tooltips to display the full path of the shortcut if the mouse stays long enough over it.
    • Fix bug: style of browser treeview applied to parent
  • tkFileBrowser 1.1.1
    • Fix bug: key browsing did not work with capital letters
    • Add specific icons for symlinks
    • Add handling of symlinks, the real path is returned instead of the link path
  • tkFileBrowser 1.1.0
    • Fix bug concerning the initialfile argument
    • Add column sorting (by name, size, modification date)
  • tkFileBrowser 1.0.1
    • Set default filebrowser parent to None as for the usual filedialogs and messageboxes.
  • tkFileBrowser 1.0.0
    • Initial version

Example

try:
    import tkinter as tk
    import tkinter.ttk as ttk
except ImportError:
    import Tkinter as tk
    import ttk
from tkfilebrowser import askopendirnames, asksaveasfilename

root = tk.Tk()
style = ttk.Style(root)
style.theme_use("clam")

def c_open():
    rep = askopendirnames(parent=root)
    print(rep)

def c_save():
    rep = asksaveasfilename(parent=root, defaultext=".png",
                            filetypes=[("Pictures", "*.png|*.jpg|*.JPG"), ("All files", "*")])
    print(rep)

ttk.Button(root, text="Open folders", command=c_open).pack()
ttk.Button(root, text="Save file", command=c_save).pack()

root.mainloop()
Source: README.rst, updated 2017-09-12