XGetfile (1)
X based audio cd player for cdrom drives
SYNOPSIS
xgetfile
[
-title
title
] [
-path
path
] [
-pattern
pattern
] [
-file
file
] [
-popup
] [
-quote
] [
-exec
command
] [
-queue
]
DESCRIPTION
XGetfile
is a versatile file requester. It pops up a window and lets the user
chose a file with the mouse or the keyboard. When the user selects a
file, several actions are possible. Please see also the
EXAMPLES
section below.
By default,
XGetfile
sends the selected filename with the complete path to stdout and exits.
This makes the program very useful for shell-scripts.
In addition, you can specify a command which
XGetfile
should execute whenever a file is selected. In that case, two modes are
possible. In normal mode, the command is executed with the filename anywhere
in its argument list, and the user will have to wait until the command
finishes before a new filename can be selected.
In queued mode, the user can select several files one after the other without
delay, while
XGetfile
will queue them up in a list. Each time a command finishes, the next file
in the list is taken and fed to a new command until the list is empty.
Queued mode is much fun when browsing through a list of audio files (:
OPTIONS
Options offered by
XGetfile
are the following:
-display lt;displaygt;
Show the control window on the given display.
-fn lt;fontgt;
Use this font rather than the default. The given font should be about the
same size like the default font. If not, the window may look ugly.
-title lt;titlegt;
Display the given title in the windows title bar instead of just
XGetfile.
-path lt;pathgt;
Start up with lt;pathgt; as the default search path.
-pattern lt;patterngt;
Display only files which match lt;patterngt;. Usual shell pattern matching
is used. The pattern string may hold several patterns separated by spaces.
Be sure to place the pattern string in double quotes on the commandline to
prevent the shell from parsing them.
-file lt;filegt;
Offer lt;filegt; to the user as the default selection. The user may still select
another file of course.
-popup
Tells
XGetfile
to pop up as a transient window directly under the pointer. Depending on your
window manager setup, this means that the requester pops up immediately
instead of letting the user pick a place for the window first. In addition,
the window manager may chose to decorate the window in a different way to
tell the user that the window is not going to live very long.
However, the actual difference between using -popup or not depends heavily
on your windowmanager.
-quote
Print the selected filename in single quotes on exit. This is useful for
filenames which contain weird characters. This option is useless if
-exec
is given.
-exec lt;commandgt;
Execute command whenever the user selects a file.
XPlaycd
won't quit after the user made a selection, but will continue running until
the user selects
Cancel
or the program gets otherwise killed.
Up to eight occurances of
%s
in lt;commandgt; will be replaced by the selected file. Be sure to place the
command in double quotes on the command line if it contains tabs or spaces.
-queue
This option is only useful if a command was specified with the -exec option.
XPlaycd
will run in queued mode and won't wait until a command finishes before the
user can select a new file. See examples below.
RESOURCES
XGetfile
understands a large number of
X11
resources which are listed below. These system wide resources usually sit in
a file called
/usr/lib/X11/app-defaults/XGetfile.
Personal resources reside either in
~/.Xdefaults
or
~/.Xresources
depending on your installation. To put an
XGetfile
resource into your personal resource file, prefix it with the word
xgetfile.
After editing your personal file, be sure to run
xrdb ~/.Xresources
or
xrdb ~/.Xdefaults
to make them work. There is no need for a prefix or an invocation of
xrdb
if you change the system wide file.
STANDARD RESOURCES
SPECIAL RESOURCES
Special
XGetfile
resources are:
*brightBorder: gray94
*darkBorder: gray40
*hilightColor: gray72
These settings are responsible for the 3D-look-and-feel of the program.
Just play with the values to see what they do.
EXAMPLES
Here are a few examples for the use of XGetfile.
In a shell script:
SELECTION=`xgetfile -title "Please select a file to load" -path "/tmp"`
XGetfile
will prompt the user for a file and will print it to stdout. The
calling shell will take
XGetfile's
output and assign it to the environment variable
SELECTION
for further processing.
If you want to use XGetfile in a script which may be used from graphic
and text based terminals, you should check for the
DISPLAY
environment variable and you should provide a text based way to select
a file if
DISPLAY
is not set. I find the
dialog(1)
program useful for that purpose.
As a versatile frontend to an audio file player with the assumed command
name
play
:
xgetfile -title "Please select a file to play" -exec "play %s" -queue"
XGetfile
will take each selected file and execute
play lt;filenamegt;
which will play it throught the sound hardware. If the user selects
more than one file, the next sample is played as soon as the previous one
ends.
If you give the command without the
-queue
option, the user
must
wait until the
play
command finishes.
To understand the difference between queued and normal mode, try something
like this example with and without the
-queue
option.
I like it to browse through my selection of samples with the following
short script:
#!/bin/sh
exec xgetfile -title "Please select a file to play" \\
-path "/usr/local/lib/sound/fx" -exec "play %s" -queue
BUGS
This manpage is
really
confusing.
SEE ALSO
AUTHOR
Olav Woelfelschneider
(wosch@rbg.informatik.th-darmstadt.de)
COPYING
Copyright (C) 1994
Olav Woelfelschneider
(wosch@rbg.informatik.th-darmstadt.de)
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
| 
