shinestacker 1.8.0__py3-none-any.whl → 1.9.3__py3-none-any.whl

shinestacker/retouch/exif_data.py

@@ -1,52 +1,120 @@
-# pylint: disable=C0114, C0115, C0116, E0611
+# pylint: disable=C0114, C0115, C0116, E0611, W0718, R0912
+from fractions import Fraction
+from xml.dom import minidom
 from PIL.TiffImagePlugin import IFDRational
-from PySide6.QtWidgets import QWidget, QHBoxLayout, QPushButton, QLabel
+from PySide6.QtWidgets import QLabel, QTextEdit
 from PySide6.QtCore import Qt
+from PySide6.QtGui import QFontDatabase
 from .. algorithms.exif import exif_dict
-from .icon_container import icon_container
-from .. gui.base_form_dialog import BaseFormDialog
+from .. gui.config_dialog import ConfigDialog
 
 
-class ExifData(BaseFormDialog):
-    def __init__(self, exif, parent=None):
-        super().__init__("EXIF data", parent=parent)
+class ExifData(ConfigDialog):
+    def __init__(self, exif, title="EXIF Data", parent=None, show_buttons=True):
         self.exif = exif
-        self.create_form()
-        button_container = QWidget()
-        button_layout = QHBoxLayout(button_container)
-        button_layout.setAlignment(Qt.AlignCenter)
-        ok_button = QPushButton("OK")
-        ok_button.setFixedWidth(100)
-        ok_button.setFocus()
-        button_layout.addWidget(ok_button)
-        self.add_row_to_layout(button_container)
-        ok_button.clicked.connect(self.accept)
-
-    def add_bold_label(self, label):
-        label = QLabel(label)
-        label.setStyleSheet("font-weight: bold")
-        self.form_layout.addRow(label)
-
-    def create_form(self):
-        self.form_layout.addRow(icon_container())
-
-        spacer = QLabel("")
-        spacer.setFixedHeight(10)
-        self.form_layout.addRow(spacer)
-        self.add_bold_label("EXIF data")
-        shortcuts = {}
+        super().__init__(title, parent)
+        self.reset_button.setVisible(False)
+        self.cancel_button.setVisible(show_buttons)
+        if not show_buttons:
+            self.ok_button.setFixedWidth(100)
+            self.button_box.setAlignment(Qt.AlignCenter)
+
+    def format_aperture(self, value):
+        if isinstance(value, IFDRational):
+            if value.denominator == 0:
+                return "f/>1024"
+            aperture_value = value.numerator / value.denominator
+            return f"f/{aperture_value:.1f}"
+        if isinstance(value, (int, float)):
+            return f"f/{float(value):.1f}"
+        return str(value)
+
+    def format_exposure_time(self, value):
+        if isinstance(value, IFDRational):
+            exposure_time = value.numerator / value.denominator
+        elif isinstance(value, (int, float)):
+            exposure_time = float(value)
+        else:
+            return str(value)
+        if exposure_time >= 0.5:
+            return f"{exposure_time:.1f} s"
+        if isinstance(value, IFDRational):
+            return f"{value.numerator}/{value.denominator} s"
+        frac = Fraction(exposure_time).limit_denominator(1000)
+        return f"{frac.numerator}/{frac.denominator} s"
+
+    def format_date_time(self, value):
+        if not isinstance(value, str):
+            return str(value)
+        try:
+            if ':' in value and ' ' in value:
+                date_part, time_part = value.split(' ', 1)
+                year, month, day = date_part.split(':', 2)
+                return f"{day}/{month}/{year} {time_part}"
+            return value
+        except (ValueError, IndexError):
+            return value
+
+    def is_likely_xml(self, text):
+        if not isinstance(text, str):
+            return False
+        text = text.strip()
+        return (text.startswith('<?xml') or
+                text.startswith('<x:xmpmeta') or
+                text.startswith('<rdf:RDF') or
+                text.startswith('<?xpacket') or
+                (text.startswith('<') and text.endswith('>') and
+                 any(tag in text for tag in ['<rdf:', '<xmp:', '<dc:', '<tiff:'])))
+
+    def prettify_xml(self, xml_string):
+        try:
+            parsed = minidom.parseString(xml_string)
+            pretty_xml = parsed.toprettyxml(indent="  ")
+            lines = [line for line in pretty_xml.split('\n') if line.strip()]
+            if lines and lines[0].startswith('<?xml version="1.0" ?>'):
+                lines = lines[1:]
+            return '\n'.join(lines)
+        except Exception:
+            return xml_string
+
+    def create_form_content(self):
         if self.exif is None:
-            shortcuts['Warning:'] = 'no EXIF data found'
             data = {}
         else:
             data = exif_dict(self.exif)
         if len(data) > 0:
             for k, (_, d) in data.items():
-                if isinstance(d, IFDRational):
-                    d = f"{d.numerator}/{d.denominator}"
+                if k in ['FNumber', 'ApertureValue']:
+                    display_value = self.format_aperture(d)
+                elif k in ['ExposureTime', 'ShutterSpeedValue']:
+                    display_value = self.format_exposure_time(d)
+                elif k in ['DateTime', 'DateTimeOriginal', 'DateTimeDigitized']:
+                    display_value = self.format_date_time(d)
+                elif isinstance(d, IFDRational):
+                    display_value = f"{d.numerator}/{d.denominator}"
                 else:
-                    d = f"{d}"
-                if "<<<" not in d and k != 'IPTCNAA':
-                    self.form_layout.addRow(f"<b>{k}:</b>", QLabel(d))
+                    display_value = str(d)
+                d_str = display_value
+                if "<<<" not in d_str and k != 'IPTCNAA':
+                    if len(d_str) <= 40:
+                        self.container_layout.addRow(f"<b>{k}:</b>", QLabel(d_str))
+                    else:
+                        if self.is_likely_xml(d_str):
+                            d_str = self.prettify_xml(d_str)
+                        text_edit = QTextEdit()
+                        text_edit.setPlainText(d_str)
+                        text_edit.setReadOnly(True)
+                        text_edit.setVerticalScrollBarPolicy(Qt.ScrollBarAsNeeded)
+                        text_edit.setLineWrapMode(QTextEdit.WidgetWidth)
+                        text_edit.setHorizontalScrollBarPolicy(Qt.ScrollBarAlwaysOff)
+                        text_edit.setFixedWidth(400)
+                        font = QFontDatabase.systemFont(QFontDatabase.FixedFont)
+                        font.setPointSize(10)
+                        text_edit.setFont(font)
+                        font.setPointSize(11)
+                        text_edit.setFont(font)
+                        text_edit.setFixedHeight(200)
+                        text_edit.setFixedHeight(100)
+                        self.container_layout.addRow(f"<b>{k}:</b>", text_edit)
         else:
-            self.form_layout.addRow("-", QLabel("Empty EXIF dictionary"))
+            self.container_layout.addRow("No EXIF Data", QLabel(''))

shinestacker/retouch/file_loader.py

@@ -5,7 +5,7 @@ import numpy as np
 import cv2
 from psdtags import PsdChannelId
 from PySide6.QtCore import QThread, Signal
-from .. algorithms.utils import read_img, extension_tif, extension_jpg
+from .. algorithms.utils import read_img, extension_tif, extension_jpg, extension_png
 from .. algorithms.multilayer import read_multilayer_tiff
 
 
@@ -50,10 +50,10 @@ class FileLoader(QThread):
             raise RuntimeError(f"Path {path} does not exist.")
         if not os.path.isfile(path):
             raise RuntimeError(f"Path {path} is not a file.")
-        if extension_jpg(path):
+        if extension_jpg(path) or extension_png(path):
             try:
                 stack = np.array([cv2.cvtColor(read_img(path), cv2.COLOR_BGR2RGB)])
-                return stack, [path.split('/')[-1].split('.')[0]]
+                return stack, [os.path.splitext(os.path.basename(path))[0]]
             except Exception as e:
                 traceback.print_tb(e.__traceback__)
                 return None, None

shinestacker/retouch/image_editor_ui.py

@@ -1,7 +1,8 @@
-# pylint: disable=C0114, C0115, C0116, E0611, R0902, R0914, R0915, R0904, W0108
+# pylint: disable=C0114, C0115, C0116, E0611, R0902, R0914, R0915, R0904, W0108, R0911
 from functools import partial
 from PySide6.QtWidgets import (QWidget, QVBoxLayout, QHBoxLayout, QFrame, QLabel, QMenu,
-                               QListWidget, QSlider, QMainWindow, QMessageBox)
+                               QFileDialog, QListWidget, QSlider, QMainWindow, QMessageBox,
+                               QDialog)
 from PySide6.QtGui import QShortcut, QKeySequence, QAction, QActionGroup
 from PySide6.QtCore import Qt
 from PySide6.QtGui import QGuiApplication
@@ -9,6 +10,7 @@ from .. config.constants import constants
 from .. config.app_config import AppConfig
 from .. config.gui_constants import gui_constants
 from .. gui.recent_file_manager import RecentFileManager
+from .. algorithms.exif import get_exif
 from .image_viewer import ImageViewer
 from .shortcuts_help import ShortcutsHelp
 from .brush import Brush
@@ -26,6 +28,7 @@ from .white_balance_filter import WhiteBalanceFilter
 from .vignetting_filter import VignettingFilter
 from .adjustments import LumiContrastFilter, SaturationVibranceFilter
 from .transformation_manager import TransfromationManager
+from .exif_data import ExifData
 
 
 class ImageEditorUI(QMainWindow, LayerCollectionHandler):
@@ -57,6 +60,9 @@ class ImageEditorUI(QMainWindow, LayerCollectionHandler):
             self.handle_temp_view,
             self.end_copy_brush_area,
             self.handle_brush_size_change,
+            self.handle_brush_hardness_change,
+            self.handle_brush_opacity_change,
+            self.handle_brush_flow_change,
             self.handle_needs_update)
         side_panel = QWidget()
         side_layout = QVBoxLayout(side_panel)
@@ -183,6 +189,7 @@ class ImageEditorUI(QMainWindow, LayerCollectionHandler):
         self.thumbnail_list.setFixedWidth(gui_constants.THUMB_WIDTH)
         self.thumbnail_list.setHorizontalScrollBarPolicy(Qt.ScrollBarAlwaysOff)
         self.thumbnail_list.setVerticalScrollBarPolicy(Qt.ScrollBarAsNeeded)
+        self.exif_dialog = None
 
         def change_layer_item(item):
             layer_idx = self.thumbnail_list.row(item)
@@ -266,8 +273,17 @@ class ImageEditorUI(QMainWindow, LayerCollectionHandler):
 
         file_menu.addAction("&Close", self.close_file, "Ctrl+W")
         file_menu.addSeparator()
+        show_exif_action = QAction("Show EXIF Data", self)
+        show_exif_action.triggered.connect(self.show_exif_data)
+        show_exif_action.setProperty("requires_file", True)
+        file_menu.addAction(show_exif_action)
+        delete_exif_action = QAction("Delete EXIF Data", self)
+        delete_exif_action.triggered.connect(self.delete_exif_data)
+        delete_exif_action.setProperty("requires_file", True)
+        file_menu.addAction(delete_exif_action)
+        file_menu.addSeparator()
         file_menu.addAction("&Import Frames", self.io_gui_handler.import_frames)
-        file_menu.addAction("Import &EXIF Data", self.io_gui_handler.select_exif_path)
+        file_menu.addAction("Import &EXIF Data", self.select_exif_path)
 
         edit_menu = menubar.addMenu("&Edit")
         self.undo_action = QAction("Undo", self)
@@ -595,6 +611,18 @@ class ImageEditorUI(QMainWindow, LayerCollectionHandler):
         if event.text() == '}':
             self.brush_tool.increase_brush_hardness()
             return
+        if event.text() == ',':
+            self.brush_tool.decrease_brush_opacity()
+            return
+        if event.text() == '.':
+            self.brush_tool.increase_brush_opacity()
+            return
+        if event.text() == ';':
+            self.brush_tool.decrease_brush_flow()
+            return
+        if event.text() == ':':
+            self.brush_tool.increase_brush_flow()
+            return
         super().keyPressEvent(event)
     # pylint: enable=C0103
 
@@ -676,6 +704,36 @@ class ImageEditorUI(QMainWindow, LayerCollectionHandler):
                 self.redo_action.setText("Redo")
                 self.redo_action.setEnabled(False)
 
+    def select_exif_path(self):
+        path, _ = QFileDialog.getOpenFileName(None, "Select file with exif data")
+        if path:
+            temp_exif_data = get_exif(path)
+            self.exif_dialog = ExifData(temp_exif_data, "Import Selected EXIF Data",
+                                        self.parent(), show_buttons=True)
+            result = self.exif_dialog.exec()
+            if result == QDialog.Accepted:
+                self.io_gui_handler.set_exif_data(temp_exif_data, path)
+                self.show_status_message(f"EXIF data loaded from {path}.")
+            else:
+                self.show_status_message("EXIF data loading cancelled.")
+
+    def show_exif_data(self):
+        self.exif_dialog = ExifData(self.io_gui_handler.exif_data, "EXIF Data",
+                                    self.parent(), show_buttons=False)
+        self.exif_dialog.exec()
+
+    def delete_exif_data(self):
+        reply = QMessageBox.question(
+            self,
+            "Confirm Delete",
+            "Warning: the current EXIF data will be erased.\n\nDo you want to continue?",
+            QMessageBox.Yes | QMessageBox.No,
+            QMessageBox.No
+        )
+        if reply == QMessageBox.Yes:
+            self.io_gui_handler.exif_data = None
+            self.io_gui_handler.exif_path = ''
+
     def luminosity_filter(self):
         self.filter_manager.apply("Luminosity, Contrast")
 
@@ -763,5 +821,23 @@ class ImageEditorUI(QMainWindow, LayerCollectionHandler):
         else:
             self.brush_tool.decrease_brush_size()
 
+    def handle_brush_hardness_change(self, delta):
+        if delta > 0:
+            self.brush_tool.increase_brush_hardness()
+        else:
+            self.brush_tool.decrease_brush_hardness()
+
+    def handle_brush_opacity_change(self, delta):
+        if delta > 0:
+            self.brush_tool.increase_brush_opacity()
+        else:
+            self.brush_tool.decrease_brush_opacity()
+
+    def handle_brush_flow_change(self, delta):
+        if delta > 0:
+            self.brush_tool.increase_brush_flow()
+        else:
+            self.brush_tool.decrease_brush_flow()
+
     def handle_set_zoom_factor(self, zoom_factor):
         self.zoom_factor_label.setText(f"zoom: {zoom_factor:.1%}")

shinestacker/retouch/image_viewer.py

@@ -132,10 +132,15 @@ class ImageViewer(QWidget):
 
     def connect_signals(
             self, handle_temp_view, end_copy_brush_area,
-            handle_brush_size_change, handle_needs_update):
+            handle_brush_size_change, handle_brush_hardness_change,
+            handle_brush_opacity_change, handle_brush_flow_change,
+            handle_needs_update):
         for st in self._strategies.values():
             st.temp_view_requested.connect(handle_temp_view)
             st.end_copy_brush_area_requested.connect(end_copy_brush_area)
             st.brush_size_change_requested.connect(handle_brush_size_change)
+            st.brush_hardness_change_requested.connect(handle_brush_hardness_change)
+            st.brush_opacity_change_requested.connect(handle_brush_opacity_change)
+            st.brush_flow_change_requested.connect(handle_brush_flow_change)
             st.needs_update_requested.connect(handle_needs_update)
             st.setFocusPolicy(Qt.StrongFocus)

shinestacker/retouch/io_gui_handler.py

@@ -7,9 +7,9 @@ from PySide6.QtWidgets import (QFileDialog, QMessageBox, QVBoxLayout, QLabel, QD
                                QApplication, QProgressBar)
 from PySide6.QtGui import QGuiApplication, QCursor
 from PySide6.QtCore import Qt, QObject, QTimer, Signal
+from .. algorithms.utils import EXTENSIONS_GUI_STR, EXTENSIONS_GUI_SAVE_STR
 from .. algorithms.exif import get_exif, write_image_with_exif_data
 from .file_loader import FileLoader
-from .exif_data import ExifData
 from .io_threads import FileMultilayerSaver, FrameImporter
 from .layer_collection import LayerCollectionHandler
 
@@ -32,7 +32,6 @@ class IOGuiHandler(QObject, LayerCollectionHandler):
         self.image_viewer = None
         self.loading_dialog = None
         self.loading_timer = None
-        self.exif_dialog = None
         self.saver_thread = None
         self.saving_dialog = None
         self.saving_timer = None
@@ -46,6 +45,10 @@ class IOGuiHandler(QObject, LayerCollectionHandler):
         self.exif_data = None
         self.exif_path = ''
 
+    def set_exif_data(self, data, path):
+        self.exif_data = data
+        self.exif_path = path
+
     def current_file_path(self):
         return self.current_file_path_master if self.save_master_only.isChecked() \
             else self.current_file_path_multi
@@ -135,7 +138,7 @@ class IOGuiHandler(QObject, LayerCollectionHandler):
         if file_paths is None:
             file_paths, _ = QFileDialog.getOpenFileNames(
                 self.parent(), "Open Image", "",
-                "Images (*.tif *.tiff *.jpg *.jpeg);;All Files (*)")
+                F"Images ({EXTENSIONS_GUI_STR});;All Files (*)")
         if not file_paths:
             return
         if self.loader_thread and self.loader_thread.isRunning():
@@ -163,11 +166,13 @@ class IOGuiHandler(QObject, LayerCollectionHandler):
         self.loader_thread.finished.connect(self.on_file_loaded)
         self.loader_thread.error.connect(self.on_file_error)
         self.loader_thread.start()
+        self.exif_path = self.current_file_path_master
+        self.exif_data = get_exif(self.exif_path)
 
     def import_frames(self):
         file_paths, _ = QFileDialog.getOpenFileNames(
             self.parent(), "Select frames", "",
-            "Images Images (*.tif *.tiff *.jpg *.jpeg);;All Files (*)")
+            f"Images Images ({EXTENSIONS_GUI_STR});;All Files (*)")
         if file_paths:
             self.import_frames_from_files(file_paths)
 
@@ -195,6 +200,9 @@ class IOGuiHandler(QObject, LayerCollectionHandler):
         self.frame_importer_thread.error.connect(self.on_frames_import_error)
         self.frame_importer_thread.progress.connect(self.update_import_progress)
         self.frame_importer_thread.start()
+        if self.exif_data is None:
+            self.exif_path = file_paths[0]
+            self.exif_data = get_exif(self.exif_path)
 
     def update_import_progress(self, percent, filename):
         if hasattr(self, 'progress_bar'):
@@ -286,8 +294,7 @@ class IOGuiHandler(QObject, LayerCollectionHandler):
         if self.layer_stack() is None:
             return
         path, _ = QFileDialog.getSaveFileName(
-            self.parent(), "Save Image", "",
-            "TIFF Files (*.tif *.tiff);;JPEG Files (*.jpg *.jpeg);;All Files (*)")
+            self.parent(), "Save Image", "", EXTENSIONS_GUI_SAVE_STR)
         if path:
             self.save_master_to_path(path)
 
@@ -296,7 +303,6 @@ class IOGuiHandler(QObject, LayerCollectionHandler):
             img = cv2.cvtColor(self.master_layer(), cv2.COLOR_RGB2BGR)
             write_image_with_exif_data(self.exif_data, img, path)
             self.current_file_path_master = os.path.abspath(path)
-            # self.mark_as_modified_requested.emit(False)
             self.update_title_requested.emit()
             self.add_recent_file_requested.emit(self.current_file_path_master)
             self.status_message_requested.emit(f"Saved master layer to: {path}")
@@ -304,15 +310,6 @@ class IOGuiHandler(QObject, LayerCollectionHandler):
             traceback.print_tb(e.__traceback__)
             QMessageBox.critical(self.parent(), "Save Error", f"Could not save file: {str(e)}")
 
-    def select_exif_path(self):
-        path, _ = QFileDialog.getOpenFileName(None, "Select file with exif data")
-        if path:
-            self.exif_path = path
-            self.exif_data = get_exif(path)
-            self.status_message_requested.emit(f"EXIF data extracted from {path}.")
-        self.exif_dialog = ExifData(self.exif_data, self.parent())
-        self.exif_dialog.exec()
-
     def close_file(self):
         self.mark_as_modified_requested.emit(False)
         self.layer_collection.reset()

shinestacker/retouch/shortcuts_help.py

@@ -61,7 +61,10 @@ class ShortcutsHelp(QDialog):
             "Ctrl + +": "Zoom in",
             "Ctrl + -": "Zoom out",
             "Ctrl + 0": "Fit to screen",
-            "Ctrl + R": "Actual size"
+            "Ctrl + R": "Actual size",
+            "Ctrl + 1": "View: overlaid",
+            "Ctrl + 2": "View: side by side",
+            "Ctrl + 3": "View: top-bottom",
         }
 
         self.add_bold_label(left_layout, "Keyboard Shortcuts")
@@ -69,13 +72,14 @@ class ShortcutsHelp(QDialog):
             left_layout.addRow(f"<b>{k}</b>", QLabel(v))
 
         shortcuts = {
-            "Ctrl + 1": "View: overlaid",
-            "Ctrl + 2": "View: side by side",
-            "Ctrl + 3": "View: top-bottom",
-            "[": "Increase brush size",
-            "]": "Decrease brush size",
-            "{": "Increase brush hardness",
-            "}": "Decrease brush hardness"
+            "[": "Decrease brush size",
+            "]": "Increase brush size",
+            "{": "Decrease brush hardness",
+            "}": "Increase brush hardness",
+            ",": "Decrease brush opacity",
+            ".": "Increase brush opacity",
+            ";": "Decrease brush flow",
+            ":": "Increase brush flow"
         }
 
         self.add_bold_label(right_layout, "Keyboard Shortcuts")
@@ -86,6 +90,9 @@ class ShortcutsHelp(QDialog):
             "Space + Drag": "Move",
             "Wheel": "Zoom in/out",
             "Ctrl + Wheel": "Adjust brush size",
+            "Shift + Wheel": "Adjust brush hardness",
+            "Alt + Wheel": "Adjust brush opacity",
+            "Ctrl + Shift + Wheel": "Adjust brush flow",
             "Left Click": "Use brush to copy from selected layer to master",
         }
 

shinestacker/retouch/view_strategy.py

@@ -6,7 +6,7 @@ import numpy as np
 from PySide6.QtCore import Qt, QPointF, QTime, QPoint, Signal, QRectF
 from PySide6.QtGui import QImage, QPainter, QColor, QBrush, QPen, QCursor, QPixmap, QPainterPath
 from PySide6.QtWidgets import (
-    QGraphicsEllipseItem, QGraphicsView, QGraphicsScene, QGraphicsPixmapItem,
+    QGraphicsEllipseItem, QGraphicsView, QGraphicsScene, QGraphicsPixmapItem, QApplication,
     QGraphicsItemGroup, QGraphicsPathItem)
 from .. config.gui_constants import gui_constants
 from .. config.app_config import AppConfig
@@ -81,6 +81,9 @@ class ViewSignals:
     temp_view_requested = Signal(bool)
     end_copy_brush_area_requested = Signal()
     brush_size_change_requested = Signal(int)  # +1 or -1
+    brush_hardness_change_requested = Signal(int)
+    brush_opacity_change_requested = Signal(int)
+    brush_flow_change_requested = Signal(int)
     needs_update_requested = Signal()
 
 
@@ -444,8 +447,15 @@ class ViewStrategy(LayerCollectionHandler):
         if self.empty() or self.gesture_active:
             return
         if event.source() == Qt.MouseEventNotSynthesized:  # Physical mouse
-            if self.control_pressed:
+            modifiers = QApplication.keyboardModifiers()
+            if modifiers & Qt.ControlModifier and modifiers & Qt.ShiftModifier:
+                self.brush_flow_change_requested.emit(1 if event.angleDelta().y() > 0 else -1)
+            elif modifiers & Qt.ControlModifier:
                 self.brush_size_change_requested.emit(1 if event.angleDelta().y() > 0 else -1)
+            elif modifiers & Qt.ShiftModifier:
+                self.brush_hardness_change_requested.emit(1 if event.angleDelta().y() > 0 else -1)
+            elif modifiers & Qt.AltModifier:
+                self.brush_opacity_change_requested.emit(1 if event.angleDelta().y() > 0 else -1)
             else:
                 self.handle_zoom_wheel(self.get_view_with_mouse(event), event)
             self.update_brush_cursor()

{shinestacker-1.8.0.dist-info → shinestacker-1.9.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: shinestacker
-Version: 1.8.0
+Version: 1.9.3
 Summary: ShineStacker
 Author-email: Luca Lista <luka.lista@gmail.com>
 License-Expression: LGPL-3.0
@@ -30,11 +30,9 @@ Provides-Extra: dev
 Requires-Dist: pytest; extra == "dev"
 Dynamic: license-file
 
-<img src='https://raw.githubusercontent.com/lucalista/shinestacker/main/src/shinestacker/gui/ico/shinestacker.png' width="150" referrerpolicy="no-referrer" alt="Shine Stacker Logo">
-
 # Shine Stacker
 
-## Focus Stacking Processing Framework and GUI
+Focus Stacking Processing Framework and GUI designed for macro photographers, microscopists, and researchers who need precise control and reproducible stacking results.
 
 [![CI multiplatform](https://github.com/lucalista/shinestacker/actions/workflows/ci-multiplatform.yml/badge.svg)](https://github.com/lucalista/shinestacker/actions/workflows/ci-multiplatform.yml)
 [![PyPI version](https://img.shields.io/pypi/v/shinestacker?color=success)](https://pypi.org/project/shinestacker/)
@@ -45,60 +43,55 @@ Dynamic: license-file
 [![Documentation Status](https://readthedocs.org/projects/shinestacker/badge/?version=latest)](https://shinestacker.readthedocs.io/en/latest/?badge=latest)
  [![License: LGPL v3](https://img.shields.io/badge/License-LGPL_v3-blue.svg)](https://www.gnu.org/licenses/lgpl-3.0)
 [![PyPI Downloads](https://static.pepy.tech/badge/shinestacker)](https://pepy.tech/projects/shinestacker)
-
-<img src='https://raw.githubusercontent.com/lucalista/shinestacker/main/img/flies.gif' width="400" referrerpolicy="no-referrer">  <img src='https://raw.githubusercontent.com/lucalista/shinestacker/main/img/flies_stack.jpg' width="400" referrerpolicy="no-referrer">
-
-<img src='https://raw.githubusercontent.com/lucalista/shinestacker/main/img/coffee.gif' width="400" referrerpolicy="no-referrer">  <img src='https://raw.githubusercontent.com/lucalista/shinestacker/main/img/coffee_stack.jpg' width="400" referrerpolicy="no-referrer">
-
-> **Focus stacking** for microscopy, macro photography, and computational imaging
+<center><img src='https://raw.githubusercontent.com/lucalista/shinestacker/main/src/shinestacker/gui/ico/shinestacker.png' width="150" referrerpolicy="no-referrer" alt="Shine Stacker Logo"></center>
 
 ## Key Features
-- 🚀 **Batch Processing**: Align, balance, and stack hundreds of images
-- 🧩 **Modular Architecture**: Mix-and-match processing modules
-- 🖌️ **Retouch Editing**: Final interactive retouch of stacked image from individual frames
-- 📊 **Jupyter Integration**: Image processing python notebooks
+- 🪟 **Cross-Platform GUI**: Native app built with Qt6, available for Windows, macOS, and Linux.
+- 🚀 **Batch Processing**: Automatically align, balance, and stack hundreds of images — perfect for macro or microscopy datasets.
+- 🧩 **Modular Architecture**: Combine configurable modules for alignment, normalization, and blending to build custom workflows.
+- 🖌️ **Retouch Editor**: Interactively refine your stacked image by painting in details from individual frames.
+- 📊 **Jupyter & Python Integration**: Use Shine Stacker as a library inside your Python or Jupyter workflows.
+
+<img src='https://raw.githubusercontent.com/lucalista/shinestacker/main/img/flies.gif' width="400" referrerpolicy="no-referrer">  <img src='https://raw.githubusercontent.com/lucalista/shinestacker/main/img/flies_stack.jpg' width="400" referrerpolicy="no-referrer">
 
 ## Interactive GUI
 
-The GUI has two main working areas: 
+The graphical interface makes complex stacking tasks simple:
+- **Project View** – Configure, preview, and run stacking workflows with optional intermediate results.
+- **Retouch View** – Manually refine the final image by blending details from selected frames and applying filters.
 
-* *Project*: manage and run focus stacking workflows in a flexible and configurable way, with optional intermediate batch stacking.
+Ideal for users who want the power of scripting and the comfort of a modern UI.
 
-<img src='https://raw.githubusercontent.com/lucalista/shinestacker/main/img/gui-project-run.png' width="600" referrerpolicy="no-referrer">
+<img src='https://raw.githubusercontent.com/lucalista/shinestacker/main/img/coffee.gif' width="400" referrerpolicy="no-referrer">  <img src='https://raw.githubusercontent.com/lucalista/shinestacker/main/img/coffee_stack.jpg' width="400" referrerpolicy="no-referrer">
 
-* *Retouch*: select interactively details from individual frames and apply final filters to the blended image.
+## Get Started
 
-<img src='https://raw.githubusercontent.com/lucalista/shinestacker/main/img/gui-retouch.png' width="600" referrerpolicy="no-referrer">
+- 📦 [Install via PyPI](https://pypi.org/project/shinestacker/)
+- 💻 [Run the GUI app](https://shinestacker.readthedocs.io/en/latest/gui.html)
+- 🧠 [Reference](https://shinestacker.readthedocs.io/en/)
+- 🐛 [Report an issue](https://github.com/lucalista/shinestacker/issues)
 
 ## Resources
 
  🌍 [Website on WordPress](https://shinestacker.wordpress.com) • 📖 [Main documentation](https://shinestacker.readthedocs.io) • 📝 [Changelog](https://github.com/lucalista/shinestacker/blob/main/CHANGELOG.md) 
 
-## Note for macOS users
-
-**The following note is only relevant if you download the application as compressed archive from the [release page](https://github.com/lucalista/shinestacker/releases).**
+## Installation
 
-The macOS system security protection prevent to run applications downloaded from the web that come from developers that don't hold an Apple Developer Certificate. 
+See the [main documentation](https://github.com/lucalista/shinestacker/blob/main/docs/main.md) for detailed installation instructions.
 
-In order to prevent this, follow the instructions below:
+**Platform notes:**
+- **Windows:** If you download the installer or ZIP archive, you may need to whitelist the app in your antivirus software.
+- **macOS:** See the [installation note for macOS users](https://github.com/lucalista/shinestacker/blob/main/docs/macos-install.md).
 
-1. Download the compressed archive ```shinestacker-macos.tar.gz``` in your ```Download``` folder.
-2. Double-click the archive to uncompress it. You will find a new folder ```shinestacker```.
-3. Open a terminal (*Applications > Utilities > Terminal*)
-4. Type the folliwng command on the terminal (assuming you installed the app from the ```dmg``` image under ```Applications```):
-```bash
-xattr -cr /Applications/shinestacker/shinestacker.app
-```
-5. Now you can double-click the Sine Stacker icon app and it should run.
 
-macOS adds a quarantine flag to all files downloaded from the internet. The above command removes that flag while preserving all other application functionality.
+## Acknowledgements & References
 
-## Credits
-
-The first version of the core focus stack algorithm was initially inspired by the [Laplacian pyramids method](https://github.com/sjawhar/focus-stacking) implementation by Sami Jawhar that was used under permission of the author. The implementation in the latest releases was rewritten from the original code.
-
-## Resources
+The first version of the core focus stack algorithm was inspired by the 
+[Laplacian pyramids method](https://github.com/sjawhar/focus-stacking) implementation 
+by Sami Jawhar, used under permission. The implementation in the latest releases 
+was rewritten from the original code.
 
+Key references:
 * [Pyramid Methods in Image Processing](https://www.researchgate.net/publication/246727904_Pyramid_Methods_in_Image_Processing), E. H. Adelson, C. H. Anderson,  J. R. Bergen, P. J. Burt, J. M. Ogden, RCA Engineer, 29-6, Nov/Dec 1984
 Pyramid methods in image processing
 * [A Multi-focus Image Fusion Method Based on Laplacian Pyramid](http://www.jcomputers.us/vol6/jcp0612-07.pdf), Wencheng Wang, Faliang Chang, Journal of Computers 6 (12), 2559, December 2011
@@ -108,13 +101,18 @@ Pyramid methods in image processing
 <img src="https://www.gnu.org/graphics/lgplv3-147x51.png" alt="LGPL 3 logo">
 
 - **Code**: The software is provided as is under the [GNU Lesser General Public License v3.0](https://www.gnu.org/licenses/lgpl-3.0.en.html). See [LICENSE](https://github.com/lucalista/shinestacker/blob/main/LICENSE) for details.
-<img src='https://raw.githubusercontent.com/lucalista/shinestacker/main/src/shinestacker/gui/ico/shinestacker.png' width="150" referrerpolicy="no-referrer" alt="Shine Stacker Logo">
 
 - **Logo**: The Shine Stacker logo was designed by [Alessandro Lista](https://linktr.ee/alelista). Copyright © Alessandro Lista. All rights reserved. The logo is not covered by the LGPL-3.0 license of this project.
 
 ## Attribution request
+
 📸 If you publish images created with Shine Stacker, please consider adding a note such as:
 
 *Created with Shine Stacker – https://github.com/lucalista/shinestacker*
 
 This is not mandatory, but highly appreciated.
+
+---
+> Developed and maintained by [Luca Lista](https://github.com/lucalista).
+> 💡 Contributions, feedback, and feature suggestions are warmly welcome.
+> If you enjoy Shine Stacker, consider giving it a ⭐️ on GitHub — it really helps visibility!