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 \-r,\-\-remote
  55 Send following commands to open window.
  56 .br
  57 .B
  58 .IP \-rh,\-\-remote-help
  59 Print remote command list.
  60 .br
  61 .B
  62 .IP \-\-debug[=level]
  63 Turn on debugging output.
  64 .br
  65 .B
  66 .IP \-g:<regexp>,\-\-grep:<regexp>
  67 Filter debug output.
  68 .br
  69 .B
  70 .IP \+w,\-\-show-log-window
  71 Show log window.
  72 .br
  73 .B
  74 .IP \-o:<FILE>,\-\-log-file:<FILE>
  75 Save log data to FILE.
  76 .br
  77 .B
  78 .IP \-v,\-\-version
  79 Print version.
  80 .br
  81 .B
  82 .IP \-h,\-\-help
  83 Print command line options.
  84
  85 .SH REMOTE OPTIONS
  86 .B
  87 .IP \-n,\-\-next
  88 Next image.
  89 .br
  90 .B
  91 .IP \-b,\-\-back
  92 Previous image.
  93 .br
  94 .B
  95 .IP \-\-first
  96 First image.
  97 .br
  98 .B
  99 .IP \-\-last
 100 Last image.
 101 .br
 102 .B
 103 .IP \-f,\-\-fullscreen
 104 Toggle full screen.
 105 .br
 106 .B
 107 .IP \-fs,\-\-fullscreen-start
 108 Start full screen.
 109 .br
 110 .B
 111 .IP \-fS,\-\-fullscreen-stop
 112 Stop full screen.
 113 .br
 114 .B
 115 .IP \-s,\-\-slideshow
 116 Toggle slideshow.
 117 .br
 118 .B
 119 .IP \-ss,\-\-slideshow-start
 120 Start slideshow.
 121 .br
 122 .B
 123 .IP \-sS,\-\-slideshow-stop
 124 Stop slideshow.
 125 .br
 126 .B
 127 .IP \-\-slideshow-recurse:<FOLDER>
 128 Start recursive slide show in FOLDER.
 129 .br
 130 .B
 131 .IP \-d<[HRS:][MINS:][N][.M]>,\-\-delay=<[hrs:][mins][N][.M]>
 132 Set slide show delay to Hrs Mins N.M seconds.
 133 .br
 134 .B
 135 .IP \+t,\-\-tools-show
 136 Show tools.
 137 .br
 138 .B
 139 .IP \-t,\-\-tools-hide
 140 Hide tools.
 141 .br
 142 .B
 143 .IP \-q,\-\-quit
 144 Quit.
 145 .br
 146 .B
 147 .IP \-\-config-load:<FILE>
 148 Load configuration from FILE.
 149 .br
 150 .B
 151 .IP \-\-get-sidecars:<FILE>
 152 Get list of sidecars of FILE.
 153 .br
 154 .B
 155 .IP \-\-get-destination:<FILE>
 156 Get destination path of FILE.
 157 .br
 158 .B
 159 .IP \-\-file:<FILE>
 160 Open FILE, bring Geeqie window to the top.
 161 .br
 162 .B
 163 .IP \-\-File:<FILE>
 164 Open FILE, do not bring Geeqie window to the top.
 165 .br
 166 .B
 167 .IP \-\-tell
 168 Print filename of current image.
 169 .br
 170 .B
 171 .IP \-\-pixel\-info
 172 Print X, Y and RGB of mouse pointer on current image.
 173 .br
 174 .B
 175 .IP \-\-view:<FILE>
 176 Open FILE in new window.
 177 .br
 178 .B
 179 .IP \-\-list-clear
 180 Clear command line collection list.
 181 .br
 182 .B
 183 .IP \-\-list-add:<FILE>
 184 Add FILE to command line collection list.
 185 .br
 186 .B
 187 .IP raise
 188 Bring the Geeqie window to the top.
 189 .br
 190 .B
 191 .IP \-ct:clear|clean,\-\-cache-thumbs:clear|clean
 192 Clear or clean thumbnail cache.
 193 .br
 194 .B
 195 .IP \-cs:clear|clean,\-\-cache-shared:clear|clean
 196 Clear or clean shared thumbnail cache.
 197 .br
 198 .B
 199 .IP \-cm,\-\-cache-metadata
 200 Clean metadata cache.
 201 .br
 202 .B
 203 .IP \-cr:<folder>,\-\-cache-render:<folder>
 204 Render thumbnails.
 205 .br
 206 .B
 207 .IP \-crr:<folder>,\-\-cache-render-recurse:<folder>
 208 Render thumbnails recursively.
 209 .br
 210 .B
 211 .IP \-crs:<folder>,\-\-cache-render-shared:<folder>
 212 Render thumbnails (see Help).
 213 .br
 214 .B
 215 .IP \-crsr:<folder>,\-\-cache-render-shared-recurse:<folder>
 216 Render thumbnails recursively (see Help).
 217 .br
 218 .B
 219 .IP \-\-lua:<FILE>,<lua-script>
 220 Run lua script on FILE.
 221 .br
 222
 223 .SH USAGE
 224 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.
 225 .B
 226 .IP left-mouse-click
 227 (on image) next image
 228 .br
 229 .B
 230 .IP middle-mouse-click
 231 (on image) previous image
 232 .br
 233 .B
 234 .IP right-mouse
 235 context menu
 236 .br
 237 .B
 238 .IP middle-mouse-drag
 239 drag and drop operations
 240 .br
 241 .B
 242 .IP mouse-wheel
 243 (on image) Changes to the next or previous image, or if option is enabled, scrolls the image vertically.
 244 .br
 245 .B
 246 .IP mouse-wheel+Shift-key
 247 (on image) Inverts the mouse wheel behavior between scrolling image or changing image.
 248 .br
 249 .B
 250 .IP mouse-wheel+Control-key
 251 (on image) Zooms the image in and out.
 252 .br
 253 .SS GENERAL  KEYS
 254 .B
 255 .IP PageDown
 256 next image
 257 .br
 258 .B
 259 .IP PageUp
 260 previous image
 261 .br
 262 .B
 263 .IP Home
 264 first image in list
 265 .br
 266 .B
 267 .IP End
 268 last image in list
 269 .br
 270 .B
 271 .IP Tab
 272 tab completion in path entry window
 273 .br
 274 .B
 275 .IP Escape
 276 cancel completion in path entry window or stop generating thumbnails
 277 .br
 278 .SS IMAGE KEYS
 279 Keys that are valid when the image part of the window is focused.
 280 .B
 281 .IP Arrows
 282 pan image
 283 .br
 284 .B
 285 .IP Shift+Arrows
 286 pan image faster
 287 .br
 288 .B
 289 .IP Space,N
 290 next image
 291 .br
 292 .B
 293 .IP Backspace,B
 294 previous image
 295 .br
 296 .SS FILE RELATED KEYS
 297 .B
 298 .IP C
 299 new empty collection
 300 .br
 301 .B
 302 .IP O
 303 open collection
 304 .br
 305 .B
 306 .IP D
 307 open the Find Duplicates window
 308 .br
 309 .B
 310 .IP C-F
 311 new folder
 312 .br
 313 .B
 314 .IP C-C
 315 copy file
 316 .br
 317 .B
 318 .IP C-M
 319 move file
 320 .br
 321 .B
 322 .IP C-R
 323 rename file
 324 .br
 325 .B
 326 .IP C-D,Delete
 327 delete file
 328 .br
 329 .B
 330 .IP C-N
 331 new window
 332 .br
 333 .B
 334 .IP C-W
 335 close window
 336 .br
 337 .B
 338 .IP C-Q
 339 quit
 340 .br
 341 .SS EDIT MENU RELATED KEYS
 342 .B
 343 .IP C-1,2..9,0
 344 run external editor
 345 .br
 346 .B
 347 .IP C-A
 348 select all files
 349 .br
 350 .B
 351 .IP C-S-A
 352 unselect all files
 353 .br
 354 .B
 355 .IP C-O
 356 go to the Configuration window
 357 .br
 358 .B
 359 .IP C-P
 360 display image properties
 361 .br
 362 .B
 363 .IP ]
 364 rotate image clockwise
 365 .br
 366 .B
 367 .IP [
 368 rotate image counterclockwise
 369 .br
 370 .B
 371 .IP S-R
 372 rotate image 180 degrees
 373 .br
 374 .B
 375 .IP S-M
 376 mirror image (horizontal)
 377 .br
 378 .B
 379 .IP S-F
 380 flip image (vertical)
 381 .br
 382 .SS VIEW MENU RELATED KEYS
 383 .B
 384 .IP +,=
 385 zoom in
 386 .br
 387 .B
 388 .IP -
 389 zoom out
 390 .br
 391 .B
 392 .IP Z,KeyPad-/
 393 zoom to original size
 394 .br
 395 .B
 396 .IP X,KeyPad-*
 397 zoom to fit window
 398 .br
 399 .B
 400 .IP 1,2,3,4
 401 zoom in to X scale factor
 402 .br
 403 .B
 404 .IP 9,8,7
 405 zoom to \-2, \-3, \-4, respectively
 406 .br
 407 .B
 408 .IP T
 409 toggle thumbnail display
 410 .br
 411 .B
 412 .IP C-L
 413 display files in list format
 414 .br
 415 .B
 416 .IP C-I
 417 display files in icon format
 418 .br
 419 .B
 420 .IP C-T
 421 toggle tree view for directories
 422 .br
 423 .B
 424 .IP R
 425 refresh file list
 426 .br
 427 .B
 428 .IP L
 429 toggle floating of file selection area
 430 .br
 431 .B
 432 .IP H
 433 toggle hiding of file selection area
 434 .br
 435 .B
 436 .IP F,V
 437 toggle full-screen mode
 438 .br
 439 .B
 440 .IP S
 441 toggle slide-show mode
 442 .br
 443 .B
 444 .IP P
 445 toggle pause of slideshow
 446 .br
 447 .B
 448 .IP C-E
 449 toggle display of exif sidebar
 450 .br
 451 .B
 452 .IP C-S
 453 toggle display of sort manager
 454 .br
 455 .SS COLLECTION WINDOW KEYS
 456 .B
 457 .IP Arrows
 458 move selection
 459 .br
 460 .B
 461 .IP Shift+Arrows
 462 select multiple images
 463 .br
 464 .B
 465 .IP Control+Arrows
 466 move selector without changing selection
 467 .br
 468 .B
 469 .IP Space
 470 select the image under the selector
 471 .br
 472 .B
 473 .IP Control+Space
 474 toggle selection of the image under the selector
 475 .br
 476 .B
 477 .IP Home
 478 move selector to the top image
 479 .br
 480 .B
 481 .IP End
 482 move selector to bottom image
 483 .br
 484 Adding Shift or Control to Home and End has a similar effect as adding them to the arrows.
 485 .B
 486 .IP C-A
 487 select all images
 488 .br
 489 .B
 490 .IP C-S-A
 491 unselect all images
 492 .br
 493 .B
 494 .IP Delete
 495 remove image form collection (does not delete the file)
 496 .br
 497 .B
 498 .IP C-L
 499 add images to collection form main file list
 500 .br
 501 .B
 502 .IP N
 503 sort collection by name
 504 .br
 505 .B
 506 .IP D
 507 sort collection by date
 508 .br
 509 .B
 510 .IP B
 511 sort collection by file size
 512 .br
 513 .B
 514 .IP P
 515 sort collection by pathname
 516 .br
 517 .B
 518 .IP I
 519 sort collection by name numerically (*)
 520 .br
 521 .B
 522 .IP Enter
 523 view image under selector in the main image window
 524 .br
 525 .B
 526 .IP V
 527 view image under selector in new window
 528 .br
 529 .B
 530 .IP C-1,2..9,0
 531 open selected image(s) in external editor
 532 .br
 533 .B
 534 .IP S
 535 save collection
 536 .br
 537 .B
 538 .IP C-S
 539 save collection as
 540 .br
 541 .B
 542 .IP A
 543 append current collection to existing collection
 544 .br
 545 .B
 546 .IP C-C
 547 copy selected files
 548 .br
 549 .B
 550 .IP C-M
 551 move selected files
 552 .br
 553 .B
 554 .IP C-R
 555 rename selected files
 556 .br
 557 .B
 558 .IP C-D
 559 delete selected files
 560 .br
 561 .B
 562 .IP C-W
 563 close window
 564 .br
 565 .SS DUPLICATES WINDOW KEYS
 566 .B
 567 .IP C-A
 568 select all images
 569 .br
 570 .B
 571 .IP C-S-A
 572 unselect all images
 573 .br
 574 .B
 575 .IP 1
 576 select group 1 images
 577 .br
 578 .B
 579 .IP 2
 580 select group 2 images
 581 .br
 582 .B
 583 .IP C-L
 584 add images from main window file list
 585 .br
 586 .B
 587 .IP C
 588 add selected images to new collection
 589 .br
 590 .B
 591 .IP Delete
 592 remove selected images from list
 593 .br
 594 .B
 595 .IP C-Delete
 596 clear window
 597 .br
 598 .B
 599 .IP Enter
 600 view image with focus in main window
 601 .br
 602 .B
 603 .IP V
 604 view image with focus in new window
 605 .br
 606 .B
 607 .IP C-1,2..9,0
 608 open selected image(s) in editor
 609 .br
 610 .B
 611 .IP C-P
 612 display properties window for selected images
 613 .br
 614 .B
 615 .IP C-C
 616 copy selected files
 617 .br
 618 .B
 619 .IP C-M
 620 move selected files
 621 .br
 622 .B
 623 .IP C-R
 624 rename selected files
 625 .br
 626 .B
 627 .IP C-D
 628 delete selected files
 629 .br
 630 .B
 631 .IP C-W
 632 close window
 633 .br
 634
 635
 636 .SH LICENSE
 637 Copyright (C) 1999-2004 by John Ellis.
 638 Copyright (C) 2004-2017 by The Geeqie Team.
 639 Use this software at your own risk!
 640 This software released under the GNU General Public License. Please read the COPYING file for more information.
 641 .SH BUGS
 642 Please send bug reports and feedback to https://github.com/BestImageViewer/geeqie/issues
 643 .SH AUTHOR
 644 .B John Ellis
 645 <johne@verizon.net>
 646 .br
 647 Manpage originally prepared by
 648 .B Nick Rusnov
 649 <nick@grawk.net>