geeqie.1

   1 .\"Created with GNOME Manpages Editor
   2 .\"http://gmanedit.sourceforge.net
   3 .\"Sergio Rua <srua@gpul.org>
   4 .\"
   5 .\"
   6 .\" Geeqie manual page.
   7 .\" (C)2004 John Ellis <johne@verizon.net>
   8 .\"
   9 .\" This document is free to modify and distribute.
  10 .\"
  11 .TH geeqie 1 "Geeqie"
  12
  13 .SH NAME
  14 Geeqie \- GTK based multiformat image viewer
  15 .SH SYNOPSIS
  16 .B geeqie
  17 .RI [ options ]
  18 .RI [ path ]
  19 .br
  20
  21 .SH DESCRIPTION
  22 \fBGeeqie\fP is an interactive GTK based image viewer that supports multiple image formats, zooming, panning, thumbnails and sorting images into collections.
  23
  24 .SH OPTIONS
  25 .B
  26 .IP \+t,\-\-with\-tools
  27 Force the toolbox to be shown.
  28 .br
  29 .B
  30 .IP \-t,\-\-without\-tools
  31 Force the toolbox to be hidden.
  32 .br
  33 .B
  34 .IP \-f,\-\-fullscreen
  35 Start in full screen mode.
  36 .br
  37 .B
  38 .IP \-s,\-\-slideshow
  39 Start in slideshow mode.
  40 .br
  41 .B
  42 .IP \-l,\-\-list[files...][collections...]
  43 Open collection window for command line files.
  44 .br
  45 .B
  46 .IP \-\-blank
  47 Start with blank file list.
  48 .br
  49 .B
  50 .IP \-\-geometry=XxY+XOFF+YOFF
  51 Set main window location.
  52 .br
  53 .B
  54 .IP \-n,\-\-new-instance
  55 Open a new instance of Geeqie.
  56 .br
  57 .B
  58 .IP \-r,\-\-remote
  59 Send following commands to open window.
  60 .br
  61 .B
  62 .IP \-rh,\-\-remote-help
  63 Print remote command list.
  64 .br
  65 .B
  66 .IP \-\-debug[=level]
  67 Turn on debugging output.
  68 .br
  69 .B
  70 .IP \-g:<regexp>,\-\-grep:<regexp>
  71 Filter debug output.
  72 .br
  73 .B
  74 .IP \+w,\-\-show-log-window
  75 Show log window.
  76 .br
  77 .B
  78 .IP \-o:<FILE>,\-\-log-file:<FILE>
  79 Save log data to FILE.
  80 .br
  81 .B
  82 .IP \-v,\-\-version
  83 Print version.
  84 .br
  85 .B
  86 .IP \-h,\-\-help
  87 Print command line options.
  88
  89 .SH REMOTE OPTIONS
  90 .B
  91 .IP \-n,\-\-next
  92 Next image.
  93 .br
  94 .B
  95 .IP \-b,\-\-back
  96 Previous image.
  97 .br
  98 .B
  99 .IP \-\-first
 100 First image.
 101 .br
 102 .B
 103 .IP \-\-last
 104 Last image.
 105 .br
 106 .B
 107 .IP \-f,\-\-fullscreen
 108 Toggle full screen.
 109 .br
 110 .B
 111 .IP \-fs,\-\-fullscreen-start
 112 Start full screen.
 113 .br
 114 .B
 115 .IP \-fS,\-\-fullscreen-stop
 116 Stop full screen.
 117 .br
 118 .B
 119 .IP \-s,\-\-slideshow
 120 Toggle slideshow.
 121 .br
 122 .B
 123 .IP \-ss,\-\-slideshow-start
 124 Start slideshow.
 125 .br
 126 .B
 127 .IP \-sS,\-\-slideshow-stop
 128 Stop slideshow.
 129 .br
 130 .B
 131 .IP \-\-slideshow-recurse:<FOLDER>
 132 Start recursive slide show in FOLDER.
 133 .br
 134 .B
 135 .IP \-d<[HRS:][MINS:][N][.M]>,\-\-delay=<[hrs:][mins][N][.M]>
 136 Set slide show delay to Hrs Mins N.M seconds.
 137 .br
 138 .B
 139 .IP \+t,\-\-tools-show
 140 Show tools.
 141 .br
 142 .B
 143 .IP \-t,\-\-tools-hide
 144 Hide tools.
 145 .br
 146 .B
 147 .IP \-q,\-\-quit
 148 Quit.
 149 .br
 150 .B
 151 .IP \-\-config-load:<FILE>|layout\ ID
 152 Load configuration from FILE.
 153 .br
 154 .B
 155 .IP \-\-get-sidecars:<FILE>
 156 Get list of sidecars of FILE.
 157 .br
 158 .B
 159 .IP \-\-get-destination:<FILE>
 160 Get destination path of FILE.
 161 .br
 162 .B
 163 .IP file:<FILE>|<URL>
 164 Open FILE or URL, bring Geeqie window to the top.
 165 .br
 166 .B
 167 .IP \-\-file:<FILE>|<URL>
 168 Open FILE or URL, bring Geeqie window to the top.
 169 .br
 170 .B
 171 .IP File:<FILE>|<URL>
 172 Open FILE or URL, do not bring Geeqie window to the top.
 173 .br
 174 .B
 175 .IP \-\-File:<FILE>|<URL>
 176 Open FILE or URL, do not bring Geeqie window to the top.
 177 .br
 178 .B
 179 .IP \-\-tell
 180 Print filename [and Collection] of current image.
 181 .br
 182 .B
 183 .IP \-\-pixel\-info
 184 Print X, Y and RGB of mouse pointer on current image.
 185 .br
 186 .B
 187 .IP \-\-get\-rectangle
 188 Get rectangle co-ordinates.
 189 .br
 190 .B
 191 .IP \-\-get\-render\-intent
 192 Get render intent.
 193 .br
 194 .B
 195 .IP \-\-get\-filelist:[<FOLDER>]
 196 Get list of files and class.
 197 .br
 198 .B
 199 .IP \-\-get\-filelist-recurse:[<FOLDER>]
 200 Get list of file and class recursive.
 201 .br
 202 .B
 203 .IP \-\-get\-collection:<COLLECTION>
 204 Get collection content.
 205 .br
 206 .B
 207 .IP \-\-get\-collection\-list
 208 Get collection list.
 209 .br
 210 .B
 211 .IP view:<FILE>
 212 Open FILE in new window.
 213 .br
 214 .B
 215 .IP \-\-view:<FILE>
 216 Open FILE in new window.
 217 .br
 218 .B
 219 .IP \-\-list-clear
 220 Clear command line collection list.
 221 .br
 222 .B
 223 .IP \-\-list-add:<FILE>
 224 Add FILE to command line collection list.
 225 .br
 226 .B
 227 .IP raise
 228 Bring the Geeqie window to the top.
 229 .br
 230 .B
 231 .IP \-\-raise
 232 Bring the Geeqie window to the top.
 233 .br
 234 .B
 235 .IP \-\-id:<ID>
 236 Window ID for following commands.
 237 .br
 238 .B
 239 .IP \-\-new-window
 240 Open new window.
 241 .br
 242 .B
 243 .IP \-\-close-window
 244 Close window.
 245 .br
 246 .B
 247 .IP \-\-geometry=XxY+XOFF+YOFF
 248 Set window geometry.
 249 .br
 250 .B
 251 .IP \-ct:clear|clean,\-\-cache-thumbs:clear|clean
 252 Clear or clean thumbnail cache.
 253 .br
 254 .B
 255 .IP \-cs:clear|clean,\-\-cache-shared:clear|clean
 256 Clear or clean shared thumbnail cache.
 257 .br
 258 .B
 259 .IP \-cm,\-\-cache-metadata
 260 Clean metadata cache.
 261 .br
 262 .B
 263 .IP \-cr:<folder>,\-\-cache-render:<folder>
 264 Render thumbnails.
 265 .br
 266 .B
 267 .IP \-crr:<folder>,\-\-cache-render-recurse:<folder>
 268 Render thumbnails recursively.
 269 .br
 270 .B
 271 .IP \-crs:<folder>,\-\-cache-render-shared:<folder>
 272 Render thumbnails (see Help).
 273 .br
 274 .B
 275 .IP \-crsr:<folder>,\-\-cache-render-shared-recurse:<folder>
 276 Render thumbnails recursively (see Help).
 277 .br
 278 .B
 279 .IP \-\-lua:<FILE>,<lua-script>
 280 Run lua script on FILE.
 281 .br
 282 .B
 283 .IP \-\-PWD:<PWD>
 284 Use PWD as working directory for following commands.
 285 .br
 286 .B
 287 .IP \-\-print0
 288 Terminate returned data with null character instead of newline.
 289 .br
 290
 291 .SH USAGE
 292 Key naming is similar to that of \fBemacs\fP(1): \fIC-key\fP indicates that control should be held, and key should be pressed; \fIS-key\fP  indicates that shift should be held and key should be pressed; these two can be combined, also, into \fIC-S-key\fP.
 293 .B
 294 .IP left-mouse-click
 295 (on image) next image
 296 .br
 297 .B
 298 .IP middle-mouse-click
 299 (on image) previous image
 300 .br
 301 .B
 302 .IP right-mouse
 303 context menu
 304 .br
 305 .B
 306 .IP middle-mouse-drag
 307 drag and drop operations
 308 .br
 309 .B
 310 .IP mouse-wheel
 311 (on image) Changes to the next or previous image, or if option is enabled, scrolls the image vertically.
 312 .br
 313 .B
 314 .IP mouse-wheel+Shift-key
 315 (on image) Inverts the mouse wheel behavior between scrolling image or changing image.
 316 .br
 317 .B
 318 .IP mouse-wheel+Control-key
 319 (on image) Zooms the image in and out.
 320 .br
 321 .SS GENERAL  KEYS
 322 .B
 323 .IP PageDown
 324 next image
 325 .br
 326 .B
 327 .IP PageUp
 328 previous image
 329 .br
 330 .B
 331 .IP Home
 332 first image in list
 333 .br
 334 .B
 335 .IP End
 336 last image in list
 337 .br
 338 .B
 339 .IP Tab
 340 tab completion in path entry window
 341 .br
 342 .B
 343 .IP Escape
 344 cancel completion in path entry window or stop generating thumbnails
 345 .br
 346 .SS IMAGE KEYS
 347 Keys that are valid when the image part of the window is focused.
 348 .B
 349 .IP Arrows
 350 pan image
 351 .br
 352 .B
 353 .IP Shift+Arrows
 354 pan image faster
 355 .br
 356 .B
 357 .IP Space,N
 358 next image
 359 .br
 360 .B
 361 .IP Backspace,B
 362 previous image
 363 .br
 364 .SS FILE RELATED KEYS
 365 .B
 366 .IP C
 367 new empty collection
 368 .br
 369 .B
 370 .IP O
 371 open collection
 372 .br
 373 .B
 374 .IP D
 375 open the Find Duplicates window
 376 .br
 377 .B
 378 .IP C-F
 379 new folder
 380 .br
 381 .B
 382 .IP C-C
 383 copy file
 384 .br
 385 .B
 386 .IP C-M
 387 move file
 388 .br
 389 .B
 390 .IP C-R
 391 rename file
 392 .br
 393 .B
 394 .IP C-D,Delete
 395 delete file
 396 .br
 397 .B
 398 .IP C-N
 399 new window
 400 .br
 401 .B
 402 .IP C-W
 403 close window
 404 .br
 405 .B
 406 .IP C-Q
 407 quit
 408 .br
 409 .SS EDIT MENU RELATED KEYS
 410 .B
 411 .IP C-1,2..9,0
 412 run external editor
 413 .br
 414 .B
 415 .IP C-A
 416 select all files
 417 .br
 418 .B
 419 .IP C-S-A
 420 unselect all files
 421 .br
 422 .B
 423 .IP C-O
 424 go to the Configuration window
 425 .br
 426 .B
 427 .IP C-P
 428 display image properties
 429 .br
 430 .B
 431 .IP ]
 432 rotate image clockwise
 433 .br
 434 .B
 435 .IP [
 436 rotate image counterclockwise
 437 .br
 438 .B
 439 .IP S-R
 440 rotate image 180 degrees
 441 .br
 442 .B
 443 .IP S-M
 444 mirror image (horizontal)
 445 .br
 446 .B
 447 .IP S-F
 448 flip image (vertical)
 449 .br
 450 .SS VIEW MENU RELATED KEYS
 451 .B
 452 .IP +,=
 453 zoom in
 454 .br
 455 .B
 456 .IP -
 457 zoom out
 458 .br
 459 .B
 460 .IP Z,KeyPad-/
 461 zoom to original size
 462 .br
 463 .B
 464 .IP X,KeyPad-*
 465 zoom to fit window
 466 .br
 467 .B
 468 .IP 1,2,3,4
 469 zoom in to X scale factor
 470 .br
 471 .B
 472 .IP 9,8,7
 473 zoom to \-2, \-3, \-4, respectively
 474 .br
 475 .B
 476 .IP T
 477 toggle thumbnail display
 478 .br
 479 .B
 480 .IP C-L
 481 display files in list format
 482 .br
 483 .B
 484 .IP C-I
 485 display files in icon format
 486 .br
 487 .B
 488 .IP C-T
 489 toggle tree view for directories
 490 .br
 491 .B
 492 .IP R
 493 refresh file list
 494 .br
 495 .B
 496 .IP L
 497 toggle floating of file selection area
 498 .br
 499 .B
 500 .IP H
 501 toggle hiding of file selection area
 502 .br
 503 .B
 504 .IP F,V
 505 toggle full-screen mode
 506 .br
 507 .B
 508 .IP S
 509 toggle slide-show mode
 510 .br
 511 .B
 512 .IP P
 513 toggle pause of slideshow
 514 .br
 515 .B
 516 .IP C-E
 517 toggle display of exif sidebar
 518 .br
 519 .B
 520 .IP C-S
 521 toggle display of sort manager
 522 .br
 523 .SS COLLECTION WINDOW KEYS
 524 .B
 525 .IP Arrows
 526 move selection
 527 .br
 528 .B
 529 .IP Shift+Arrows
 530 select multiple images
 531 .br
 532 .B
 533 .IP Control+Arrows
 534 move selector without changing selection
 535 .br
 536 .B
 537 .IP Space
 538 select the image under the selector
 539 .br
 540 .B
 541 .IP Control+Space
 542 toggle selection of the image under the selector
 543 .br
 544 .B
 545 .IP Home
 546 move selector to the top image
 547 .br
 548 .B
 549 .IP End
 550 move selector to bottom image
 551 .br
 552 Adding Shift or Control to Home and End has a similar effect as adding them to the arrows.
 553 .B
 554 .IP C-A
 555 select all images
 556 .br
 557 .B
 558 .IP C-S-A
 559 unselect all images
 560 .br
 561 .B
 562 .IP Delete
 563 remove image form collection (does not delete the file)
 564 .br
 565 .B
 566 .IP C-L
 567 add images to collection form main file list
 568 .br
 569 .B
 570 .IP N
 571 sort collection by name
 572 .br
 573 .B
 574 .IP D
 575 sort collection by date
 576 .br
 577 .B
 578 .IP B
 579 sort collection by file size
 580 .br
 581 .B
 582 .IP P
 583 sort collection by pathname
 584 .br
 585 .B
 586 .IP I
 587 sort collection by name numerically (*)
 588 .br
 589 .B
 590 .IP Enter
 591 view image under selector in the main image window
 592 .br
 593 .B
 594 .IP V
 595 view image under selector in new window
 596 .br
 597 .B
 598 .IP C-1,2..9,0
 599 open selected image(s) in external editor
 600 .br
 601 .B
 602 .IP S
 603 save collection
 604 .br
 605 .B
 606 .IP C-S
 607 save collection as
 608 .br
 609 .B
 610 .IP A
 611 append current collection to existing collection
 612 .br
 613 .B
 614 .IP C-C
 615 copy selected files
 616 .br
 617 .B
 618 .IP C-M
 619 move selected files
 620 .br
 621 .B
 622 .IP C-R
 623 rename selected files
 624 .br
 625 .B
 626 .IP C-D
 627 delete selected files
 628 .br
 629 .B
 630 .IP C-W
 631 close window
 632 .br
 633 .SS DUPLICATES WINDOW KEYS
 634 .B
 635 .IP C-A
 636 select all images
 637 .br
 638 .B
 639 .IP C-S-A
 640 unselect all images
 641 .br
 642 .B
 643 .IP 1
 644 select group 1 images
 645 .br
 646 .B
 647 .IP 2
 648 select group 2 images
 649 .br
 650 .B
 651 .IP C-L
 652 add images from main window file list
 653 .br
 654 .B
 655 .IP C
 656 add selected images to new collection
 657 .br
 658 .B
 659 .IP Delete
 660 remove selected images from list
 661 .br
 662 .B
 663 .IP C-Delete
 664 clear window
 665 .br
 666 .B
 667 .IP Enter
 668 view image with focus in main window
 669 .br
 670 .B
 671 .IP V
 672 view image with focus in new window
 673 .br
 674 .B
 675 .IP C-1,2..9,0
 676 open selected image(s) in editor
 677 .br
 678 .B
 679 .IP C-P
 680 display properties window for selected images
 681 .br
 682 .B
 683 .IP C-C
 684 copy selected files
 685 .br
 686 .B
 687 .IP C-M
 688 move selected files
 689 .br
 690 .B
 691 .IP C-R
 692 rename selected files
 693 .br
 694 .B
 695 .IP C-D
 696 delete selected files
 697 .br
 698 .B
 699 .IP C-W
 700 close window
 701 .br
 702
 703 .SH FILES
 704 The following data lists the locations Geeqie uses for various actions. The
 705 uppercase symbols are environment variables. If they are not set on your system
 706 the fallback locations are listed in parentheses. Geeqie will first attempt to
 707 load a configuration file from:
 708
 709 .B /etc/geeqie/geeqierc.xml
 710
 711 It will then continue with the following locations.
 712 Most of Geeqie's configuration files are contained in the folder, and sub-folders of:
 713
 714 .B $XDG_CONFIG_HOME/geeqie/
 715 .B ($~/.config/geeqie/)
 716
 717 Geeqie's standard configuration file is:
 718
 719 .B .../geeqierc.xml
 720
 721 An alternative configuration file may be used by executing:
 722
 723 .B geeqie -r --config-load:<filename>
 724
 725 Geeqie-created desktop files used by Plugins are in the folder:
 726
 727 .B .../applications
 728
 729 Lua script files for Lua Extensions are in the folder:
 730
 731 .B .../lua
 732
 733 Historic data such as last several folders visited, bookmarks, and recently used collections, as well as default print settings are contained in this text file:
 734
 735 .B .../history
 736
 737 Keyboard shortcut maps are contained in this text file:
 738
 739 .B .../accels
 740
 741 The location for Collections is in the folder:
 742
 743 .B $XDG_DATA_HOME/geeqie/collections
 744 .br
 745 .B ($~/.local/share/geeqie/collections)
 746
 747 The lirc Infra-red controller configuration file must be located at:
 748
 749 .B $HOME/.lircrc
 750
 751 Thumbnails are stored in a location specified in Thumbnail Preferences
 752
 753 Metadata is stored either in the image file or in the location specified in Safe Delete
 754
 755 The safe delete folder is specified in the Metadata tab of main Preferences
 756
 757 .SH LICENSE
 758 Copyright (C) 1999-2004 by John Ellis.
 759 Copyright (C) 2004-2017 by The Geeqie Team.
 760 Use this software at your own risk!
 761 This software released under the GNU General Public License. Please read the COPYING file for more information.
 762 .SH BUGS
 763 Please send bug reports and feedback to https://github.com/BestImageViewer/geeqie/issues
 764 .SH AUTHOR
 765 .B John Ellis
 766 <johne@verizon.net>
 767 .br
 768 Manpage originally prepared by
 769 .B Nick Rusnov
 770 <nick@grawk.net>