
Install Fotoxx Binary Package
-----------------------------

This is a distro-agnostic binary package that should install on any recent
flavor of Linux desktop. It contains the application binary executable and 
some library files that may not have ABI compatibility across different 
Linux flavors and releases.

Installation Procedure:
  0. Download the package file (fotoxx-N.N-bin.tar.gz)
  1. Open a terminal window and enter the following commands:
  2. $ chdir Downloads                      # go to download folder
  3. $ tar -xzf fotoxx-N.N-bin.tar.gz       # unpack the tar file
  4. $ chdir fotoxx                         # go to unpacked files
  5. $ chmod u+x install.sh                 # make installer executable
  6. $ ./install.sh                         # run the installer
 
You may need a new login or reboot to update the system menu or create
an icon/launcher from the desktop file.

The executable file is at: /home/<user>/.local/bin/fotoxx*
The desktop file is at: /home/<user>/.local/share/applications/fotoxx*.desktop
Other files are at: /home/<user>/.local/share/fotoxx/*

Uninstall Fotoxx
----------------
Remove the Fotoxx package files: 
  $ find $HOME/.local -path "*fotoxx*" -type l,f,d -delete
Remove any user files created by Fotoxx:
  $ rm -r $HOME/.fotoxx

=================================================================================

Install Fotoxx From Source Code
-------------------------------

Building fotoxx requires the following packages:  
    g++ or clang++           C++ compiler and linker 
    libgtk-3-dev             GTK3 graphics library (GUI base)
    libtiff-*-dev            tiff image files
    libpng-*-dev             png  image files
    libjpeg-*-dev            jpeg image files
    liblcms2-*-dev           color space conversion
    libchamplain-gtk-*-dev   geomapping library
    libclutter-gtk-*-dev     graphics library

At run time the following packages are also required:
    dcraw               RAW photo file conversion program
    exiftool            read/write image metadata (EXIF etc.) 
    binutils            GNU binary utilities (addr2line function) 
 
The above are Debian names. Package naming is chaotic, 
so you may have to hunt the names for other Linux flavors.

Build and install Fotoxx as follows:
   1. Download the package file (fotoxx-N.N-source.tar.gz)
   2. Open a terminal window 
   3. $ cd Downloads                            # go to download folder
   4. $ tar -xzf fotoxx-N.N-source.tar.gz       # unpack to ./fotoxx 
   5. $ cd fotoxx                               # go there 
   6. $ make                                    # build program 
   7. $ sudo make install                       # install program

Missing dependencies will cause error messages in step 6. 
Install these from your package repository and repeat step 6. 

Step 7 moves all files to the following locations:
   /usr/bin/fotoxx                 binary executable 
   /usr/share/fotoxx/              images, setup files, user guide
   /usr/share/doc/fotoxx/          changelog, copyright, license

FOR PACKAGE BUILDERS (See Makefile)
   If $PREFIX is defined, files go there instead of /usr. 
   If $DESTDIR is also defined, files go to $DESTDIR$PREFIX. 

Uninstall Fotoxx
----------------
Remove the Fotoxx package files: 
   Delete /usr/bin/fotoxx/, /usr/share/fotoxx/, /usr/share/doc/fotoxx/
Remove any user files created by Fotoxx:
   Delete $HOME/.fotoxx/

NOTE
----
Fotoxx is easy to use but unconventional. 
To avoid frustration, please read the user guide - key F1.
Read the introductory pages. The rest can be referenced as needed.
Key F1 will show the relevant topic for whatever function is active.


