Release scan2pdf-v2.5

Fonic · Fonic · commit d9a6cfb35010 · 2024-01-23T18:13:20.000+01:00
Changes:
- Added option '-u/--manual-duplex' to facilitate scanning double-sided
  documents with devices that lack hardware support for duplex scanning
- Added Service Menu for KDE file managers Konqueror and Dolphin for
  convenient one-click scanning to PDF file via context menu entries
- Reduced 'printx()' functions to one-liners, output warnings and errors
  to stderr
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,3 +1,11 @@
+## Changelog for release v2.5
+
+**Changes:**
+- Added option `-u/--manual-duplex` to facilitate scanning double-sided
+  documents with devices that lack hardware support for duplex scanning
+- Added _Service Menu_ for KDE file managers _Konqueror_ and _Dolphin_
+  for convenient one-click scanning to PDF file via context menu entries
+
 ## Changelog for release v2.4
 
 **Changes:**
@@ -67,4 +75,4 @@ Initial release (versions prior to v2.1 have not been published).
 
 ##
 
-_Last updated: 01/15/24_
+_Last updated: 01/23/24_
diff --git a/README.md b/README.md
@@ -2,6 +2,7 @@
 Scan documents directly to PDF files from the command line. Especially useful
 to batch-scan large volumes of documents.
 
+
 ## Donations
 I'm striving to become a full-time developer of [Free and open-source software
 (FOSS)](https://en.wikipedia.org/wiki/Free_and_open-source_software). Donations
@@ -11,6 +12,7 @@ help me achieve that goal and are highly appreciated.
 <a href="https://paypal.me/fonicmaxxim"><img src="https://raw.githubusercontent.com/fonic/donate-buttons/main/paypal-button.png" alt="Donate via PayPal" height="35"></a>&nbsp;&nbsp;
 <a href="https://ko-fi.com/fonic"><img src="https://raw.githubusercontent.com/fonic/donate-buttons/main/kofi-button.png" alt="Donate via Ko-fi" height="35"></a>
 
+
 ## Requirements
 **Dependencies:**<br/>
 _Bash_              (&ge;v4.0),
@@ -30,12 +32,20 @@ Refer to the [releases](https://github.com/fonic/scan2pdf/releases) section
 for downloads links. There is no actual installation required. Simply extract
 the downloaded archive to a folder of your choice.
 
+For [KDE](https://kde.org/) file managers
+[Konqueror](https://apps.kde.org/konqueror/) and
+[Dolphin](https://apps.kde.org/dolphin/), a
+[Service Menu](#service-menu) is included that allows for convenient one-click
+scanning to PDF file from within the context menu.
+
+
 ## Configuration
 Open `scan2pdf.conf` in your favorite text editor and adjust the settings
 to your liking. Refer to embedded comments for details. Refer to
 [this section](#configuration-options) for a listing of configuration options
 and current defaults.
 
+
 ## Quick Start
 To scan a single document to PDF file, use the following command:
 ```
@@ -50,25 +60,45 @@ $ ./scan2pdf.sh -a -o document_%05d.pdf
 See [this section](#command-line-options) for a detailed list of command line
 options.
 
+
 ## Contributing
 
-To date, _Scan to PDF (scan2pdf)_ has only been tested with _Brother_ printers.
+_Scan to PDF (scan2pdf)_ has mainly been tested with _Brother_ printers.
 If you own a printer manufactured by _HP_, _Canon_, _Epson_ or some other
 well-established brand and would like to help with adding support, please
 create an [issue on GitHub](https://github.com/fonic/scan2pdf/issues) and
 provide the output of `scanimage --help`.
 
+
+## Service Menu
+
+To use the _Service Menu_, which provides a _Scan to PDF_ entry in the
+right-click context menu of [KDE](https://kde.org/) file managers
+[Konqueror](https://apps.kde.org/konqueror/) and
+[Dolphin](https://apps.kde.org/dolphin/), simply copy/move `scan2pdf.desktop`
+to `~/.local/share/kio/servicemenus` and make sure `scan2pdf.sh` is stored in
+a location accessible via `PATH`.
+
+Advanced users might want to edit and customize `scan2pdf.desktop` (which is
+an INI-style text file) to their liking (e.g. to change scan sources, color
+modes, scan resolutions, path to `scan2pdf.sh`, etc.).
+
+Screenshot:
+
+![Screenshot](https://raw.githubusercontent.com/fonic/scan2pdf/main/SERVICEMENU.png)
+
+
 ## Command Line Options
 
 Available command line options:
 ```
 Usage: scan2pdf.sh [OPTIONS] OUTFILE
 
-Scan to PDF (scan2pdf) v2.4 (01/15/24)
+Scan to PDF (scan2pdf) v2.5 (01/23/24)
 Scan documents directly to PDF files.
 
 Options:
-  -d, --device STRING       Scanner device ['brother4:net1;dev0']
+  -d, --device STRING       Scanner device ['brother3:net1;dev0']
   -m, --mode STRING         Color mode ['24bit Color']
                             'Black & White',
                             'Gray[Error Diffusion]',
@@ -91,8 +121,12 @@ Options:
 
   -l, --topleftx VALUE      Top left x offset of scan area in mm (0..216) [0]
   -t, --toplefty VALUE      Top left y offset of scan area in mm (0..356) [0]
-  -x, --width VALUE         Width of scan area in mm (0..216) [216]
-  -y, --height VALUE        Height of scan area in mm (0..356) [279]
+  -x, --width VALUE         Width of scan area in mm (0..216) [210]
+  -y, --height VALUE        Height of scan area in mm (0..356) [297]
+
+  -u, --manual-duplex       Perform manual duplex scan: scan odd pages, prompt,
+                            scan even pages, then interleave odd and even pages
+                            to produce combined output
 
   -a, --batch-scan          Scan multiple documents, prompt in between documents
                             (option '-o/--outfile-template' becomes mandatory)
@@ -101,12 +135,14 @@ Options:
                             integer component (e.g. '~/Documents/Scan_%05d.pdf')
 
   -k, --keep-temp           Keep temporary directory on exit
+
   -h, --help                Print usage information
 
 NOTE:
 Strings/values in square brackets show current defaults.
 ```
 
+
 ## Configuration Options
 
 Configuration options and current defaults:
@@ -118,7 +154,7 @@ Configuration options and current defaults:
 #  Scan to PDF (scan2pdf)                                                      -
 #                                                                              -
 #  Created by Fonic <https://github.com/fonic>                                 -
-#  Date: 04/17/21 - 01/15/24                                                   -
+#  Date: 04/17/21 - 01/23/24                                                   -
 #                                                                              -
 # ------------------------------------------------------------------------------
 
@@ -215,4 +251,4 @@ TIFF2PDF_OPTS=("-j" "-q" "95")                              # Use JPEG compressi
 
 ##
 
-_Last updated: 01/15/24_
+_Last updated: 01/23/24_
diff --git a/SERVICEMENU.png b/SERVICEMENU.png
diff --git a/scan2pdf.conf b/scan2pdf.conf
@@ -5,7 +5,7 @@
 #  Scan to PDF (scan2pdf)                                                      -
 #                                                                              -
 #  Created by Fonic <https://github.com/fonic>                                 -
-#  Date: 04/17/21 - 01/15/24                                                   -
+#  Date: 04/17/21 - 01/23/24                                                   -
 #                                                                              -
 # ------------------------------------------------------------------------------
 
diff --git a/scan2pdf.desktop b/scan2pdf.desktop
@@ -0,0 +1,63 @@
+# ------------------------------------------------------------------------------
+#                                                                              -
+#  Scan to PDF (scan2pdf) - Service Menu for KDE                               -
+#                                                                              -
+#  Created by Fonic <https://github.com/fonic>                                 -
+#  Date: 01/12/24 - 01/23/24                                                   -
+#                                                                              -
+#  NOTE:                                                                       -
+#  Copy/move this file to '~/.local/share/kio/servicemenus' and make           -
+#  sure 'scan2pdf.sh' is stored in a location accessible via PATH.             -
+#                                                                              -
+# ------------------------------------------------------------------------------
+
+[Desktop Entry]
+Type=Service
+ServiceTypes=KonqPopupMenu/Plugin
+MimeType=inode/directory
+Actions=scanToPDF1;scanToPDF2;scanToPDF3;scanToPDF4;scanToPDF5;scanToPDF6;scanToPDF7;scanToPDF8
+X-KDE-Priority=TopLevel
+X-KDE-Submenu=Scan to PDF
+X-KDE-Icon=document-scan
+
+
+[Desktop Action scanToPDF1]
+Name=Color 150 dpi
+Icon=color
+Exec=scan2pdf.sh -m "24bit Color" -r 150 -o "%f/scan_%05d.pdf"
+
+[Desktop Action scanToPDF2]
+Name=Color 200 dpi
+Icon=color
+Exec=scan2pdf.sh -m "24bit Color" -r 200 -o "%f/scan_%05d.pdf"
+
+[Desktop Action scanToPDF3]
+Name=Color 300 dpi
+Icon=color
+Exec=scan2pdf.sh -m "24bit Color" -r 300 -o "%f/scan_%05d.pdf"
+
+[Desktop Action scanToPDF4]
+Name=Color 600 dpi
+Icon=color
+Exec=scan2pdf.sh -m "24bit Color" -r 600 -o "%f/scan_%05d.pdf"
+
+
+[Desktop Action scanToPDF5]
+Name=Grayscale 150 dpi
+Icon=gray-scale
+Exec=scan2pdf.sh -m "True Gray" -r 150 -o "%f/scan_%05d.pdf"
+
+[Desktop Action scanToPDF6]
+Name=Grayscale 200 dpi
+Icon=gray-scale
+Exec=scan2pdf.sh -m "True Gray" -r 200 -o "%f/scan_%05d.pdf"
+
+[Desktop Action scanToPDF7]
+Name=Grayscale 300 dpi
+Icon=gray-scale
+Exec=scan2pdf.sh -m "True Gray" -r 300 -o "%f/scan_%05d.pdf"
+
+[Desktop Action scanToPDF8]
+Name=Grayscale 600 dpi
+Icon=gray-scale
+Exec=scan2pdf.sh -m "True Gray" -r 600 -o "%f/scan_%05d.pdf"
diff --git a/scan2pdf.sh b/scan2pdf.sh
