Usage
=====

Command syntax
--------------

Run the command with parameter **--help** to see the syntax. Giving no arguments starts the **GUI mode**.

.. code:: bash

    usage: tagit [-h] [--settings SETTINGS] [--verbose] [--version]
                 {gui,clean,index,sync,merge} ...

    Image tagger tool.

    positional arguments:
      {gui,clean,index,sync,merge}
        gui                 Normal operation
        clean               Remove nonexistent images
        index               Write the database
        sync                Write the files
        merge               Create the union of two databases

    optional arguments:
      -h, --help            show this help message and exit
      --settings SETTINGS, -s SETTINGS
                            Use settings file.
      --verbose, -v
      --version             show program's version number and exit


Keybindings
-----------

=================================================== =============================================
action                                              keys
=================================================== =============================================
Show keybindings                                    SHIFT + / ('?' on the us keyboard)
Select image                                        whitespace, CTRL + whitespace, SHIFT + whitespace
Deselect image                                      whitespace, CTRL + whitespace, SHIFT + whitespace
Select all images                                   CTRL + a
Deselect all images                                 ESC, CTRL + SHIFT + a
Move the cursor around                              left, right, up and down cursor
Scroll one row down                                 j
Scroll one row up                                   k
Next page                                           page down
Previous page                                       page up
First image                                         Home
Last image                                          End
Add tag to selected images                          CTRL + t
Repeat "Add tag" on selected images                 CTRL + SHIFT + t
Edit tags of selected images                        CTRL + e
Apply filter / reload                               F5
Go back one token                                   ALT + left cursor, Backspace
Go forth one token                                  ALT + right cursor
Add filter token                                    CTRL + k
Filter address line                                 CTRL + l
Save                                                CTRL + s
Save as                                             CTRL + SHIFT + s
Show only selected images                           CTRL + ENTER
Remove selected images from view                    DEL
Rotate selected images counter-clockwise            <
Rotate selected images clockwise                    >
=================================================== =============================================