# BINS

## Name

bins-edit-gui -- Set fields in XML picture description files for BINS (using a GNOME-based GUI)

## Synopsis

bins-edit-gui [`files`...]

## DESCRIPTION

This manual page documents briefly the bins-edit-gui command.

bins-edit-gui sets values in the XML picture description files that bins(1) uses to generate galleries. It displays the image (scaled down to fit the window) and allows you to fill in the predefined fields (or add new ones.) For command-line editing of the same data, see bins_edit(1).

## OPTIONS

This program follows the usual GNU command line syntax, with long options starting with two dashes (`-'). A summary of options is included below.

`file`

  `file` is the filename of the image itself.

`-v`, `--version`

  Displays program version.

`-v`, `--version`

  Displays program version.

`-h`, `--help`

  Displays command-line options.

`--debug`

  Enables random developer debugging messages.

## COMMANDS

C-n Next file

  Save current tags set (if any changes have been made) and move on to the next image.

M-Page Down Forward 10

  Save current tags set (if any changes have been made) and skip forward by 10 files.

C-p Previous file

  Save current tags set (if any changes have been made) and move back to the previous image.

M-Page Up Back 10

  Save current tags set (if any changes have been made) and skip backwards by 10 files.

M-Home Start of List

  Save current tags set (if any changes have been made) and jump to the first file.

M-End End of List

  Save current tags set (if any changes have been made) and jump to the last file.

M-a Auto-fill

  Fill in any blank fields with the values from the most recently seen image. Particularly useful for copying a location or event across a set of images.

Revert

  Reload tags from the XML file, wiping unsaved changes.

C-s Save

  Save changes, if any.

F2 Album

  Edit the album this picture is in. (Under construction, but functional.)

F3 Open

  Not yet implemented. Should provide a file browser later.

> Rotate Right

  Rotate image to the Right (Clockwise.) Actually sets the `Orientation` tag with `priority` 1 so that it overrides the corresponding EXIF tag; it does not modify the image file itself.

Cancel rotation

  Cancels any current changes to the rotation tags (effectively, this is a "revert" function for the rotation, it doesn't to back to the original EXIF tags in the JPEG file.)

< Rotate Left

  Rotate image to the Left (Counter Clockwise.) Actually sets the `Orientation` tag with `priority` 1 so that it overrides the corresponding EXIF tag; it does not modify the image file itself.

C-q Quit

  Quit program, saving current changes (if any.)

About

  Display About box.

License

  Display License box.

## EXAMPLES

Edit all the images in a directory:

bins-edit-gui $(find bins-picture-dir -name '*.jpg')

## SEE ALSO

bins (1), bins_edit (1).

## AUTHOR

This manual page was written by Mark W. Eichin `<eichin@thok.org>`.