OBFILEBROWSER(1)					      OBFILEBROWSER(1)



NAME
       ObFilebrowser - a file browser for Openbox using pipe menus


SYNOPSIS
       obfilebrowser [options] <path>


DESCRIPTION
       ObFilebrowser is a command-line tool which creates pipe menus for Open‐
       box from system paths. These menus can display the content of  directo‐
       ries and lists of applications for opening files. The application lists
       are created from the mimeinfo on the system. Default  applications  are
       determined using ~/.local/share/applications/defaults.list.


MENU EXAMPLE
       The  following,	if  added  to  the  Openbox  root  menu	 in  $XDG_CON‐
       FIG_HOME/openbox/menu.xml, would display	 the  contents	of  your  home
       directory :

	      <menu   id="obfb-home"   label="home"  execute="obfilebrowser  ~
	      --term 'urxvtc -e %s'" />

       Note the use of the "--term" option, which is required to launch appli‐
       cations	that  run  in  a  terminal. Other options may be included (see
       below). The order of the options is irrelevant.


       Note that if obfilebrowser is not on your path, you will need to	 spec‐
       ify a full path to it in the menu's "execute" attribute above.


OPTIONS
       -h, --help
	      Display the help message and exit.


       --copy An  internal option to enable copying paths and mimetypes to the
	      clipboard. This functionality requires xsel.


       --no-hidden
	      Do not display hidden files (files which begin with ".").


       --no-parent
	      Do not allow navitation to parent directory ("..").


       --no-self
	      Do not display menu for the current directory (".").


AUTHORS
       Xyne



				  August 2009		      OBFILEBROWSER(1)