==========================================================================================================
** NOTE **:
If you have no wish to run AlbumEasy from the command line, you can safely ignore this file.
==========================================================================================================

AlbumEasy may be run from the console as a command line application by means of the -c command line argument.

In order to do so the -c argument should followed by the name of the album data file e.g.:
./AlbumEasy -c examples/AlbumSample.txt

Error messages are written to stderr, in which case they may be captured to a text file as follows:
./AlbumEasy -c examples/AlbumSample.txt 2>errs.txt<span>

----------------------------------------------------------------------------------------------------------
NOTE: On Linux, if the correct Qt libraries are not already installed on the system, please use AlbumEasy.sh
      to run the program, this will first load the correct libraries before executing the program
      e.g

./AlbumEasy.sh -c examples/AlbumSample.txt

----------------------------------------------------------------------------------------------------------

AlbumEasy uses the same configuration settings for both console and GUI modes. So to make any changes to
the configuration it is necessary to do so in GUI mode by means of the Configuration Dialogue Box.

Note:It is also necessary to run the application in GUI mode in order to access the help files.

----------------------------------------------------------------------------------------------------------

Console mode is functional on macOS, Linux and Windows.

However when running on Windows, a Windows shortcoming prevents a dual mode application from displaying
text in the console.
As a result, although the application is functional in console mode on Windows, the user will
not see any status or error messages.
To get around this, it is suggested that an alternative console such as the one provided by
Cygwin (http://www.cygwin.com) be installed on Windows.

----------------------------------------------------------------------------------------------------------
Sample Script
-------------
This script may serve as the basis for running AlbumEasy from the command line in batch mode.
It should run unchanged on macOS, Linux or a Windows Cygwin console:
----------------------------------------------------------------------------------------------------------


#!/bin/bash

  #prevent the shell from expanding any empty result set to the pattern e.g *.txt
shopt -s nullglob

echo -e "\n">errs.txt

  #process all files matching the *.txt pattern, writing errors to the file errs.txt
for f in *.txt
do
  if [ "$f" != "errs.txt" ]            #don't attempt to process the errs.txt file
  then
    AlbumEasy -c "$f" 2>>errs.txt
  fi
done

 #display any errors
cat errs.txt

----------------------------------------------------------------------------------------------------------

Because tThis script will try to process all *.txt files, it will also attempt to process
any decorative border files that may be in the directory. To exclude these, for example a
decorative border file called border.txt change:

   if [ "$f" != "errs.txt" ]
 to
   if [ "$f" != "errs.txt" ] && [ "$f" != "border.txt" ]
