NAME

       paperwork-cli - cli interface to paperwork

SYNOPSIS

       paperwork-cli [-h] command

DESCRIPTION

       Interactive shell frontend for Paperwork.

OPTIONS

       -h, --help
              Show help for paperwork-shell

       sync   Synchronize the index(es) with the content of the work directory

       show [--pages]
              Show the content of a document

                 --pages
                        Pages to show: 1,4 or 1-10 (default: all)

       search [--limit]
              Search keywords in documents

                 --limit, -l LIMIT
                        Maximum number of results (default: 50)

       scanner subcommand
              Manage scanner configuration

                 list   List all scanners and their possible settings

                 get    Show the currently selected scanner and its settings

                 set [--source SOURCE] [--resolution RESOLUTION] device_id
                        Define which scanner and which settings to use

                        --source SOURCE
                               Default  source  on the scanner to use (if not specified, one will
                               be selected randomly)

                        --resolution RESOLUTION, -r RESOLUTION
                               Default resolution (dpi ; default=300)

       scan [--doc_id DOC_ID] source_id`
              Scan pages

              --doc_id DOC_ID, -d DOC_ID
                     Document to which the scanned pages must be added

       reset [--pages PAGES] doc_id
              Reset a page to its original content

              --pages PAGES, -p PAGES

       rename source_doc_id dest_doc_id
              Change a document identifier

              source_doc_id
                     Document to rename

              dest_doc_id
                     New name for the document

       ocr [--pages PAGES] doc_id
              OCR document or pages

              --pages PAGES, -p PAGES
                     Pages to OCR  (single integer, range or comma-separated list,  default:  all
                     pages)

       move source_doc_id source_page dest_doc_id dest_page
              Move a page

              source_doc_id
                     Source document

              source_page
                     Page to move

              dest_doc_id
                     Destination document

              dest_page
                     Target page number

       label subcommand
              Commands to manage labels

              list   Show labels

              show [doc_ids [doc_ids ...]]
                     Show labels from doc_ids

                     doc_ids
                            Document(s)

              add [--color COLOR] doc_id label_name
                     Add label label_name to document doc_id with optional color COLOR

              remove doc_id label_name
                     Remove label label_name from document doc_id

              delete label_name
                     Delete label label_name

       import [--doc_id DOC_ID] [files [files ...]]
              Import file(s)

              files  Files to import

              --doc_id, --doc, -d DOC_ID
                     Target document for import

       extra_text subcommand
              Manage additional text attached to documents

              get    Get a document additional text

              set    Set a document additional text

       export [--pages PAGES] [--filters FILTERS] [--out OUT] doc_id
              Export a document, a page, or a set of pages.

              doc_id Document to export

              --pages, -p PAGES
                     Pages to export (single integer, range or comma-separated list, default: all
                     pages)

              --filters, -f FILTERS
                     Export filters. Specify this option once for each filter to apply  (ex:  '-f
                     grayscale -f jpeg').

              --out, -o OUT
                     Output file/directory. If not specified, will list the filters that could be
                     chained after those already specified.

       edit [--modifiers MODIFIERS] [--pages PAGES] doc_id
              Edit page

              doc_id

              --modifiers, -m MODIFIERS
                     List   of   image   modifiers    (comma    separated,    possible    values:
                     ['rotate_clockwise', 'rotate_counterclockwise', 'color_equalization'])

              --pages, -p PAGES

       delete [--pages PAGES] [doc_ids [doc_ids ...]]
              Delete a document or a page

              doc_ids
                     Target documents

              --pages, -p PAGES
                     Pages to delete (single integer, range or comma-separated list, default: all
                     pages)

       about  About Paperwork

       plugins subcommand
              Manage paperwork-cli plugins

              list   Show plugins enabled for paperwork-cli

              add    Add plugin in papaerwork-cli

              remove Remove plugin from paperwork-cli

              reset  Clean up your mess by resetting the plugin list to its default value

              show   Show information regarding a plugin (must be enabled)

       config subcommand
              Manage Paperwork configuration

              get    Get a value from Paperwork's configuration

              put    Set a value in Paperwork's configuration

              show   Show Paperwork's configuration

              list_types
                     Show value types you can use from command line

EXAMPLE

       • Export a document:

         paperwork-cli export 20150303_2314_39  -p  2  -f  img_boxes  -f  grayscale  -f  jpeg  -o
         ~/tmp/pouet.jpg

SEE ALSO

       • paperwork-json(1), paperwork-gtk(1)

       • The paperwork frontend introduction (file:///usr/share/doc/paperwork-gtk/intro.pdf)

       • The paperwork frontend usage manual (file:///usr/share/doc/paperwork-gtk/usage.pdf)

AUTHOR

       Thomas Perret, 2019-2020

COPYRIGHT

       GPL-3.0+