File	Date	Author	Commit
addenda	2024-06-26	Antonio Fernández Galaz	[9f266b] Fix instability in auto-alignment margins. Fix ...
locale	2024-06-26	Antonio Fernández Galaz	[9f266b] Fix instability in auto-alignment margins. Fix ...
py_modul	2024-06-26	Antonio Fernández Galaz	[9f266b] Fix instability in auto-alignment margins. Fix ...
README.txt	2021-02-08	Antonio Fernández Galaz	[7f76ed] Solve the issue of restore-trash / trash-restore
explora-exif.py	2020-07-16	Antonio Fernández Galaz	[f32e34] Include a thumbnail in the images rendered
gen-descr.py	2021-02-06	Antonio Fernández Galaz	[a57ab2] Fix a couple little bugs
gen-html5.py	2021-02-10	Antonio Fernández Galaz	[7d68e1] Review of the gen-html5.py command for compatib...
gen-render.py	2024-06-26	Antonio Fernández Galaz	[9f266b] Fix instability in auto-alignment margins. Fix ...
git_add.sh	2022-06-19	Antonio Fernández Galaz	[7557c7] Add 'star' rating of .pair files
list_gettext.txt	2022-05-31	Antonio Fernández Galaz	[5c0032] Navigation of .pair files
requirements.txt	2023-05-29	Antonio Fernández Galaz	[c6bf3d] Change format of side-car files (.pair & .lstpa...
stmani3.py	2023-05-29	Antonio Fernández Galaz	[c6bf3d] Change format of side-car files (.pair & .lstpa...
stmani_todo_folder.spec	2022-04-29	Antonio Fernández Galaz	[e1d8e4] Fix 'X' and 'Z' Zooms

Read Me

# Copyright (C) 2011 Antonio Fernández Galaz stmani@afgalaz.es
#
# This file is part of STMANI.
#
# STMANI is free software: you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation, either version 3 of the License, or
# (at your option) any later version.
#
# STMANI is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with STMANI.  If not, see <http://www.gnu.org/licenses/>.
#
# Contributor(s):
#


StMani3 is verified to run in a Linux Mint 19.3 box. 
---------------------------------------------------

Installation procedure: 
-----------------------

1- Find it at https://sourceforge.net/p/stmani3/code/ci/master/tree/

2- Click "Download Snapshot", download and unzip it somewhere

3- Install system dependencies:
   
   sudo apt-get install python3 python3-pip virtualenv g++ python-all-dev libexiv2-dev libboost-python-dev

   sudo apt-get install libimage-exiftool-perl

   sudo apt-get install trash-cli

4- cd <stmani3 folder>    (the folder where stmani3.py is)

5- Create Python3 Virtual Environment:
   virtualenv -p python3 .venv

6- Activate Virtual Environment. A "(.venv)" prefix will appear in the promt line:
   source .venv/bin/activate

7- Install python modules in the Virtual Environment:
   pip install -r requirements.txt

8- run StMani3:
   ./stmani3.py    (or  python3 ./stmani3.py)

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

For normal running:
-------------------

1- cd <stmani3 folder>    (the folder where stmani3.py is)

2- Activate Virtual Environment. A "(.venv)" prefix will appear in the promt line:
   source .venv/bin/activate

3- run StMani3:
   ./stmani3.py    (or  python3 ./stmani3.py)

---------------------------------------
Better write a script that does it all:
         #!/bin/bash 
         cd <stmani3 folder>
         source .venv/bin/activate
         python3 ./stmani3.py

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

(Many thanks JackDesBwa for his help to sort out the virtualenv mess:-)