Provided by: paperwork-backend_1.3.1-2_all 
NAME
paperwork-shell - cli interface to paperwork
SYNOPSIS
paperwork-shell command
DESCRIPTION
Paperwork shell is a cli interface to control paperwork working directory. Most commands
output a JSON structure.
COMMANDS
-h, --help
Show help for paperwork-shell
-q Quiet mode (JSON reply only)
-b Batch mode (never ask any question)
help [command]
Show help for command or all commands by default
scan Start paperwork and immediately scan a page
add_label document label [color]
Add a label on a document. Color must be specified if the label doesn't exists yet.
Color will be ignored if the label already exists. Color format must be given in
hexadecimal format (e.g. #abcdef). Document must be specified using the ID of the
document (see search command).
delete_doc document document must be specified using its ID (see search command)
dump document [page]
Dump the content of the specified document. You can specify which page to dump
with its number. Beware, page start from 1. Document must be specified using its ID
(see search command). Beware: This is the only command not replying in JSON format
export_all output_dir [-- [--quality quality] [--page_format format]]
Export all documents as PDF files in output_fir folder. Default quality is 50.
Default page format is A4.
export_doc document filename [-- [--quality quality] [--page_format format]]
Export one document as a PDF file named filename. Default quality is 50. Default
page format is A4.
guess_labels document [-- [--apply]]
Guess the labels that should be set on the document. Guessed labels are not applied
by default, if you wan them to be applied, invoke with the --apply argument.
Document must be specified using its ID.
import file_or_folder [file_or_folder [...]] [-- [--no_ocr] [--no_label_guessing]
[--append document]]
Import a file or a PDF folder. OCR is run by default on images and on PDF pages
without text (PDF containing only images) (use --no_ocr to disable). You can
disable automatic label guessing by using --no_label_guessing option. You can add
the file to an existing document by using the --append option. Document must be
specified using its ID (see searc command). Please keep in mind that documents that
are already in the word directory are never imported again and are simply silently
ignored.
ocr document`[`|page] [document`[`|page] [...]] [-- [--lang language] [--empty_only]]
Re-run the OCR on the specified elements. Elements can be whole documents or
specific pages (see EXAMPLE). Specifies the language to use for OCR with --lang
option (check OCR tool for supported language). The default language used is the
one in Paperwork's configuration. Run through pages without text only using the
--empty_only otherwise, all pages are processed.
remove_label document label
Remove a label from a document. Note that if the document was the last one to use
the label, the label may disappear entirely from Paperwork. Document must be
specified using its ID (see search command).
rename old new
Change the ID of a document. Note that the document id are also their date. Using
an ID that is not a date may have side effects (the main one being the document
won't be sorted correctly).
rescan Rescan the work directory. Look for new, updated or deleted documents and update
the index accordingly.
search keyword [keyword [...]]
List the documents containing the keywords. Syntax is the same than with the search
field in Paperwork-gui. Search "" (empty string) to get all the documents. See
EXAMPLE.
show document
Show document information (but not its content, see dump). See search for the
document id.
switch_workdir path
Change current Paperwork's work directory to path. Does not update the index. You
should run the rescan command after this one.
EXAMPLE
• Get help for the rescan command:
paperwork-shell help rescan
• Create a new label and add it to a document:
paperwork-shell add_label 19700101_0000_01 important #ff0000
• Delete a document:
paperwork-shell delete_doc 19700101_0000_01
• Dump the third page of a document:
paperwork-shell dump 19700101_0000_01 3
• Export all documents into a folder:
paperwork-shell export_all export-folder --quality 80 --format A4
• Export one document:
paperwork-shell export_doc 19700101_0000_01 important_doc.pdf --quality 30
• Guess labels of a document without applying them:
paperwork-shell guess_labels 19700101_0000_01
• Import a folder of PDF files into paperwork workdir:
paperwork-shell import folder/
• Add an image to an existing document:
paperwork-shell import image.png -- --append 19700101_0000_01
• Redo OCR on a documents with another language:
paperwork-shell ocr 19700101_0000_01 -- --lang jpn
• Redo OCR on a specific page:
paperwork-shell ocr "19700101_0000_01|2"
• Remove a label from a document:
paperwork-shell remove_label 19700101_0000_01 important
• Rescan working:
paperwork-shell rescan
• Search documents in workdir:
paperwork-shell search "label:important AND paperwork"
• Show document information:
paperwork-shell show 19700101_0000_01
• Change workdir
paperwork-shell switch_workdir ~/papers
SEE ALSO
• paperwork(1)
• The paperwork frontend manual (file:///usr/share/doc/paperwork-gtk/usage.pdf)
AUTHOR
Thomas Perret, 2019
COPYRIGHT
GPL-3.0+