Metadata

About

ObFileBrowser is a *drumroll* file browser for Openbox. It uses pipemenus to display files and directories and generates submenus with commands to open files with their associated applications. These assocations can be configured using Mimeo or any other application that follows the Desktop Entry Specification.

See the help message for usage information.

Features

• creates traversable menus for navigating between directories
• creates launcher menus for files and directories
• parent and current directories can be hidden
• displays hidden files in separate, optional menu
• options to add custom commands to launcher menu, e.g. for copying filepaths, creating associations

Additional Menus

• desktop entry menus, sorted by name and by category

Screenshots

Help Message

$ obfilebrowser --help

usage: obfilebrowser [-h] [--no-parent] [--no-self] [--no-hidden]
                     [--term <cmd>] [--command <name> <command>] [--more-help]
                     [--desktop-menu] [--cache] [--delete-cache]
                     [<filepath>]

Browse and open files using Openbox pipe menus.

positional arguments:
  <filepath>            The path to a file or directory.

options:
  -h, --help            show this help message and exit
  --no-parent           Remove the ".." entry from the initial directory.
  --no-self             Remove the "." launcher menu from the initial
                        directory.
  --no-hidden           Remove the "hidden" menu containing hidden files and
                        directories.
  --term <cmd>          Specify a terminal command. See Mimeo's documentation
                        for details.
  --command <name> <command>
                        Custom commands to add to every Exec menu. See "--
                        more-help" for details.
  --more-help           Display more information.
  --desktop-menu        Display desktop entries sorted by name and category.
  --cache               Cache menus in a database to speed up subsequent
                        browsing. This should detect changes in target
                        directories and MIME-type associations.
  --delete-cache        Delete the cache database.

CHANGELOG