fix: fix invalid install for UNIX app icon

Also use git version of aqtinstall for Qt 6.11.0+ for Windows
miurahr/aqtinstall#1007

.git-blame-ignore-revs

@@ -0,0 +1,3 @@
+# .git-blame-ignore-revs
+# CR LF to LF
+ed5a6023326fd2ab420ded76976501be33e0b389

.gitattributes

@@ -0,0 +1,5 @@
+*.txt    text eol=lf
+*.cpp    text eol=lf
+*.h      text eol=lf
+*.ui     text eol=lf
+*.qml    text eol=lf

.github/FUNDING.yml

@@ -0,0 +1,2 @@
+ko_fi: blumia
+custom: ["https://blumia.itch.io/pineapple-pictures"]

.github/workflows/macos.yml

@@ -1,6 +1,6 @@
 name: macOS CI
 
-on: [push, pull_request]
+on: [push, pull_request, workflow_dispatch]
 
 jobs:
   build:
@@ -8,12 +8,38 @@ jobs:
     runs-on: macos-latest
 
     steps:
-    - uses: actions/checkout@v1
-    - name: Install Qt
-      uses: jurplel/install-qt-action@v2
+    - uses: actions/checkout@v6
+    - name: Install uv
+      uses: astral-sh/setup-uv@v6
       with:
-        version: '5.15.2'
-    - name: Run a qt project
+        enable-cache: true
+    - name: Install MetaGlot
+      run: uv tool install git+https://github.com/SarasasChipWorkshop/metaglot.git
+    - name: Install Qt
+      uses: jurplel/install-qt-action@v4
+      with:
+        version: '6.11.2'
+        modules: 'qtimageformats'
+        cache: true
+    - name: Install Conan and Dependencies
+      id: conan
+      working-directory: ./
+      shell: bash
       run: |
-        cmake ./
-        make
+        pip3 install wheel setuptools
+        pip3 install conan --upgrade
+        conan --version
+        conan profile detect
+        conan install --requires=exiv2/0.28.3 --generator CMakeDeps --generator CMakeToolchain --build=missing
+    - name: Build
+      run: |
+        cmake . -DTRANSLATION_RESOURCE_EMBEDDING=ON --preset conan-release
+        cmake --build --preset conan-release
+    - name: Deploy
+      run: |
+        macdeployqt ./ppic.app -dmg
+        ls
+    - uses: actions/upload-artifact@v6
+      with:
+        name: "macos-bundle"
+        path: "*.dmg"

.github/workflows/reuse-check.yml

@@ -7,9 +7,11 @@ name: REUSE Compliance Check
 on: [push, pull_request]
 
 jobs:
-  test:
+  reuse-compliance-check:
     runs-on: ubuntu-latest
     steps: 
-    - uses: actions/checkout@v2
+    - name: Checkout
+      uses: actions/checkout@v4
+
     - name: REUSE Compliance Check
-      uses: fsfe/reuse-action@v1
+      uses: fsfe/reuse-action@v5

.github/workflows/ubuntu.yml

@@ -1,18 +1,22 @@
 name: Ubuntu CI
 
-on: [push, pull_request]
+on: [push, pull_request, workflow_dispatch]
 
 jobs:
-  ubuntu-20-04-build:
-
-    runs-on: ubuntu-20.04
-
+  ubuntu-24-04-build:
+    runs-on: ubuntu-24.04
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v6
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+        with:
+          enable-cache: true
+      - name: Install MetaGlot
+        run: uv tool install git+https://github.com/SarasasChipWorkshop/metaglot.git
       - name: Get build dept.
         run: |
           sudo apt update
-          sudo apt install cmake qtbase5-dev libqt5svg5-dev qttools5-dev libexiv2-dev
+          sudo apt install cmake qt6-base-dev qt6-svg-dev qt6-tools-dev libexiv2-dev
       - name: Build it
         run: |
           mkdir build
@@ -24,33 +28,7 @@ jobs:
         run: |
           cd build
           sudo apt install ./*.deb
-      - uses: actions/upload-artifact@v3
+      - uses: actions/upload-artifact@v6
         with:
-          name: ubuntu-20.04-deb-package
-          path: build/*.deb
-
-  ubuntu-22-04-build:
-
-    runs-on: ubuntu-22.04
-
-    steps:
-      - uses: actions/checkout@v3
-      - name: Get build dept.
-        run: |
-          sudo apt update
-          sudo apt install cmake qtbase5-dev libqt5svg5-dev qttools5-dev libexiv2-dev
-      - name: Build it
-        run: |
-          mkdir build
-          cd build
-          cmake ../
-          make
-          cpack -G DEB
-      - name: Try install it
-        run: |
-          cd build
-          sudo apt install ./*.deb
-      - uses: actions/upload-artifact@v3
-        with:
-          name: ubuntu-22.04-deb-package
+          name: ubuntu-24.04-deb-package
           path: build/*.deb

.github/workflows/windows.yml

@@ -1,30 +1,108 @@
 name: Windows CI
 
-on: [push, pull_request]
+on: [push, pull_request, workflow_dispatch]
 
 jobs:
-  msvc-build:
-  
+  msvc-cmake-build:
+
     strategy:
       matrix:
-        vs: ['2019']
-        msvc_arch: ['x64']
+        include:
+          - qt_ver: '6.11.2'
+            vs: '2022'
+            aqt_arch: 'win64_msvc2022_64'
+            msvc_arch: 'x64'
 
-    runs-on: windows-2019
+    runs-on: windows-2022
 
     steps:
-    - uses: actions/checkout@v3
-    - name: Install Qt
-      uses: jurplel/install-qt-action@v2
+    - uses: actions/checkout@v6
+    - name: Install uv
+      uses: astral-sh/setup-uv@v6
       with:
-        arch: 'win64_msvc2019_64'
-        version: '5.15.2'
+        enable-cache: true
+    - name: Install MetaGlot
+      run: uv tool install git+https://github.com/SarasasChipWorkshop/metaglot.git
+    - name: Install Qt
+      uses: jurplel/install-qt-action@v4
+      with:
+        arch: ${{ matrix.aqt_arch }}
+        version: ${{ matrix.qt_ver }}
+        modules: 'qtimageformats'
+        cache: true
+        # we need this until miurahr/aqtinstall#1007 ships 3.3.1 for Qt >= 6.11.0 for Windows.
+        aqtsource: 'aqtinstall @ git+https://github.com/miurahr/aqtinstall@16db45a70b5905ad596941b223469bc86a56901a'
     - name: Build
       shell: cmd
       run: |
+        :: ------ env ------
+        set PWD=%cd%
         set VS=${{ matrix.vs }}
         set VCVARS="C:\Program Files (x86)\Microsoft Visual Studio\%VS%\Enterprise\VC\Auxiliary\Build\vcvarsall.bat"
         if not exist %VCVARS% set VCVARS="C:\Program Files\Microsoft Visual Studio\%VS%\Enterprise\VC\Auxiliary\Build\vcvarsall.bat"
         call %VCVARS% ${{ matrix.msvc_arch }}
-        qmake pineapple-pictures.pro
-        nmake
+        :: ------ dep ------
+        set CMAKE_PREFIX_PATH=%PWD%/dependencies_bin
+        mkdir dependencies_src
+        echo ::group::===== exiv2 =====
+        curl -fsSL -o exiv2_bin.zip https://github.com/Exiv2/exiv2/releases/download/v0.28.7/exiv2-0.28.7-2022msvc-AMD64.zip
+        7z x exiv2_bin.zip -y
+        ren .\exiv2-0.28.7-2022msvc-AMD64 dependencies_bin
+        echo ::endgroup::
+        echo ::group::===== zlib =====
+        curl -fsSL -o zlib_src.zip https://github.com/madler/zlib/releases/download/v1.3.2/zlib132.zip
+        7z x zlib_src.zip -y -o"dependencies_src"
+        ren .\dependencies_src\zlib-1.3.2 zlib || goto :error
+        cmake ./dependencies_src/zlib -Bbuild_dependencies/zlib -DCMAKE_INSTALL_PREFIX="dependencies_bin" || goto :error
+        cmake --build build_dependencies/zlib --config Release --target=install || goto :error
+        echo ::endgroup::
+        echo ::group::===== AOM for libavif AVI decoding support =====
+        git clone -q -b v3.13.1 --depth 1 https://aomedia.googlesource.com/aom dependencies_src/aom
+        cmake ./dependencies_src/aom -Bbuild_dependencies/aom -DCMAKE_INSTALL_PREFIX="dependencies_bin" -DENABLE_DOCS=OFF -DBUILD_SHARED_LIBS=ON -DAOM_TARGET_CPU=generic -DENABLE_TESTS=OFF -DENABLE_TESTDATA=OFF -DENABLE_TOOLS=OFF -DENABLE_EXAMPLES=0 || goto :error
+        cmake --build build_dependencies/aom --config Release --target=install || goto :error
+        echo ::endgroup::
+        echo ::group::===== libavif =====
+        curl -fsSL -o libavif-v1_3_0.zip https://github.com/AOMediaCodec/libavif/archive/v1.3.0.zip
+        7z x libavif-v1_3_0.zip -y -o"dependencies_src"
+        ren .\dependencies_src\libavif-1.3.0 libavif || goto :error
+        cmake ./dependencies_src/libavif -Bbuild_dependencies/libavif -DCMAKE_INSTALL_PREFIX="dependencies_bin" -DAVIF_CODEC_AOM=SYSTEM -DAVIF_CODEC_AOM_DECODE=ON -DAVIF_CODEC_AOM_ENCODE=ON -DAVIF_LIBYUV=LOCAL
+        cmake --build build_dependencies/libavif --config Release --target=install || goto :error
+        echo ::endgroup::
+        echo ::group::===== expat =====
+        curl -fsSL -o expat_src.zip https://github.com/libexpat/libexpat/archive/R_2_7_3.zip
+        7z x expat_src.zip -y -o"dependencies_src"
+        ren .\dependencies_src\libexpat-R_2_7_3 expat || goto :error
+        cmake ./dependencies_src/expat/expat -Bbuild_dependencies/expat -DCMAKE_INSTALL_PREFIX="dependencies_bin" || goto :error
+        cmake --build build_dependencies/expat --config Release --target=install || goto :error
+        echo ::endgroup::
+        echo ::group::===== ECM =====
+        git clone -q https://invent.kde.org/frameworks/extra-cmake-modules.git dependencies_src/extra-cmake-modules
+        cmake .\dependencies_src\extra-cmake-modules -Bbuild_dependencies/extra-cmake-modules -DCMAKE_INSTALL_PREFIX="dependencies_bin" -DBUILD_TESTING=OFF || goto :error
+        cmake --build build_dependencies/extra-cmake-modules --config Release --target=install || goto :error
+        echo ::endgroup::
+        echo ::group::===== KArchive =====
+        git clone -q https://invent.kde.org/frameworks/karchive.git dependencies_src/karchive
+        cmake .\dependencies_src\karchive -Bbuild_dependencies/karchive -DBUILD_TESTING=OFF -DWITH_LIBZSTD=OFF -DWITH_BZIP2=OFF -DWITH_LIBLZMA=OFF -DCMAKE_INSTALL_PREFIX="dependencies_bin" || goto :error
+        cmake --build build_dependencies/karchive --config Release --target=install || goto :error
+        echo ::endgroup::
+        echo ::group::===== KImageFormats =====
+        git clone -q https://invent.kde.org/frameworks/kimageformats.git dependencies_src/kimageformats
+        cmake .\dependencies_src\kimageformats -Bbuild_dependencies/kimageformats -DBUILD_TESTING=OFF -DKDE_INSTALL_QTPLUGINDIR=%QT_ROOT_DIR%\plugins || goto :error
+        cmake --build build_dependencies/kimageformats --config Release --target=install || goto :error
+        echo ::endgroup::
+        :: ------ app ------
+        echo ::group::===== App (Build'n'Install) =====
+        cmake -Bbuild .
+        cmake --build build --config Release
+        cmake --install build --config Release --prefix "%PWD%\build"
+        echo ::endgroup::
+        :: ------ pkg ------
+        windeployqt --verbose=2 --no-compiler-runtime --no-quick-import --no-translations --no-network --no-opengl-sw --no-system-d3d-compiler --no-system-dxc-compiler --skip-plugin-types tls,networkinformation build\bin\ppic.exe
+        robocopy ./dependencies_bin/bin build/bin *.dll
+        if ErrorLevel 8 (exit /B 1)
+        copy LICENSE build\bin
+        exit /B 0
+    - uses: actions/upload-artifact@v6
+      with:
+        name: "windows-msvc${{ matrix.vs }}-qt${{ matrix.qt_ver }}-cmake-package"
+        path: build/bin/*

.gitignore

@@ -2,8 +2,21 @@
 *.user
 *.user.*
 
+# Why, macOS, why?
+.DS_Store
+
 # Translation files
 *.qm
+*.mo
 
 # Generic Build Dir
 [Bb]uild/
+cmake-build-*/
+
+# IDE/Editor config folders
+.vscode/
+.idea/
+.qtcreator/
+
+# Clangd cache
+.cache/

.reuse/dep5

@@ -1,28 +0,0 @@
-Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
-Upstream-Name: Pineapple Pictures
-Source: https://github.com/BLumia/pineapple-pictures
-
-# Config files
-Files: .gitignore appveyor.yml .github/*
-Copyright: None
-License: CC0-1.0
-
-# README, resource files and Metadata files
-Files: README*.md assets/*.rc assets/*.qrc dist/*
-Copyright: None
-License: CC0-1.0
-
-# Translation files
-# See assets/plain/translators.html for a list of translators
-Files: app/translations/*.ts assets/plain/translators.html
-Copyright: Translators from hosted.weblate.org
-License: MIT
-
-# Assets
-Files: assets/icons/*.svg
-Copyright: 2022 Gary Wang
-License: MIT
-
-Files: assets/icons/app-icon.*
-Copyright: 2020 Lovelyblack
-License: MIT

CMakeLists.txt

@@ -1,49 +1,50 @@
-# SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
+# SPDX-FileCopyrightText: 2022 - 2025 Gary Wang <git@blumia.net>
 #
 # SPDX-License-Identifier: MIT
 
-project (pineapple-pictures)
+cmake_minimum_required(VERSION 3.16)
 
-cmake_minimum_required (VERSION 3.9.5)
+project(pineapple-pictures VERSION 1.6.0) # don't forget to update NEWS file and AppStream metadata.
 
-list(APPEND CMAKE_MODULE_PATH ${CMAKE_CURRENT_LIST_DIR}/cmake)
-
-include (GNUInstallDirs)
-include (FeatureSummary)
-
-set (CMAKE_AUTOMOC ON)
-set (CMAKE_AUTORCC ON)
-set (QT_MINIMUM_VERSION "5.10")
+include(GNUInstallDirs)
+include(FeatureSummary)
 
 option (EXIV2_METADATA_SUPPORT "Better image metadata support via libexiv2" ON)
+option (TRANSLATION_RESOURCE_EMBEDDING "Embedding .qm translation files inside resource" OFF)
 
-find_package(Qt5 ${QT_MINIMUM_VERSION} REQUIRED
-    COMPONENTS Widgets Svg LinguistTools
+set (CMAKE_CXX_STANDARD 17)
+set (CMAKE_CXX_STANDARD_REQUIRED ON)
+set (CMAKE_AUTOMOC ON)
+set (CMAKE_AUTORCC ON)
+set (CMAKE_AUTOUIC ON)
+
+find_package(QT NAMES Qt6 REQUIRED COMPONENTS Core)
+
+set (QT_MINIMUM_VERSION "6.5")
+
+find_package(Qt${QT_VERSION_MAJOR} ${QT_MINIMUM_VERSION} REQUIRED
+    COMPONENTS Widgets Svg SvgWidgets LinguistTools
     OPTIONAL_COMPONENTS DBus
 )
 
 if (EXIV2_METADATA_SUPPORT)
-    find_package(LibExiv2)
-    set_package_properties(LibExiv2 PROPERTIES
+    find_package(exiv2)
+    set_package_properties(exiv2 PROPERTIES
         URL "https://www.exiv2.org"
         DESCRIPTION "image metadata support"
-        TYPE OPTIONAL
+        TYPE RECOMMENDED
         PURPOSE "Bring better image metadata support"
     )
 endif ()
 
-#LibExiv2_FOUND
 set (PPIC_CPP_FILES
     app/main.cpp
-    app/framelesswindow.cpp
     app/mainwindow.cpp
     app/actionmanager.cpp
     app/graphicsview.cpp
     app/graphicsscene.cpp
     app/bottombuttongroup.cpp
     app/navigatorview.cpp
-    app/opacityhelper.cpp
-    app/toolbutton.cpp
     app/settings.cpp
     app/settingsdialog.cpp
     app/aboutdialog.cpp
@@ -51,18 +52,19 @@ set (PPIC_CPP_FILES
     app/metadatadialog.cpp
     app/exiv2wrapper.cpp
     app/playlistmanager.cpp
+    app/fileopeneventhandler.cpp
+    app/playlistscout.cpp
+    app/playlistscouts/qtscout.cpp
+    app/playlistscouts/explorerscout.cpp
 )
 
 set (PPIC_HEADER_FILES
-    app/framelesswindow.h
     app/mainwindow.h
     app/actionmanager.h
     app/graphicsview.h
     app/graphicsscene.h
     app/bottombuttongroup.h
     app/navigatorview.h
-    app/opacityhelper.h
-    app/toolbutton.h
     app/settings.h
     app/settingsdialog.h
     app/aboutdialog.h
@@ -70,6 +72,17 @@ set (PPIC_HEADER_FILES
     app/metadatadialog.h
     app/exiv2wrapper.h
     app/playlistmanager.h
+    app/fileopeneventhandler.h
+    app/playlistscout.h
+    app/playlistscouts/qtscout.h
+    app/playlistscouts/explorerscout.h
+)
+
+set (PPIC_UI_FILES
+    app/settingsdialog.ui
+    app/aboutdialog.ui
+    app/metadatadialog.ui
+    app/mainwindow.ui
 )
 
 set (PPIC_QRC_FILES
@@ -83,42 +96,77 @@ set (PPIC_RC_FILES
 set (EXE_NAME ppic)
 
 # Translation
-file (GLOB PPIC_TS_FILES app/translations/*.ts)
+file (GLOB PPIC_TS_FILES locales/app/*.ts)
 set (PPIC_CPP_FILES_FOR_I18N ${PPIC_CPP_FILES})
 
-qt5_create_translation(PPIC_QM_FILES ${PPIC_CPP_FILES_FOR_I18N} ${PPIC_TS_FILES})
+find_program (UV_EXECUTABLE uv)
+if (NOT UV_EXECUTABLE)
+    message (FATAL_ERROR "uv is required to run the metaglot tool, install it from https://docs.astral.sh/uv/")
+endif ()
 
 if (WIN32)
-    list(APPEND PPIC_RC_FILES assets/pineapple-pictures.rc)
+    set (PPIC_RC_TEMPLATE_FILE ${CMAKE_CURRENT_BINARY_DIR}/pineapple-pictures.rc.in)
+    execute_process (
+        COMMAND ${UV_EXECUTABLE} tool run metaglot render rc
+                --manifest ${CMAKE_SOURCE_DIR}/dist/pineapple-pictures.rc.in.toml
+                --po ${CMAKE_SOURCE_DIR}/locales/winrc/*.po
+                --template ${CMAKE_SOURCE_DIR}/dist/pineapple-pictures.rc.in.liquid
+                --output ${PPIC_RC_TEMPLATE_FILE}
+        RESULT_VARIABLE METAGLOT_RESULT
+    )
+    if (NOT METAGLOT_RESULT EQUAL 0)
+        message (FATAL_ERROR "Failed to generate pineapple-pictures.rc.in via MetaGlot (exit code: ${METAGLOT_RESULT}). If it is not installed yet, run: uv tool install git+https://github.com/SarasasChipWorkshop/metaglot.git")
+    endif ()
+
+    configure_file (${PPIC_RC_TEMPLATE_FILE} ${CMAKE_CURRENT_BINARY_DIR}/pineapple-pictures.rc @ONLY)
+    list (APPEND PPIC_RC_FILES ${CMAKE_CURRENT_BINARY_DIR}/pineapple-pictures.rc)
 endif ()
 
 add_executable (${EXE_NAME}
     ${PPIC_HEADER_FILES}
     ${PPIC_CPP_FILES}
+    ${PPIC_UI_FILES}
     ${PPIC_QRC_FILES}
     ${PPIC_RC_FILES}
-    ${PPIC_QM_FILES}
 )
 
-target_link_libraries (${EXE_NAME} Qt5::Widgets Qt5::Svg)
+set(ADD_TRANSLATIONS_ADDITIONAL_ARGS)
 
-if (LibExiv2_FOUND)
-    message(INFO ${LibExiv2_INCLUDE_DIRS})
-    target_include_directories(${EXE_NAME}
-    PRIVATE
-        ${LibExiv2_INCLUDE_DIRS}
-    )
+if (Qt6_VERSION VERSION_GREATER_EQUAL "6.9.0")
+    set(ADD_TRANSLATIONS_ADDITIONAL_ARGS MERGE_QT_TRANSLATIONS)
+endif()
+
+if (TRANSLATION_RESOURCE_EMBEDDING)
+    qt_add_translations(${EXE_NAME} ${ADD_TRANSLATIONS_ADDITIONAL_ARGS} TS_FILES ${PPIC_TS_FILES})
+else()
+    qt_add_translations(${EXE_NAME} ${ADD_TRANSLATIONS_ADDITIONAL_ARGS} TS_FILES ${PPIC_TS_FILES} QM_FILES_OUTPUT_VARIABLE PPIC_QM_FILES)
+endif()
+
+# YYC MARK:
+# This is essential, otherwise Qt UIC generated UI header file
+# can not find our header files if there are custom widgets inside UI file.
+target_include_directories(${EXE_NAME} PRIVATE app/)
+
+target_sources(${EXE_NAME} PRIVATE ${PPIC_QM_FILES})
+
+target_link_libraries (${EXE_NAME} Qt${QT_VERSION_MAJOR}::Widgets Qt${QT_VERSION_MAJOR}::Svg Qt${QT_VERSION_MAJOR}::SvgWidgets)
+
+if (exiv2_FOUND)
+    if(NOT TARGET Exiv2::exiv2lib AND TARGET exiv2lib)
+        # for exiv2 0.27.x and (macOS?) conan build
+        add_library(Exiv2::exiv2lib ALIAS exiv2lib)
+    endif()
     target_link_libraries (${EXE_NAME}
-        LibExiv2::LibExiv2
+        Exiv2::exiv2lib
     )
     target_compile_definitions(${EXE_NAME} PRIVATE
-        HAVE_EXIV2_VERSION="${LibExiv2_VERSION}"
+        HAVE_EXIV2_VERSION="${exiv2_VERSION}"
     )
 endif ()
 
-if (Qt5DBus_FOUND)
+if (TARGET Qt6::DBus)
     target_link_libraries (${EXE_NAME}
-        Qt5::DBus
+        Qt${QT_VERSION_MAJOR}::DBus
     )
     target_compile_definitions(${EXE_NAME} PRIVATE
         HAVE_QTDBUS
@@ -127,11 +175,6 @@ endif()
 
 # Extra build settings
 if (WIN32)
-    set_property (
-        TARGET ${EXE_NAME}
-        PROPERTY WIN32_EXECUTABLE true
-    )
-
     target_compile_definitions(${EXE_NAME} PRIVATE
         FLAG_PORTABLE_MODE_SUPPORT=1
     )
@@ -162,6 +205,7 @@ macro (ppic_set_version_via_describe _describe_long)
 endmacro ()
 
 # Version setup
+target_compile_definitions(${EXE_NAME} PRIVATE PPIC_VERSION_STRING="${CMAKE_PROJECT_VERSION}")
 if (EXISTS "${CMAKE_SOURCE_DIR}/.git")
     find_package(Git)
     set_package_properties(Git PROPERTIES TYPE OPTIONAL PURPOSE "Determine exact build version.")
@@ -179,53 +223,81 @@ if (EXISTS "${CMAKE_SOURCE_DIR}/.git")
     endif ()
 endif ()
 
-# Helper macros for install settings
-macro (ppic_convert_to_relative_path _var)
-    # Make sure _var is a relative path
-    if (IS_ABSOLUTE "${${_var}}")
-        file (RELATIVE_PATH ${_var} "${CMAKE_INSTALL_PREFIX}" "${${_var}}")
-    endif ()
-endmacro ()
-
 # Install settings
 if (WIN32)
-    # FIXME: try to avoid install to a "bin" subfolder under windows...
-    #        when fixed, don't forget to update the CI config file...
-    set (BIN_INSTALL_DIR "") # seems useless, don't know why...
+    set_target_properties(${EXE_NAME} PROPERTIES
+        WIN32_EXECUTABLE TRUE
+    )
+elseif (APPLE)
+    set_source_files_properties(dist/sarasacw-picture.icns PROPERTIES
+        MACOSX_PACKAGE_LOCATION "Resources"
+    )
+    target_sources(${EXE_NAME} PUBLIC dist/sarasacw-picture.icns)
+    # See https://cmake.org/cmake/help/v3.15/prop_tgt/MACOSX_BUNDLE_INFO_PLIST.html
+    set_target_properties(${EXE_NAME} PROPERTIES
+        MACOSX_BUNDLE TRUE
+        MACOSX_BUNDLE_INFO_PLIST ${CMAKE_CURRENT_SOURCE_DIR}/dist/MacOSXBundleInfo.plist.in
+        MACOSX_BUNDLE_BUNDLE_NAME "Pineapple Pictures"
+        MACOSX_BUNDLE_GUI_IDENTIFIER net.blumia.pineapple-pictures
+        MACOSX_BUNDLE_ICON_FILE sarasacw-picture.icns # contains the .icns file name, *without* the path.
+        MACOSX_BUNDLE_BUNDLE_VERSION ${PROJECT_VERSION}
+        MACOSX_BUNDLE_SHORT_VERSION_STRING ${PROJECT_VERSION_MAJOR}.${PROJECT_VERSION_MINOR}
+    )
 elseif (UNIX)
     if (CMAKE_INSTALL_PREFIX_INITIALIZED_TO_DEFAULT)
         set(CMAKE_INSTALL_PREFIX /usr)
     endif ()
 
-    set (BIN_INSTALL_DIR "${CMAKE_INSTALL_BINDIR}") # relative, usually "bin"
-    ppic_convert_to_relative_path(BIN_INSTALL_DIR)
-    set (LIB_INSTALL_DIR "${CMAKE_INSTALL_LIBDIR}") # "lib" or "lib64"
-    ppic_convert_to_relative_path(LIB_INSTALL_DIR)
-
     # install icon
     install (
-        FILES assets/icons/app-icon.svg
-        DESTINATION "${CMAKE_INSTALL_DATADIR}/icons/hicolor/48x48/apps"
-        RENAME pineapple-pictures.svg
+        DIRECTORY dist/freedesktop-icons/
+        DESTINATION "${CMAKE_INSTALL_DATADIR}/icons/hicolor"
     )
 
-    # install shortcut
+    # generate and install desktop entry file
+    set (PPIC_DESKTOP_FILE ${CMAKE_CURRENT_BINARY_DIR}/net.blumia.pineapple-pictures.desktop)
+    execute_process (
+        COMMAND ${UV_EXECUTABLE} tool run metaglot render desktop
+                --manifest ${CMAKE_SOURCE_DIR}/dist/net.blumia.pineapple-pictures.desktop.toml
+                --po ${CMAKE_SOURCE_DIR}/locales/desktop/*.po
+                --template ${CMAKE_SOURCE_DIR}/dist/net.blumia.pineapple-pictures.desktop.liquid
+                --output ${PPIC_DESKTOP_FILE}
+        RESULT_VARIABLE METAGLOT_DESKTOP_RESULT
+    )
+    if (NOT METAGLOT_DESKTOP_RESULT EQUAL 0)
+        message (FATAL_ERROR "Failed to generate net.blumia.pineapple-pictures.desktop via MetaGlot (exit code: ${METAGLOT_DESKTOP_RESULT}). If it is not installed yet, run: uv tool install git+https://github.com/SarasasChipWorkshop/metaglot.git")
+    endif ()
+
     install (
-        FILES dist/net.blumia.pineapple-pictures.desktop
+        FILES ${PPIC_DESKTOP_FILE}
         DESTINATION "${CMAKE_INSTALL_DATAROOTDIR}/applications"
     )
 
-    # install app metadata file for appstream (and some other stuff using this metadata like snapcraft)
+    # generate and install app metadata file for appstream (and some other stuff using this metadata like snapcraft)
+    set (PPIC_METAINFO_FILE ${CMAKE_CURRENT_BINARY_DIR}/net.blumia.pineapple-pictures.metainfo.xml)
+    execute_process (
+        COMMAND ${UV_EXECUTABLE} tool run metaglot render appstream
+                --manifest ${CMAKE_SOURCE_DIR}/dist/net.blumia.pineapple-pictures.metainfo.xml.toml
+                --po ${CMAKE_SOURCE_DIR}/locales/appstream/*.po
+                --template ${CMAKE_SOURCE_DIR}/dist/net.blumia.pineapple-pictures.metainfo.xml.liquid
+                --output ${PPIC_METAINFO_FILE}
+        RESULT_VARIABLE METAGLOT_METAINFO_RESULT
+    )
+    if (NOT METAGLOT_METAINFO_RESULT EQUAL 0)
+        message (FATAL_ERROR "Failed to generate net.blumia.pineapple-pictures.metainfo.xml via MetaGlot (exit code: ${METAGLOT_METAINFO_RESULT}). If it is not installed yet, run: uv tool install git+https://github.com/SarasasChipWorkshop/metaglot.git")
+    endif ()
+
     install (
-        FILES dist/appstream/net.blumia.pineapple-pictures.metainfo.xml
+        FILES ${PPIC_METAINFO_FILE}
         DESTINATION "${CMAKE_INSTALL_DATAROOTDIR}/metainfo"
     )
 endif()
 
 set (INSTALL_TARGETS_DEFAULT_ARGS
-    RUNTIME DESTINATION ${BIN_INSTALL_DIR}
-    LIBRARY DESTINATION ${LIB_INSTALL_DIR}
-    ARCHIVE DESTINATION ${LIB_INSTALL_DIR} COMPONENT Devel
+    BUNDLE DESTINATION .
+    RUNTIME DESTINATION ${CMAKE_INSTALL_BINDIR}
+    LIBRARY DESTINATION ${CMAKE_INSTALL_LIBDIR}
+    ARCHIVE DESTINATION ${CMAKE_INSTALL_LIBDIR} COMPONENT Devel
 )
 
 install (
@@ -233,20 +305,25 @@ install (
     ${INSTALL_TARGETS_DEFAULT_ARGS}
 )
 
-if (WIN32)
+if (TRANSLATION_RESOURCE_EMBEDDING)
+    target_compile_definitions(${EXE_NAME}
+        PRIVATE TRANSLATION_RESOURCE_EMBEDDING
+    )
+elseif (WIN32)
     set (QM_FILE_INSTALL_DIR "${CMAKE_INSTALL_BINDIR}/translations")
-else ()
+else()
     set (QM_FILE_INSTALL_DIR "${CMAKE_INSTALL_FULL_DATADIR}/pineapple-pictures/translations")
     target_compile_definitions(${EXE_NAME}
-        PRIVATE QM_FILE_INSTALL_DIR=${QM_FILE_INSTALL_DIR}
+        PRIVATE QM_FILE_INSTALL_ABSOLUTE_DIR=${QM_FILE_INSTALL_DIR}
     )
-endif ()
-
-install (
-    FILES ${PPIC_QM_FILES}
-    DESTINATION ${QM_FILE_INSTALL_DIR}
-)
+endif()
 
+if (DEFINED QM_FILE_INSTALL_DIR)
+    install(
+        FILES ${PPIC_QM_FILES}
+        DESTINATION ${QM_FILE_INSTALL_DIR}
+    )
+endif()
 feature_summary(WHAT ALL INCLUDE_QUIET_PACKAGES FATAL_ON_MISSING_REQUIRED_PACKAGES)
 
 # CPACK: General Settings
@@ -261,8 +338,8 @@ elseif (APPLE)
     # ...
 elseif (UNIX)
     set (CPACK_SYSTEM_NAME "${CMAKE_SYSTEM_NAME}-${CMAKE_SYSTEM_PROCESSOR}")
-    set (CPACK_DEBIAN_PACKAGE_SHILIBDEPS ON)
-    set (CPACK_DEBIAN_PACKAGE_RECOMMENDS "kimageformat-plugins")
+    set (CPACK_DEBIAN_PACKAGE_SHLIBDEPS ON)
+    set (CPACK_DEBIAN_PACKAGE_RECOMMENDS "kimageformat6-plugins")
 endif()
 
 include(CPack)

LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2020 BLumia
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 BLumia
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

LICENSES/BSD-3-Clause.txt

@@ -1,11 +0,0 @@
-Copyright (c) <year> <owner>. 
-
-Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
-
-1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
-
-2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
-
-3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
-
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

NEWS

@@ -0,0 +1,301 @@
+Version 1.6.0
+~~~~~~~~~~~~~
+Released: 2026-08-22
+
+Features:
+ * Allow dragging window from titlebar to move window when maximized
+ * Add an option to show/hide bird-eye view
+
+Bugfixes:
+ * Maximize the window when the image size matches the screen size
+ * Fix window might stuck when drag move on some ill-formed window manager
+ * Make titlebar respect RTL layout
+
+Miscellaneous:
+ * Update translations
+ * Update Qt version to 6.11.2 for Windows and macOS pre-built binaries
+
+Contributors:
+ Tech-Tac, Heimen Stoffels (vistaus), VenusGirl, Oğuz Ersen
+
+Version 1.5.0
+~~~~~~~~~~~~~
+Released: 2026-07-04
+
+Features:
+ * Introduced an optional titlebar that display file name and allows drag and double-click to move and toggle maximize state
+ * Windows: Now the application will use the system's built-in animation for open window animation
+
+Bugfixes:
+ * Show empty url list should also reset window title to blank
+
+Miscellaneous:
+ * Update translations
+ * Add vcs-browser link to AppStream metadata
+
+Contributors:
+ Heimen Stoffels (vistaus), VenusGirl (VenusGirl)
+
+Version 1.4.1
+~~~~~~~~~~~~~
+Released: 2026-04-05
+
+Miscellaneous:
+ * Update translations
+ * Update Qt version to 6.10.3 for Windows and macOS pre-built binaries
+
+Contributors:
+ Heimen Stoffels (vistaus), Loc Huynh (hthienloc)
+
+Version 1.4.0
+~~~~~~~~~~~~~
+Released: 2026-02-11
+
+Features:
+ * Action to save image as new file with different format
+ * Add Vietnamese and Slovenian translation
+
+Miscellaneous:
+ * Update copyright year to 2026
+ * Update translations
+ * Update Qt version to 6.10.2 for Windows and macOS pre-built binaries
+
+Contributors:
+ Loc Huynh, Sabri Ünal, VenusGirl, Andrej Poženel, Andrey
+
+Version 1.3.0
+~~~~~~~~~~~~~
+Released: 2025-12-20
+
+Features:
+ * New option to limit SVG support to SVG Tiny 1.2 standard
+ * Windows: ship tools and configurations that help user associate image files to this program
+
+Bugfixes:
+ * Fix window not appear at the screen that the mouse cursor is at
+ * Fix Windows prebuilt binary having AVIF plugin included but not actually support it
+
+Miscellaneous:
+ * CPack DEB: will now recommend "kimageformat6-plugins" instead of the KF5 version
+ * Update translations
+ * Update exiv2 version for Windows binary build
+
+Contributors:
+ VenusGirl, Andrey
+
+Version 1.2.1
+~~~~~~~~~~~~~
+Released: 2025-11-22
+
+Bugfixes:
+ * Fix incorrect color when display some CMYK images.
+
+Miscellaneous:
+ * Now use Qt 6.10.1 for pre-built binary
+ * Update README description and AppStream metainfo
+ * Update translations
+ * Update libavif, AOM and expat version for Windows binary build
+
+Contributors:
+ albanobattistella
+
+Version 1.2.0
+~~~~~~~~~~~~~
+Released: 2025-09-21
+
+Features:
+ * Long image mode that detect extra wide image and auto fit by its thin side
+ * Windows: Add product version to binary metadata / resource file
+
+Miscellaneous:
+ * Update translations
+ * Update libavif version for Windows binary build
+
+Contributors:
+ Heimen Stoffels, albanobattistella, Sabri Ünal
+
+Version 1.1.1
+~~~~~~~~~~~~~
+Released: 2025-08-02
+
+Features:
+ * Click dock icon should show window when it's hidden on macOS
+
+Bugfixes:
+ * Ensure "Fit by Width" position the view to the beginning of the image
+
+Miscellaneous:
+ * Update translations
+ * Update Exiv2 version for Windows binary build
+
+Contributors:
+ Heimen Stoffels, VenusGirl, தமிழ்நேரம்
+
+Version 1.1.0
+~~~~~~~~~~~~~
+Released: 2025-07-06
+
+Features:
+ * New option to disable built-in close window animation
+ * New option to disable gallery looping
+ * Support load m3u8 as image gallery playlist
+
+Miscellaneous:
+ * Drop Qt 5 support
+
+Contributors:
+ Heimen Stoffels, albanobattistella, தமிழ்நேரம்
+
+Version 1.0.0
+~~~~~~~~~~~~~
+Released: 2025-05-03
+
+Features:
+ * Support enforces windowed mode on start-up
+ * Reload image automatically when current image gets updated
+
+Bugfixes:
+ * Display correct text language on macOS
+
+Miscellaneous:
+ * Use native text for shortcut editor's label
+ * Display native commandline message when possible
+ * Merge Qt translations into app applications as well
+
+Contributors:
+ Heimen Stoffels, albanobattistella, mmahhi
+
+Version 0.9.2
+~~~~~~~~~~~~~
+Released: 2025-03-05
+
+Bugfixes:
+ * Refer to the right exiv2 CMake module so it can be found on Linux
+
+Miscellaneous:
+ * Convert DEP5 to REUSE.toml for better REUSE compliance
+ * Update translations
+
+Contributors:
+ Pino Toscano, TamilNeram
+
+Version 0.9.1
+~~~~~~~~~~~~~
+Released: 2025-01-25
+
+Features:
+ * Option to double-click to fullscreen
+ * Build-time option to embed translation resources
+
+Bugfixes:
+ * Fix window size not adjusted when open file on macOS
+ * Should center window according to available screen geometry
+
+Miscellaneous:
+ * Change close window bahavior on macOS
+ * Update translations
+
+Contributors:
+ albanobattistella, Sabri Ünal
+
+Version 0.9.0
+~~~~~~~~~~~~~
+Released: 2024-12-08
+
+Features:
+ * Support custom shortcuts for existing actions
+ * Actions for frame-by-frame animated image playback support
+
+Miscellaneous:
+ * Initial macOS bundle support
+ * bump minimum required CMake version to 3.16
+ * Update translations
+
+Contributors:
+ albanobattistella, VenusGirl, gallegonovato, Sabri Ünal
+
+Version 0.8.2.1
+~~~~~~~~~~~~~
+Released: 2024-10-27
+
+Bugfixes:
+ * Cannot load translations caused by a change in 0.8.2
+
+Version 0.8.2
+~~~~~~~~~~~~~
+Released: 2024-10-26
+
+Features:
+ * New option to allow use light-color checkerboard by default
+
+Contributors:
+ albanobattistella, mmahhi, gallegonovato
+
+Version 0.8.1
+~~~~~~~~~~~~~
+Released: 2024-08-25
+
+Features:
+ * New command line option to list all supported formats
+
+Contributors:
+ albanobattistella, mmahhi, ovl-1, gallegonovato, Oğuz Ersen
+
+Version 0.8.0
+~~~~~~~~~~~~~
+Released: 2024-06-29
+
+Features:
+ * Support move image file to trash
+
+Contributors:
+ albanobattistella, mmahhi, gallegonovato, Oğuz Ersen
+
+Version 0.7.4
+~~~~~~~~~~~~~
+Released: 2024-04-04
+
+Features:
+ * Add some icons for corresponding menu actions
+
+Contributors:
+ Reza Almanda, mmahhi, Oğuz Ersen, volkov, Сергій
+
+Version 0.7.3
+~~~~~~~~~~~~~
+Released: 2023-10-24
+
+Features:
+ * Add "Keep transformation" to menu
+
+Contributors:
+ mmahhi, VenusGirl, albanobattistella, gallegonovato, Heimen Stoffels
+
+Version 0.7.2
+~~~~~~~~~~~~~
+Released: 2023-08-27
+
+Features:
+ * Add an option in setting dialog to tweak the High-DPI scaling rounding policy (might only works in Qt 6 build)
+
+Bugfixes:
+ * Remove image size limit for Qt 6 build
+ * Fix application icon install location under Linux
+
+Contributors:
+ Heimen Stoffels, Andrey, Dan, gallegonovato, albanobattistella, Sabri Ünal
+
+Version 0.7.1
+~~~~~~~~~~~~~
+Released: 2023-07-08
+
+Features:
+ * TIF and TIFF format files in the same folder will now be automatically added to the gallery
+ * Built-in window resizing now also supports Linux desktop. (macOS might also works as well)
+
+Bugfixes:
+ * Settings dialog will automatedly use a suitable size instead of a hard-coded one
+ * Fix default configuration file location under Linux. (was `~/.config/config.ini`, now it's `~/.config/Pineapple Pictures/config.ini`)
+
+Contributors:
+ yyc12345

README.md

@@ -1,78 +1,84 @@
-Yet another image viewer.
-
-|CI|Build Status|
-|---|---|
-|Windows Build|[![Windows build status](https://ci.appveyor.com/api/projects/status/dbd8clww3cit6oa0/branch/master?svg=true)](https://ci.appveyor.com/project/BLumia/pineapplepictures/branch/master)|
-|macOS Build|[![macOS CI](https://github.com/BLumia/pineapple-pictures/actions/workflows/macos.yml/badge.svg)](https://github.com/BLumia/pineapple-pictures/actions/workflows/macos.yml)|
-|Ubuntu Build|[![Ubuntu CI](https://github.com/BLumia/pineapple-pictures/actions/workflows/ubuntu.yml/badge.svg)](https://github.com/BLumia/pineapple-pictures/actions/workflows/ubuntu.yml)|
-
-![Pineapple Pictures - Main Window](https://repository-images.githubusercontent.com/211888654/e8697600-e370-11eb-9b2a-b71e05262954)
-
-## Summary
-
-Pineapple Pictures is a lightweight image viewer that allows you view JPEG, PNG, GIF, SVG, PSD, KRA, XCF, TGA, AVIF and some other frequently used image formats files quickly and easily, and also provide a Stay-on-Top window setting that allows you pin the window so you can use it to pin a reference image at the top and then you can work with other software.
-
-## Get it!
-
- - [GitHub Release Page](https://github.com/BLumia/pineapple-pictures/releases)
- - [SourceForge](https://sourceforge.net/projects/pineapple-pictures/)
- - Archlinux AUR: [pineapple-pictures](https://aur.archlinux.org/packages/pineapple-pictures/) | [pineapple-pictures-git](https://aur.archlinux.org/packages/pineapple-pictures-git/)
- - Debian (since bullseye) or Ubuntu (since 21.04): `sudo apt install pineapple-pictures`
- - [Itch.io Store](https://blumia.itch.io/pineapple-pictures)
-
-## Help Translation!
-
-[Translate this project on Weblate!](https://hosted.weblate.org/projects/pineapple-pictures/)
-
-## Build it manually:
-
-Current state, we need:
-
- - `cmake`: as the build system.
- - `qt5` with `qt5-svg` and `qt5-tools`: since the app is using Qt.
- - `libexiv2`: able to display more image metadata. (optional, but recommended)
-
-Then we can build it with any proper c++ compiler like g++ or msvc.
-
-Building it just requires normal cmake building steps:
-
-``` bash
-$ mkdir build && cd build
-$ cmake ..
-$ cmake --build . # or simply using `make` if you are using Makefile as the cmake generator.
-```
-
-After that, a `ppic` executable file will be available to use. You can also optionally install it by using the target `install` (or simply `make install` in case you are using Makefile). After the build process, you can also use `cpack` to make a package.
-
-The project will try to build with `exiv2` when it's available at build time, if you would like to build the project without `exiv2`, pass `-DEXIV2_METADATA_SUPPORT=OFF` to `cmake`. The project will also not use `exiv2` if it's not found, the `EXIV2_METADATA_SUPPORT` option can be useful if you have `exiv2` but specifically don't want to use it.
-
-Image formats supports rely on Qt's imageformats plugins, just get the plugins you need from your distro's package manager will be fine. For Windows user, you may need build and install the imageformats plugin manually, read the content below.
-
-> **Note**
-> Although there is a `pineapple-pictures.pro` file which can be used for QMake build, it's only for testing purpose and it doesn't have `exiv2` support included. Using QMake to build this project is NOT supported, please use CMake if possible.
-
-### Linux
-
-Just normal build process as other program will be fine. Nothing special ;)
-
-For Archlinux there are also a [PKGBUILD](https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=pineapple-pictures-git) you can use.
-
-For packaging to debian-based distro, the `CMakeLists.txt` provides some cpack configurations for generating a `.deb` package. After the build process, use `cpack -G DEB` to generate the package. You can also take `.github/workflows/ubuntu.yml` as a reference.
-
-For this project, `DEB` is the only supported cpack generator in current state, feel free to submit a PR if you like improving `cpack` support for this project.
-
-### Windows
-
-The normal build steps for Linux is also applied to Windows, but since Windows doesn't have a decent package manager, so if you need any other image formats support other than the supported formats which Qt provided, you need to get and build these imageformats plugins manually and vendor it. It's optional and can be skipped if you don't need extra image formats support.
-
-For the Windows binary I provided, kimageformats plugin is used (for formats like kra, xcf, psd and etc.). You can take `appveyor.yml` as a reference to learn what I did when building the Windows binary.
-
-[KDE Craft](https://community.kde.org/Craft) environment also can be used to build and package this program. I did also created a blueprint for building this project that you can found it at [here](https://github.com/BearKidsTeam/craft-shmooprint-bkt). It's not the way I used to create the release binary, but still worth trying.
-
-### macOS
-
-I don't have a mac, so no support at all. There is also a GitHub Action (see `.github/workflows/macos.yml`) running macOS build though so at least it can build. Feel free to submit a PR if you would like to give some love to the macOS build ;P
-
-## License
-
-Pineapple Pictures as a whole is licensed under MIT license. Individual files may have a different, but compatible license.
+# Sarasas Chip Workshop Picture
+
+Yet another legacy Windows Photo Viewer with cross-platform support.
+
+> [!IMPORTANT]
+> SarasaCW Picture are still in refactoring. Please do not use it until this message removes.
+
+## Summary
+
+Sarasas Chip Workshop Picture (abbr. SarasaCW Picture) is a lightweight image viewer that has cross-platform support and similar user interface about legacy Windows Photo Viewer. It allows you view JPEG, PNG, GIF, SVG, PSD, KRA, XCF, TGA, HDR, AVIF and some other frequently used image formats files quickly and easily without changing your long-term Windows usage experience.
+
+SarasaCW Picture is the **hard fork** of [Pineapple Pictures](https://github.com/BLumia/pineapple-pictures) since Pineapple Pictures 1.4.1 version.
+
+<!--
+
+|CI|Build Status|
+|---|---|
+|Windows Build|[![Windows CI](https://github.com/BLumia/pineapple-pictures/actions/workflows/windows.yml/badge.svg)](https://github.com/BLumia/pineapple-pictures/actions/workflows/windows.yml)|
+|macOS Build|[![macOS CI](https://github.com/BLumia/pineapple-pictures/actions/workflows/macos.yml/badge.svg)](https://github.com/BLumia/pineapple-pictures/actions/workflows/macos.yml)|
+|Ubuntu Build|[![Ubuntu CI](https://github.com/BLumia/pineapple-pictures/actions/workflows/ubuntu.yml/badge.svg)](https://github.com/BLumia/pineapple-pictures/actions/workflows/ubuntu.yml)|
+
+![Pineapple Pictures - Main Window](https://repository-images.githubusercontent.com/211888654/e8697600-e370-11eb-9b2a-b71e05262954)
+
+## Get it!
+
+### Maintained by the original author
+
+- [GitHub Release Page](https://github.com/BLumia/pineapple-pictures/releases)
+- [SourceForge](https://sourceforge.net/projects/pineapple-pictures/)
+- Archlinux AUR: [pineapple-pictures](https://aur.archlinux.org/packages/pineapple-pictures/) | [pineapple-pictures-git](https://aur.archlinux.org/packages/pineapple-pictures-git/)
+- [Itch.io Store](https://blumia.itch.io/pineapple-pictures)
+
+### Maintained by contributors / certain distro's package maintainers
+
+[![Packaging status](https://repology.org/badge/vertical-allrepos/pineapple-pictures.svg?columns=4)](https://repology.org/project/pineapple-pictures/versions)
+
+## Contribution
+
+Beside feedback and code contribution, other contributions are also welcome!
+
+### Help Translation!
+
+[Translate this project on Weblate!](https://hosted.weblate.org/projects/pineapple-pictures/)
+
+### Funding
+
+[![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/blumia)
+
+[![Afdian](https://static.afdiancdn.com/static/img/logo/logo.png)Afdian](https://afdian.com/a/BLumia)
+
+## Build it manually:
+
+Current state, we need:
+
+ - `cmake`: as the build system.
+ - `qt6` with `qt6-svg` and `qt6-tools`: since the app is using Qt.
+ - `libexiv2`: able to display more image metadata. (optional, but recommended)
+
+Then we can build it with any proper c++ compiler like g++ or msvc.
+
+Building it just requires normal cmake building steps:
+
+``` bash
+$ mkdir build && cd build
+$ cmake ..
+$ cmake --build . # or simply using `make` if you are using Makefile as the cmake generator.
+```
+
+After that, a `ppic` executable file will be available to use. You can also optionally install it by using the target `install` (or simply `make install` in case you are using Makefile). After the build process, you can also use `cpack` to make a package.
+
+The project will try to build with `exiv2` when it's available at build time, if you would like to build the project without `exiv2`, pass `-DEXIV2_METADATA_SUPPORT=OFF` to `cmake`. The project will also not use `exiv2` if it's not found, the `EXIV2_METADATA_SUPPORT` option can be useful if you have `exiv2` but specifically don't want to use it.
+
+Image formats supports rely on Qt's imageformats plugins, just get the plugins you need from your distro's package manager will be fine. For Windows user, you may need build and install the imageformats plugin manually, read the content below.
+
+It's possible to build it under Windows, Linux, macOS, and maybe other desktop platforms that Qt is ported to. For platform specific build instructions, please read the [related wiki page](https://github.com/BLumia/pineapple-pictures/wiki/Platform-Specific-Build-Instructions).
+
+> [!NOTE]
+> Although there is a `pineapple-pictures.pro` file which can be used for QMake build, it's only for testing purpose and it doesn't have `exiv2` support included. Using QMake to build this project is NOT supported, please use CMake if possible.
+
+## License
+
+Pineapple Pictures as a whole is licensed under MIT license. Individual files may have a different, but compatible license.
+
+-->

README.zh_CN.md

@@ -1,78 +1,87 @@
-简单轻量的跨平台看图工具。
-
-|CI|构建状态|
-|---|---|
-|Windows Build|[![Windows build status](https://ci.appveyor.com/api/projects/status/dbd8clww3cit6oa0/branch/master?svg=true)](https://ci.appveyor.com/project/BLumia/pineapplepictures/branch/master)|
-|macOS Build|[![macOS CI](https://github.com/BLumia/pineapple-pictures/actions/workflows/macos.yml/badge.svg)](https://github.com/BLumia/pineapple-pictures/actions/workflows/macos.yml)|
-|Ubuntu Build|[![Ubuntu CI](https://github.com/BLumia/pineapple-pictures/actions/workflows/ubuntu.yml/badge.svg)](https://github.com/BLumia/pineapple-pictures/actions/workflows/ubuntu.yml)|
-
-![Pineapple Pictures - Main Window](https://repository-images.githubusercontent.com/211888654/e8697600-e370-11eb-9b2a-b71e05262954)
-
-## 简介
-
-菠萝看图是一个轻量图像查看器，允许你简单快捷的查看 JPEG, PNG, GIF, SVG, PSD, KRA, XCF, TGA, AVIF 等常用格式的图像文件，并提供了置顶窗口的选项以便你在使用其它软件时也可以将参考图片固定在顶端。
-
-## 立即获取!
-
- - [GitHub Release 页面](https://github.com/BLumia/pineapple-pictures/releases) | [gitee 发布页面](https://gitee.com/blumia/pineapple-pictures/releases)
- - [SourceForge](https://sourceforge.net/projects/pineapple-pictures/)
- - Archlinux AUR: [pineapple-pictures](https://aur.archlinux.org/packages/pineapple-pictures/) | [pineapple-pictures-git](https://aur.archlinux.org/packages/pineapple-pictures-git/)
- - Debian (自 bullseye 起) 或 Ubuntu (自 21.04 起): `sudo apt install pineapple-pictures`
- - [Itch.io 商店](https://blumia.itch.io/pineapple-pictures)
-
-## 帮助翻译!
-
-[在 Weblate 上帮助此项目翻译到更多语言!](https://hosted.weblate.org/projects/pineapple-pictures/)
-
-## 手动构建步骤:
-
-当前状态，我们需要先确保如下依赖可用:
-
- - `cmake`: 我们所使用的构建系统
- - 包含 `qt5-svg` 与 `qt5-tools` 组件的 `qt5`: 此应用基于 Qt
- - `libexiv2`: 用以获取和显示更多的图像元信息（可选，推荐）
-
-然后我们就可以使用任何常规的 c++ 编译器如 g++ 或 msvc 来进行构建了
-
-构建过程就是常规的 CMake 应用构建过程:
-
-``` bash
-$ mkdir build && cd build
-$ cmake ..
-$ cmake --build . # 如果你使用 Makefile 作为 CMake 生成器，也可以直接简单的使用 `make`
-```
-
-完毕后，一个名为 `ppic` 的可执行程序即会被生成以供使用。您也可以选择通过使用 CMake 生成的 `install` 目标继续将其安装到您的设备上（假设您使用 Makefile，即可执行 `make install` 来进行安装）。构建步骤完毕后，您也可以使用 `cpack` 来对应用程序进行打包。
-
-当 `exiv2` 在构建时可用时，此项目将尝试使用其进行构建，若您不希望使用 `exiv2`，请传递 `-DEXIV2_METADATA_SUPPORT=OFF` 参数给 `cmake`。此项目在找不到 `exiv2` 时并不会使用 `exiv2`，`EXIV2_METADATA_SUPPORT` 选项可供尽管存在可用的 `exiv2` 但您明确不希望启用其支持时使用。
-
-此应用的图片格式支持依赖于 Qt 的 imageformats 插件，直接从您所用的发行版获取对应的图像格式插件即可。对于 Windows 用户，您可能需要手动构建和使用图像格式插件。下方给出了进一步的说明。
-
-> **Note**
-> 尽管存在一个可用于 QMake 构建的 `pineapple-pictures.pro` 文件，但其仅供简单测试所用且其并不包含 `exiv2` 支持。使用 QMake 构建此项目是 **不受支持** 的，请尽可能考虑使用 CMake。
-
-### Linux
-
-常规的构建步骤即可完成构建，不需要额外的处理步骤 ;)
-
-对于 Archlinux 发行版的用户，这里还有一个 [PKGBUILD](https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=pineapple-pictures-git) 可供使用和参考。
-
-对于在基于 debian 的发行版中进行打包的需求， `CMakeLists.txt` 已经提供了一些基本的 cpack 配置以便生成一个有效的 `.deb` 软件包。在构建步骤完毕后，使用 `cpack -G DEB` 即可生成 DEB 软件包。您也可以参考 `.github/workflows/ubuntu.yml` 来查看当前正在使用的 CI 配置是如何进行打包的。
-
-目前，`DEB` 是当前唯一受到直接支持的 cpack 生成目标。若希望为此项目添加其它的 cpack 目标支持，欢迎发起合并请求。
-
-### Windows
-
-上述的构建步骤在 Windows 中也适用，但由于 Windows 中不具备类如大多 Linux 发行版中所提供的方便的软件包管理机制，故如果您需要任何 Qt 官方支持之外的图像格式例如 psd，xcf，kra 等格式的支持，你就可能需要自行获取并构建对应的 imageformats 插件，并在您最终生成的可执行文件中一并提供这些插件。若您不需要这些额外的图像格式支持，这个步骤也可以直接跳过。
-
-我们所提供的预编译好的 Windows 程序包含了 kimageformats 插件来提供额外（kra, xcf, psd 等）格式的支持。您可以参考 `appveyor.yml` 来查看我们是如何构建并打包 Windows 可执行程序的。
-
-[KDE Craft](https://community.kde.org/Craft) 环境也可以被用来构建此应用程序。我也创建了一个蓝图来进行此项目的构建和打包，可参见[这里](https://github.com/BearKidsTeam/craft-shmooprint-bkt)。尽管这不是我用于构建发布二进制所使用的方案，但仍值得一试。
-
-### macOS
-
-由于我没有 mac 设备，故 macOS 暂时不受任何支持。不过我们目前有一个 GitHub Action 来执行 macOS 环境下的构建（见 `.github/workflows/macos.yml`）所以至少 macOS 下是可以顺利进行构建的。如果您想完善对 macOS 的支持，也欢迎您创建合并请求 ;P
-
-## 许可协议
-
-菠萝看图整体使用 MIT 协议进行发布。项目所随的部分源文件可能具备不同但与之兼容的许可协议。
+# Sarasas Chip Workshop 照片查看器
+
+简单轻量的、具有跨平台支持的、经典样式的 Windows 照片查看器。
+
+> [!IMPORTANT]
+> SarasaCW 照片查看器还在重构中。在这条信息被移除之前请不要使用它。
+
+## 简介
+
+Sarasas Chip Workshop 照片查看器（简称 SarasaCW 照片查看器）是一个轻量级的图片查看器。支持跨平台。界面风格类似于经典的 Windows 照片查看器。它可以让你快速轻松地浏览 JPEG、PNG、GIF、SVG、PSD、KRA、XCF、TGA、HDR、AVIF 以及其他一些常用的图片格式，且无需改变你长期的 Windows 使用习惯。
+
+SarasaCW 照片查看器是[菠萝看图](https://github.com/BLumia/pineapple-pictures)的**硬分叉**，该分叉自菠萝看图 1.4.1 版本开始。
+
+<!--
+
+简单轻量的跨平台看图工具。
+
+|CI|构建状态|
+|---|---|
+|Windows Build|[![Windows CI](https://github.com/BLumia/pineapple-pictures/actions/workflows/windows.yml/badge.svg)](https://github.com/BLumia/pineapple-pictures/actions/workflows/windows.yml)|
+|macOS Build|[![macOS CI](https://github.com/BLumia/pineapple-pictures/actions/workflows/macos.yml/badge.svg)](https://github.com/BLumia/pineapple-pictures/actions/workflows/macos.yml)|
+|Ubuntu Build|[![Ubuntu CI](https://github.com/BLumia/pineapple-pictures/actions/workflows/ubuntu.yml/badge.svg)](https://github.com/BLumia/pineapple-pictures/actions/workflows/ubuntu.yml)|
+
+![Pineapple Pictures - Main Window](https://repository-images.githubusercontent.com/211888654/e8697600-e370-11eb-9b2a-b71e05262954)
+
+## 立即获取!
+
+### 由原作者维护
+
+- [GitHub Release 页面](https://github.com/BLumia/pineapple-pictures/releases)
+- [SourceForge](https://sourceforge.net/projects/pineapple-pictures/)
+- Archlinux AUR: [pineapple-pictures](https://aur.archlinux.org/packages/pineapple-pictures/) | [pineapple-pictures-git](https://aur.archlinux.org/packages/pineapple-pictures-git/)
+- [Itch.io 商店](https://blumia.itch.io/pineapple-pictures)
+- Flatpak (于 FlatHub): [net.blumia.pineapple-pictures](https://flathub.org/apps/net.blumia.pineapple-pictures) *([我应当使用 flatpak 版吗？](https://github.com/BLumia/pineapple-pictures/wiki/Container%E2%80%90based-Packaging-Solutions-Support))*
+
+### 由贡献者/对应发行版的打包人员维护
+
+[![打包状态](https://repology.org/badge/vertical-allrepos/pineapple-pictures.svg?columns=4)](https://repology.org/project/pineapple-pictures/versions)
+
+## 参与贡献
+
+除了参与反馈和代码贡献外，也欢迎各种类型的贡献！
+
+### 帮助翻译!
+
+[在 Weblate 上帮助此项目翻译到更多语言!](https://hosted.weblate.org/projects/pineapple-pictures/)
+
+### 打赏
+
+[![Afdian](https://static.afdiancdn.com/static/img/logo/logo.png)Afdian | 爱发电](https://afdian.com/a/BLumia)
+
+[![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/blumia)
+
+## 手动构建步骤:
+
+当前状态，我们需要先确保如下依赖可用:
+
+ - `cmake`: 我们所使用的构建系统
+ - 包含 `qt6-svg` 与 `qt6-tools` 组件的 `qt6`: 此应用基于 Qt
+ - `libexiv2`: 用以获取和显示更多的图像元信息（可选，推荐）
+
+然后我们就可以使用任何常规的 c++ 编译器如 g++ 或 msvc 来进行构建了
+
+构建过程就是常规的 CMake 应用构建过程:
+
+``` bash
+$ mkdir build && cd build
+$ cmake ..
+$ cmake --build . # 如果你使用 Makefile 作为 CMake 生成器，也可以直接简单的使用 `make`
+```
+
+完毕后，一个名为 `ppic` 的可执行程序即会被生成以供使用。您也可以选择通过使用 CMake 生成的 `install` 目标继续将其安装到您的设备上（假设您使用 Makefile，即可执行 `make install` 来进行安装）。构建步骤完毕后，您也可以使用 `cpack` 来对应用程序进行打包。
+
+当 `exiv2` 在构建时可用时，此项目将尝试使用其进行构建，若您不希望使用 `exiv2`，请传递 `-DEXIV2_METADATA_SUPPORT=OFF` 参数给 `cmake`。此项目在找不到 `exiv2` 时并不会使用 `exiv2`，`EXIV2_METADATA_SUPPORT` 选项可供尽管存在可用的 `exiv2` 但您明确不希望启用其支持时使用。
+
+此应用的图片格式支持依赖于 Qt 的 imageformats 插件，直接从您所用的发行版获取对应的图像格式插件即可。对于 Windows 用户，您可能需要手动构建和使用图像格式插件。下方给出了进一步的说明。
+
+在 Windows、Linux 以及 macOS 系统均可构建此应用，其它有移植 Qt 支持的平台也可能可以进行构建。若要了解一些平台相关的构建指引，请参阅[相关的 Wiki 页面](https://github.com/BLumia/pineapple-pictures/wiki/Platform-Specific-Build-Instructions)。
+
+> [!NOTE]
+> 尽管存在一个可用于 QMake 构建的 `pineapple-pictures.pro` 文件，但其仅供简单测试所用且其并不包含 `exiv2` 支持。使用 QMake 构建此项目是 **不受支持** 的，请尽可能考虑使用 CMake。
+
+## 许可协议
+
+菠萝看图整体使用 MIT 协议进行发布。项目所随的部分源文件可能具备不同但与之兼容的许可协议。
+
+-->

REUSE.toml

@@ -0,0 +1,39 @@
+version = 1
+SPDX-PackageName = "Pineapple Pictures"
+SPDX-PackageDownloadLocation = "https://github.com/BLumia/pineapple-pictures"
+
+[[annotations]]
+path = [".gitattributes", ".git-blame-ignore-revs", ".gitignore", "appveyor.yml", ".github/**"]
+precedence = "aggregate"
+SPDX-FileCopyrightText = "None"
+SPDX-License-Identifier = "CC0-1.0"
+
+[[annotations]]
+path = ["README**.md", "NEWS", "assets/**.rc.in", "assets/**.qrc", "dist/appstream/**", "dist/**.in", "dist/**.desktop", "dist/**.rc.in.toml", "dist/**.rc.in.liquid"]
+precedence = "aggregate"
+SPDX-FileCopyrightText = "None"
+SPDX-License-Identifier = "CC0-1.0"
+
+[[annotations]]
+path = ["locales/app/**.ts", "locales/winrc/**", "assets/plain/translators.html"]
+precedence = "aggregate"
+SPDX-FileCopyrightText = "Translators from hosted.weblate.org"
+SPDX-License-Identifier = "MIT"
+
+[[annotations]]
+path = "tool/**"
+precedence = "aggregate"
+SPDX-FileCopyrightText = "2026 yyc12345"
+SPDX-License-Identifier = "MIT"
+
+[[annotations]]
+path = "assets/icons/**.svg"
+precedence = "aggregate"
+SPDX-FileCopyrightText = "2022 Gary Wang"
+SPDX-License-Identifier = "MIT"
+
+[[annotations]]
+path = "assets/icons/app-icon.**"
+precedence = "aggregate"
+SPDX-FileCopyrightText = "2020 Lovelyblack"
+SPDX-License-Identifier = "MIT"

app/aboutdialog.cpp

@@ -1,172 +1,99 @@
-// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
-//
-// SPDX-License-Identifier: MIT
-
-#include "aboutdialog.h"
-
-#include <QAbstractButton>
-#include <QDialogButtonBox>
-#include <QTextBrowser>
-#include <QTabWidget>
-#include <QVBoxLayout>
-#include <QApplication>
-#include <QLabel>
-#include <QPushButton>
-#include <QFile>
-
-AboutDialog::AboutDialog(QWidget *parent)
-    : QDialog(parent)
-    , m_tabWidget(new QTabWidget)
-    , m_buttonBox(new QDialogButtonBox)
-    , m_helpTextEdit(new QTextBrowser)
-    , m_aboutTextEdit(new QTextBrowser)
-    , m_specialThanksTextEdit(new QTextBrowser)
-    , m_licenseTextEdit(new QTextBrowser)
-    , m_3rdPartyLibsTextEdit(new QTextBrowser)
-{
-    this->setWindowTitle(tr("About"));
-
-    const QStringList helpStr {
-        QStringLiteral("<p>%1</p>").arg(tr("Launch application with image file path as argument to load the file.")),
-        QStringLiteral("<p>%1</p>").arg(tr("Drag and drop image file onto the window is also supported.")),
-        QStringLiteral("<p>%1</p>").arg(tr("None of the operations in this application will alter the pictures on disk.")),
-        QStringLiteral("<p>%1</p>").arg(tr("Context menu option explanation:")),
-        QStringLiteral("<ul>"),
-        // blumia: Chain two arg() here since it seems lupdate will remove one of them if we use
-        //         the old `arg(QCoreApp::translate(), tr())` way, but it's worth to mention
-        //         `arg(QCoreApp::translate(), this->tr())` works, but lupdate will complain about the usage.
-        QStringLiteral("<li><b>%1</b>:<br/>%2</li>")
-                .arg(QCoreApplication::translate("MainWindow", "Stay on top"))
-                .arg(tr("Make window stay on top of all other windows.")),
-        QStringLiteral("<li><b>%1</b>:<br/>%2</li>")
-                .arg(QCoreApplication::translate("MainWindow", "Protected mode"))
-                .arg(tr("Avoid close window accidentally. (eg. by double clicking the window)")),
-        QStringLiteral("</ul>")
-    };
-
-    const QStringList aboutStr {
-        QStringLiteral("<center><img width='128' height='128' src=':/icons/app-icon.svg'/><br/>"),
-        qApp->applicationDisplayName(),
-#ifdef GIT_DESCRIBE_VERSION_STRING
-        (QStringLiteral("<br/>") + tr("Version: %1").arg(GIT_DESCRIBE_VERSION_STRING)),
-#endif // GIT_DESCRIBE_VERSION_STRING
-        QStringLiteral("<hr/>"),
-        tr("Copyright (c) %1 %2", "%1 is year, %2 is the name of copyright holder(s)")
-            .arg(QStringLiteral("2022"), QStringLiteral("<a href='https://github.com/BLumia'>@BLumia</a>")),
-        QStringLiteral("<br/>"),
-        tr("Logo designed by %1").arg(QStringLiteral("<a href='https://github.com/Lovelyblack'>@Lovelyblack</a>")),
-        QStringLiteral("<hr/>"),
-        tr("Built with Qt %1 (%2)").arg(QT_VERSION_STR, QSysInfo::buildCpuArchitecture()),
-        QStringLiteral("<br/><a href='%1'>%2</a>").arg("https://github.com/BLumia/pineapple-pictures", tr("Source code")),
-        QStringLiteral("</center>")
-    };
-
-    QFile translaterHtml(":/plain/translators.html");
-    bool canOpenFile = translaterHtml.open(QIODevice::ReadOnly);
-    const QByteArray & translatorList = canOpenFile ? translaterHtml.readAll() : "";
-
-    const QStringList specialThanksStr {
-        QStringLiteral("<h1 align='center'>%1</h1><a href='%2'>%3</a><p>%4</p>").arg(
-            tr("Contributors"),
-            QStringLiteral("https://github.com/BLumia/pineapple-pictures/graphs/contributors"),
-            tr("List of contributors on GitHub"),
-            tr("Thanks to all people who contributed to this project.")
-        ),
-
-        QStringLiteral("<h1 align='center'>%1</h1><p>%2</p>%3").arg(
-            tr("Translators"),
-            tr("I would like to thank the following people who volunteered to translate this application."),
-            translatorList
-        )
-    };
-
-    const QStringList licenseStr {
-        QStringLiteral("<h1 align='center'><b>%1</b></h1>").arg(tr("Your Rights")),
-        QStringLiteral("<p>%1</p><p>%2</p><ul><li>%3</li><li>%4</li><li>%5</li><li>%6</li></ul>").arg(
-            tr("%1 is released under the MIT License."), // %1
-            tr("This license grants people a number of freedoms:"), // %2
-            tr("You are free to use %1, for any purpose"), // %3
-            tr("You are free to distribute %1"), // %4
-            tr("You can study how %1 works and change it"), // %5
-            tr("You can distribute changed versions of %1") // %6
-        ).arg(QStringLiteral("<i>%1</i>")),
-        QStringLiteral("<p>%1</p>").arg(tr("The MIT license guarantees you this freedom. Nobody is ever permitted to take it away.")),
-        QStringLiteral("<hr/><pre>%2</pre>")
-    };
-
-    const QString mitLicense(QStringLiteral(R"(Expat/MIT License
-
-Copyright (c) 2020 BLumia
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
-)"));
-
-    const QStringList thirdPartyLibsStr {
-        QStringLiteral("<h1 align='center'><b>%1</b></h1>").arg(tr("Third-party Libraries used by %1")),
-        tr("%1 is built on the following free software libraries:", "Free as in freedom"),
-        QStringLiteral("<ul>"),
-#ifdef HAVE_EXIV2_VERSION
-        QStringLiteral("<li><a href='%1'>%2</a>: %3</li>").arg("https://www.exiv2.org/", "Exiv2", "GPLv2"),
-#endif // EXIV2_VERSION
-        QStringLiteral("<li><a href='%1'>%2</a>: %3</li>").arg("https://www.qt.io/", "Qt", "GPLv2 + GPLv3 + LGPLv2.1 + LGPLv3"),
-        QStringLiteral("</ul>")
-    };
-
-    m_helpTextEdit->setText(helpStr.join('\n'));
-
-    m_aboutTextEdit->setText(aboutStr.join('\n'));
-    m_aboutTextEdit->setOpenExternalLinks(true);
-
-    m_specialThanksTextEdit->setText(specialThanksStr.join('\n'));
-    m_specialThanksTextEdit->setOpenExternalLinks(true);
-
-    m_licenseTextEdit->setText(licenseStr.join('\n').arg(qApp->applicationDisplayName(), mitLicense));
-
-    m_3rdPartyLibsTextEdit->setText(thirdPartyLibsStr.join('\n').arg(QStringLiteral("<i>%1</i>").arg(qApp->applicationDisplayName())));
-    m_3rdPartyLibsTextEdit->setOpenExternalLinks(true);
-
-    m_tabWidget->addTab(m_helpTextEdit, tr("&Help"));
-    m_tabWidget->addTab(m_aboutTextEdit, tr("&About"));
-    m_tabWidget->addTab(m_specialThanksTextEdit, tr("&Special Thanks"));
-    m_tabWidget->addTab(m_licenseTextEdit, tr("&License"));
-    m_tabWidget->addTab(m_3rdPartyLibsTextEdit, tr("&Third-party Libraries"));
-
-    m_buttonBox->setStandardButtons(QDialogButtonBox::Close);
-    connect(m_buttonBox, QOverload<QAbstractButton *>::of(&QDialogButtonBox::clicked), this, [this](){
-        this->close();
-    });
-
-    setLayout(new QVBoxLayout);
-
-    layout()->addWidget(m_tabWidget);
-    layout()->addWidget(m_buttonBox);
-
-    setMinimumSize(361, 161); // not sure why it complain "Unable to set geometry"
-    setWindowFlag(Qt::WindowContextHelpButtonHint, false);
-}
-
-AboutDialog::~AboutDialog()
-{
-
-}
-
-QSize AboutDialog::sizeHint() const
-{
-    return QSize(520, 350);
-}
+// SPDX-FileCopyrightText: 2025 Gary Wang <git@blumia.net>
+//
+// SPDX-License-Identifier: MIT
+
+#include "aboutdialog.h"
+#include "ui_aboutdialog.h"
+
+#include <QApplication>
+#include <QFile>
+
+using namespace Qt::Literals::StringLiterals;
+
+static QString loadEmbeddedHtml(QString&& path) {
+    QFile htmlFile(path);
+    bool canOpenFile = htmlFile.open(QIODevice::ReadOnly);
+    QByteArray htmlRawContent = canOpenFile ? htmlFile.readAll() : QByteArrayLiteral("");
+    return QString::fromUtf8(htmlRawContent);
+}
+
+AboutDialog::AboutDialog(QWidget *parent)
+    : QDialog(parent), ui(new QT_PREPEND_NAMESPACE(Ui::AboutDialog))
+{
+    ui->setupUi(this);
+    setWindowFlag(Qt::WindowContextHelpButtonHint, false);
+
+    // blumia: Chain two arg() here since it seems lupdate will remove one of them if we use
+    //         the old `arg(QCoreApp::translate(), tr())` way, but it's worth to mention
+    //         `arg(QCoreApp::translate(), this->tr())` works, but lupdate will complain about the usage.
+    const QString HELP_HTML = loadEmbeddedHtml(u":/htmls/help.html"_s)
+        .arg(tr("General Help"))
+        .arg(tr("Launch application with image file path as argument to load the file."))
+        .arg(tr("Passing in a single image file will load all the images in that directory and start viewing from that image."))
+        .arg(tr("Passing in multiple image files lets you view them one by one."))
+        .arg(tr("Drag and drop image file onto the window is also supported."))
+        .arg(tr("None of the operations in this application will alter the pictures on disk."))
+        .arg(tr("Context Menu Help"))
+        .arg(tr("Keep transformation", "The same meaning of MainWindow's Keep transformation."))
+        .arg(tr("Avoid resetting the zoom/rotation/flip state that was applied to the image view when switching between images."))
+        .arg(tr("Checkerboard", "The same meaning of MainWindow's Checkerboard."))
+        .arg(tr("Checkerboard light and dark theme can be adjusted in the configuration window, or easily switch it by holding Shift and clicking the button."));
+
+    const QString APP_NAME_ARG = qApp->applicationDisplayName();
+    const QString APP_VERSION_ARG =
+#ifdef GIT_DESCRIBE_VERSION_STRING
+        GIT_DESCRIBE_VERSION_STRING;
+#else
+        qApp->applicationVersion();
+#endif // GIT_DESCRIBE_VERSION_STRING
+    const QString QT_VERSION_ARG = QT_VERSION_STR;
+    const QString QT_ARCH_ARG = QSysInfo::buildCpuArchitecture();
+    const QString ABOUT_HTML = loadEmbeddedHtml(u":/htmls/about.html"_s)
+        .arg(APP_NAME_ARG)
+        .arg(tr("Version: %1").arg(APP_VERSION_ARG))
+        .arg(tr("Upstream author"))
+        .arg(tr("Hard fork author"))
+        .arg(tr("Logo designer"))
+        .arg(tr("Built with Qt %1 (%2)").arg(QT_VERSION_ARG).arg(QT_ARCH_ARG))
+        .arg(tr("Source code"));
+
+    const QString SPECIAL_THANKS_HTML = loadEmbeddedHtml(u":/htmls/special-thanks.html"_s)
+        .arg(tr("Contributors"))
+        .arg(tr("List of contributors on GitHub"))
+        .arg(tr("Thanks to all people who contributed to this project."))
+        .arg(tr("Translators"))
+        .arg(tr("I would like to thank the following people who volunteered to translate this application."));
+
+    const QString LICENSE_HTML = loadEmbeddedHtml(u":/htmls/license.html"_s)
+        .arg(tr("License"))
+        .arg(tr("This application is released under the MIT License."))
+        .arg(tr("License Verbatim Copy"));
+
+    const QString THIRD_PARTY_LIBS_HTML = loadEmbeddedHtml(u":/htmls/third-party-libs.html"_s)
+        .arg(tr("Third-party Libraries"))
+        .arg(tr("This application is built on the following free software libraries.", "Free as in freedom"))
+        .arg(tr("Some of them are optional and might not be included with this distribution depending on the build environment."));
+
+    ui->m_helpTextEdit->setHtml(HELP_HTML);
+    ui->m_aboutTextEdit->setHtml(ABOUT_HTML);
+    ui->m_specialThanksTextEdit->setHtml(SPECIAL_THANKS_HTML);
+    ui->m_licenseTextEdit->setHtml(LICENSE_HTML);
+    ui->m_3rdPartyLibsTextEdit->setHtml(THIRD_PARTY_LIBS_HTML);
+
+    connect(ui->m_buttonBox, QOverload<QAbstractButton *>::of(&QDialogButtonBox::clicked), this, [this](QAbstractButton * btn){
+        Q_UNUSED(btn)
+        this->close();
+    });
+
+    setMinimumSize(361, 161); // not sure why it complain "Unable to set geometry"
+}
+
+AboutDialog::~AboutDialog()
+{
+    delete ui;
+}
+
+QSize AboutDialog::sizeHint() const
+{
+    return QSize(520, 350);
+}

app/aboutdialog.h

@@ -1,36 +1,29 @@
-// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
-//
-// SPDX-License-Identifier: MIT
-
-#ifndef ABOUTDIALOG_H
-#define ABOUTDIALOG_H
-
-#include <QDialog>
-
-QT_BEGIN_NAMESPACE
-class QTextBrowser;
-class QTabWidget;
-class QDialogButtonBox;
-QT_END_NAMESPACE
-
-class AboutDialog : public QDialog
-{
-    Q_OBJECT
-public:
-    explicit AboutDialog(QWidget *parent = nullptr);
-    ~AboutDialog() override;
-
-    QSize sizeHint() const override;
-
-private:
-    QTabWidget * m_tabWidget = nullptr;
-    QDialogButtonBox * m_buttonBox = nullptr;
-
-    QTextBrowser * m_helpTextEdit = nullptr;
-    QTextBrowser * m_aboutTextEdit = nullptr;
-    QTextBrowser * m_specialThanksTextEdit = nullptr;
-    QTextBrowser * m_licenseTextEdit = nullptr;
-    QTextBrowser * m_3rdPartyLibsTextEdit = nullptr;
-};
-
-#endif // ABOUTDIALOG_H
+// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
+//
+// SPDX-License-Identifier: MIT
+
+#ifndef ABOUTDIALOG_H
+#define ABOUTDIALOG_H
+
+#include <QDialog>
+
+QT_BEGIN_NAMESPACE
+namespace Ui {
+class AboutDialog;
+}
+QT_END_NAMESPACE
+
+class AboutDialog : public QDialog
+{
+    Q_OBJECT
+public:
+    explicit AboutDialog(QWidget *parent = nullptr);
+    ~AboutDialog() override;
+
+    QSize sizeHint() const override;
+
+private:
+    QT_PREPEND_NAMESPACE(Ui::AboutDialog) *ui;
+};
+
+#endif // ABOUTDIALOG_H

app/aboutdialog.ui

@@ -0,0 +1,106 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<ui version="4.0">
+ <class>AboutDialog</class>
+ <widget class="QDialog" name="AboutDialog">
+  <property name="windowModality">
+   <enum>Qt::NonModal</enum>
+  </property>
+  <property name="windowTitle">
+   <string>About</string>
+  </property>
+  <property name="minimumSize">
+   <size>
+    <width>361</width>
+    <height>161</height>
+   </size>
+  </property>
+  <layout class="QVBoxLayout" name="verticalLayout">
+   <item>
+    <widget class="QTabWidget" name="m_tabWidget">
+     <property name="currentIndex">
+      <number>0</number>
+     </property>
+     <widget class="QWidget" name="helpTab">
+      <attribute name="title">
+       <string>&amp;Help</string>
+      </attribute>
+      <layout class="QVBoxLayout" name="helpTabLayout">
+       <item>
+         <widget class="QTextBrowser" name="m_helpTextEdit">
+          <property name="openExternalLinks">
+           <bool>false</bool>
+          </property>
+         </widget>
+       </item>
+      </layout>
+     </widget>
+     <widget class="QWidget" name="aboutTab">
+      <attribute name="title">
+       <string>&amp;About</string>
+      </attribute>
+      <layout class="QVBoxLayout" name="aboutTabLayout">
+       <item>
+         <widget class="QTextBrowser" name="m_aboutTextEdit">
+          <property name="openExternalLinks">
+           <bool>true</bool>
+          </property>
+         </widget>
+       </item>
+      </layout>
+     </widget>
+     <widget class="QWidget" name="specialThanksTab">
+      <attribute name="title">
+       <string>&amp;Special Thanks</string>
+      </attribute>
+      <layout class="QVBoxLayout" name="specialThanksTabLayout">
+       <item>
+         <widget class="QTextBrowser" name="m_specialThanksTextEdit">
+          <property name="openExternalLinks">
+           <bool>true</bool>
+          </property>
+         </widget>
+       </item>
+      </layout>
+     </widget>
+     <widget class="QWidget" name="licenseTab">
+      <attribute name="title">
+       <string>&amp;License</string>
+      </attribute>
+      <layout class="QVBoxLayout" name="licenseTabLayout">
+       <item>
+         <widget class="QTextBrowser" name="m_licenseTextEdit">
+          <property name="openExternalLinks">
+           <bool>false</bool>
+          </property>
+         </widget>
+       </item>
+      </layout>
+     </widget>
+     <widget class="QWidget" name="thirdPartyLibsTab">
+      <attribute name="title">
+       <string>&amp;Third-party Libraries</string>
+      </attribute>
+      <layout class="QVBoxLayout" name="thirdPartyLibsTabLayout">
+       <item>
+         <widget class="QTextBrowser" name="m_3rdPartyLibsTextEdit">
+          <property name="openExternalLinks">
+           <bool>true</bool>
+          </property>
+         </widget>
+       </item>
+      </layout>
+     </widget>
+    </widget>
+   </item>
+   <item>
+    <widget class="QDialogButtonBox" name="m_buttonBox">
+     <property name="standardButtons">
+      <set>QDialogButtonBox::Close</set>
+     </property>
+    </widget>
+   </item>
+  </layout>
+ </widget>
+ <resources/>
+ <connections/>
+</ui>

app/actionmanager.cpp

@@ -1,148 +1,208 @@
-// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
-//
-// SPDX-License-Identifier: MIT
-
-#include "actionmanager.h"
-
-#include "mainwindow.h"
-
-#include <QGuiApplication>
-#include <QSvgRenderer>
-#include <QPainter>
-
-#define ICON_NAME(name)\
-    QStringLiteral(":/icons/" #name ".svg")
-
-#define ACTION_NAME(s) QStringLiteral(STRIFY(s))
-#define STRIFY(s) #s
-
-ActionManager::ActionManager()
-{
-
-}
-
-ActionManager::~ActionManager()
-{
-
-}
-
-QIcon ActionManager::loadHidpiIcon(const QString &resp, QSize sz)
-{
-    QSvgRenderer r(resp);
-    QPixmap pm = QPixmap(sz * qApp->devicePixelRatio());
-    pm.fill(Qt::transparent);
-    QPainter p(&pm);
-    r.render(&p);
-    pm.setDevicePixelRatio(qApp->devicePixelRatio());
-    return QIcon(pm);
-}
-
-void ActionManager::setupAction(MainWindow *mainWindow)
-{
-    auto create_action = [] (QWidget *w, QAction **a, QString i, QString an) {
-        *a = new QAction(w);
-        if (!i.isNull())
-            (*a)->setIcon(ActionManager::loadHidpiIcon(i));
-        (*a)->setObjectName(an);
-        w->addAction(*a);
-    };
-    #define CREATE_NEW_ICON_ACTION(w, a, i) create_action(w, &a, ICON_NAME(i), ACTION_NAME(a))
-    CREATE_NEW_ICON_ACTION(mainWindow, actionActualSize, zoom-original);
-    CREATE_NEW_ICON_ACTION(mainWindow, actionToggleMaximize, view-fullscreen);
-    CREATE_NEW_ICON_ACTION(mainWindow, actionZoomIn, zoom-in);
-    CREATE_NEW_ICON_ACTION(mainWindow, actionZoomOut, zoom-out);
-    CREATE_NEW_ICON_ACTION(mainWindow, actionToggleCheckerboard, view-background-checkerboard);
-    CREATE_NEW_ICON_ACTION(mainWindow, actionRotateClockwise, object-rotate-right);
-    #undef CREATE_NEW_ICON_ACTION
-
-    #define CREATE_NEW_ACTION(w, a) create_action(w, &a, QString(), ACTION_NAME(a))
-    CREATE_NEW_ACTION(mainWindow, actionPrevPicture);
-    CREATE_NEW_ACTION(mainWindow, actionNextPicture);
-
-    CREATE_NEW_ACTION(mainWindow, actionOpen);
-    CREATE_NEW_ACTION(mainWindow, actionHorizontalFlip);
-    CREATE_NEW_ACTION(mainWindow, actionFitInView);
-    CREATE_NEW_ACTION(mainWindow, actionFitByWidth);
-    CREATE_NEW_ACTION(mainWindow, actionCopyPixmap);
-    CREATE_NEW_ACTION(mainWindow, actionCopyFilePath);
-    CREATE_NEW_ACTION(mainWindow, actionPaste);
-    CREATE_NEW_ACTION(mainWindow, actionToggleStayOnTop);
-    CREATE_NEW_ACTION(mainWindow, actionToggleProtectMode);
-    CREATE_NEW_ACTION(mainWindow, actionSettings);
-    CREATE_NEW_ACTION(mainWindow, actionHelp);
-    CREATE_NEW_ACTION(mainWindow, actionLocateInFileManager);
-    CREATE_NEW_ACTION(mainWindow, actionProperties);
-    CREATE_NEW_ACTION(mainWindow, actionQuitApp);
-    #undef CREATE_NEW_ACTION
-
-    retranslateUi(mainWindow);
-
-    QMetaObject::connectSlotsByName(mainWindow);
-}
-
-void ActionManager::retranslateUi(MainWindow *mainWindow)
-{
-    Q_UNUSED(mainWindow);
-
-    actionOpen->setText(QCoreApplication::translate("MainWindow", "&Open...", nullptr));
-
-    actionActualSize->setText(QCoreApplication::translate("MainWindow", "Actual size", nullptr));
-    actionToggleMaximize->setText(QCoreApplication::translate("MainWindow", "Toggle maximize", nullptr));
-    actionZoomIn->setText(QCoreApplication::translate("MainWindow", "Zoom in", nullptr));
-    actionZoomOut->setText(QCoreApplication::translate("MainWindow", "Zoom out", nullptr));
-    actionToggleCheckerboard->setText(QCoreApplication::translate("MainWindow", "Toggle Checkerboard", nullptr));
-    actionRotateClockwise->setText(QCoreApplication::translate("MainWindow", "Rotate right", nullptr));
-
-    actionPrevPicture->setText(QCoreApplication::translate("MainWindow", "Previous image", nullptr));
-    actionNextPicture->setText(QCoreApplication::translate("MainWindow", "Next image", nullptr));
-
-    actionHorizontalFlip->setText(QCoreApplication::translate("MainWindow", "Flip &Horizontally", nullptr));
-    actionFitInView->setText("Fit in view"); // TODO: what should it called?
-    actionFitByWidth->setText("Fit by width"); // TODO: what should it called?
-    actionCopyPixmap->setText(QCoreApplication::translate("MainWindow", "Copy P&ixmap", nullptr));
-    actionCopyFilePath->setText(QCoreApplication::translate("MainWindow", "Copy &File Path", nullptr));
-    actionPaste->setText(QCoreApplication::translate("MainWindow", "&Paste", nullptr));
-    actionToggleStayOnTop->setText(QCoreApplication::translate("MainWindow", "Stay on top", nullptr));
-    actionToggleProtectMode->setText(QCoreApplication::translate("MainWindow", "Protected mode", nullptr));
-    actionSettings->setText(QCoreApplication::translate("MainWindow", "Configure...", nullptr));
-    actionHelp->setText(QCoreApplication::translate("MainWindow", "Help", nullptr));
-#ifdef Q_OS_WIN
-    actionLocateInFileManager->setText(
-        QCoreApplication::translate(
-            "MainWindow", "Show in File Explorer",
-            "File Explorer is the name of explorer.exe under Windows"
-        )
-    );
-#else
-    actionLocateInFileManager->setText(QCoreApplication::translate("MainWindow", "Show in directory", nullptr));
-#endif // Q_OS_WIN
-    actionProperties->setText(QCoreApplication::translate("MainWindow", "Properties", nullptr));
-    actionQuitApp->setText(QCoreApplication::translate("MainWindow", "Quit", nullptr));
-}
-
-void ActionManager::setupShortcuts()
-{
-    actionOpen->setShortcut(QKeySequence(Qt::CTRL | Qt::Key_O));
-    actionActualSize->setShortcut(QKeySequence(Qt::CTRL | Qt::Key_0));
-    actionZoomIn->setShortcut(QKeySequence(QKeySequence::ZoomIn));
-    actionZoomOut->setShortcut(QKeySequence(QKeySequence::ZoomOut));
-    actionPrevPicture->setShortcuts({
-        QKeySequence(Qt::Key_PageUp),
-        QKeySequence(Qt::Key_Left),
-    });
-    actionNextPicture->setShortcuts({
-        QKeySequence(Qt::Key_PageDown),
-        QKeySequence(Qt::Key_Right),
-    });
-    actionHorizontalFlip->setShortcut(QKeySequence(Qt::CTRL | Qt::Key_R));
-    actionCopyPixmap->setShortcut(QKeySequence(QKeySequence::Copy));
-    actionPaste->setShortcut(QKeySequence::Paste);
-    actionHelp->setShortcut(QKeySequence::HelpContents);
-    actionSettings->setShortcut(QKeySequence::Preferences);
-    actionProperties->setShortcut(QKeySequence(Qt::CTRL | Qt::Key_I));
-    actionQuitApp->setShortcuts({
-        QKeySequence(Qt::Key_Space),
-        QKeySequence(Qt::Key_Escape)
-    });
-}
-
+// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
+//
+// SPDX-License-Identifier: MIT
+
+#include "actionmanager.h"
+
+#include "settings.h"
+#include "mainwindow.h"
+#include "playlistmanager.h"
+#include "graphicsview.h"
+#include "graphicsscene.h"
+
+#include <QGuiApplication>
+#include <QSvgRenderer>
+#include <QPainter>
+
+static QIcon loadHidpiIcon(const QString &resp, QSize sz = QSize(32, 32))
+{
+    QPixmap pm = QPixmap(resp);
+    pm.scaled(sz * qApp->devicePixelRatio(), Qt::KeepAspectRatio);
+    pm.setDevicePixelRatio(qApp->devicePixelRatio());
+    return QIcon(pm);
+}
+
+void ActionManager::setupAction(MainWindow *mainWindow)
+{
+    // region: Action and Its Icon Creation
+
+    // Declare some convenient macros and lambdas.
+
+    #define ICON_NAME(name)\
+        QStringLiteral(":/icons/" #name ".png")
+
+    #define ACTION_NAME(s) QStringLiteral(STRIFY(s))
+    #define STRIFY(s) #s
+
+    auto create_action = [] (QWidget *w, QAction **a, QString i, QString an, bool iconFromTheme = false) {
+        *a = new QAction(w);
+        if (!i.isNull())
+            (*a)->setIcon(iconFromTheme ? QIcon::fromTheme(i) : loadHidpiIcon(i));
+        (*a)->setObjectName(an);
+        w->addAction(*a);
+    };
+
+    /// This macro for register normal action.
+    #define CREATE_NEW_ACTION(w, a) create_action(w, &a, QString(), ACTION_NAME(a))
+    /// This macro for register Qt theme action.
+    #define CREATE_NEW_THEMEICON_ACTION(w, a, i) create_action(w, &a, QLatin1String(STRIFY(i)), ACTION_NAME(a), true)
+    /// This macro for register action with our custom icon.
+    #define CREATE_NEW_ICON_ACTION(w, a, i) create_action(w, &a, ICON_NAME(i), ACTION_NAME(a), false)
+
+    CREATE_NEW_ACTION(mainWindow, actionCopyPixmap);
+    CREATE_NEW_ACTION(mainWindow, actionCopyFilePath);
+
+    CREATE_NEW_ICON_ACTION(mainWindow, actionPrevPicture, go-previous);
+    CREATE_NEW_ICON_ACTION(mainWindow, actionNextPicture, go-next);
+
+    CREATE_NEW_ICON_ACTION(mainWindow, actionActualSize, fit-to-size);
+    CREATE_NEW_ICON_ACTION(mainWindow, actionFitToScreen, fit-to-screen);
+    CREATE_NEW_ACTION(mainWindow, actionFitByWidth);
+    CREATE_NEW_ACTION(mainWindow, actionFitByHeight);
+    CREATE_NEW_ICON_ACTION(mainWindow, actionZoomIn, zoom-in);
+    CREATE_NEW_ICON_ACTION(mainWindow, actionZoomOut, zoom-out);
+
+    CREATE_NEW_ICON_ACTION(mainWindow, actionFlipHorizontal, flip-horizontal);
+    CREATE_NEW_ICON_ACTION(mainWindow, actionFlipVertical, flip-vertical);
+    CREATE_NEW_ICON_ACTION(mainWindow, actionRotateClockwise, rotate-right);
+    CREATE_NEW_ICON_ACTION(mainWindow, actionRotateCounterClockwise, rotate-left);
+
+    CREATE_NEW_ACTION(mainWindow, actionToggleAvoidResetTransform);
+    CREATE_NEW_ACTION(mainWindow, actionToggleCheckerboard);
+    CREATE_NEW_ACTION(mainWindow, actionTogglePauseAnimation);
+    CREATE_NEW_ACTION(mainWindow, actionAnimationNextFrame);
+
+    CREATE_NEW_ACTION(mainWindow, actionTrash/*, edit-delete*/);
+    CREATE_NEW_ACTION(mainWindow, actionLocateInFileManager/*, system-file-manager*/);
+    CREATE_NEW_ICON_ACTION(mainWindow, actionProperties, image-info);
+
+    CREATE_NEW_ACTION(mainWindow, actionSettings);
+    CREATE_NEW_ACTION(mainWindow, actionHelp/*, system-help*/);
+
+    // Remove convenient macros
+
+    #undef CREATE_NEW_ICON_ACTION
+    #undef CREATE_NEW_THEMEICON_ACTION
+    #undef CREATE_NEW_ACTION
+
+    #undef STRIFY
+    #undef ACTION_NAME
+    #undef ICON_NAME
+
+    // endregion
+
+    // region: Setup Checkable Action
+
+    actionToggleAvoidResetTransform->setCheckable(true);
+    actionToggleCheckerboard->setCheckable(true);
+    actionTogglePauseAnimation->setCheckable(true);
+
+    // endregion
+
+    // region: Action Translatable Text Setup
+
+    actionCopyPixmap->setText(QCoreApplication::translate("MainWindow", "Copy P&ixmap", nullptr));
+    actionCopyFilePath->setText(QCoreApplication::translate("MainWindow", "Copy &File Path", nullptr));
+
+    actionPrevPicture->setText(QCoreApplication::translate("MainWindow", "Previous image", nullptr));
+    actionNextPicture->setText(QCoreApplication::translate("MainWindow", "Next image", nullptr));
+
+    actionActualSize->setText(QCoreApplication::translate("MainWindow", "Actual size", nullptr));
+    actionFitToScreen->setText(QCoreApplication::translate("MainWindow", "Fit to screen", nullptr));
+    actionFitByWidth->setText(QCoreApplication::translate("MainWindow", "Fit by width", nullptr));
+    actionFitByHeight->setText(QCoreApplication::translate("MainWindow", "Fit by height", nullptr));
+    actionZoomIn->setText(QCoreApplication::translate("MainWindow", "Zoom in", nullptr));
+    actionZoomOut->setText(QCoreApplication::translate("MainWindow", "Zoom out", nullptr));
+
+    actionFlipHorizontal->setText(QCoreApplication::translate("MainWindow", "Flip &Horizontally", nullptr));
+    actionFlipVertical->setText(QCoreApplication::translate("MainWindow", "Flip &Vertically", nullptr));
+    actionRotateClockwise->setText(QCoreApplication::translate("MainWindow", "Rotate right", nullptr));
+    actionRotateCounterClockwise->setText(QCoreApplication::translate("MainWindow", "Rotate left", nullptr));
+
+    actionToggleAvoidResetTransform->setText(QCoreApplication::translate("MainWindow", "Keep transformation", "The 'transformation' means the flip/rotation status that currently applied to the image view"));
+    actionToggleCheckerboard->setText(QCoreApplication::translate("MainWindow", "Toggle Checkerboard", nullptr));
+    actionTogglePauseAnimation->setText(QCoreApplication::translate("MainWindow", "Pause/Resume Animation", nullptr));
+    actionAnimationNextFrame->setText(QCoreApplication::translate("MainWindow", "Animation Go to Next Frame", nullptr));
+
+    actionTrash->setText(QCoreApplication::translate("MainWindow", "Move to Trash", nullptr));
+#ifdef Q_OS_WIN
+    actionLocateInFileManager->setText(
+        QCoreApplication::translate(
+            "MainWindow", "Show in File Explorer",
+            "File Explorer is the name of explorer.exe under Windows"
+            )
+        );
+#else
+    actionLocateInFileManager->setText(QCoreApplication::translate("MainWindow", "Show in directory", nullptr));
+#endif // Q_OS_WIN
+    actionProperties->setText(QCoreApplication::translate("MainWindow", "Properties", nullptr));
+
+    actionSettings->setText(QCoreApplication::translate("MainWindow", "Configure...", nullptr));
+    actionHelp->setText(QCoreApplication::translate("MainWindow", "Help", nullptr));
+    // endregion
+
+    QMetaObject::connectSlotsByName(mainWindow);
+}
+
+void ActionManager::setupShortcuts()
+{
+    actionCopyPixmap->setShortcut(QKeySequence::Copy);
+
+    actionPrevPicture->setShortcuts({
+        QKeySequence(Qt::Key_Left),
+        QKeySequence(Qt::Key_PageUp),
+    });
+    actionNextPicture->setShortcuts({
+        QKeySequence(Qt::Key_Right),
+        QKeySequence(Qt::Key_PageDown),
+    });
+
+    actionActualSize->setShortcut(QKeySequence(Qt::CTRL | Qt::Key_0));
+    actionZoomIn->setShortcut(QKeySequence::ZoomIn);
+    actionZoomOut->setShortcut(QKeySequence::ZoomOut);
+
+    actionTrash->setShortcut(QKeySequence::Delete);
+    actionProperties->setShortcut(QKeySequence(Qt::CTRL | Qt::Key_I));
+
+    actionSettings->setShortcut(QKeySequence::Preferences);
+    actionHelp->setShortcut(QKeySequence::HelpContents);
+}
+
+void ActionManager::updateActionState(PlaylistManager* pm, GraphicsView* gv)
+{
+    const auto* gs = gv->scene();
+    const auto* settings = Settings::instance();
+
+    // Update copy actions
+    bool canCopy = pm->currentIndex().has_value();
+    actionCopyPixmap->setEnabled(canCopy);
+    actionCopyFilePath->setEnabled(canCopy);
+
+    // Update Prev/Next Picture State
+    const int galleryFileCount = pm->totalCount();
+    const bool loopGallery = settings->loopGallery();
+    actionPrevPicture->setEnabled(galleryFileCount > 1 && (loopGallery || !pm->isFirstIndex()));
+    actionNextPicture->setEnabled(galleryFileCount > 1 && (loopGallery || !pm->isLastIndex()));
+
+    // Update Avoid Reset Transform
+    actionToggleAvoidResetTransform->setChecked(gv->isAvoidResetTransform());
+    // Update Checkerboard
+    actionToggleCheckerboard->setChecked(gv->isCheckerboard());
+    // Update Animation Graphics Action
+    bool canPauseAnimation = gs->canPauseAnimation();
+    actionTogglePauseAnimation->setEnabled(canPauseAnimation);
+    if (canPauseAnimation) {
+        actionTogglePauseAnimation->setChecked(gs->isPauseAnimation());
+    } else {
+        actionTogglePauseAnimation->setChecked(false);
+    }
+    bool canSkipAnimation = gs->canSkipAnimationFrame();
+    actionAnimationNextFrame->setEnabled(canSkipAnimation);
+
+    // Update trash, located in explorer and properties.
+    bool hasLoadedFile = pm->currentIndex().has_value();
+    actionTrash->setEnabled(hasLoadedFile);
+    actionLocateInFileManager->setEnabled(hasLoadedFile);
+    actionProperties->setEnabled(hasLoadedFile);
+}
+

app/actionmanager.h

@@ -1,52 +1,60 @@
-// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
-//
-// SPDX-License-Identifier: MIT
-
-#ifndef ACTIONMANAGER_H
-#define ACTIONMANAGER_H
-
-#include <QAction>
-
-class MainWindow;
-
-class ActionManager
-{
-public:
-    ActionManager();
-    ~ActionManager();
-
-    void setupAction(MainWindow * mainWindow);
-    void retranslateUi(MainWindow *MainWindow);
-    void setupShortcuts();
-
-    static QIcon loadHidpiIcon(const QString &resp, QSize sz = QSize(32, 32));
-
-public:
-    QAction *actionOpen;
-
-    QAction *actionActualSize;
-    QAction *actionToggleMaximize;
-    QAction *actionZoomIn;
-    QAction *actionZoomOut;
-    QAction *actionToggleCheckerboard;
-    QAction *actionRotateClockwise;
-
-    QAction *actionPrevPicture;
-    QAction *actionNextPicture;
-
-    QAction *actionHorizontalFlip;
-    QAction *actionFitInView;
-    QAction *actionFitByWidth;
-    QAction *actionCopyPixmap;
-    QAction *actionCopyFilePath;
-    QAction *actionPaste;
-    QAction *actionToggleStayOnTop;
-    QAction *actionToggleProtectMode;
-    QAction *actionSettings;
-    QAction *actionHelp;
-    QAction *actionLocateInFileManager;
-    QAction *actionProperties;
-    QAction *actionQuitApp;
-};
-
-#endif // ACTIONMANAGER_H
+// SPDX-FileCopyrightText: 2025 Gary Wang <git@blumia.net>
+//
+// SPDX-License-Identifier: MIT
+
+#ifndef ACTIONMANAGER_H
+#define ACTIONMANAGER_H
+
+#include <QAction>
+
+class MainWindow;
+class PlaylistManager;
+class GraphicsView;
+
+/// Action Manager is separated from Main Window
+/// to manage all actions specifically.
+class ActionManager
+{
+public:
+    explicit ActionManager() = default;
+    ~ActionManager() = default;
+
+    void setupAction(MainWindow * mainWindow);
+    void setupShortcuts();
+
+public slots:
+    void updateActionState(PlaylistManager* pm, GraphicsView* gv);
+
+public:
+    QAction *actionCopyPixmap;
+    QAction *actionCopyFilePath;
+
+    QAction *actionPrevPicture;
+    QAction *actionNextPicture;
+
+    QAction *actionActualSize;
+    QAction *actionFitToScreen;
+    QAction *actionFitByWidth;
+    QAction *actionFitByHeight;
+    QAction *actionZoomIn;
+    QAction *actionZoomOut;
+
+    QAction *actionFlipHorizontal;
+    QAction *actionFlipVertical;
+    QAction *actionRotateClockwise;
+    QAction *actionRotateCounterClockwise;
+
+    QAction *actionToggleAvoidResetTransform;
+    QAction *actionToggleCheckerboard;
+    QAction *actionTogglePauseAnimation;
+    QAction *actionAnimationNextFrame;
+
+    QAction *actionTrash;
+    QAction *actionLocateInFileManager;
+    QAction *actionProperties;
+
+    QAction *actionSettings;
+    QAction *actionHelp;
+};
+
+#endif // ACTIONMANAGER_H

app/bottombuttongroup.cpp

@@ -1,59 +1,45 @@
-// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
-//
-// SPDX-License-Identifier: MIT
-
-#include "bottombuttongroup.h"
-
-#include "opacityhelper.h"
-
-#include <functional>
-
-#include <QToolButton>
-#include <QVBoxLayout>
-#include <QDebug>
-
-BottomButtonGroup::BottomButtonGroup(const std::vector<QAction *> &actionList, QWidget *parent)
-    : QGroupBox (parent)
-    , m_opacityHelper(new OpacityHelper(this))
-{
-    QHBoxLayout * mainLayout = new QHBoxLayout(this);
-    mainLayout->setSizeConstraint(QLayout::SetFixedSize);
-    this->setLayout(mainLayout);
-    this->setSizePolicy(QSizePolicy::Minimum, QSizePolicy::Minimum);
-    this->setStyleSheet("BottomButtonGroup {"
-                        "border: 1px solid gray;"
-                        "border-top-left-radius: 10px;"
-                        "border-top-right-radius: 10px;"
-                        "border-style: none;"
-                        "background-color:rgba(0,0,0,120)"
-                        "}"
-                        "QToolButton {"
-                        "background:transparent;"
-                        "}"
-                        "QToolButton:!focus {"
-                        "border-style: none;"
-                        "}");
-
-    auto newActionBtn = [this](QAction * action) -> QToolButton * {
-        QToolButton * btn = new QToolButton(this);
-        btn->setDefaultAction(action);
-        btn->setIconSize(QSize(32, 32));
-        btn->setFixedSize(40, 40);
-        return btn;
-    };
-
-    for (QAction * action : actionList) {
-        addButton(newActionBtn(action));
-    }
-}
-
-void BottomButtonGroup::setOpacity(qreal opacity, bool animated)
-{
-    m_opacityHelper->setOpacity(opacity, animated);
-}
-
-void BottomButtonGroup::addButton(QAbstractButton *button)
-{
-    layout()->addWidget(button);
-    updateGeometry();
-}
+// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
+//
+// SPDX-License-Identifier: MIT
+
+#include "bottombuttongroup.h"
+
+#include <QToolButton>
+#include <QVBoxLayout>
+#include <QDebug>
+
+BottomButtonGroup::BottomButtonGroup(QWidget *parent)
+    : QGroupBox (parent)
+{
+    QHBoxLayout * mainLayout = new QHBoxLayout(this);
+    mainLayout->setSizeConstraint(QLayout::SetFixedSize);
+    this->setLayout(mainLayout);
+    this->setSizePolicy(QSizePolicy::Minimum, QSizePolicy::Minimum);
+    this->setStyleSheet(R"#(
+BottomButtonGroup {
+    border-style: none;
+    background: transparent;
+}
+QToolButton {
+    background: transparent;
+    border-style: none;
+}
+)#");
+}
+
+void BottomButtonGroup::addActions(const std::vector<QAction *> & actionList) {
+    for (QAction * action : actionList) {
+        // Create button
+        QToolButton * btn = new QToolButton(this);
+        btn->setDefaultAction(action);
+        btn->setIconSize(QSize(32, 32));
+        btn->setFixedSize(40, 40);
+        // Add button
+        layout()->addWidget(btn);
+    }
+    updateGeometry();
+}
+
+void BottomButtonGroup::addAction(QAction* action) {
+    addActions({action});
+}

app/bottombuttongroup.h

@@ -1,27 +1,23 @@
-// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
-//
-// SPDX-License-Identifier: MIT
-
-#ifndef BOTTOMBUTTONGROUP_H
-#define BOTTOMBUTTONGROUP_H
-
-#include <vector>
-
-#include <QAbstractButton>
-#include <QGroupBox>
-
-class OpacityHelper;
-class BottomButtonGroup : public QGroupBox
-{
-    Q_OBJECT
-public:
-    explicit BottomButtonGroup(const std::vector<QAction *> & actionList, QWidget *parent = nullptr);
-
-    void setOpacity(qreal opacity, bool animated = true);
-    void addButton(QAbstractButton *button);
-
-private:
-    OpacityHelper * m_opacityHelper;
-};
-
-#endif // BOTTOMBUTTONGROUP_H
+// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
+//
+// SPDX-License-Identifier: MIT
+
+#ifndef BOTTOMBUTTONGROUP_H
+#define BOTTOMBUTTONGROUP_H
+
+#include <vector>
+
+#include <QAbstractButton>
+#include <QGroupBox>
+
+class BottomButtonGroup : public QGroupBox
+{
+    Q_OBJECT
+public:
+    explicit BottomButtonGroup(QWidget *parent = nullptr);
+
+    void addActions(const std::vector<QAction *> & actionList);
+    void addAction(QAction* action);
+};
+
+#endif // BOTTOMBUTTONGROUP_H

app/exiv2wrapper.cpp

@@ -1,126 +1,138 @@
-// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
-//
-// SPDX-License-Identifier: MIT
-
-#include "exiv2wrapper.h"
-
-#ifdef HAVE_EXIV2_VERSION
-#include <exiv2/exiv2.hpp>
-#else // HAVE_EXIV2_VERSION
-namespace Exiv2 {
-class Image {};
-}
-#endif // HAVE_EXIV2_VERSION
-
-#include <sstream>
-
-#include <QFile>
-#include <QDebug>
-
-Exiv2Wrapper::Exiv2Wrapper()
-{
-
-}
-
-Exiv2Wrapper::~Exiv2Wrapper()
-{
-
-}
-
-template<typename Collection, typename Iterator>
-void Exiv2Wrapper::cacheSection(Collection collection)
-{
-    const Collection& exifData = collection;
-    Iterator it = exifData.begin(), end = exifData.end();
-    for (; it != end; ++it) {
-        QString key = QString::fromUtf8(it->key().c_str());
-        if (it->tagName().substr(0, 2) == "0x") continue;
-        QString label = QString::fromLocal8Bit(it->tagLabel().c_str());
-        std::ostringstream stream;
-        stream << *it;
-        QString value = QString::fromUtf8(stream.str().c_str());
-        m_metadataValue.insert(key, value);
-        m_metadataLabel.insert(key, label);
-
-        qDebug() << key << label << value;
-    }
-}
-
-bool Exiv2Wrapper::load(const QString &filePath)
-{
-#ifdef HAVE_EXIV2_VERSION
-    QByteArray filePathByteArray = QFile::encodeName(filePath);
-    try {
-        m_exivImage.reset(Exiv2::ImageFactory::open(filePathByteArray.constData()).release());
-        m_exivImage->readMetadata();
-    } catch (const Exiv2::Error& error) {
-        m_errMsg = QString::fromUtf8(error.what());
-        return false;
-    }
-    return true;
-#else // HAVE_EXIV2_VERSION
-    Q_UNUSED(filePath);
-    return false;
-#endif // HAVE_EXIV2_VERSION
-}
-
-void Exiv2Wrapper::cacheSections()
-{
-#ifdef HAVE_EXIV2_VERSION
-    if (m_exivImage->checkMode(Exiv2::mdExif) & Exiv2::amRead) {
-        cacheSection<Exiv2::ExifData, Exiv2::ExifData::const_iterator>(m_exivImage->exifData());
-    }
-
-    if (m_exivImage->checkMode(Exiv2::mdIptc) & Exiv2::amRead) {
-        cacheSection<Exiv2::IptcData, Exiv2::IptcData::const_iterator>(m_exivImage->iptcData());
-    }
-
-    if (m_exivImage->checkMode(Exiv2::mdXmp) & Exiv2::amRead) {
-        cacheSection<Exiv2::XmpData, Exiv2::XmpData::const_iterator>(m_exivImage->xmpData());
-    }
-
-//    qDebug() << m_metadataValue;
-//    qDebug() << m_metadataLabel;
-#endif // HAVE_EXIV2_VERSION
-}
-
-QString Exiv2Wrapper::comment() const
-{
-#ifdef HAVE_EXIV2_VERSION
-    return m_exivImage->comment().c_str();
-#else // HAVE_EXIV2_VERSION
-    return QString();
-#endif // HAVE_EXIV2_VERSION
-}
-
-QString Exiv2Wrapper::label(const QString &key) const
-{
-    return m_metadataLabel.value(key);
-}
-
-QString Exiv2Wrapper::value(const QString &key) const
-{
-    return m_metadataValue.value(key);
-}
-
-QString Exiv2Wrapper::XmpValue(const QString &rawValue)
-{
-    QString ignored;
-    return Exiv2Wrapper::XmpValue(rawValue, ignored);
-}
-
-QString Exiv2Wrapper::XmpValue(const QString &rawValue, QString &language)
-{
-    if (rawValue.size() > 6 && rawValue.startsWith(QLatin1String("lang=\""))) {
-        int pos = rawValue.indexOf('"', 6);
-
-        if (pos != -1) {
-            language = rawValue.mid(6, pos - 6);
-            return (rawValue.mid(pos + 2));
-        }
-    }
-
-    language.clear();
-    return rawValue;
-}
-
+// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
+//
+// SPDX-License-Identifier: MIT
+
+#include "exiv2wrapper.h"
+
+#ifdef HAVE_EXIV2_VERSION
+#include <exiv2/exiv2.hpp>
+#else // HAVE_EXIV2_VERSION
+namespace Exiv2 {
+class Image {};
+}
+#endif // HAVE_EXIV2_VERSION
+
+#include <sstream>
+
+#include <QFile>
+#include <QDebug>
+
+Exiv2Wrapper::Exiv2Wrapper()
+{
+
+}
+
+Exiv2Wrapper::~Exiv2Wrapper()
+{
+
+}
+
+#ifdef HAVE_EXIV2_VERSION // stupid AppleClang...
+template<typename Collection, typename Iterator>
+void Exiv2Wrapper::cacheSection(Collection collection)
+{
+    const Collection& exifData = collection;
+    Iterator it = exifData.begin(), end = exifData.end();
+    for (; it != end; ++it) {
+        QString key = QString::fromUtf8(it->key().c_str());
+        if (it->tagName().substr(0, 2) == "0x") continue;
+        // We might get exceptions like "No namespace info available for XMP prefix `Item'"
+        // when trying to get tagLabel() data from a Xmpdatum if the tag is not common-used.
+        // We don't care for those rare tags so let's just use a try-cache...
+        try {
+            QString label = QString::fromLocal8Bit(it->tagLabel().c_str());
+            std::ostringstream stream;
+            stream << *it;
+            QString value = QString::fromUtf8(stream.str().c_str());
+            m_metadataValue.insert(key, value);
+            m_metadataLabel.insert(key, label);
+            qDebug() << key << label << value;
+#if EXIV2_TEST_VERSION(0, 28, 0)
+        } catch (Exiv2::Error & err) {
+#else // 0.27.x
+        } catch (Exiv2::AnyError & err) {
+#endif // EXIV2_TEST_VERSION(0, 28, 0)
+            qWarning() << "Error loading key" << key << ":" << err.what();
+        }
+    }
+}
+#endif // HAVE_EXIV2_VERSION
+
+bool Exiv2Wrapper::load(const QString &filePath)
+{
+#ifdef HAVE_EXIV2_VERSION
+    QByteArray filePathByteArray = QFile::encodeName(filePath);
+    try {
+        m_exivImage.reset(Exiv2::ImageFactory::open(filePathByteArray.constData()).release());
+        m_exivImage->readMetadata();
+    } catch (const Exiv2::Error& error) {
+        m_errMsg = QString::fromUtf8(error.what());
+        return false;
+    }
+    return true;
+#else // HAVE_EXIV2_VERSION
+    Q_UNUSED(filePath);
+    return false;
+#endif // HAVE_EXIV2_VERSION
+}
+
+void Exiv2Wrapper::cacheSections()
+{
+#ifdef HAVE_EXIV2_VERSION
+    if (m_exivImage->checkMode(Exiv2::mdExif) & Exiv2::amRead) {
+        cacheSection<Exiv2::ExifData, Exiv2::ExifData::const_iterator>(m_exivImage->exifData());
+    }
+
+    if (m_exivImage->checkMode(Exiv2::mdIptc) & Exiv2::amRead) {
+        cacheSection<Exiv2::IptcData, Exiv2::IptcData::const_iterator>(m_exivImage->iptcData());
+    }
+
+    if (m_exivImage->checkMode(Exiv2::mdXmp) & Exiv2::amRead) {
+        cacheSection<Exiv2::XmpData, Exiv2::XmpData::const_iterator>(m_exivImage->xmpData());
+    }
+
+//    qDebug() << m_metadataValue;
+//    qDebug() << m_metadataLabel;
+#endif // HAVE_EXIV2_VERSION
+}
+
+QString Exiv2Wrapper::comment() const
+{
+#ifdef HAVE_EXIV2_VERSION
+    return m_exivImage->comment().c_str();
+#else // HAVE_EXIV2_VERSION
+    return QString();
+#endif // HAVE_EXIV2_VERSION
+}
+
+QString Exiv2Wrapper::label(const QString &key) const
+{
+    return m_metadataLabel.value(key);
+}
+
+QString Exiv2Wrapper::value(const QString &key) const
+{
+    return m_metadataValue.value(key);
+}
+
+QString Exiv2Wrapper::XmpValue(const QString &rawValue)
+{
+    QString ignored;
+    return Exiv2Wrapper::XmpValue(rawValue, ignored);
+}
+
+QString Exiv2Wrapper::XmpValue(const QString &rawValue, QString &language)
+{
+    if (rawValue.size() > 6 && rawValue.startsWith(QLatin1String("lang=\""))) {
+        int pos = rawValue.indexOf('"', 6);
+
+        if (pos != -1) {
+            language = rawValue.mid(6, pos - 6);
+            return (rawValue.mid(pos + 2));
+        }
+    }
+
+    language.clear();
+    return rawValue;
+}
+

app/exiv2wrapper.h

@@ -1,43 +1,43 @@
-// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
-//
-// SPDX-License-Identifier: MIT
-
-#ifndef EXIV2WRAPPER_H
-#define EXIV2WRAPPER_H
-
-#include <memory>
-
-#include <QString>
-#include <QMap>
-
-namespace Exiv2 {
-class Image;
-}
-
-class Exiv2Wrapper
-{
-public:
-    Exiv2Wrapper();
-    ~Exiv2Wrapper();
-
-    bool load(const QString& filePath);
-    void cacheSections();
-
-    QString comment() const;
-    QString label(const QString & key) const;
-    QString value(const QString & key) const;
-
-    static QString XmpValue(const QString &rawValue);
-    static QString XmpValue(const QString &rawValue, QString & language);
-
-private:
-    std::unique_ptr<Exiv2::Image> m_exivImage;
-    QMap<QString, QString> m_metadataValue;
-    QMap<QString, QString> m_metadataLabel;
-    QString m_errMsg;
-
-    template<typename Collection, typename Iterator>
-    void cacheSection(Collection collection);
-};
-
-#endif // EXIV2WRAPPER_H
+// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
+//
+// SPDX-License-Identifier: MIT
+
+#ifndef EXIV2WRAPPER_H
+#define EXIV2WRAPPER_H
+
+#include <memory>
+
+#include <QString>
+#include <QMap>
+
+namespace Exiv2 {
+class Image;
+}
+
+class Exiv2Wrapper
+{
+public:
+    Exiv2Wrapper();
+    ~Exiv2Wrapper();
+
+    bool load(const QString& filePath);
+    void cacheSections();
+
+    QString comment() const;
+    QString label(const QString & key) const;
+    QString value(const QString & key) const;
+
+    static QString XmpValue(const QString &rawValue);
+    static QString XmpValue(const QString &rawValue, QString & language);
+
+private:
+    std::unique_ptr<Exiv2::Image> m_exivImage;
+    QMap<QString, QString> m_metadataValue;
+    QMap<QString, QString> m_metadataLabel;
+    QString m_errMsg;
+
+    template<typename Collection, typename Iterator>
+    void cacheSection(Collection collection);
+};
+
+#endif // EXIV2WRAPPER_H

app/fileopeneventhandler.cpp

@@ -0,0 +1,22 @@
+// SPDX-FileCopyrightText: 2024 Gary Wang <git@blumia.net>
+//
+// SPDX-License-Identifier: MIT
+
+#include "fileopeneventhandler.h"
+
+#include <QFileOpenEvent>
+
+FileOpenEventHandler::FileOpenEventHandler(QObject *parent)
+    : QObject(parent)
+{
+}
+
+bool FileOpenEventHandler::eventFilter(QObject *obj, QEvent *event)
+{
+    if (event->type() == QEvent::FileOpen) {
+        QFileOpenEvent *fileOpenEvent = static_cast<QFileOpenEvent *>(event);
+        emit fileOpen(fileOpenEvent->url());
+        return true;
+    }
+    return QObject::eventFilter(obj, event);
+}

app/fileopeneventhandler.h

@@ -0,0 +1,21 @@
+// SPDX-FileCopyrightText: 2024 Gary Wang <git@blumia.net>
+//
+// SPDX-License-Identifier: MIT
+
+#pragma once
+
+#include <QObject>
+
+class FileOpenEventHandler : public QObject
+{
+    Q_OBJECT
+
+public:
+    explicit FileOpenEventHandler(QObject *parent = nullptr);
+
+protected:
+    bool eventFilter(QObject *obj, QEvent *event) override;
+
+signals:
+    void fileOpen(const QUrl &url);
+};

app/framelesswindow.cpp

@@ -1,127 +0,0 @@
-// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
-//
-// SPDX-License-Identifier: MIT
-
-#include "framelesswindow.h"
-
-#include <QApplication>
-#include <QVBoxLayout>
-
-#ifdef _WIN32
-#include <windows.h>
-#endif // _WIN32
-
-FramelessWindow::FramelessWindow(QWidget *parent)
-    : QWidget(parent)
-    , m_centralLayout(new QVBoxLayout(this))
-{
-    // TODO: Remove the comment below when we switch to Qt 6 completely.
-    // There is a bug in Qt 5 that will make pressing Meta+Up cause the app
-    // fullscreen under Windows, see QTBUG-91226 to learn more.
-    // The bug seems no longer exists in Qt 6 (I only tested it under Qt 6.3.0).
-#if QT_VERSION >= QT_VERSION_CHECK(6, 0, 0)
-    this->setWindowFlags(Qt::Window | Qt::FramelessWindowHint | Qt::WindowMinMaxButtonsHint);
-#else
-    this->setWindowFlags(Qt::Window | Qt::FramelessWindowHint | Qt::WindowMinimizeButtonHint);
-#endif // QT_VERSION >= QT_VERSION_CHECK(6, 0, 0)
-
-    m_centralLayout->setContentsMargins(QMargins());
-}
-
-void FramelessWindow::setCentralWidget(QWidget *widget)
-{
-    if (m_centralWidget) {
-        m_centralLayout->removeWidget(m_centralWidget);
-        m_centralWidget->deleteLater();
-    }
-
-    m_centralLayout->addWidget(widget);
-    m_centralWidget = widget;
-}
-
-bool FramelessWindow::nativeEvent(const QByteArray &eventType, void *message, NATIVE_RESULT *result)
-{
-#ifdef _WIN32
-    // https://stackoverflow.com/questions/43505580/qt-windows-resizable-frameless-window
-    // Too lazy to do this now.. just stackoverflow it and did a copy and paste..
-    Q_UNUSED(eventType)
-    MSG* msg = static_cast<MSG*>(message);
-
-    if (msg->message == WM_NCHITTEST) {
-        if (isMaximized()) {
-            return false;
-        }
-
-        *result = 0;
-        const LONG borderWidth = 8;
-        RECT winrect;
-        GetWindowRect(reinterpret_cast<HWND>(winId()), &winrect);
-
-        // must be short to correctly work with multiple monitors (negative coordinates)
-        short x = msg->lParam & 0x0000FFFF;
-        short y = (msg->lParam & 0xFFFF0000) >> 16;
-
-        bool resizeWidth = minimumWidth() != maximumWidth();
-        bool resizeHeight = minimumHeight() != maximumHeight();
-        if (resizeWidth) {
-            //left border
-            if (x >= winrect.left && x < winrect.left + borderWidth) {
-                *result = HTLEFT;
-            }
-            //right border
-            if (x < winrect.right && x >= winrect.right - borderWidth) {
-                *result = HTRIGHT;
-            }
-        }
-        if (resizeHeight) {
-            //bottom border
-            if (y < winrect.bottom && y >= winrect.bottom - borderWidth) {
-                *result = HTBOTTOM;
-            }
-            //top border
-            if (y >= winrect.top && y < winrect.top + borderWidth) {
-                *result = HTTOP;
-            }
-        }
-        if (resizeWidth && resizeHeight) {
-            //bottom left corner
-            if (x >= winrect.left && x < winrect.left + borderWidth &&
-                    y < winrect.bottom && y >= winrect.bottom - borderWidth)
-            {
-                *result = HTBOTTOMLEFT;
-            }
-            //bottom right corner
-            if (x < winrect.right && x >= winrect.right - borderWidth &&
-                    y < winrect.bottom && y >= winrect.bottom - borderWidth)
-            {
-                *result = HTBOTTOMRIGHT;
-            }
-            //top left corner
-            if (x >= winrect.left && x < winrect.left + borderWidth &&
-                    y >= winrect.top && y < winrect.top + borderWidth)
-            {
-                *result = HTTOPLEFT;
-            }
-            //top right corner
-            if (x < winrect.right && x >= winrect.right - borderWidth &&
-                    y >= winrect.top && y < winrect.top + borderWidth)
-            {
-                *result = HTTOPRIGHT;
-            }
-        }
-
-        if (*result != 0)
-            return true;
-
-        QWidget *action = QApplication::widgetAt(QCursor::pos());
-        if (action == this) {
-            *result = HTCAPTION;
-            return true;
-        }
-    }
-
-    return false;
-#else
-    return QWidget::nativeEvent(eventType, message, result);
-#endif // _WIN32
-}

app/framelesswindow.h

@@ -1,36 +0,0 @@
-// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
-//
-// SPDX-License-Identifier: MIT
-
-#ifndef FRAMELESSWINDOW_H
-#define FRAMELESSWINDOW_H
-
-#include <QWidget>
-
-#if QT_VERSION >= QT_VERSION_CHECK(6, 0, 0)
-    typedef qintptr NATIVE_RESULT;
-#else
-    typedef long NATIVE_RESULT;
-#endif // QT_VERSION_CHECK(6, 0, 0)
-
-QT_BEGIN_NAMESPACE
-class QVBoxLayout;
-QT_END_NAMESPACE
-
-class FramelessWindow : public QWidget
-{
-    Q_OBJECT
-public:
-    explicit FramelessWindow(QWidget *parent = nullptr);
-
-    void setCentralWidget(QWidget * widget);
-
-protected:
-    bool nativeEvent(const QByteArray& eventType, void* message, NATIVE_RESULT* result) override;
-
-private:
-    QVBoxLayout * m_centralLayout = nullptr;
-    QWidget * m_centralWidget = nullptr; // just a pointer, doesn't take the ownership.
-};
-
-#endif // FRAMELESSWINDOW_H

app/graphicsscene.cpp

@@ -4,16 +4,48 @@
 
 #include "graphicsscene.h"
 
+#include "settings.h"
+
+#include <QStyleHints>
+#include <QOperatingSystemVersion>
+#include <QGuiApplication>
 #include <QGraphicsSceneMouseEvent>
 #include <QMimeData>
 #include <QDebug>
 #include <QGraphicsItem>
 #include <QUrl>
 #include <QGraphicsSvgItem>
+#include <QSvgRenderer>
 #include <QMovie>
-#include <QLabel>
 #include <QPainter>
 
+static const QColor& ColorSchemaToTextForeground(Qt::ColorScheme colorScheme) {
+    // YYC MARK:
+    // If we are using Windows 10 and lower system or Qt which do not support "Windows 11"
+    // theme (lower than Qt 6.7), we should only support light mode.
+    // Because Qt's dark-mode-aware "Windows 11" theme is only well-supported on Windows 11.
+#if defined(Q_OS_WIN)
+#if QT_VERSION < QT_VERSION_CHECK(6, 7, 0)
+    colorScheme = Qt::ColorScheme::Light;
+#else
+    if (QOperatingSystemVersion::current() < QOperatingSystemVersion::Windows11) {
+        colorScheme = Qt::ColorScheme::Light;
+    }
+#endif // QT_VERSION < QT_VERSION_CHECK(6, 7, 0)
+#endif // defined(Q_OS_WIN)
+
+    switch (colorScheme) {
+    case Qt::ColorScheme::Dark:
+        static QColor WHITE = QColor("White");
+        return WHITE;
+    case Qt::ColorScheme::Light:
+    case Qt::ColorScheme::Unknown:
+    default:
+        static QColor BLACK = QColor("Black");
+        return BLACK;
+    }
+}
+
 class PGraphicsPixmapItem : public QGraphicsPixmapItem
 {
 public:
@@ -21,6 +53,9 @@ public:
         : QGraphicsPixmapItem(pixmap, parent)
     {}
 
+    enum { Type = UserType + 1 };
+    int type() const override { return Type; }
+
     void setScaleHint(float scaleHint) {
         m_scaleHint = scaleHint;
     }
@@ -56,10 +91,46 @@ private:
     QPixmap m_cachedPixmap;
 };
 
+class PGraphicsMovieItem : public QGraphicsItem
+{
+public:
+    PGraphicsMovieItem(QGraphicsItem *parent = nullptr) : QGraphicsItem(parent) {}
+
+    enum { Type = UserType + 2 };
+    int type() const override { return Type; }
+
+    void setMovie(QMovie* movie) {
+        if (m_movie) m_movie->disconnect();
+        m_movie.reset(movie);
+        m_movie->connect(m_movie.data(), &QMovie::updated, [this](){
+            this->update();
+        });
+    }
+
+    QRectF boundingRect() const override {
+        if (m_movie) { return m_movie->frameRect(); }
+        else { return QRectF(); }
+    }
+
+    void paint(QPainter* painter, const QStyleOptionGraphicsItem* option, QWidget* widget) override {
+        if (m_movie) {
+            painter->drawPixmap(m_movie->frameRect(), m_movie->currentPixmap(), m_movie->frameRect());
+        }
+    }
+
+    inline QMovie * movie() const {
+        return m_movie.data();
+    }
+
+private:
+    QScopedPointer<QMovie> m_movie;
+};
+
 GraphicsScene::GraphicsScene(QObject *parent)
     : QGraphicsScene(parent)
 {
-    showText(tr("Drag image here"));
+    showText(tr("Drag image here", "The same meaning of MainWindow's hint."));
+    connect(qGuiApp->styleHints(), &QStyleHints::colorSchemeChanged, this, &GraphicsScene::updateStyle);
 }
 
 GraphicsScene::~GraphicsScene()
@@ -81,7 +152,7 @@ void GraphicsScene::showText(const QString &text)
 {
     this->clear();
     QGraphicsTextItem * textItem = this->addText(text);
-    textItem->setDefaultTextColor(QColor("White"));
+    textItem->setDefaultTextColor(ColorSchemaToTextForeground(qGuiApp->styleHints()->colorScheme()));
     m_theThing = textItem;
     this->setSceneRect(m_theThing->boundingRect());
 }
@@ -89,7 +160,15 @@ void GraphicsScene::showText(const QString &text)
 void GraphicsScene::showSvg(const QString &filepath)
 {
     this->clear();
-    QGraphicsSvgItem * svgItem = new QGraphicsSvgItem(filepath);
+    QGraphicsSvgItem * svgItem = new QGraphicsSvgItem();
+    QSvgRenderer * render = new QSvgRenderer(svgItem);
+#if QT_VERSION >= QT_VERSION_CHECK(6, 7, 0)
+    if (Settings::instance()->svgTiny12Only()) {
+        render->setOptions(QtSvg::Tiny12FeaturesOnly);
+    }
+#endif // QT_VERSION >= QT_VERSION_CHECK(6, 7, 0)
+    render->load(filepath);
+    svgItem->setSharedRenderer(render);
     this->addItem(svgItem);
     m_theThing = svgItem;
     this->setSceneRect(m_theThing->boundingRect());
@@ -98,14 +177,14 @@ void GraphicsScene::showSvg(const QString &filepath)
 void GraphicsScene::showAnimated(const QString &filepath)
 {
     this->clear();
-    QLabel * label = new QLabel;
-    QMovie * movie = new QMovie(filepath, QByteArray(), label);
-    label->setStyleSheet("background-color:rgba(225,255,255,0);");
-    label->setMovie(movie);
-    this->addWidget(label);
+
+    PGraphicsMovieItem * animatedItem = new PGraphicsMovieItem();
+    QMovie * movie = new QMovie(filepath);
     movie->start();
-    m_theThing = this->addRect(QRect(QPoint(0, 0), label->sizeHint()),
-                               QPen(Qt::transparent));
+    animatedItem->setMovie(movie);
+    this->addItem(animatedItem);
+    m_theThing = animatedItem;
+
     this->setSceneRect(m_theThing->boundingRect());
 }
 
@@ -121,6 +200,59 @@ bool GraphicsScene::trySetTransformationMode(Qt::TransformationMode mode, float
     return false;
 }
 
+/// Fetch graphics item as our custom animated item.
+/// Return nullptr means this item is not animated item.
+static PGraphicsMovieItem* fetchAnimatedItem(QGraphicsItem *item) {
+    return qgraphicsitem_cast<PGraphicsMovieItem *>(item);
+}
+
+bool GraphicsScene::canPauseAnimation() const {
+    return fetchAnimatedItem(m_theThing) != nullptr;
+}
+
+bool GraphicsScene::isPauseAnimation() const {
+    auto* animatedItem = fetchAnimatedItem(m_theThing);
+    if (animatedItem != nullptr) {
+        return animatedItem->movie()->state() == QMovie::Paused;
+    } else {
+        return false;
+    }
+}
+
+bool GraphicsScene::togglePauseAnimation()
+{
+    auto* animatedItem = fetchAnimatedItem(m_theThing);
+    if (animatedItem != nullptr) {
+        animatedItem->movie()->setPaused(animatedItem->movie()->state() != QMovie::Paused);
+        return true;
+    } else {
+        return false;
+    }
+}
+
+bool GraphicsScene::canSkipAnimationFrame() const {
+    return isPauseAnimation();
+}
+
+bool GraphicsScene::skipAnimationFrame(int delta)
+{
+    auto* animatedItem = fetchAnimatedItem(m_theThing);
+
+    // Only paused animated item can skip frame
+    if (animatedItem == nullptr) {
+        return false;
+    }
+    if (animatedItem->movie()->state() != QMovie::Paused) {
+        return false;
+    }
+
+    // Perform skip
+    const int frameCount = animatedItem->movie()->frameCount();
+    const int currentFrame = animatedItem->movie()->currentFrameNumber();
+    const int targetFrame = (currentFrame + delta) % frameCount;
+    return animatedItem->movie()->jumpToFrame(targetFrame);
+}
+
 QPixmap GraphicsScene::renderToPixmap()
 {
     PGraphicsPixmapItem * pixmapItem = qgraphicsitem_cast<PGraphicsPixmapItem *>(m_theThing);
@@ -135,3 +267,14 @@ QPixmap GraphicsScene::renderToPixmap()
 
     return pixmap;
 }
+
+void GraphicsScene::updateStyle(Qt::ColorScheme colorScheme) {
+    Q_UNUSED(colorScheme)
+
+    QGraphicsItem * item = this->m_theThing;
+    if (item == nullptr) return;
+    QGraphicsTextItem * textItem = qgraphicsitem_cast<QGraphicsTextItem*>(item);
+    if (textItem == nullptr) return;
+
+    textItem->setDefaultTextColor(ColorSchemaToTextForeground(colorScheme));
+}

app/graphicsscene.h

@@ -21,10 +21,28 @@ public:
 
     bool trySetTransformationMode(Qt::TransformationMode mode, float scaleHint);
 
+    /// Check whether current thing is animation.
+    /// Only animation thing can be paused.
+    bool canPauseAnimation() const;
+    /// Check whether we are pasuing an animation graphics.
+    bool isPauseAnimation() const;
+    /// Toggle animation graphics pause state.
+    /// Return true for successfully toggle, otherwise false.
+    bool togglePauseAnimation();
+    /// Check whether we can skip animation frame.
+    /// Only paused animation graphics can skip frame.
+    bool canSkipAnimationFrame() const;
+    /// Skip paused animation graphics with given frame.
+    /// Return true for successfully skip, otherwise false.
+    bool skipAnimationFrame(int delta = 1);
+
     QPixmap renderToPixmap();
 
+private slots:
+    void updateStyle(Qt::ColorScheme colorScheme);
+
 private:
-    QGraphicsItem * m_theThing;
+    QGraphicsItem * m_theThing = nullptr;
 };
 
 #endif // GRAPHICSSCENE_H

app/graphicsview.cpp

@@ -1,409 +1,517 @@
-// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
-//
-// SPDX-License-Identifier: MIT
-
-#include "graphicsview.h"
-
-#include "graphicsscene.h"
-
-#include <QDebug>
-#include <QMouseEvent>
-#include <QScrollBar>
-#include <QMimeData>
-#include <QImageReader>
-#include <QStyleOptionGraphicsItem>
-
-// TODO: remove this once we drop older Qt support.
-#if QT_VERSION >= QT_VERSION_CHECK(5, 13, 0)
-#define COMPAT_CONSTCOLOR constexpr
-#else
-#define COMPAT_CONSTCOLOR const
-#endif
-
-GraphicsView::GraphicsView(QWidget *parent)
-    : QGraphicsView (parent)
-{
-    setDragMode(QGraphicsView::ScrollHandDrag);
-    setHorizontalScrollBarPolicy(Qt::ScrollBarAlwaysOff);
-    setVerticalScrollBarPolicy(Qt::ScrollBarAlwaysOff);
-    setResizeAnchor(QGraphicsView::AnchorUnderMouse);
-    setTransformationAnchor(QGraphicsView::AnchorUnderMouse);
-    setStyleSheet("background-color: rgba(0, 0, 0, 220);"
-                  "border-radius: 3px;");
-    setAcceptDrops(true);
-    setCheckerboardEnabled(false);
-
-    connect(horizontalScrollBar(), &QScrollBar::valueChanged, this, &GraphicsView::viewportRectChanged);
-    connect(verticalScrollBar(), &QScrollBar::valueChanged, this, &GraphicsView::viewportRectChanged);
-}
-
-void GraphicsView::showFileFromPath(const QString &filePath, bool doRequestGallery)
-{
-    emit navigatorViewRequired(false, transform());
-
-    if (filePath.endsWith(".svg")) {
-        showSvg(filePath);
-    } else {
-        QImageReader imageReader(filePath);
-        imageReader.setAutoTransform(true);
-        imageReader.setDecideFormatFromContent(true);
-
-        // Since if the image format / plugin does not support this feature, imageFormat() will returns an invalid format.
-        // So we cannot use imageFormat() and check if it returns QImage::Format_Invalid to detect if we support the file.
-        // QImage::Format imageFormat = imageReader.imageFormat();
-        if (imageReader.format().isEmpty()) {
-            doRequestGallery = false;
-            showText(tr("File is not a valid image"));
-        } else if (imageReader.supportsAnimation() && imageReader.imageCount() > 1) {
-            showAnimated(filePath);
-        } else if (!imageReader.canRead()) {
-            doRequestGallery = false;
-            showText(tr("Image data is invalid or currently unsupported"));
-        } else {
-            QPixmap && pixmap = QPixmap::fromImageReader(&imageReader);
-            if (pixmap.isNull()) {
-                doRequestGallery = false;
-                showText(tr("Image data is invalid or currently unsupported"));
-            } else {
-                pixmap.setDevicePixelRatio(devicePixelRatioF());
-                showImage(pixmap);
-            }
-        }
-    }
-
-    if (doRequestGallery) {
-        emit requestGallery(filePath);
-    }
-}
-
-void GraphicsView::showImage(const QPixmap &pixmap)
-{
-    resetTransform();
-    scene()->showImage(pixmap);
-    displayScene();
-}
-
-void GraphicsView::showImage(const QImage &image)
-{
-    resetTransform();
-    scene()->showImage(QPixmap::fromImage(image));
-    displayScene();
-}
-
-void GraphicsView::showText(const QString &text)
-{
-    resetTransform();
-    scene()->showText(text);
-    displayScene();
-}
-
-void GraphicsView::showSvg(const QString &filepath)
-{
-    resetTransform();
-    scene()->showSvg(filepath);
-    displayScene();
-}
-
-void GraphicsView::showAnimated(const QString &filepath)
-{
-    resetTransform();
-    scene()->showAnimated(filepath);
-    displayScene();
-}
-
-GraphicsScene *GraphicsView::scene() const
-{
-    return qobject_cast<GraphicsScene*>(QGraphicsView::scene());
-}
-
-void GraphicsView::setScene(GraphicsScene *scene)
-{
-    return QGraphicsView::setScene(scene);
-}
-
-qreal GraphicsView::scaleFactor() const
-{
-    return QStyleOptionGraphicsItem::levelOfDetailFromTransform(transform());
-}
-
-void GraphicsView::resetTransform()
-{
-    QGraphicsView::resetTransform();
-}
-
-void GraphicsView::zoomView(qreal scaleFactor)
-{
-    m_enableFitInView = false;
-    scale(scaleFactor, scaleFactor);
-    applyTransformationModeByScaleFactor();
-    emit navigatorViewRequired(!isThingSmallerThanWindowWith(transform()), transform());
-}
-
-// This is always according to user's view.
-// the direction of the rotation will NOT be clockwise because the y-axis points downwards.
-void GraphicsView::rotateView(bool clockwise)
-{
-    resetScale();
-
-    QTransform tf(0,                  clockwise ? 1 : -1, 0,
-                  clockwise ? -1 : 1, 0,                  0,
-                  0,                  0,                  1);
-    tf = transform() * tf;
-    setTransform(tf);
-}
-
-void GraphicsView::flipView(bool horizontal)
-{
-    QTransform tf(horizontal ? -1 : 1, 0,                   0,
-                  0,                   horizontal ? 1 : -1, 0,
-                  0,                   0,                   1);
-    tf = transform() * tf;
-    setTransform(tf);
-
-    // Ensure the navigation view is also flipped.
-    emit navigatorViewRequired(!isThingSmallerThanWindowWith(transform()), transform());
-}
-
-void GraphicsView::resetScale()
-{
-    setTransform(resetScale(transform()));
-    applyTransformationModeByScaleFactor();
-    emit navigatorViewRequired(!isThingSmallerThanWindowWith(transform()), transform());
-}
-
-void GraphicsView::fitInView(const QRectF &rect, Qt::AspectRatioMode aspectRadioMode)
-{
-    QGraphicsView::fitInView(rect, aspectRadioMode);
-    applyTransformationModeByScaleFactor();
-}
-
-void GraphicsView::fitByOrientation(Qt::Orientation ori, bool scaleDownOnly)
-{
-    resetScale();
-
-    QRectF viewRect = this->viewport()->rect().adjusted(2, 2, -2, -2);
-    QRectF imageRect = transform().mapRect(sceneRect());
-
-    qreal ratio;
-
-    if (ori == Qt::Horizontal) {
-        ratio = viewRect.width() / imageRect.width();
-    } else {
-        ratio = viewRect.height() / imageRect.height();
-    }
-
-    if (scaleDownOnly && ratio > 1) ratio = 1;
-
-    scale(ratio, ratio);
-    centerOn(imageRect.top(), 0);
-    m_enableFitInView = false;
-
-    applyTransformationModeByScaleFactor();
-    emit navigatorViewRequired(!isThingSmallerThanWindowWith(transform()), transform());
-}
-
-void GraphicsView::displayScene()
-{
-    if (isSceneBiggerThanView()) {
-        fitInView(sceneRect(), Qt::KeepAspectRatio);
-    }
-
-    m_enableFitInView = true;
-}
-
-bool GraphicsView::isSceneBiggerThanView() const
-{
-    if (!isThingSmallerThanWindowWith(transform())) {
-        return true;
-    } else {
-        return false;
-    }
-}
-
-// Automately do fit in view when viewport(window) smaller than image original size.
-void GraphicsView::setEnableAutoFitInView(bool enable)
-{
-    m_enableFitInView = enable;
-}
-
-inline double zeroOrOne(double number)
-{
-    return qFuzzyIsNull(number) ? 0 : (number > 0 ? 1 : -1);
-}
-
-// Note: this only works if we only have 90 degree based rotation
-//       and no shear/translate.
-QTransform GraphicsView::resetScale(const QTransform & orig)
-{
-    return QTransform(zeroOrOne(orig.m11()), zeroOrOne(orig.m12()),
-                      zeroOrOne(orig.m21()), zeroOrOne(orig.m22()),
-                      orig.dx(),             orig.dy());
-}
-
-void GraphicsView::toggleCheckerboard(bool invertCheckerboardColor)
-{
-    setCheckerboardEnabled(!m_checkerboardEnabled, invertCheckerboardColor);
-}
-
-void GraphicsView::mousePressEvent(QMouseEvent *event)
-{
-    if (shouldIgnoreMousePressMoveEvent(event)) {
-        event->ignore();
-        // blumia: return here, or the QMouseEvent event transparency won't
-        //         work if we set a QGraphicsView::ScrollHandDrag drag mode.
-        return;
-    }
-
-    return QGraphicsView::mousePressEvent(event);
-}
-
-void GraphicsView::mouseMoveEvent(QMouseEvent *event)
-{
-    if (shouldIgnoreMousePressMoveEvent(event)) {
-        event->ignore();
-    }
-
-    return QGraphicsView::mouseMoveEvent(event);
-}
-
-void GraphicsView::mouseReleaseEvent(QMouseEvent *event)
-{
-    if (event->button() == Qt::ForwardButton || event->button() == Qt::BackButton) {
-        event->ignore();
-    } else {
-        QGraphicsItem *item = itemAt(event->pos());
-        if (!item) {
-            event->ignore();
-        }
-    }
-
-    return QGraphicsView::mouseReleaseEvent(event);
-}
-
-void GraphicsView::wheelEvent(QWheelEvent *event)
-{
-    event->ignore();
-    // blumia: no need for calling parent method.
-}
-
-void GraphicsView::resizeEvent(QResizeEvent *event)
-{
-    if (m_enableFitInView) {
-        bool originalSizeSmallerThanWindow = isThingSmallerThanWindowWith(resetScale(transform()));
-        if (originalSizeSmallerThanWindow && scaleFactor() >= 1) {
-            // no longer need to do fitInView()
-            // but we leave the m_enableFitInView value unchanged in case
-            // user resize down the window again.
-        } else if (originalSizeSmallerThanWindow && scaleFactor() < 1) {
-            resetScale();
-        } else {
-            fitInView(sceneRect(), Qt::KeepAspectRatio);
-        }
-    } else {
-        emit navigatorViewRequired(!isThingSmallerThanWindowWith(transform()), transform());
-    }
-    return QGraphicsView::resizeEvent(event);
-}
-
-void GraphicsView::dragEnterEvent(QDragEnterEvent *event)
-{
-    if (event->mimeData()->hasUrls() || event->mimeData()->hasImage() || event->mimeData()->hasText()) {
-        event->acceptProposedAction();
-    } else {
-        event->ignore();
-    }
-//    qDebug() << event->mimeData() << "Drag Enter Event"
-//             << event->mimeData()->hasUrls() << event->mimeData()->hasImage()
-//             << event->mimeData()->formats() << event->mimeData()->hasFormat("text/uri-list");
-
-    return QGraphicsView::dragEnterEvent(event);
-}
-
-void GraphicsView::dragMoveEvent(QDragMoveEvent *event)
-{
-    Q_UNUSED(event)
-    // by default, QGraphicsView/Scene will ignore the action if there are no QGraphicsItem under cursor.
-    // We actually doesn't care and would like to keep the drag event as-is, so just do nothing here.
-}
-
-void GraphicsView::dropEvent(QDropEvent *event)
-{
-    event->acceptProposedAction();
-
-    const QMimeData * mimeData = event->mimeData();
-
-    if (mimeData->hasUrls()) {
-        const QList<QUrl> &urls = mimeData->urls();
-        if (urls.isEmpty()) {
-            showText(tr("File url list is empty"));
-        } else {
-            showFileFromPath(urls.first().toLocalFile(), true);
-        }
-    } else if (mimeData->hasImage()) {
-        QImage img = qvariant_cast<QImage>(mimeData->imageData());
-        QPixmap pixmap = QPixmap::fromImage(img);
-        if (pixmap.isNull()) {
-            showText(tr("Image data is invalid"));
-        } else {
-            showImage(pixmap);
-        }
-    } else if (mimeData->hasText()) {
-        showText(mimeData->text());
-    } else {
-        showText(tr("Not supported mimedata: %1").arg(mimeData->formats().first()));
-    }
-}
-
-bool GraphicsView::isThingSmallerThanWindowWith(const QTransform &transform) const
-{
-    return rect().size().expandedTo(transform.mapRect(sceneRect()).size().toSize())
-            == rect().size();
-}
-
-bool GraphicsView::shouldIgnoreMousePressMoveEvent(const QMouseEvent *event) const
-{
-    if (event->buttons() == Qt::NoButton) {
-        return true;
-    }
-
-    QGraphicsItem *item = itemAt(event->pos());
-    if (!item) {
-        return true;
-    }
-
-    if (isThingSmallerThanWindowWith(transform())) {
-        return true;
-    }
-
-    return false;
-}
-
-void GraphicsView::setCheckerboardEnabled(bool enabled, bool invertColor)
-{
-    m_checkerboardEnabled = enabled;
-    m_isLastCheckerboardColorInverted = invertColor;
-    if (m_checkerboardEnabled) {
-        // Prepare background check-board pattern
-        QPixmap tilePixmap(0x20, 0x20);
-        tilePixmap.fill(invertColor ? QColor(220, 220, 220, 170) : QColor(35, 35, 35, 170));
-        QPainter tilePainter(&tilePixmap);
-        COMPAT_CONSTCOLOR QColor color(45, 45, 45, 170);
-        COMPAT_CONSTCOLOR QColor invertedColor(210, 210, 210, 170);
-        tilePainter.fillRect(0, 0, 0x10, 0x10, invertColor ? invertedColor : color);
-        tilePainter.fillRect(0x10, 0x10, 0x10, 0x10, invertColor ? invertedColor : color);
-        tilePainter.end();
-
-        setBackgroundBrush(tilePixmap);
-    } else {
-        setBackgroundBrush(Qt::transparent);
-    }
-}
-
-void GraphicsView::applyTransformationModeByScaleFactor()
-{
-    if (this->scaleFactor() < 1) {
-        scene()->trySetTransformationMode(Qt::SmoothTransformation, this->scaleFactor());
-    } else {
-        scene()->trySetTransformationMode(Qt::FastTransformation, this->scaleFactor());
-    }
-}
+// SPDX-FileCopyrightText: 2025 Gary Wang <git@blumia.net>
+//
+// SPDX-License-Identifier: MIT
+
+#include "graphicsview.h"
+
+#include "graphicsscene.h"
+#include "settings.h"
+
+#include <QStyleHints>
+#include <QOperatingSystemVersion>
+#include <QDebug>
+#include <QColorSpace>
+#include <QMouseEvent>
+#include <QScrollBar>
+#include <QMimeData>
+#include <QImageReader>
+#include <QStyleOptionGraphicsItem>
+
+GraphicsView::GraphicsView(QWidget *parent)
+    : QGraphicsView (parent)
+{
+    setDragMode(QGraphicsView::ScrollHandDrag);
+    setHorizontalScrollBarPolicy(Qt::ScrollBarAlwaysOff);
+    setVerticalScrollBarPolicy(Qt::ScrollBarAlwaysOff);
+    setResizeAnchor(QGraphicsView::AnchorUnderMouse);
+    setTransformationAnchor(QGraphicsView::AnchorUnderMouse);
+    setAcceptDrops(false);
+    setCheckerboardEnabled(false);
+
+    updateStyle(qGuiApp->styleHints()->colorScheme());
+    connect(qGuiApp->styleHints(), &QStyleHints::colorSchemeChanged, this, &GraphicsView::updateStyle);
+
+    connect(horizontalScrollBar(), &QScrollBar::valueChanged, this, &GraphicsView::viewportRectChanged);
+    connect(verticalScrollBar(), &QScrollBar::valueChanged, this, &GraphicsView::viewportRectChanged);
+}
+
+void GraphicsView::showFileFromPath(const QString &filePath)
+{
+    emit navigatorViewRequired(false, transform());
+
+    if (filePath.endsWith(".svg")) {
+        showSvg(filePath);
+    } else {
+        QImageReader imageReader(filePath);
+        imageReader.setAutoTransform(true);
+        imageReader.setDecideFormatFromContent(true);
+        imageReader.setAllocationLimit(0);
+
+        // Since if the image format / plugin does not support this feature, imageFormat() will returns an invalid format.
+        // So we cannot use imageFormat() and check if it returns QImage::Format_Invalid to detect if we support the file.
+        // QImage::Format imageFormat = imageReader.imageFormat();
+        if (imageReader.format().isEmpty()) {
+            showText(tr("File is not a valid image"));
+        } else if (imageReader.supportsAnimation() && imageReader.imageCount() > 1) {
+            showAnimated(filePath);
+        } else if (!imageReader.canRead()) {
+            showText(tr("Image data is invalid or currently unsupported"));
+        } else {
+#if QT_VERSION >= QT_VERSION_CHECK(6, 8, 0)
+            QImage && img = imageReader.read();
+            if (img.isNull()) {
+                showText(tr("Image data is invalid or currently unsupported"));
+            } else {
+                if (img.format() == QImage::Format_CMYK8888) {
+                    img.convertToColorSpace(QColorSpace::SRgb);
+                }
+                img.setDevicePixelRatio(devicePixelRatioF());
+                showImage(img);
+            }
+#else
+            QPixmap && pixmap = QPixmap::fromImageReader(&imageReader);
+            if (pixmap.isNull()) {
+                showText(tr("Image data is invalid or currently unsupported"));
+            } else {
+                pixmap.setDevicePixelRatio(devicePixelRatioF());
+                showImage(pixmap);
+            }
+#endif // QT_VERSION >= QT_VERSION_CHECK(6, 8, 0)
+        }
+    }
+}
+
+void GraphicsView::showImage(const QPixmap &pixmap)
+{
+    resetTransform();
+    scene()->showImage(pixmap);
+    displayScene();
+}
+
+void GraphicsView::showImage(const QImage &image)
+{
+    resetTransform();
+    scene()->showImage(QPixmap::fromImage(image));
+    displayScene();
+}
+
+void GraphicsView::showText(const QString &text)
+{
+    resetTransform();
+    scene()->showText(text);
+    displayScene();
+}
+
+void GraphicsView::showSvg(const QString &filepath)
+{
+    resetTransform();
+    scene()->showSvg(filepath);
+    displayScene();
+}
+
+void GraphicsView::showAnimated(const QString &filepath)
+{
+    resetTransform();
+    scene()->showAnimated(filepath);
+    displayScene();
+}
+
+GraphicsScene *GraphicsView::scene() const
+{
+    return qobject_cast<GraphicsScene*>(QGraphicsView::scene());
+}
+
+void GraphicsView::setScene(GraphicsScene *scene)
+{
+    return QGraphicsView::setScene(scene);
+}
+
+qreal GraphicsView::scaleFactor() const
+{
+    return QStyleOptionGraphicsItem::levelOfDetailFromTransform(transform());
+}
+
+void GraphicsView::resetTransform()
+{
+    if (!shouldAvoidTransform()) {
+        QGraphicsView::resetTransform();
+    }
+}
+
+void GraphicsView::zoomView(qreal scaleFactor)
+{
+    m_enableFitToScreen = false;
+    scale(scaleFactor, scaleFactor);
+    applyTransformationModeByScaleFactor();
+    emit navigatorViewRequired(!isThingSmallerThanWindowWith(transform()), transform());
+}
+
+// This is always according to user's view.
+// the direction of the rotation will NOT be clockwise because the y-axis points downwards.
+void GraphicsView::rotateView(bool clockwise)
+{
+    resetScale();
+
+    QTransform tf(0,                  clockwise ? 1 : -1, 0,
+                  clockwise ? -1 : 1, 0,                  0,
+                  0,                  0,                  1);
+    tf = transform() * tf;
+    setTransform(tf);
+    
+    // Apply transformation mode but don't emit navigator signal here
+    // Let displayScene() handle the navigator visibility correctly
+    applyTransformationModeByScaleFactor();
+}
+
+void GraphicsView::flipView(bool horizontal)
+{
+    QTransform tf(horizontal ? -1 : 1, 0,                   0,
+                  0,                   horizontal ? 1 : -1, 0,
+                  0,                   0,                   1);
+    tf = transform() * tf;
+    setTransform(tf);
+
+    // Ensure the navigation view is also flipped.
+    emit navigatorViewRequired(!isThingSmallerThanWindowWith(transform()), transform());
+}
+
+void GraphicsView::resetScale()
+{
+    setTransform(resetScale(transform()));
+    applyTransformationModeByScaleFactor();
+    emit navigatorViewRequired(!isThingSmallerThanWindowWith(transform()), transform());
+}
+
+void GraphicsView::fitInView(const QRectF &rect, Qt::AspectRatioMode aspectRadioMode)
+{
+    QGraphicsView::fitInView(rect, aspectRadioMode);
+    applyTransformationModeByScaleFactor();
+}
+
+void GraphicsView::fitByOrientation(Qt::Orientation ori, bool scaleDownOnly)
+{
+    resetScale();
+
+    QRectF viewRect = this->viewport()->rect();
+    QRectF imageRect = transform().mapRect(sceneRect());
+    QSize viewSize = viewRect.size().toSize();
+
+    qreal ratio;
+
+    if (ori == Qt::Horizontal) {
+        // Horizontal fit means fit by width
+        if (scaleDownOnly && imageRect.width() <= viewSize.width()) {
+            // Image width already fits, no scaling needed
+            ratio = 1;
+        } else {
+            ratio = viewRect.width() / imageRect.width();
+        }
+    } else {
+        // Vertical fit means fit by height
+        if (scaleDownOnly && imageRect.height() <= viewSize.height()) {
+            // Image height already fits, no scaling needed
+            ratio = 1;
+        } else {
+            ratio = viewRect.height() / imageRect.height();
+        }
+    }
+
+    if (ratio != 1) {
+        scale(ratio, ratio);
+    }
+
+    // Position the image correctly based on orientation with rotation consideration
+    QRectF originalScene = sceneRect();
+    QTransform currentTransform = transform();
+    
+    // TODO: 
+    // I guess following code may be optimized by matrix arithmetic operation.
+    // There is an AI given solution. But I didn't use it.
+    // Because I want to keep the same behavior of upstream.
+
+    // // Horizontal fit: Let the position of top center of viewport, (cx, 0), be inversely mapped to scene.
+    // // And compensate the behavior of `centerOn` which put given point to the center of viewport.
+    // QTransform inv = currentTransform.inverted();
+    // QPointF viewCx = viewport()->rect().center().x();
+    // QPointF viewCy = viewport()->rect().center().y();
+    // // The target is viewport top center. Its y=0, so `centerOn` required scene point is (viewCx, -viewCy).
+    // centerOn(inv.map(QPointF(viewCx, -viewCy)));
+
+    if (ori == Qt::Horizontal) {
+        // For horizontal fit (fit by width), position at top (for tall images)
+        // Find the scene point that corresponds to the top-center of the transformed image
+        QPointF sceneTopCenter;
+
+        if (qFuzzyIsNull(currentTransform.m12()) && qFuzzyIsNull(currentTransform.m21())) {
+            // 0° or 180° rotation
+            if (currentTransform.m11() > 0 && currentTransform.m22() > 0) {
+                // 0° rotation: use original top-center
+                sceneTopCenter = QPointF(originalScene.center().x(), originalScene.top());
+            } else {
+                // 180° rotation: the visual "top" is now at the scene bottom
+                sceneTopCenter = QPointF(originalScene.center().x(), originalScene.bottom());
+            }
+        } else {
+            // 90/270 degree rotation: the "top" in view corresponds to left/right in scene
+            if (currentTransform.m12() > 0) {
+                // 90 degree: top in view = left in scene
+                sceneTopCenter = QPointF(originalScene.left(), originalScene.center().y());
+            } else {
+                // 270 degree: top in view = right in scene
+                sceneTopCenter = QPointF(originalScene.right(), originalScene.center().y());
+            }
+        }
+        centerOn(sceneTopCenter);
+    } else {
+        // For vertical fit (fit by height), position at left (for wide images)
+        // Find the scene point that corresponds to the left-center of the transformed image
+        QPointF sceneLeftCenter;
+
+        if (qFuzzyIsNull(currentTransform.m12()) && qFuzzyIsNull(currentTransform.m21())) {
+            // 0° or 180° rotation
+            if (currentTransform.m11() > 0 && currentTransform.m22() > 0) {
+                // 0° rotation: use original left-center
+                sceneLeftCenter = QPointF(originalScene.left(), originalScene.center().y());
+            } else {
+                // 180° rotation: the visual "left" is now at the scene right
+                sceneLeftCenter = QPointF(originalScene.right(), originalScene.center().y());
+            }
+        } else {
+            // 90/270 degree rotation: the "left" in view corresponds to top/bottom in scene
+            if (currentTransform.m21() > 0) {
+                // 90 degree: left in view = top in scene
+                sceneLeftCenter = QPointF(originalScene.center().x(), originalScene.top());
+            } else {
+                // 270 degree: left in view = bottom in scene
+                sceneLeftCenter = QPointF(originalScene.center().x(), originalScene.bottom());
+            }
+        }
+        centerOn(sceneLeftCenter);
+    }
+
+    m_enableFitToScreen = false;
+
+    applyTransformationModeByScaleFactor();
+    emit navigatorViewRequired(!isThingSmallerThanWindowWith(transform()), transform());
+}
+
+void GraphicsView::displayScene()
+{
+    if (shouldAvoidTransform()) {
+        emit navigatorViewRequired(!isThingSmallerThanWindowWith(transform()), transform());
+        return;
+    }
+
+    if (isSceneBiggerThanView()) {
+        // Do fit-in-view
+        fitInView(sceneRect(), Qt::KeepAspectRatio);
+        // After fitInView, the image should fit the window, so hide navigator
+        emit navigatorViewRequired(false, transform());
+    } else {
+        // Image is already smaller than window, no navigator needed
+        emit navigatorViewRequired(false, transform());
+    }
+
+    m_enableFitToScreen = true;
+    m_firstUserMediaLoaded = true;
+}
+
+bool GraphicsView::isSceneBiggerThanView() const
+{
+    if (!isThingSmallerThanWindowWith(transform())) {
+        return true;
+    } else {
+        return false;
+    }
+}
+
+// Automately do fit in view when viewport(window) smaller than image original size.
+void GraphicsView::setEnableAutoFitToScreen(bool enable)
+{
+    m_enableFitToScreen = enable;
+}
+
+bool GraphicsView::isAvoidResetTransform() const
+{
+    return m_avoidResetTransform;
+}
+
+void GraphicsView::setAvoidResetTransform(bool avoidReset)
+{
+    m_avoidResetTransform = avoidReset;
+}
+
+bool GraphicsView::isCheckerboard() const {
+    return m_checkerboardEnabled;
+}
+
+void GraphicsView::toggleCheckerboard(bool invertCheckerboardColor)
+{
+    setCheckerboardEnabled(!m_checkerboardEnabled, invertCheckerboardColor);
+}
+
+inline double zeroOrOne(double number)
+{
+    return qFuzzyIsNull(number) ? 0 : (number > 0 ? 1 : -1);
+}
+
+// Note: this only works if we only have 90 degree based rotation
+//       and no shear/translate.
+QTransform GraphicsView::resetScale(const QTransform & orig)
+{
+    return QTransform(zeroOrOne(orig.m11()), zeroOrOne(orig.m12()),
+                      zeroOrOne(orig.m21()), zeroOrOne(orig.m22()),
+                      orig.dx(),             orig.dy());
+}
+
+void GraphicsView::updateStyle(Qt::ColorScheme colorScheme) {
+    // YYC MARK:
+    // If we are using Windows 10 and lower system or Qt which do not support "Windows 11"
+    // theme (lower than Qt 6.7), we should only support light mode.
+    // Because Qt's dark-mode-aware "Windows 11" theme is only well-supported on Windows 11.
+#if defined(Q_OS_WIN)
+#if QT_VERSION < QT_VERSION_CHECK(6, 7, 0)
+    colorScheme = Qt::ColorScheme::Light;
+#else
+    if (QOperatingSystemVersion::current() < QOperatingSystemVersion::Windows11) {
+        colorScheme = Qt::ColorScheme::Light;
+    }
+#endif // QT_VERSION < QT_VERSION_CHECK(6, 7, 0)
+#endif // defined(Q_OS_WIN)
+
+    switch (colorScheme) {
+    case Qt::ColorScheme::Dark:
+        setStyleSheet(R"#(
+border-style: none;
+background-color: black;
+)#");
+        break;
+    case Qt::ColorScheme::Light:
+    case Qt::ColorScheme::Unknown:
+    default:
+        setStyleSheet(R"#(
+border-style: none;
+background-color: white;
+)#");
+        break;
+    }
+}
+
+void GraphicsView::mousePressEvent(QMouseEvent *event)
+{
+    if (shouldIgnoreMousePressMoveEvent(event)) {
+        event->ignore();
+        // blumia: return here, or the QMouseEvent event transparency won't
+        //         work if we set a QGraphicsView::ScrollHandDrag drag mode.
+        return;
+    }
+
+    return QGraphicsView::mousePressEvent(event);
+}
+
+void GraphicsView::mouseMoveEvent(QMouseEvent *event)
+{
+    if (shouldIgnoreMousePressMoveEvent(event)) {
+        event->ignore();
+    }
+
+    return QGraphicsView::mouseMoveEvent(event);
+}
+
+void GraphicsView::mouseReleaseEvent(QMouseEvent *event)
+{
+    if (event->button() == Qt::ForwardButton || event->button() == Qt::BackButton) {
+        event->ignore();
+    } else {
+        QGraphicsItem *item = itemAt(event->pos());
+        if (!item) {
+            event->ignore();
+        }
+    }
+
+    return QGraphicsView::mouseReleaseEvent(event);
+}
+
+void GraphicsView::wheelEvent(QWheelEvent *event)
+{
+    event->ignore();
+    // blumia: no need for calling parent method.
+}
+
+void GraphicsView::resizeEvent(QResizeEvent *event)
+{
+    if (m_enableFitToScreen) {
+        bool originalSizeSmallerThanWindow = isThingSmallerThanWindowWith(resetScale(transform()));
+        if (originalSizeSmallerThanWindow && scaleFactor() >= 1) {
+            // no longer need to do fitInView()
+            // but we leave the m_enableToScreen value unchanged in case
+            // user resize down the window again.
+        } else if (originalSizeSmallerThanWindow && scaleFactor() < 1) {
+            resetScale();
+        } else {
+            fitInView(sceneRect(), Qt::KeepAspectRatio);
+        }
+    } else {
+        emit navigatorViewRequired(!isThingSmallerThanWindowWith(transform()), transform());
+    }
+    return QGraphicsView::resizeEvent(event);
+}
+
+bool GraphicsView::isThingSmallerThanWindowWith(const QTransform &transform) const
+{
+    return rect().size().expandedTo(transform.mapRect(sceneRect()).size().toSize())
+            == rect().size();
+}
+
+bool GraphicsView::shouldIgnoreMousePressMoveEvent(const QMouseEvent *event) const
+{
+    if (event->buttons() == Qt::NoButton) {
+        return true;
+    }
+
+    QGraphicsItem *item = itemAt(event->pos());
+    if (!item) {
+        return true;
+    }
+
+    if (isThingSmallerThanWindowWith(transform())) {
+        return true;
+    }
+
+    return false;
+}
+
+void GraphicsView::setCheckerboardEnabled(bool enabled, bool invertColor)
+{
+    m_checkerboardEnabled = enabled;
+    bool isLightCheckerboard = Settings::instance()->useLightCheckerboard() ^ invertColor;
+    if (m_checkerboardEnabled) {
+        // Prepare background check-board pattern
+        QPixmap tilePixmap(0x20, 0x20);
+        tilePixmap.fill(isLightCheckerboard ? QColor(220, 220, 220, 170) : QColor(35, 35, 35, 170));
+        QPainter tilePainter(&tilePixmap);
+        constexpr QColor color(45, 45, 45, 170);
+        constexpr QColor invertedColor(210, 210, 210, 170);
+        tilePainter.fillRect(0, 0, 0x10, 0x10, isLightCheckerboard ? invertedColor : color);
+        tilePainter.fillRect(0x10, 0x10, 0x10, 0x10, isLightCheckerboard ? invertedColor : color);
+        tilePainter.end();
+
+        setBackgroundBrush(tilePixmap);
+    } else {
+        setBackgroundBrush(Qt::transparent);
+    }
+}
+
+void GraphicsView::applyTransformationModeByScaleFactor()
+{
+    if (this->scaleFactor() < 1) {
+        scene()->trySetTransformationMode(Qt::SmoothTransformation, this->scaleFactor());
+    } else {
+        scene()->trySetTransformationMode(Qt::FastTransformation, this->scaleFactor());
+    }
+}
+
+bool GraphicsView::shouldAvoidTransform() const
+{
+    return m_firstUserMediaLoaded && m_avoidResetTransform;
+}

app/graphicsview.h

@@ -1,77 +1,82 @@
-// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
-//
-// SPDX-License-Identifier: MIT
-
-#ifndef GRAPHICSVIEW_H
-#define GRAPHICSVIEW_H
-
-#include <QGraphicsView>
-#include <QUrl>
-
-class GraphicsScene;
-class GraphicsView : public QGraphicsView
-{
-    Q_OBJECT
-public:
-    GraphicsView(QWidget *parent = nullptr);
-
-    void showFileFromPath(const QString &filePath, bool requestGallery = false);
-
-    void showImage(const QPixmap &pixmap);
-    void showImage(const QImage &image);
-    void showText(const QString &text);
-    void showSvg(const QString &filepath);
-    void showAnimated(const QString &filepath);
-
-    GraphicsScene * scene() const;
-    void setScene(GraphicsScene *scene);
-
-    qreal scaleFactor() const;
-
-    void resetTransform();
-    void zoomView(qreal scaleFactor);
-    void rotateView(bool clockwise = true);
-    void flipView(bool horizontal = true);
-    void resetScale();
-    void fitInView(const QRectF &rect, Qt::AspectRatioMode aspectRadioMode = Qt::IgnoreAspectRatio);
-    void fitByOrientation(Qt::Orientation ori = Qt::Horizontal, bool scaleDownOnly = false);
-
-    void displayScene();
-    bool isSceneBiggerThanView() const;
-    void setEnableAutoFitInView(bool enable = true);
-
-    static QTransform resetScale(const QTransform & orig);
-
-signals:
-    void navigatorViewRequired(bool required, QTransform transform);
-    void viewportRectChanged();
-    void requestGallery(const QString &filePath);
-
-public slots:
-    void toggleCheckerboard(bool invertCheckerboardColor = false);
-
-private:
-    void mousePressEvent(QMouseEvent * event) override;
-    void mouseMoveEvent(QMouseEvent * event) override;
-    void mouseReleaseEvent(QMouseEvent * event) override;
-    void wheelEvent(QWheelEvent *event) override;
-    void resizeEvent(QResizeEvent *event) override;
-
-    void dragEnterEvent(QDragEnterEvent *event) override;
-    void dragMoveEvent(QDragMoveEvent *event) override;
-    void dropEvent(QDropEvent *event) override;
-
-    bool isThingSmallerThanWindowWith(const QTransform &transform) const;
-    bool shouldIgnoreMousePressMoveEvent(const QMouseEvent *event) const;
-    void setCheckerboardEnabled(bool enabled, bool invertColor = false);
-    void applyTransformationModeByScaleFactor();
-
-    // Consider switch to 3 state for "no fit", "always fit" and "fit when view is smaller"?
-    // ... or even more? e.g. "fit/snap width" things...
-    // Currently it's "no fit" when it's false and "fit when view is smaller" when it's true.
-    bool m_enableFitInView = false;
-    bool m_checkerboardEnabled = false;
-    bool m_isLastCheckerboardColorInverted = false;
-};
-
-#endif // GRAPHICSVIEW_H
+// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
+//
+// SPDX-License-Identifier: MIT
+
+#ifndef GRAPHICSVIEW_H
+#define GRAPHICSVIEW_H
+
+#include <QGraphicsView>
+#include <QUrl>
+
+class GraphicsScene;
+class GraphicsView : public QGraphicsView
+{
+    Q_OBJECT
+public:
+    GraphicsView(QWidget *parent = nullptr);
+
+    void showFileFromPath(const QString &filePath);
+
+    void showImage(const QPixmap &pixmap);
+    void showImage(const QImage &image);
+    void showText(const QString &text);
+    void showSvg(const QString &filepath);
+    void showAnimated(const QString &filepath);
+
+    GraphicsScene * scene() const;
+    void setScene(GraphicsScene *scene);
+
+    qreal scaleFactor() const;
+
+    void resetTransform();
+    void zoomView(qreal scaleFactor);
+    void rotateView(bool clockwise = true);
+    void flipView(bool horizontal = true);
+    void resetScale();
+    void fitInView(const QRectF &rect, Qt::AspectRatioMode aspectRadioMode = Qt::IgnoreAspectRatio);
+    void fitByOrientation(Qt::Orientation ori = Qt::Horizontal, bool scaleDownOnly = false);
+
+    void displayScene();
+    bool isSceneBiggerThanView() const;
+    void setEnableAutoFitToScreen(bool enable = true);
+
+    bool isAvoidResetTransform() const;
+    void setAvoidResetTransform(bool avoidReset);
+
+    bool isCheckerboard() const;
+    void toggleCheckerboard(bool invertCheckerboardColor = false);
+
+    static QTransform resetScale(const QTransform & orig);
+
+signals:
+    void navigatorViewRequired(bool required, QTransform transform);
+    void viewportRectChanged();
+
+private slots:
+    void updateStyle(Qt::ColorScheme colorScheme);
+
+private:
+    void mousePressEvent(QMouseEvent * event) override;
+    void mouseMoveEvent(QMouseEvent * event) override;
+    void mouseReleaseEvent(QMouseEvent * event) override;
+    void wheelEvent(QWheelEvent *event) override;
+    void resizeEvent(QResizeEvent *event) override;
+
+    bool isThingSmallerThanWindowWith(const QTransform &transform) const;
+    bool shouldIgnoreMousePressMoveEvent(const QMouseEvent *event) const;
+    void setCheckerboardEnabled(bool enabled, bool invertColor = false);
+    void applyTransformationModeByScaleFactor();
+
+    inline bool shouldAvoidTransform() const;
+
+    // Consider switch to 3 state for "no fit", "always fit" and "fit when view is smaller"?
+    // ... or even more? e.g. "fit/snap width" things...
+    // Currently it's "no fit" when it's false and "fit when view is smaller" when it's true.
+    bool m_enableFitToScreen = false;
+    bool m_avoidResetTransform = false;
+    bool m_checkerboardEnabled = false;
+    bool m_useLightCheckerboard = false;
+    bool m_firstUserMediaLoaded = false;
+};
+
+#endif // GRAPHICSVIEW_H

app/main.cpp

@@ -1,60 +1,96 @@
-// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
-//
-// SPDX-License-Identifier: MIT
-
-#include "mainwindow.h"
-
-#include "playlistmanager.h"
-
-#include <QApplication>
-#include <QCommandLineParser>
-#include <QDir>
-#include <QTranslator>
-#include <QUrl>
-
-// QM_FILE_INSTALL_DIR should be defined from the CMakeLists file.
-#ifndef QM_FILE_INSTALL_DIR
-#define QM_FILE_INSTALL_DIR ":/i18n/"
-#endif // QM_FILE_INSTALL_DIR
-
-int main(int argc, char *argv[])
-{
-    QApplication a(argc, argv);
-#if QT_VERSION < QT_VERSION_CHECK(6, 0, 0)
-    a.setAttribute(Qt::ApplicationAttribute::AA_UseHighDpiPixmaps);
-#endif
-
-    QTranslator translator;
-    QString qmDir;
-#ifdef _WIN32
-    qmDir = QDir(QCoreApplication::applicationDirPath()).absoluteFilePath("translations");
-#else
-    qmDir = QT_STRINGIFY(QM_FILE_INSTALL_DIR);
-#endif
-    if (translator.load(QString("PineapplePictures_%1").arg(QLocale::system().name()), qmDir)) {
-        a.installTranslator(&translator);
-    }
-    a.setApplicationName("Pineapple Pictures");
-    a.setApplicationDisplayName(QCoreApplication::translate("main", "Pineapple Pictures"));
-
-    // parse commandline arguments
-    QCommandLineParser parser;
-    parser.addPositionalArgument("File list", QCoreApplication::translate("main", "File list."));
-    parser.addHelpOption();
-
-    parser.process(a);
-
-    MainWindow w;
-    w.show();
-
-    QStringList urlStrList = parser.positionalArguments();
-    QList<QUrl> && urlList = PlaylistManager::convertToUrlList(urlStrList);
-
-    if (!urlList.isEmpty()) {
-        w.showUrls(urlList);
-    }
-
-    w.initWindowSize();
-
-    return a.exec();
-}
+// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
+//
+// SPDX-License-Identifier: MIT
+
+#include "mainwindow.h"
+
+#include "settings.h"
+
+#ifdef Q_OS_MACOS
+#include "fileopeneventhandler.h"
+#endif // Q_OS_MACOS
+
+#include <QApplication>
+#include <QCommandLineParser>
+#include <QDir>
+#include <QTranslator>
+#include <QUrl>
+
+using namespace Qt::Literals::StringLiterals;
+
+int main(int argc, char *argv[])
+{
+    QCoreApplication::setApplicationName(u"Pineapple Pictures"_s);
+    QCoreApplication::setApplicationVersion(PPIC_VERSION_STRING);
+    QGuiApplication::setHighDpiScaleFactorRoundingPolicy(Settings::instance()->hiDpiScaleFactorBehavior());
+
+    QApplication a(argc, argv);
+
+    QTranslator translator;
+#if defined(TRANSLATION_RESOURCE_EMBEDDING)
+    const QString qmDir = u":/i18n/"_s;
+#elif defined(QM_FILE_INSTALL_ABSOLUTE_DIR)
+    const QString qmDir = QT_STRINGIFY(QM_FILE_INSTALL_ABSOLUTE_DIR);
+#else
+    const QString qmDir = QDir(QCoreApplication::applicationDirPath()).absoluteFilePath("translations");
+#endif
+    if (translator.load(QLocale(), u"PineapplePictures"_s, u"_"_s, qmDir)) {
+        QCoreApplication::installTranslator(&translator);
+    }
+
+    QGuiApplication::setApplicationDisplayName(QCoreApplication::translate("main", "Pineapple Pictures"));
+
+    // commandline options
+    QCommandLineOption supportedImageFormats(u"supported-image-formats"_s, QCoreApplication::translate("main", "List supported image format suffixes, and quit program."));
+    // parse commandline arguments
+    QCommandLineParser parser;
+    parser.addOption(supportedImageFormats);
+    parser.addPositionalArgument("File list", QCoreApplication::translate("main", "File list."));
+    parser.addHelpOption();
+    parser.process(a);
+
+    if (parser.isSet(supportedImageFormats)) {
+#if QT_VERSION < QT_VERSION_CHECK(6, 9, 0)
+        fputs(qPrintable(MainWindow::supportedImageFormats().join(QChar('\n'))), stdout);
+        ::exit(EXIT_SUCCESS);
+#else
+        QCommandLineParser::showMessageAndExit(QCommandLineParser::MessageType::Information,
+                                               MainWindow::supportedImageFormats().join(QChar('\n')));
+#endif
+    }
+
+    MainWindow w;
+    w.show();
+
+#ifdef Q_OS_MACOS
+    FileOpenEventHandler * fileOpenEventHandler = new FileOpenEventHandler(&a);
+    a.installEventFilter(fileOpenEventHandler);
+    a.connect(fileOpenEventHandler, &FileOpenEventHandler::fileOpen, [&w](const QUrl & url){
+        if (w.isHidden()) {
+            w.showNormal();
+        } else {
+            w.activateWindow();
+        }
+        w.showFiles({url});
+        w.initWindowSize();
+    });
+
+    // Handle dock icon clicks to show hidden window
+    a.connect(&a, &QApplication::applicationStateChanged, [&w](Qt::ApplicationState state) {
+        if (state == Qt::ApplicationActive && w.isHidden()) {
+            w.showFiles({});
+            w.galleryCurrent(false);
+            w.showNormal();
+            w.raise();
+            w.activateWindow();
+        }
+    });
+#endif // Q_OS_MACOS
+
+    QStringList fileList = parser.positionalArguments();
+    w.showFiles(fileList);
+
+    w.initWindowSize();
+
+    return QApplication::exec();
+}

app/mainwindow.h

@@ -1,120 +1,97 @@
-// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
-//
-// SPDX-License-Identifier: MIT
-
-#ifndef MAINWINDOW_H
-#define MAINWINDOW_H
-
-#include "framelesswindow.h"
-
-#include <QParallelAnimationGroup>
-#include <QPropertyAnimation>
-#include <QPushButton>
-
-#if QT_VERSION >= QT_VERSION_CHECK(6, 0, 0)
-    typedef QEnterEvent QT_ENTER_EVENT;
-#else
-    typedef QEvent QT_ENTER_EVENT;
-#endif // QT_VERSION_CHECK(6, 0, 0)
-
-QT_BEGIN_NAMESPACE
-class QGraphicsOpacityEffect;
-class QGraphicsView;
-QT_END_NAMESPACE
-
-class ActionManager;
-class PlaylistManager;
-class ToolButton;
-class GraphicsView;
-class NavigatorView;
-class BottomButtonGroup;
-class MainWindow : public FramelessWindow
-{
-    Q_OBJECT
-
-public:
-    explicit MainWindow(QWidget *parent = nullptr);
-    ~MainWindow() override;
-
-    void showUrls(const QList<QUrl> &urls);
-    void initWindowSize();
-    void adjustWindowSizeBySceneRect();
-    QUrl currentImageFileUrl() const;
-
-    void clearGallery();
-    void loadGalleryBySingleLocalFile(const QString &path);
-    void galleryPrev();
-    void galleryNext();
-
-protected slots:
-    void showEvent(QShowEvent *event) override;
-    void enterEvent(QT_ENTER_EVENT *event) override;
-    void leaveEvent(QEvent *event) override;
-    void mousePressEvent(QMouseEvent *event) override;
-    void mouseMoveEvent(QMouseEvent *event) override;
-    void mouseReleaseEvent(QMouseEvent *event) override;
-    void mouseDoubleClickEvent(QMouseEvent *event) override;
-    void wheelEvent(QWheelEvent *event) override;
-    void resizeEvent(QResizeEvent *event) override;
-    void contextMenuEvent(QContextMenuEvent *event) override;
-
-    void centerWindow();
-    void closeWindow();
-    void updateWidgetsPosition();
-    void toggleProtectedMode();
-    void toggleStayOnTop();
-    bool stayOnTop() const;
-    bool canPaste() const;
-    void quitAppAction(bool force = false);
-    void toggleFullscreen();
-    void toggleMaximize();
-
-protected:
-    QSize sizeHint() const override;
-
-private slots:
-    void on_actionOpen_triggered();
-
-    void on_actionActualSize_triggered();
-    void on_actionToggleMaximize_triggered();
-    void on_actionZoomIn_triggered();
-    void on_actionZoomOut_triggered();
-    void on_actionToggleCheckerboard_triggered();
-    void on_actionRotateClockwise_triggered();
-
-    void on_actionPrevPicture_triggered();
-    void on_actionNextPicture_triggered();
-
-    void on_actionHorizontalFlip_triggered();
-    void on_actionFitInView_triggered();
-    void on_actionFitByWidth_triggered();
-    void on_actionCopyPixmap_triggered();
-    void on_actionCopyFilePath_triggered();
-    void on_actionPaste_triggered();
-    void on_actionToggleStayOnTop_triggered();
-    void on_actionToggleProtectMode_triggered();
-    void on_actionSettings_triggered();
-    void on_actionHelp_triggered();
-    void on_actionProperties_triggered();
-    void on_actionLocateInFileManager_triggered();
-    void on_actionQuitApp_triggered();
-
-private:
-    ActionManager *m_am;
-    PlaylistManager *m_pm;
-
-    QPoint m_oldMousePos;
-    QPropertyAnimation *m_fadeOutAnimation;
-    QPropertyAnimation *m_floatUpAnimation;
-    QParallelAnimationGroup *m_exitAnimationGroup;
-    ToolButton *m_closeButton;
-    ToolButton *m_prevButton;
-    ToolButton *m_nextButton;
-    GraphicsView *m_graphicsView;
-    NavigatorView *m_gv;
-    BottomButtonGroup *m_bottomButtonGroup;
-    bool m_protectedMode = false;
-    bool m_clickedOnWindow = false;
-};
-
-#endif // MAINWINDOW_H
+// SPDX-FileCopyrightText: 2025 Gary Wang <git@blumia.net>
+//
+// SPDX-License-Identifier: MIT
+
+#ifndef MAINWINDOW_H
+#define MAINWINDOW_H
+
+#include <QWidget>
+
+QT_BEGIN_NAMESPACE
+class QFileSystemWatcher;
+namespace Ui {
+class MainWindow;
+}
+QT_END_NAMESPACE
+
+class ActionManager;
+class PlaylistManager;
+
+class MainWindow : public QWidget
+{
+    Q_OBJECT
+
+public:
+    explicit MainWindow(QWidget *parent = nullptr);
+    ~MainWindow() override;
+
+    void showFiles(const QStringList& files);
+    void showFiles(const QList<QUrl>& urls);
+    void initWindowSize();
+
+    void clearGallery();
+    void galleryPrev();
+    void galleryNext();
+    void galleryCurrent(bool fromFileWatcher);
+
+    static QStringList supportedImageFormats();
+
+protected slots:
+    void wheelEvent(QWheelEvent *event) override;
+    void contextMenuEvent(QContextMenuEvent *event) override;
+    void dragEnterEvent(QDragEnterEvent *event) override;
+    void dragMoveEvent(QDragMoveEvent *event) override;
+    void dropEvent(QDropEvent *event) override;
+
+    void centerWindow();
+    void toggleAvoidResetTransform();
+    void toggleFullscreen();
+    void toggleMaximize();
+
+protected:
+    QSize sizeHint() const override;
+
+private slots:
+    void on_actionCopyPixmap_triggered();
+    void on_actionCopyFilePath_triggered();
+
+    void on_actionPrevPicture_triggered();
+    void on_actionNextPicture_triggered();
+
+    void on_actionActualSize_triggered();
+    void on_actionFitToScreen_triggered();
+    void on_actionFitByWidth_triggered();
+    void on_actionFitByHeight_triggered();
+    void on_actionZoomIn_triggered();
+    void on_actionZoomOut_triggered();
+
+    void on_actionFlipHorizontal_triggered();
+    void on_actionFlipVertical_triggered();
+    void on_actionRotateClockwise_triggered();
+    void on_actionRotateCounterClockwise_triggered();
+
+    void on_actionToggleAvoidResetTransform_triggered();
+    void on_actionToggleCheckerboard_triggered();
+    void on_actionTogglePauseAnimation_triggered();
+    void on_actionAnimationNextFrame_triggered();
+
+    void on_actionTrash_triggered();
+    void on_actionLocateInFileManager_triggered();
+    void on_actionProperties_triggered();
+
+    void on_actionSettings_triggered();
+    void on_actionHelp_triggered();
+
+private:
+    bool updateFileWatcher(const QString & basePath = QString());
+    void updateActionState();
+
+private:
+    QT_PREPEND_NAMESPACE(Ui::MainWindow) *ui;
+    
+    ActionManager *m_am;
+    PlaylistManager *m_pm;
+    QFileSystemWatcher *m_fileSystemWatcher;
+};
+
+#endif // MAINWINDOW_H

app/mainwindow.ui

@@ -0,0 +1,169 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<ui version="4.0">
+ <class>MainWindow</class>
+ <widget class="QWidget" name="MainWindow">
+  <property name="windowModality">
+   <enum>Qt::NonModal</enum>
+  </property>
+  <property name="minimumSize">
+   <size>
+    <width>640</width>
+    <height>480</height>
+   </size>
+  </property>
+  <property name="acceptDrops">
+   <bool>true</bool>
+  </property>
+  <layout class="QVBoxLayout" name="m_centralLayout">
+   <property name="spacing">
+    <number>0</number>
+   </property>
+   <property name="leftMargin">
+    <number>0</number>
+   </property>
+   <property name="topMargin">
+    <number>0</number>
+   </property>
+   <property name="rightMargin">
+    <number>0</number>
+   </property>
+   <property name="bottomMargin">
+    <number>0</number>
+   </property>
+   <item>
+    <widget class="GraphicsView" name="m_gv">
+     <property name="frameShape">
+      <enum>QFrame::NoFrame</enum>
+     </property>
+     <property name="verticalScrollBarPolicy">
+      <enum>Qt::ScrollBarAlwaysOff</enum>
+     </property>
+     <property name="horizontalScrollBarPolicy">
+      <enum>Qt::ScrollBarAlwaysOff</enum>
+     </property>
+    </widget>
+   </item>
+   <item>
+    <widget class="QWidget" name="bottomBar" native="true">
+     <property name="minimumSize">
+      <size>
+       <width>0</width>
+       <height>72</height>
+      </size>
+     </property>
+     <property name="maximumSize">
+      <size>
+       <width>16777215</width>
+       <height>72</height>
+      </size>
+     </property>
+     <layout class="QHBoxLayout" name="bottomBarLayout">
+      <property name="spacing">
+       <number>0</number>
+      </property>
+      <property name="leftMargin">
+       <number>0</number>
+      </property>
+      <property name="topMargin">
+       <number>0</number>
+      </property>
+      <property name="rightMargin">
+       <number>0</number>
+      </property>
+      <property name="bottomMargin">
+       <number>0</number>
+      </property>
+      <item>
+       <widget class="QWidget" name="m_navPH" native="true">
+        <property name="minimumSize">
+         <size>
+          <width>99</width>
+          <height>72</height>
+         </size>
+        </property>
+        <property name="maximumSize">
+         <size>
+          <width>99</width>
+          <height>72</height>
+         </size>
+        </property>
+       </widget>
+      </item>
+      <item>
+       <spacer name="leftSpacer">
+        <property name="orientation">
+         <enum>Qt::Horizontal</enum>
+        </property>
+       </spacer>
+      </item>
+      <item>
+       <widget class="BottomButtonGroup" name="m_bottomButtonGroup"/>
+      </item>
+      <item>
+       <spacer name="rightSpacer">
+        <property name="orientation">
+         <enum>Qt::Horizontal</enum>
+        </property>
+       </spacer>
+      </item>
+      <item>
+       <widget class="NavigatorView" name="m_nav">
+        <property name="minimumSize">
+         <size>
+          <width>99</width>
+          <height>72</height>
+         </size>
+        </property>
+        <property name="maximumSize">
+         <size>
+          <width>99</width>
+          <height>72</height>
+         </size>
+        </property>
+        <property name="frameShape">
+         <enum>QFrame::NoFrame</enum>
+        </property>
+        <property name="verticalScrollBarPolicy">
+         <enum>Qt::ScrollBarAlwaysOff</enum>
+        </property>
+        <property name="horizontalScrollBarPolicy">
+         <enum>Qt::ScrollBarAlwaysOff</enum>
+        </property>
+       </widget>
+      </item>
+     </layout>
+    </widget>
+   </item>
+  </layout>
+  <widget class="QMenu" name="m_subMenuCopy">
+   <property name="title">
+    <string>&amp;Copy</string>
+   </property>
+  </widget>
+  <widget class="QMenu" name="m_subMenuTransform">
+   <property name="title">
+    <string>&amp;Transform</string>
+   </property>
+  </widget>
+  <widget class="QMenu" name="m_menu"/>
+ </widget>
+ <customwidgets>
+  <customwidget>
+   <class>GraphicsView</class>
+   <extends>QGraphicsView</extends>
+   <header>graphicsview.h</header>
+  </customwidget>
+  <customwidget>
+   <class>NavigatorView</class>
+   <extends>QGraphicsView</extends>
+   <header>navigatorview.h</header>
+  </customwidget>
+  <customwidget>
+   <class>BottomButtonGroup</class>
+   <extends>QGroupBox</extends>
+   <header>bottombuttongroup.h</header>
+  </customwidget>
+ </customwidgets>
+ <resources/>
+ <connections/>
+</ui>

app/metadatadialog.cpp

@@ -1,110 +1,113 @@
-// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
-//
-// SPDX-License-Identifier: MIT
-
-#include "metadatadialog.h"
-
-#include <QDialogButtonBox>
-#include <QPainter>
-#include <QStyledItemDelegate>
-#include <QTreeView>
-#include <QVBoxLayout>
-#include <QHeaderView>
-
-#include "metadatamodel.h"
-
-class PropertyTreeView : public QTreeView
-{
-public:
-    explicit PropertyTreeView(QWidget* parent) : QTreeView(parent) {}
-    ~PropertyTreeView() {}
-
-protected:
-    void rowsInserted(const QModelIndex& parent, int start, int end) override
-    {
-        QTreeView::rowsInserted(parent, start, end);
-        if (!parent.isValid()) {
-            // we are inserting a section group
-            for (int row = start; row <= end; ++row) {
-                setupSection(row);
-            }
-        } else {
-            // we are inserting a property
-            setRowHidden(parent.row(), QModelIndex(), false);
-        }
-    }
-
-    void reset() override
-    {
-        QTreeView::reset();
-        if (model()) {
-            for (int row = 0; row < model()->rowCount(); ++row) {
-                setupSection(row);
-            }
-        }
-    }
-
-private:
-    void setupSection(int row)
-    {
-        expand(model()->index(row, 0));
-        setFirstColumnSpanned(row, QModelIndex(), true);
-        setRowHidden(row, QModelIndex(), !model()->hasChildren(model()->index(row, 0)));
-    }
-};
-
-class PropertyTreeItemDelegate : public QStyledItemDelegate
-{
-public:
-    PropertyTreeItemDelegate(QObject* parent)
-        : QStyledItemDelegate(parent)
-    {}
-
-protected:
-    void paint(QPainter* painter, const QStyleOptionViewItem& option, const QModelIndex& index) const override
-    {
-        QStyleOptionViewItem opt = option;
-        if (!index.parent().isValid()) {
-            opt.font.setBold(true);
-            opt.features.setFlag(QStyleOptionViewItem::Alternate);
-        }
-        QStyledItemDelegate::paint(painter, opt, index);
-    }
-};
-
-MetadataDialog::MetadataDialog(QWidget *parent)
-    : QDialog(parent)
-    , m_treeView(new PropertyTreeView(this))
-{
-    m_treeView->setRootIsDecorated(false);
-    m_treeView->setIndentation(0);
-    m_treeView->setItemDelegate(new PropertyTreeItemDelegate(m_treeView));
-    m_treeView->header()->resizeSection(0, sizeHint().width() / 2);
-
-    setWindowTitle(tr("Image Metadata"));
-
-    QDialogButtonBox * buttonBox = new QDialogButtonBox(QDialogButtonBox::Close);
-
-    setLayout(new QVBoxLayout);
-    layout()->addWidget(m_treeView);
-    layout()->addWidget(buttonBox);
-
-    connect(buttonBox, &QDialogButtonBox::rejected, this, &QDialog::close);
-
-    setWindowFlag(Qt::WindowContextHelpButtonHint, false);
-}
-
-MetadataDialog::~MetadataDialog()
-{
-
-}
-
-void MetadataDialog::setMetadataModel(MetadataModel * model)
-{
-    m_treeView->setModel(model);
-}
-
-QSize MetadataDialog::sizeHint() const
-{
-    return QSize(520, 350);
-}
+// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
+//
+// SPDX-License-Identifier: MIT
+
+#include "metadatadialog.h"
+#include "ui_metadatadialog.h"
+
+#include <QDialogButtonBox>
+#include <QPainter>
+#include <QStyledItemDelegate>
+#include <QTreeView>
+#include <QHeaderView>
+
+#include "metadatamodel.h"
+
+class PropertyTreeView : public QTreeView
+{
+public:
+    explicit PropertyTreeView(QWidget* parent) : QTreeView(parent) {}
+    ~PropertyTreeView() {}
+
+protected:
+    void rowsInserted(const QModelIndex& parent, int start, int end) override
+    {
+        QTreeView::rowsInserted(parent, start, end);
+        if (!parent.isValid()) {
+            // we are inserting a section group
+            for (int row = start; row <= end; ++row) {
+                setupSection(row);
+            }
+        } else {
+            // we are inserting a property
+            setRowHidden(parent.row(), QModelIndex(), false);
+        }
+    }
+
+    void reset() override
+    {
+        QTreeView::reset();
+        if (model()) {
+            for (int row = 0; row < model()->rowCount(); ++row) {
+                setupSection(row);
+            }
+        }
+    }
+
+private:
+    void setupSection(int row)
+    {
+        expand(model()->index(row, 0));
+        setFirstColumnSpanned(row, QModelIndex(), true);
+        setRowHidden(row, QModelIndex(), !model()->hasChildren(model()->index(row, 0)));
+    }
+};
+
+class PropertyTreeItemDelegate : public QStyledItemDelegate
+{
+public:
+    PropertyTreeItemDelegate(QObject* parent)
+        : QStyledItemDelegate(parent)
+    {}
+
+protected:
+    void paint(QPainter* painter, const QStyleOptionViewItem& option, const QModelIndex& index) const override
+    {
+        QStyleOptionViewItem opt = option;
+        if (!index.parent().isValid()) {
+            opt.font.setBold(true);
+            opt.features.setFlag(QStyleOptionViewItem::Alternate);
+        }
+        QStyledItemDelegate::paint(painter, opt, index);
+    }
+};
+
+MetadataDialog::MetadataDialog(QWidget *parent)
+    : QDialog(parent), ui(new QT_PREPEND_NAMESPACE(Ui::MetadataDialog))
+{
+    ui->setupUi(this);
+    setWindowFlag(Qt::WindowContextHelpButtonHint, false);
+
+    // YYC MARK:
+    // Because we use custom QTreeView and we do not want to expose it to public domain.
+    // So I have to use this way as the compromise.
+
+    // Create our custom QTreeView and insert them
+    m_treeView = new PropertyTreeView(this);
+    auto* layout = ui->verticalLayout;
+    const int index = layout->indexOf(ui->m_buttonBox);
+    layout->insertWidget(index, m_treeView);
+
+    // Setup our custom QTreeView
+    m_treeView->setRootIsDecorated(false);
+    m_treeView->setIndentation(0);
+    m_treeView->setItemDelegate(new PropertyTreeItemDelegate(m_treeView));
+    m_treeView->header()->resizeSection(0, sizeHint().width() / 2);
+
+    connect(ui->m_buttonBox, &QDialogButtonBox::rejected, this, &QDialog::close);
+}
+
+MetadataDialog::~MetadataDialog()
+{
+    delete ui;
+}
+
+void MetadataDialog::setMetadataModel(MetadataModel * model)
+{
+    m_treeView->setModel(model);
+}
+
+QSize MetadataDialog::sizeHint() const
+{
+    return QSize(520, 350);
+}

app/metadatadialog.h

@@ -1,30 +1,37 @@
-// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
-//
-// SPDX-License-Identifier: MIT
-
-#ifndef METADATADIALOG_H
-#define METADATADIALOG_H
-
-#include <QDialog>
-
-QT_BEGIN_NAMESPACE
-class QTreeView;
-QT_END_NAMESPACE
-
-class MetadataModel;
-class MetadataDialog : public QDialog
-{
-    Q_OBJECT
-public:
-    explicit MetadataDialog(QWidget * parent);
-    ~MetadataDialog() override;
-
-    void setMetadataModel(MetadataModel * model);
-
-    QSize sizeHint() const override;
-
-private:
-    QTreeView * m_treeView = nullptr;
-};
-
-#endif // METADATADIALOG_H
+// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
+//
+// SPDX-License-Identifier: MIT
+
+#ifndef METADATADIALOG_H
+#define METADATADIALOG_H
+
+#include <QDialog>
+
+QT_BEGIN_NAMESPACE
+class QTreeView;
+QT_END_NAMESPACE
+
+QT_BEGIN_NAMESPACE
+namespace Ui {
+class MetadataDialog;
+}
+QT_END_NAMESPACE
+
+class MetadataModel;
+class MetadataDialog : public QDialog
+{
+    Q_OBJECT
+public:
+    explicit MetadataDialog(QWidget * parent);
+    ~MetadataDialog() override;
+
+    void setMetadataModel(MetadataModel * model);
+
+    QSize sizeHint() const override;
+
+private:
+    QTreeView * m_treeView = nullptr;
+    QT_PREPEND_NAMESPACE(Ui::MetadataDialog) *ui;
+};
+
+#endif // METADATADIALOG_H

app/metadatadialog.ui

@@ -0,0 +1,23 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<ui version="4.0">
+ <class>MetadataDialog</class>
+ <widget class="QDialog" name="MetadataDialog">
+  <property name="windowModality">
+   <enum>Qt::NonModal</enum>
+  </property>
+  <property name="windowTitle">
+   <string>Image Metadata</string>
+  </property>
+  <layout class="QVBoxLayout" name="verticalLayout">
+   <item>
+    <widget class="QDialogButtonBox" name="m_buttonBox">
+     <property name="standardButtons">
+      <set>QDialogButtonBox::Close</set>
+     </property>
+    </widget>
+   </item>
+  </layout>
+ </widget>
+ <resources/>
+ <connections/>
+</ui>

app/metadatamodel.cpp

@@ -1,314 +1,320 @@
-// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
-//
-// SPDX-License-Identifier: MIT
-
-#include "metadatamodel.h"
-#include "exiv2wrapper.h"
-
-#include <QDir>
-#include <QDebug>
-#include <QDateTime>
-#include <QFileInfo>
-#include <QImageReader>
-
-MetadataModel::MetadataModel(QObject *parent)
-    : QAbstractItemModel(parent)
-{
-
-}
-
-MetadataModel::~MetadataModel()
-{
-
-}
-
-void MetadataModel::setFile(const QString &imageFilePath)
-{
-    QFileInfo fileInfo(imageFilePath);
-    // It'll be fine if we don't re-use the image reader we pass to the graphics scene for now.
-    QImageReader imgReader(imageFilePath);
-    imgReader.setAutoTransform(true);
-    imgReader.setDecideFormatFromContent(true);
-
-    const QString & itemTypeString = tr("%1 File").arg(QString(imgReader.format().toUpper()));
-    const QString & sizeString = QLocale().formattedDataSize(fileInfo.size());
-    const QString & birthTimeString = QLocale().toString(fileInfo.birthTime(), QLocale::LongFormat);
-    const QString & lastModifiedTimeString = QLocale().toString(fileInfo.lastModified(), QLocale::LongFormat);
-    const QString & imageDimensionsString = imageSize(imgReader.size());
-    const QString & imageRatioString = imageSizeRatio(imgReader.size());
-
-    appendSection(QStringLiteral("Description"), tr("Description", "Section name."));
-    appendSection(QStringLiteral("Origin"), tr("Origin", "Section name."));
-    appendSection(QStringLiteral("Image"), tr("Image", "Section name."));
-    appendSection(QStringLiteral("Camera"), tr("Camera", "Section name."));
-    appendSection(QStringLiteral("AdvancedPhoto"), tr("Advanced photo", "Section name."));
-    appendSection(QStringLiteral("GPS"), tr("GPS", "Section name."));
-    appendSection(QStringLiteral("File"), tr("File", "Section name."));
-
-    if (imgReader.supportsOption(QImageIOHandler::Size)) {
-        appendProperty(QStringLiteral("Image"), QStringLiteral("Image.Dimensions"),
-                       tr("Dimensions"), imageDimensionsString);
-        appendProperty(QStringLiteral("Image"), QStringLiteral("Image.SizeRatio"),
-                       tr("Aspect ratio"), imageRatioString);
-    }
-    if (imgReader.supportsAnimation() && imgReader.imageCount() > 1) {
-        appendProperty(QStringLiteral("Image"), QStringLiteral("Image.FrameCount"),
-                       tr("Frame count"), QString::number(imgReader.imageCount()));
-    }
-
-    appendProperty(QStringLiteral("File"), QStringLiteral("File.Name"),
-                   tr("Name"), fileInfo.fileName());
-    appendProperty(QStringLiteral("File"), QStringLiteral("File.ItemType"),
-                   tr("Item type"), itemTypeString);
-    appendProperty(QStringLiteral("File"), QStringLiteral("File.Path"),
-                   tr("Folder path"), QDir::toNativeSeparators(fileInfo.path()));
-    appendProperty(QStringLiteral("File"), QStringLiteral("File.Size"),
-                   tr("Size"), sizeString);
-    appendProperty(QStringLiteral("File"), QStringLiteral("File.CreatedTime"),
-                   tr("Date created"), birthTimeString);
-    appendProperty(QStringLiteral("File"), QStringLiteral("File.LastModified"),
-                   tr("Date modified"), lastModifiedTimeString);
-
-    Exiv2Wrapper wrapper;
-    if (wrapper.load(imageFilePath)) {
-        wrapper.cacheSections();
-
-        appendExivPropertyIfExist(wrapper, QStringLiteral("Description"),
-                                  QStringLiteral("Xmp.dc.title"), tr("Title"), true);
-        appendExivPropertyIfExist(wrapper, QStringLiteral("Description"),
-                                  QStringLiteral("Exif.Image.ImageDescription"), tr("Subject"), true);
-        appendExivPropertyIfExist(wrapper, QStringLiteral("Description"),
-                                  QStringLiteral("Exif.Image.Rating"), tr("Rating"));
-        appendExivPropertyIfExist(wrapper, QStringLiteral("Description"),
-                                  QStringLiteral("Xmp.dc.subject"), tr("Tags"));
-        appendPropertyIfNotEmpty(QStringLiteral("Description"), QStringLiteral("Description.Comments"),
-                                 tr("Comments"), wrapper.comment());
-
-        appendExivPropertyIfExist(wrapper, QStringLiteral("Origin"),
-                                  QStringLiteral("Exif.Image.Artist"), tr("Authors"));
-        appendExivPropertyIfExist(wrapper, QStringLiteral("Origin"),
-                                  QStringLiteral("Exif.Photo.DateTimeOriginal"), tr("Date taken"));
-        // FIXME: We may fetch the same type of metadata from different metadata collection.
-        //        Current implementation is not pretty and may need to do a rework...
-        // appendExivPropertyIfExist(wrapper, QStringLiteral("Origin"),
-        //                                  QStringLiteral("Xmp.xmp.CreatorTool"), tr("Program name"));
-        appendExivPropertyIfExist(wrapper, QStringLiteral("Origin"),
-                                  QStringLiteral("Exif.Image.Software"), tr("Program name"));
-        appendExivPropertyIfExist(wrapper, QStringLiteral("Origin"),
-                                  QStringLiteral("Exif.Image.Copyright"), tr("Copyright"));
-
-        appendExivPropertyIfExist(wrapper, QStringLiteral("Image"),
-                                  QStringLiteral("Exif.Image.XResolution"), tr("Horizontal resolution"));
-        appendExivPropertyIfExist(wrapper, QStringLiteral("Image"),
-                                  QStringLiteral("Exif.Image.YResolution"), tr("Vertical resolution"));
-        appendExivPropertyIfExist(wrapper, QStringLiteral("Image"),
-                                  QStringLiteral("Exif.Image.ResolutionUnit"), tr("Resolution unit"));
-        appendExivPropertyIfExist(wrapper, QStringLiteral("Image"),
-                                  QStringLiteral("Exif.Photo.ColorSpace"), tr("Colour representation"));
-
-        appendExivPropertyIfExist(wrapper, QStringLiteral("Camera"),
-                                  QStringLiteral("Exif.Image.Make"), tr("Camera maker"));
-        appendExivPropertyIfExist(wrapper, QStringLiteral("Camera"),
-                                  QStringLiteral("Exif.Image.Model"), tr("Camera model"));
-        appendExivPropertyIfExist(wrapper, QStringLiteral("Camera"),
-                                  QStringLiteral("Exif.Photo.FNumber"), tr("F-stop"));
-        appendExivPropertyIfExist(wrapper, QStringLiteral("Camera"),
-                                  QStringLiteral("Exif.Photo.ExposureTime"), tr("Exposure time"));
-        appendExivPropertyIfExist(wrapper, QStringLiteral("Camera"),
-                                  QStringLiteral("Exif.Photo.ISOSpeedRatings"), tr("ISO speed"));
-        appendExivPropertyIfExist(wrapper, QStringLiteral("Camera"),
-                                  QStringLiteral("Exif.Photo.ExposureBiasValue"), tr("Exposure bias"));
-        appendExivPropertyIfExist(wrapper, QStringLiteral("Camera"),
-                                  QStringLiteral("Exif.Photo.FocalLength"), tr("Focal length"));
-        appendExivPropertyIfExist(wrapper, QStringLiteral("Camera"),
-                                  QStringLiteral("Exif.Photo.MaxApertureValue"), tr("Max aperture"));
-        appendExivPropertyIfExist(wrapper, QStringLiteral("Camera"),
-                                  QStringLiteral("Exif.Photo.MeteringMode"), tr("Metering mode"));
-        appendExivPropertyIfExist(wrapper, QStringLiteral("Camera"),
-                                  QStringLiteral("Exif.Photo.Flash"), tr("Flash mode"));
-        appendExivPropertyIfExist(wrapper, QStringLiteral("Camera"),
-                                  QStringLiteral("Exif.Photo.FocalLengthIn35mmFilm"), tr("35mm focal length"));
-
-        appendExivPropertyIfExist(wrapper, QStringLiteral("AdvancedPhoto"),
-                                  QStringLiteral("Exif.Photo.LensModel"), tr("Lens model"));
-        appendExivPropertyIfExist(wrapper, QStringLiteral("AdvancedPhoto"),
-                                  QStringLiteral("Exif.Photo.BrightnessValue"), tr("Brightness"));
-        appendExivPropertyIfExist(wrapper, QStringLiteral("AdvancedPhoto"),
-                                  QStringLiteral("Exif.Photo.ExposureProgram"), tr("Exposure program"));
-        appendExivPropertyIfExist(wrapper, QStringLiteral("AdvancedPhoto"),
-                                  QStringLiteral("Exif.Photo.Saturation"), tr("Saturation"));
-        appendExivPropertyIfExist(wrapper, QStringLiteral("AdvancedPhoto"),
-                                  QStringLiteral("Exif.Photo.Sharpness"), tr("Sharpness"));
-        appendExivPropertyIfExist(wrapper, QStringLiteral("AdvancedPhoto"),
-                                  QStringLiteral("Exif.Photo.WhiteBalance"), tr("White balance"));
-        appendExivPropertyIfExist(wrapper, QStringLiteral("AdvancedPhoto"),
-                                  QStringLiteral("Exif.Photo.DigitalZoomRatio"), tr("Digital zoom"));
-        appendExivPropertyIfExist(wrapper, QStringLiteral("AdvancedPhoto"),
-                                  QStringLiteral("Exif.Photo.ExifVersion"), tr("EXIF version"));
-
-        appendExivPropertyIfExist(wrapper, QStringLiteral("GPS"),
-                                  QStringLiteral("Exif.GPSInfo.GPSLatitudeRef"), tr("Latitude reference"));
-        appendExivPropertyIfExist(wrapper, QStringLiteral("GPS"),
-                                  QStringLiteral("Exif.GPSInfo.GPSLatitude"), tr("Latitude"));
-        appendExivPropertyIfExist(wrapper, QStringLiteral("GPS"),
-                                  QStringLiteral("Exif.GPSInfo.GPSLongitudeRef"), tr("Longitude reference"));
-        appendExivPropertyIfExist(wrapper, QStringLiteral("GPS"),
-                                  QStringLiteral("Exif.GPSInfo.GPSLongitude"), tr("Longitude"));
-        appendExivPropertyIfExist(wrapper, QStringLiteral("GPS"),
-                                  QStringLiteral("Exif.GPSInfo.GPSAltitudeRef"), tr("Altitude reference"));
-        appendExivPropertyIfExist(wrapper, QStringLiteral("GPS"),
-                                  QStringLiteral("Exif.GPSInfo.GPSAltitude"), tr("Altitude"));
-
-    }
-}
-
-QString MetadataModel::imageSize(const QSize &size)
-{
-    QString imageSize;
-
-    if (size.isValid()) {
-        imageSize = tr("%1 x %2").arg(QString::number(size.width()), QString::number(size.height()));
-    } else {
-        imageSize = QLatin1Char('-');
-    }
-
-    return imageSize;
-}
-
-int simplegcd(int a, int b) {
-    return b == 0 ? a : simplegcd(b, a % b);
-}
-
-QString MetadataModel::imageSizeRatio(const QSize &size)
-{
-    if (!size.isValid()) {
-        return QStringLiteral("-");
-    }
-    int gcd = simplegcd(size.width(), size.height());
-    return tr("%1 : %2").arg(QString::number(size.width() / gcd), QString::number(size.height() / gcd));
-}
-
-bool MetadataModel::appendSection(const QString &sectionKey, QStringView sectionDisplayName)
-{
-    if (m_sections.contains(sectionKey)) {
-        return false;
-    }
-
-    m_sections.append(sectionKey);
-    m_sectionProperties[sectionKey] = qMakePair<QString, QList<QString> >(sectionDisplayName.toString(), {});
-
-    return true;
-}
-
-bool MetadataModel::appendPropertyIfNotEmpty(const QString &sectionKey, const QString &propertyKey, const QString &propertyDisplayName, const QString &propertyValue)
-{
-    if (propertyValue.isEmpty()) return false;
-
-    return appendProperty(sectionKey, propertyKey, propertyDisplayName, propertyValue);
-}
-
-bool MetadataModel::appendProperty(const QString &sectionKey, const QString &propertyKey, QStringView propertyDisplayName, QStringView propertyValue)
-{
-    if (!m_sections.contains(sectionKey)) {
-        return false;
-    }
-
-    QList<QString> & propertyList = m_sectionProperties[sectionKey].second;
-    if (!propertyList.contains(propertyKey)) {
-        propertyList.append(propertyKey);
-    }
-
-    m_properties[propertyKey] = qMakePair<QString, QString>(propertyDisplayName.toString(), propertyValue.toString());
-
-    return true;
-}
-
-bool MetadataModel::appendExivPropertyIfExist(const Exiv2Wrapper &wrapper, const QString &sectionKey, const QString &exiv2propertyKey, const QString &propertyDisplayName, bool isXmpString)
-{
-    const QString & value = wrapper.value(exiv2propertyKey);
-    if (!value.isEmpty()) {
-        appendProperty(sectionKey, exiv2propertyKey,
-                       propertyDisplayName.isEmpty() ? wrapper.label(exiv2propertyKey) : propertyDisplayName,
-                       isXmpString ? Exiv2Wrapper::XmpValue(value) : value);
-        return true;
-    }
-    return false;
-}
-
-QModelIndex MetadataModel::index(int row, int column, const QModelIndex &parent) const
-{
-    if (!hasIndex(row, column, parent)) {
-        return QModelIndex();
-    }
-
-    if (!parent.isValid()) {
-        return createIndex(row, column, RowType::SectionRow);
-    } else {
-        // internalid param: row means nth section it belongs to.
-        return createIndex(row, column, RowType::PropertyRow + parent.row());
-    }
-}
-
-QModelIndex MetadataModel::parent(const QModelIndex &child) const
-{
-    if (!child.isValid()) {
-        return QModelIndex();
-    }
-
-    if (child.internalId() == RowType::SectionRow) {
-        return QModelIndex();
-    } else {
-        return createIndex(child.internalId() - RowType::PropertyRow, 0, SectionRow);
-    }
-}
-
-int MetadataModel::rowCount(const QModelIndex &parent) const
-{
-    if (!parent.isValid()) {
-        return m_sections.count();
-    }
-
-    if (parent.internalId() == RowType::SectionRow) {
-        const QString & sectionKey = m_sections[parent.row()];
-        return m_sectionProperties[sectionKey].second.count();
-    }
-
-    return 0;
-}
-
-int MetadataModel::columnCount(const QModelIndex &) const
-{
-    // Always key(display name) and value.
-    return 2;
-}
-
-QVariant MetadataModel::data(const QModelIndex &index, int role) const
-{
-    if (!index.isValid()) {
-        return QVariant();
-    }
-
-    if (role != Qt::DisplayRole) {
-        return QVariant();
-    }
-
-    if (index.internalId() == RowType::SectionRow) {
-        return (index.column() == 0) ? m_sectionProperties[m_sections[index.row()]].first
-                                     : QVariant();
-    } else {
-        int sectionIndex = index.internalId() - RowType::PropertyRow;
-        const QString & sectionKey = m_sections[sectionIndex];
-        const QList<QString> & propertyList = m_sectionProperties[sectionKey].second;
-        return (index.column() == 0) ? m_properties[propertyList[index.row()]].first
-                                     : m_properties[propertyList[index.row()]].second;
-    }
-}
-
-QVariant MetadataModel::headerData(int section, Qt::Orientation orientation, int role) const
-{
-    if (orientation == Qt::Vertical || role != Qt::DisplayRole) {
-        return QVariant();
-    }
-
-    return section == 0 ? tr("Property") : tr("Value");
-}
+// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
+//
+// SPDX-License-Identifier: MIT
+
+#include "metadatamodel.h"
+#include "exiv2wrapper.h"
+
+#include <QDir>
+#include <QDebug>
+#include <QDateTime>
+#include <QFileInfo>
+#include <QImageReader>
+
+using namespace Qt::Literals::StringLiterals;
+
+MetadataModel::MetadataModel(QObject *parent)
+    : QAbstractItemModel(parent)
+{
+
+}
+
+MetadataModel::~MetadataModel()
+{
+
+}
+
+void MetadataModel::setFile(const QString &imageFilePath)
+{
+    QFileInfo fileInfo(imageFilePath);
+    // It'll be fine if we don't re-use the image reader we pass to the graphics scene for now.
+    QImageReader imgReader(imageFilePath);
+    imgReader.setAutoTransform(true);
+    imgReader.setDecideFormatFromContent(true);
+
+    const QString & itemTypeString = tr("%1 File").arg(QString(imgReader.format().toUpper()));
+    const QString & sizeString = QLocale().formattedDataSize(fileInfo.size());
+    const QString & birthTimeString = QLocale().toString(fileInfo.birthTime(), QLocale::LongFormat);
+    const QString & lastModifiedTimeString = QLocale().toString(fileInfo.lastModified(), QLocale::LongFormat);
+    const QString & imageDimensionsString = imageSize(imgReader.size());
+    const QString & imageRatioString = imageSizeRatio(imgReader.size());
+
+    appendSection(u"Description"_s, tr("Description", "Section name."));
+    appendSection(u"Origin"_s, tr("Origin", "Section name."));
+    appendSection(u"Image"_s, tr("Image", "Section name."));
+    appendSection(u"Camera"_s, tr("Camera", "Section name."));
+    appendSection(u"AdvancedPhoto"_s, tr("Advanced photo", "Section name."));
+    appendSection(u"GPS"_s, tr("GPS", "Section name."));
+    appendSection(u"File"_s, tr("File", "Section name."));
+
+    if (imgReader.supportsOption(QImageIOHandler::Size)) {
+        appendProperty(u"Image"_s, u"Image.Dimensions"_s,
+                       tr("Dimensions"), imageDimensionsString);
+        appendProperty(u"Image"_s, u"Image.SizeRatio"_s,
+                       tr("Aspect ratio"), imageRatioString);
+    }
+    if (imgReader.supportsAnimation() && imgReader.imageCount() > 1) {
+        appendProperty(u"Image"_s, u"Image.FrameCount"_s,
+                       tr("Frame count"), QString::number(imgReader.imageCount()));
+    }
+
+    appendProperty(u"File"_s, u"File.Name"_s,
+                   tr("Name"), fileInfo.fileName());
+    appendProperty(u"File"_s, u"File.ItemType"_s,
+                   tr("Item type"), itemTypeString);
+    appendProperty(u"File"_s, u"File.Path"_s,
+                   tr("Folder path"), QDir::toNativeSeparators(fileInfo.path()));
+    appendProperty(u"File"_s, u"File.Size"_s,
+                   tr("Size"), sizeString);
+    appendProperty(u"File"_s, u"File.CreatedTime"_s,
+                   tr("Date created"), birthTimeString);
+    appendProperty(u"File"_s, u"File.LastModified"_s,
+                   tr("Date modified"), lastModifiedTimeString);
+
+    Exiv2Wrapper wrapper;
+    if (wrapper.load(imageFilePath)) {
+        wrapper.cacheSections();
+
+        appendExivPropertyIfExist(wrapper, u"Description"_s,
+                                  u"Xmp.dc.title"_s, tr("Title"), true);
+        appendExivPropertyIfExist(wrapper, u"Description"_s,
+                                  u"Exif.Image.ImageDescription"_s, tr("Subject"), true);
+        appendExivPropertyIfExist(wrapper, u"Description"_s,
+                                  u"Exif.Image.Rating"_s, tr("Rating"));
+        appendExivPropertyIfExist(wrapper, u"Description"_s,
+                                  u"Xmp.dc.subject"_s, tr("Tags"));
+        appendPropertyIfNotEmpty(u"Description"_s, u"Description.Comments"_s,
+                                 tr("Comments"), wrapper.comment());
+
+        appendExivPropertyIfExist(wrapper, u"Origin"_s,
+                                  u"Exif.Image.Artist"_s, tr("Authors"));
+        appendExivPropertyIfExist(wrapper, u"Origin"_s,
+                                  u"Exif.Photo.DateTimeOriginal"_s, tr("Date taken"));
+        // FIXME: We may fetch the same type of metadata from different metadata collection.
+        //        Current implementation is not pretty and may need to do a rework...
+        // appendExivPropertyIfExist(wrapper, QStringLiteral("Origin"),
+        //                                  QStringLiteral("Xmp.xmp.CreatorTool"), tr("Program name"));
+        appendExivPropertyIfExist(wrapper, u"Origin"_s,
+                                  u"Exif.Image.Software"_s, tr("Program name"));
+        appendExivPropertyIfExist(wrapper, u"Origin"_s,
+                                  u"Exif.Image.Copyright"_s, tr("Copyright"));
+
+        appendExivPropertyIfExist(wrapper, u"Image"_s,
+                                  u"Exif.Image.XResolution"_s, tr("Horizontal resolution"));
+        appendExivPropertyIfExist(wrapper, u"Image"_s,
+                                  u"Exif.Image.YResolution"_s, tr("Vertical resolution"));
+        appendExivPropertyIfExist(wrapper, u"Image"_s,
+                                  u"Exif.Image.ResolutionUnit"_s, tr("Resolution unit"));
+        appendExivPropertyIfExist(wrapper, u"Image"_s,
+                                  u"Exif.Photo.ColorSpace"_s, tr("Colour representation"));
+
+        appendExivPropertyIfExist(wrapper, u"Camera"_s,
+                                  u"Exif.Image.Make"_s, tr("Camera maker"));
+        appendExivPropertyIfExist(wrapper, u"Camera"_s,
+                                  u"Exif.Image.Model"_s, tr("Camera model"));
+        appendExivPropertyIfExist(wrapper, u"Camera"_s,
+                                  u"Exif.Photo.FNumber"_s, tr("F-stop"));
+        appendExivPropertyIfExist(wrapper, u"Camera"_s,
+                                  u"Exif.Photo.ExposureTime"_s, tr("Exposure time"));
+        appendExivPropertyIfExist(wrapper, u"Camera"_s,
+                                  u"Exif.Photo.ISOSpeedRatings"_s, tr("ISO speed"));
+        appendExivPropertyIfExist(wrapper, u"Camera"_s,
+                                  u"Exif.Photo.ExposureBiasValue"_s, tr("Exposure bias"));
+        appendExivPropertyIfExist(wrapper, u"Camera"_s,
+                                  u"Exif.Photo.FocalLength"_s, tr("Focal length"));
+        appendExivPropertyIfExist(wrapper, u"Camera"_s,
+                                  u"Exif.Photo.MaxApertureValue"_s, tr("Max aperture"));
+        appendExivPropertyIfExist(wrapper, u"Camera"_s,
+                                  u"Exif.Photo.MeteringMode"_s, tr("Metering mode"));
+        appendExivPropertyIfExist(wrapper, u"Camera"_s,
+                                  u"Exif.Photo.SubjectDistance"_s, tr("Subject distance"));
+        appendExivPropertyIfExist(wrapper, u"Camera"_s,
+                                  u"Exif.Photo.Flash"_s, tr("Flash mode"));
+        appendExivPropertyIfExist(wrapper, u"Camera"_s,
+                                  u"Exif.Photo.FocalLengthIn35mmFilm"_s, tr("35mm focal length"));
+
+        appendExivPropertyIfExist(wrapper, u"AdvancedPhoto"_s,
+                                  u"Exif.Photo.LensModel"_s, tr("Lens model"));
+        appendExivPropertyIfExist(wrapper, u"AdvancedPhoto"_s,
+                                  u"Exif.Photo.Contrast"_s, tr("Contrast"));
+        appendExivPropertyIfExist(wrapper, u"AdvancedPhoto"_s,
+                                  u"Exif.Photo.BrightnessValue"_s, tr("Brightness"));
+        appendExivPropertyIfExist(wrapper, u"AdvancedPhoto"_s,
+                                  u"Exif.Photo.ExposureProgram"_s, tr("Exposure program"));
+        appendExivPropertyIfExist(wrapper, u"AdvancedPhoto"_s,
+                                  u"Exif.Photo.Saturation"_s, tr("Saturation"));
+        appendExivPropertyIfExist(wrapper, u"AdvancedPhoto"_s,
+                                  u"Exif.Photo.Sharpness"_s, tr("Sharpness"));
+        appendExivPropertyIfExist(wrapper, u"AdvancedPhoto"_s,
+                                  u"Exif.Photo.WhiteBalance"_s, tr("White balance"));
+        appendExivPropertyIfExist(wrapper, u"AdvancedPhoto"_s,
+                                  u"Exif.Photo.DigitalZoomRatio"_s, tr("Digital zoom"));
+        appendExivPropertyIfExist(wrapper, u"AdvancedPhoto"_s,
+                                  u"Exif.Photo.ExifVersion"_s, tr("EXIF version"));
+
+        appendExivPropertyIfExist(wrapper, u"GPS"_s,
+                                  u"Exif.GPSInfo.GPSLatitudeRef"_s, tr("Latitude reference"));
+        appendExivPropertyIfExist(wrapper, u"GPS"_s,
+                                  u"Exif.GPSInfo.GPSLatitude"_s, tr("Latitude"));
+        appendExivPropertyIfExist(wrapper, u"GPS"_s,
+                                  u"Exif.GPSInfo.GPSLongitudeRef"_s, tr("Longitude reference"));
+        appendExivPropertyIfExist(wrapper, u"GPS"_s,
+                                  u"Exif.GPSInfo.GPSLongitude"_s, tr("Longitude"));
+        appendExivPropertyIfExist(wrapper, u"GPS"_s,
+                                  u"Exif.GPSInfo.GPSAltitudeRef"_s, tr("Altitude reference"));
+        appendExivPropertyIfExist(wrapper, u"GPS"_s,
+                                  u"Exif.GPSInfo.GPSAltitude"_s, tr("Altitude"));
+
+    }
+}
+
+QString MetadataModel::imageSize(const QSize &size)
+{
+    QString imageSize;
+
+    if (size.isValid()) {
+        imageSize = tr("%1 x %2").arg(QString::number(size.width()), QString::number(size.height()));
+    } else {
+        imageSize = QLatin1Char('-');
+    }
+
+    return imageSize;
+}
+
+int simplegcd(int a, int b) {
+    return b == 0 ? a : simplegcd(b, a % b);
+}
+
+QString MetadataModel::imageSizeRatio(const QSize &size)
+{
+    if (!size.isValid()) {
+        return QStringLiteral("-");
+    }
+    int gcd = simplegcd(size.width(), size.height());
+    return tr("%1 : %2").arg(QString::number(size.width() / gcd), QString::number(size.height() / gcd));
+}
+
+bool MetadataModel::appendSection(const QString &sectionKey, QStringView sectionDisplayName)
+{
+    if (m_sections.contains(sectionKey)) {
+        return false;
+    }
+
+    m_sections.append(sectionKey);
+    m_sectionProperties[sectionKey] = qMakePair<QString, QList<QString> >(sectionDisplayName.toString(), {});
+
+    return true;
+}
+
+bool MetadataModel::appendPropertyIfNotEmpty(const QString &sectionKey, const QString &propertyKey, const QString &propertyDisplayName, const QString &propertyValue)
+{
+    if (propertyValue.isEmpty()) return false;
+
+    return appendProperty(sectionKey, propertyKey, propertyDisplayName, propertyValue);
+}
+
+bool MetadataModel::appendProperty(const QString &sectionKey, const QString &propertyKey, QStringView propertyDisplayName, QStringView propertyValue)
+{
+    if (!m_sections.contains(sectionKey)) {
+        return false;
+    }
+
+    QList<QString> & propertyList = m_sectionProperties[sectionKey].second;
+    if (!propertyList.contains(propertyKey)) {
+        propertyList.append(propertyKey);
+    }
+
+    m_properties[propertyKey] = qMakePair<QString, QString>(propertyDisplayName.toString(), propertyValue.toString());
+
+    return true;
+}
+
+bool MetadataModel::appendExivPropertyIfExist(const Exiv2Wrapper &wrapper, const QString &sectionKey, const QString &exiv2propertyKey, const QString &propertyDisplayName, bool isXmpString)
+{
+    const QString & value = wrapper.value(exiv2propertyKey);
+    if (!value.isEmpty()) {
+        appendProperty(sectionKey, exiv2propertyKey,
+                       propertyDisplayName.isEmpty() ? wrapper.label(exiv2propertyKey) : propertyDisplayName,
+                       isXmpString ? Exiv2Wrapper::XmpValue(value) : value);
+        return true;
+    }
+    return false;
+}
+
+QModelIndex MetadataModel::index(int row, int column, const QModelIndex &parent) const
+{
+    if (!hasIndex(row, column, parent)) {
+        return QModelIndex();
+    }
+
+    if (!parent.isValid()) {
+        return createIndex(row, column, RowType::SectionRow);
+    } else {
+        // internalid param: row means nth section it belongs to.
+        return createIndex(row, column, RowType::PropertyRow + parent.row());
+    }
+}
+
+QModelIndex MetadataModel::parent(const QModelIndex &child) const
+{
+    if (!child.isValid()) {
+        return QModelIndex();
+    }
+
+    if (child.internalId() == RowType::SectionRow) {
+        return QModelIndex();
+    } else {
+        return createIndex(child.internalId() - RowType::PropertyRow, 0, SectionRow);
+    }
+}
+
+int MetadataModel::rowCount(const QModelIndex &parent) const
+{
+    if (!parent.isValid()) {
+        return m_sections.count();
+    }
+
+    if (parent.internalId() == RowType::SectionRow) {
+        const QString & sectionKey = m_sections[parent.row()];
+        return m_sectionProperties[sectionKey].second.count();
+    }
+
+    return 0;
+}
+
+int MetadataModel::columnCount(const QModelIndex &) const
+{
+    // Always key(display name) and value.
+    return 2;
+}
+
+QVariant MetadataModel::data(const QModelIndex &index, int role) const
+{
+    if (!index.isValid()) {
+        return QVariant();
+    }
+
+    if (role != Qt::DisplayRole) {
+        return QVariant();
+    }
+
+    if (index.internalId() == RowType::SectionRow) {
+        return (index.column() == 0) ? m_sectionProperties[m_sections[index.row()]].first
+                                     : QVariant();
+    } else {
+        int sectionIndex = index.internalId() - RowType::PropertyRow;
+        const QString & sectionKey = m_sections[sectionIndex];
+        const QList<QString> & propertyList = m_sectionProperties[sectionKey].second;
+        return (index.column() == 0) ? m_properties[propertyList[index.row()]].first
+                                     : m_properties[propertyList[index.row()]].second;
+    }
+}
+
+QVariant MetadataModel::headerData(int section, Qt::Orientation orientation, int role) const
+{
+    if (orientation == Qt::Vertical || role != Qt::DisplayRole) {
+        return QVariant();
+    }
+
+    return section == 0 ? tr("Property") : tr("Value");
+}

app/metadatamodel.h

@@ -1,52 +1,52 @@
-// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
-//
-// SPDX-License-Identifier: MIT
-
-#ifndef METADATAMODEL_H
-#define METADATAMODEL_H
-
-#include <QAbstractItemModel>
-
-class Exiv2Wrapper;
-class MetadataModel : public QAbstractItemModel
-{
-    Q_OBJECT
-
-public:
-    explicit MetadataModel(QObject *parent = nullptr);
-    ~MetadataModel();
-
-    void setFile(const QString & imageFilePath);
-    static QString imageSize(const QSize &size);
-    static QString imageSizeRatio(const QSize &size);
-    bool appendSection(const QString & sectionKey, QStringView sectionDisplayName);
-    bool appendPropertyIfNotEmpty(const QString & sectionKey, const QString & propertyKey,
-                                  const QString & propertyDisplayName, const QString & propertyValue = QString());
-    bool appendProperty(const QString & sectionKey, const QString & propertyKey,
-                        QStringView propertyDisplayName, QStringView propertyValue = QString());
-    bool appendExivPropertyIfExist(const Exiv2Wrapper & wrapper, const QString & sectionKey,
-                                   const QString & exiv2propertyKey, const QString & propertyDisplayName = QString(),
-                                   bool isXmpString = false);
-
-private:
-    enum RowType : quintptr {
-        SectionRow,
-        PropertyRow,
-    };
-
-    QModelIndex index(int row, int column, const QModelIndex &parent = QModelIndex()) const override;
-    QModelIndex parent(const QModelIndex &child) const override;
-    int rowCount(const QModelIndex &parent = QModelIndex()) const override;
-    int columnCount(const QModelIndex & = QModelIndex()) const override;
-    QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const override;
-    QVariant headerData(int section, Qt::Orientation orientation, int role = Qt::DisplayRole) const override;
-
-    // [SECTION_KEY]
-    QList<QString> m_sections;
-    // {SECTION_KEY: (SECTION_DISPLAY_NAME, [PROPERTY_KEY])}
-    QMap<QString, QPair<QString, QList<QString> > > m_sectionProperties;
-    // {PROPERTY_KEY: (PROPERTY_DISPLAY_NAME, PROPERTY_VALUE)}
-    QMap<QString, QPair<QString, QString> > m_properties;
-};
-
-#endif // METADATAMODEL_H
+// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
+//
+// SPDX-License-Identifier: MIT
+
+#ifndef METADATAMODEL_H
+#define METADATAMODEL_H
+
+#include <QAbstractItemModel>
+
+class Exiv2Wrapper;
+class MetadataModel : public QAbstractItemModel
+{
+    Q_OBJECT
+
+public:
+    explicit MetadataModel(QObject *parent = nullptr);
+    ~MetadataModel();
+
+    void setFile(const QString & imageFilePath);
+    static QString imageSize(const QSize &size);
+    static QString imageSizeRatio(const QSize &size);
+    bool appendSection(const QString & sectionKey, QStringView sectionDisplayName);
+    bool appendPropertyIfNotEmpty(const QString & sectionKey, const QString & propertyKey,
+                                  const QString & propertyDisplayName, const QString & propertyValue = QString());
+    bool appendProperty(const QString & sectionKey, const QString & propertyKey,
+                        QStringView propertyDisplayName, QStringView propertyValue = QString());
+    bool appendExivPropertyIfExist(const Exiv2Wrapper & wrapper, const QString & sectionKey,
+                                   const QString & exiv2propertyKey, const QString & propertyDisplayName = QString(),
+                                   bool isXmpString = false);
+
+private:
+    enum RowType : quintptr {
+        SectionRow,
+        PropertyRow,
+    };
+
+    QModelIndex index(int row, int column, const QModelIndex &parent = QModelIndex()) const override;
+    QModelIndex parent(const QModelIndex &child) const override;
+    int rowCount(const QModelIndex &parent = QModelIndex()) const override;
+    int columnCount(const QModelIndex & = QModelIndex()) const override;
+    QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const override;
+    QVariant headerData(int section, Qt::Orientation orientation, int role = Qt::DisplayRole) const override;
+
+    // [SECTION_KEY]
+    QList<QString> m_sections;
+    // {SECTION_KEY: (SECTION_DISPLAY_NAME, [PROPERTY_KEY])}
+    QMap<QString, QPair<QString, QList<QString> > > m_sectionProperties;
+    // {PROPERTY_KEY: (PROPERTY_DISPLAY_NAME, PROPERTY_VALUE)}
+    QMap<QString, QPair<QString, QString> > m_properties;
+};
+
+#endif // METADATAMODEL_H

app/navigatorview.cpp

@@ -1,86 +1,120 @@
-// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
-//
-// SPDX-License-Identifier: MIT
-
-#include "navigatorview.h"
-
-#include "graphicsview.h"
-#include "opacityhelper.h"
-
-#include <QMouseEvent>
-#include <QDebug>
-
-NavigatorView::NavigatorView(QWidget *parent)
-    : QGraphicsView (parent)
-    , m_viewportRegion(this->rect())
-    , m_opacityHelper(new OpacityHelper(this))
-{
-    setHorizontalScrollBarPolicy(Qt::ScrollBarAlwaysOff);
-    setVerticalScrollBarPolicy(Qt::ScrollBarAlwaysOff);
-    setStyleSheet("background-color: rgba(0, 0, 0, 120);"
-                  "border-radius: 3px;");
-}
-
-// doesn't take or manage its ownership
-void NavigatorView::setMainView(GraphicsView *mainView)
-{
-    m_mainView = mainView;
-}
-
-void NavigatorView::setOpacity(qreal opacity, bool animated)
-{
-    m_opacityHelper->setOpacity(opacity, animated);
-}
-
-void NavigatorView::updateMainViewportRegion()
-{
-    if (m_mainView != nullptr) {
-        m_viewportRegion = mapFromScene(m_mainView->mapToScene(m_mainView->rect()));
-        update();
-    }
-}
-
-void NavigatorView::mousePressEvent(QMouseEvent *event)
-{
-    m_mouseDown = true;
-
-    if (m_mainView) {
-        m_mainView->centerOn(mapToScene(event->pos()));
-        update();
-    }
-
-    event->accept();
-}
-
-void NavigatorView::mouseMoveEvent(QMouseEvent *event)
-{
-    if (m_mouseDown && m_mainView) {
-        m_mainView->centerOn(mapToScene(event->pos()));
-        update();
-        event->accept();
-    } else {
-        event->ignore();
-    }
-}
-
-void NavigatorView::mouseReleaseEvent(QMouseEvent *event)
-{
-    m_mouseDown = false;
-
-    event->accept();
-}
-
-void NavigatorView::wheelEvent(QWheelEvent *event)
-{
-    event->ignore();
-    return QGraphicsView::wheelEvent(event);
-}
-
-void NavigatorView::paintEvent(QPaintEvent *event)
-{
-    QGraphicsView::paintEvent(event);
-
-    QPainter painter(viewport());
-    painter.setPen(QPen(Qt::gray, 2));
-    painter.drawRect(m_viewportRegion.boundingRect());
-}
+// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
+//
+// SPDX-License-Identifier: MIT
+
+#include "navigatorview.h"
+
+#include "graphicsview.h"
+
+#include <QStyleHints>
+#include <QOperatingSystemVersion>
+#include <QMouseEvent>
+#include <QDebug>
+#include <QTimer>
+
+NavigatorView::NavigatorView(QWidget *parent)
+    : QGraphicsView (parent)
+    , m_viewportRegion(this->rect())
+{
+    setHorizontalScrollBarPolicy(Qt::ScrollBarAlwaysOff);
+    setVerticalScrollBarPolicy(Qt::ScrollBarAlwaysOff);
+
+    updateStyle(qGuiApp->styleHints()->colorScheme());
+    connect(qGuiApp->styleHints(), &QStyleHints::colorSchemeChanged, this, &NavigatorView::updateStyle);
+}
+
+// doesn't take or manage its ownership
+void NavigatorView::setMainView(GraphicsView *mainView)
+{
+    m_mainView = mainView;
+}
+
+void NavigatorView::updateMainViewportRegion()
+{
+    // Use QTimer::singleShot with lambda to delay the update
+    // This ensures all geometry updates are complete before calculating viewport region
+    QTimer::singleShot(0, [this]() {
+        if (m_mainView != nullptr) {
+            m_viewportRegion = mapFromScene(m_mainView->mapToScene(m_mainView->rect()));
+            update();
+        }
+    });
+}
+
+void NavigatorView::updateStyle(Qt::ColorScheme colorScheme) {
+    // YYC MARK:
+    // If we are using Windows 10 and lower system or Qt which do not support "Windows 11"
+    // theme (lower than Qt 6.7), we should only support light mode.
+    // Because Qt's dark-mode-aware "Windows 11" theme is only well-supported on Windows 11.
+#if defined(Q_OS_WIN)
+#if QT_VERSION < QT_VERSION_CHECK(6, 7, 0)
+    colorScheme = Qt::ColorScheme::Light;
+#else
+    if (QOperatingSystemVersion::current() < QOperatingSystemVersion::Windows11) {
+        colorScheme = Qt::ColorScheme::Light;
+    }
+#endif // QT_VERSION < QT_VERSION_CHECK(6, 7, 0)
+#endif // defined(Q_OS_WIN)
+
+    switch (colorScheme) {
+    case Qt::ColorScheme::Dark:
+    setStyleSheet(R"#(
+border-style: none;
+background-color: rgba(255, 255, 255, 70);
+)#");
+        break;
+    case Qt::ColorScheme::Light:
+    case Qt::ColorScheme::Unknown:
+    default:
+        setStyleSheet(R"#(
+border-style: none;
+background-color: rgba(0, 0, 0, 70);
+)#");
+        break;
+    }
+}
+
+void NavigatorView::mousePressEvent(QMouseEvent *event)
+{
+    m_mouseDown = true;
+
+    if (m_mainView) {
+        m_mainView->centerOn(mapToScene(event->pos()));
+        update();
+    }
+
+    event->accept();
+}
+
+void NavigatorView::mouseMoveEvent(QMouseEvent *event)
+{
+    if (m_mouseDown && m_mainView) {
+        m_mainView->centerOn(mapToScene(event->pos()));
+        update();
+        event->accept();
+    } else {
+        event->ignore();
+    }
+}
+
+void NavigatorView::mouseReleaseEvent(QMouseEvent *event)
+{
+    m_mouseDown = false;
+
+    event->accept();
+}
+
+void NavigatorView::wheelEvent(QWheelEvent *event)
+{
+    event->ignore();
+    return QGraphicsView::wheelEvent(event);
+}
+
+void NavigatorView::paintEvent(QPaintEvent *event)
+{
+    QGraphicsView::paintEvent(event);
+
+    QPainter painter(viewport());
+    painter.setPen(QPen(Qt::gray, 2));
+    painter.drawRect(m_viewportRegion.boundingRect());
+}

app/navigatorview.h

@@ -1,38 +1,38 @@
-// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
-//
-// SPDX-License-Identifier: MIT
-
-#ifndef NAVIGATORVIEW_H
-#define NAVIGATORVIEW_H
-
-#include <QGraphicsView>
-
-class OpacityHelper;
-class GraphicsView;
-class NavigatorView : public QGraphicsView
-{
-    Q_OBJECT
-public:
-    NavigatorView(QWidget *parent = nullptr);
-
-    void setMainView(GraphicsView *mainView);
-    void setOpacity(qreal opacity, bool animated = true);
-
-public slots:
-    void updateMainViewportRegion();
-
-private:
-    void mousePressEvent(QMouseEvent * event) override;
-    void mouseMoveEvent(QMouseEvent * event) override;
-    void mouseReleaseEvent(QMouseEvent * event) override;
-
-    void wheelEvent(QWheelEvent *event) override;
-    void paintEvent(QPaintEvent *event) override;
-
-    bool m_mouseDown = false;
-    QPolygon m_viewportRegion;
-    QGraphicsView *m_mainView = nullptr;
-    OpacityHelper *m_opacityHelper = nullptr;
-};
-
-#endif // NAVIGATORVIEW_H
+// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
+//
+// SPDX-License-Identifier: MIT
+
+#ifndef NAVIGATORVIEW_H
+#define NAVIGATORVIEW_H
+
+#include <QGraphicsView>
+
+class GraphicsView;
+class NavigatorView : public QGraphicsView
+{
+    Q_OBJECT
+public:
+    NavigatorView(QWidget *parent = nullptr);
+
+    void setMainView(GraphicsView *mainView);
+
+public slots:
+    void updateMainViewportRegion();
+
+private slots:
+    void updateStyle(Qt::ColorScheme colorScheme);
+
+private:
+    void mousePressEvent(QMouseEvent * event) override;
+    void mouseMoveEvent(QMouseEvent * event) override;
+    void mouseReleaseEvent(QMouseEvent * event) override;
+
+    void wheelEvent(QWheelEvent *event) override;
+    void paintEvent(QPaintEvent *event) override;
+
+    bool m_mouseDown = false;
+    QPolygon m_viewportRegion;
+    QGraphicsView *m_mainView = nullptr;
+};
+
+#endif // NAVIGATORVIEW_H

app/opacityhelper.cpp

@@ -1,31 +0,0 @@
-// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
-//
-// SPDX-License-Identifier: MIT
-
-#include "opacityhelper.h"
-
-#include <QGraphicsOpacityEffect>
-#include <QPropertyAnimation>
-
-OpacityHelper::OpacityHelper(QWidget *parent)
-    : QObject(parent)
-    , m_opacityFx(new QGraphicsOpacityEffect(parent))
-    , m_opacityAnimation(new QPropertyAnimation(m_opacityFx, "opacity"))
-{
-    parent->setGraphicsEffect(m_opacityFx);
-
-    m_opacityAnimation->setDuration(300);
-}
-
-void OpacityHelper::setOpacity(qreal opacity, bool animated)
-{
-    if (!animated) {
-        m_opacityFx->setOpacity(opacity);
-        return;
-    }
-
-    m_opacityAnimation->stop();
-    m_opacityAnimation->setStartValue(m_opacityFx->opacity());
-    m_opacityAnimation->setEndValue(opacity);
-    m_opacityAnimation->start();
-}

app/opacityhelper.h

@@ -1,27 +0,0 @@
-// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
-//
-// SPDX-License-Identifier: MIT
-
-#ifndef OPACITYHELPER_H
-#define OPACITYHELPER_H
-
-#include <QWidget>
-
-QT_BEGIN_NAMESPACE
-class QGraphicsOpacityEffect;
-class QPropertyAnimation;
-QT_END_NAMESPACE
-
-class OpacityHelper : QObject
-{
-public:
-    OpacityHelper(QWidget * parent);
-
-    void setOpacity(qreal opacity, bool animated = true);
-
-protected:
-    QGraphicsOpacityEffect * m_opacityFx;
-    QPropertyAnimation * m_opacityAnimation;
-};
-
-#endif // OPACITYHELPER_H

app/playlistmanager.cpp

@@ -1,173 +1,295 @@
-// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
-//
-// SPDX-License-Identifier: MIT
-
-#include "playlistmanager.h"
-
-#include <QCollator>
-#include <QDir>
-#include <QFileInfo>
-#include <QUrl>
-
-PlaylistManager::PlaylistManager(PlaylistType type, QObject *parent)
-    : QObject(parent)
-    , m_type(type)
-{
-
-}
-
-PlaylistManager::~PlaylistManager()
-{
-
-}
-
-void PlaylistManager::setPlaylistType(PlaylistManager::PlaylistType type)
-{
-    m_type = type;
-}
-
-PlaylistManager::PlaylistType PlaylistManager::playlistType() const
-{
-    return m_type;
-}
-
-QStringList PlaylistManager::autoLoadFilterSuffix() const
-{
-    return m_autoLoadSuffix;
-}
-
-void PlaylistManager::setAutoLoadFilterSuffix(const QStringList & nameFilters)
-{
-    m_autoLoadSuffix = nameFilters;
-}
-
-void PlaylistManager::clear()
-{
-    m_currentIndex = -1;
-    m_playlist.clear();
-}
-
-void PlaylistManager::setPlaylist(const QList<QUrl> &urls)
-{
-    m_playlist = urls;
-}
-
-void PlaylistManager::setCurrentFile(const QString & filePath)
-{
-    QFileInfo info(filePath);
-    QDir dir(info.path());
-    QString && currentFileName = info.fileName();
-
-    switch (playlistType()) {
-    case PL_SAMEFOLDER: {
-        if (dir.path() == m_currentDir) {
-            int index = indexOf(filePath);
-            m_currentIndex = index == -1 ? appendFile(filePath) : index;
-        } else {
-            QStringList entryList = dir.entryList(
-                        m_autoLoadSuffix,
-                        QDir::Files | QDir::NoSymLinks, QDir::NoSort);
-
-            QCollator collator;
-            collator.setNumericMode(true);
-
-            std::sort(entryList.begin(), entryList.end(), collator);
-
-            clear();
-
-            int index = -1;
-            for (int i = 0; i < entryList.count(); i++) {
-                const QString & fileName = entryList.at(i);
-                const QString & oneEntry = dir.absoluteFilePath(fileName);
-                const QUrl & url = QUrl::fromLocalFile(oneEntry);
-                m_playlist.append(url);
-                if (fileName == currentFileName) {
-                    index = i;
-                }
-            }
-            m_currentIndex = index == -1 ? appendFile(filePath) : index;
-            m_currentDir = dir.path();
-        }
-        break;
-    }
-    case PL_USERPLAYLIST:{
-        int index = indexOf(filePath);
-        m_currentIndex = index == -1 ? appendFile(filePath) : index;
-        break;
-    }
-    default:
-        break;
-    }
-
-    emit loaded(m_playlist.count());
-}
-
-void PlaylistManager::setCurrentIndex(int index)
-{
-    if (index < 0 || index >= m_playlist.count()) return;
-    m_currentIndex = index;
-}
-
-int PlaylistManager::appendFile(const QString &filePath)
-{
-    int index = m_playlist.length();
-    m_playlist.append(QUrl::fromLocalFile(filePath));
-
-    return index;
-}
-
-int PlaylistManager::indexOf(const QString &filePath)
-{
-    const QUrl & url = QUrl::fromLocalFile(filePath);
-    return m_playlist.indexOf(url);
-}
-
-int PlaylistManager::count() const
-{
-    return m_playlist.count();
-}
-
-std::tuple<int, QString> PlaylistManager::previousFile() const
-{
-    int count = m_playlist.count();
-    if (count == 0) return std::make_tuple(-1, QString());
-
-    int index = m_currentIndex - 1 < 0 ? count - 1 : m_currentIndex - 1;
-    return std::make_tuple(index, m_playlist.at(index).toLocalFile());
-}
-
-std::tuple<int, QString> PlaylistManager::nextFile() const
-{
-    int count = m_playlist.count();
-    if (count == 0) return std::make_tuple(-1, QString());
-
-    int index = m_currentIndex + 1 == count ? 0 : m_currentIndex + 1;
-    return std::make_tuple(index, m_playlist.at(index).toLocalFile());
-}
-
-std::tuple<int, QString> PlaylistManager::currentFile() const
-{
-    if (m_playlist.count() == 0) return std::make_tuple(-1, QString());
-
-    return std::make_tuple(m_currentIndex, m_playlist.at(m_currentIndex).toLocalFile());
-}
-
-std::tuple<int, QUrl> PlaylistManager::currentFileUrl() const
-{
-    if (m_playlist.count() == 0) return std::make_tuple(-1, QUrl());
-
-    return std::make_tuple(m_currentIndex, m_playlist.at(m_currentIndex));
-}
-
-QList<QUrl> PlaylistManager::convertToUrlList(const QStringList &files)
-{
-    QList<QUrl> urlList;
-    for (const QString & str : qAsConst(files)) {
-        QUrl url = QUrl::fromLocalFile(str);
-        if (url.isValid()) {
-            urlList.append(url);
-        }
-    }
-
-    return urlList;
-}
+// SPDX-FileCopyrightText: 2025 Gary Wang <git@blumia.net>
+//
+// SPDX-License-Identifier: MIT
+
+#include "playlistmanager.h"
+#include "playlistscout.h"
+
+#include <QCollator>
+#include <QDir>
+#include <QFileInfo>
+#include <QUrl>
+
+PlaylistManager::PlaylistManager(QObject *parent)
+    : QObject(parent)
+    , m_currentIndex(std::nullopt)
+    , m_playlist()
+    , m_allowedSuffixes()
+{
+
+}
+
+PlaylistManager::~PlaylistManager()
+{
+
+}
+
+// region: Allowed Suffixes Operations
+
+const QStringList& PlaylistManager::allowedSuffixes() const {
+    return m_allowedSuffixes;
+}
+
+void PlaylistManager::setAllowedSuffixes(const QStringList& nameFilters) {
+    m_allowedSuffixes = nameFilters;
+    emit allowedSuffixesChanged(m_allowedSuffixes);
+}
+
+// endregion
+
+// region: Playlist Loader and Reset
+
+bool PlaylistManager::loadPlaylist(const QStringList& files) {
+    // Convert string list to url list first
+    QList<QUrl> urls;
+    for (const QString & file : std::as_const(files)) {
+        urls.append(urlFromString(file));
+    }
+
+    return loadPlaylist(urls);
+}
+
+bool PlaylistManager::loadPlaylist(const QList<QUrl>& urls) {
+    // Check its count, and check M3U8 playlist for single file case.
+    if (urls.isEmpty()) {
+        clearPlaylist();
+        return true;
+    } else if (urls.count() == 1) {
+        const QUrl& firstUrl = urls.first();
+        const QString lowerCaseUrlPath(firstUrl.path().toLower());
+        if (lowerCaseUrlPath.endsWith(".m3u8") || lowerCaseUrlPath.endsWith(".m3u")) {
+            return loadM3U8Playlist(firstUrl);
+        } else {
+            return loadSingleFilePlaylist(firstUrl);
+        }
+    } else {
+        return loadMultipleFilesPlaylist(std::move(urls));
+    }
+}
+
+bool PlaylistManager::loadSingleFilePlaylist(const QUrl& url) {
+    // Check URL at first
+    if (!checkUrl(url))
+        return false;
+
+    // Scout playlist by given file
+    auto scoutResult = PlaylistScout::scout(url, m_allowedSuffixes);
+    if (!scoutResult.has_value()) {
+        return false;
+    }
+
+    // Setup playlist with index
+    setPlaylist(std::move(scoutResult->playlist), scoutResult->indexHint);
+    return true;
+}
+
+bool PlaylistManager::loadMultipleFilesPlaylist(const QList<QUrl>&& urls) {
+    // Check all of them are valid
+    for (const auto& url : std::as_const(urls)) {
+        if (!checkUrl(url)) {
+            return false;
+        }
+    }
+
+    // Set playlist and return
+    setPlaylist(std::move(urls));
+    return true;
+}
+
+bool PlaylistManager::loadM3U8Playlist(const QUrl& url) {
+    // Check URL at first
+    if (!checkUrl(url))
+        return false;
+
+    QList<QUrl> urls;
+    QFile file(url.toLocalFile());
+    if (file.open(QIODevice::ReadOnly | QIODevice::Text)) {
+        while (!file.atEnd()) {
+            QString line = file.readLine();
+            if (line.startsWith('#')) {
+                continue;
+            }
+            QFileInfo fileInfo(file);
+            QUrl item = QUrl::fromUserInput(line, fileInfo.absolutePath());
+            if (!checkUrl(item)) {
+                return false;
+            }
+            urls.append(item);
+        }
+    } else {
+        return false;
+    }
+
+    setPlaylist(std::move(urls));
+    return true;
+}
+
+void PlaylistManager::setPlaylist(const QList<QUrl>&& urls, std::optional<qsizetype> indexHint) {
+    // Setup playlist
+    m_playlist = std::move(urls);
+
+    // Set index with hint
+    if (indexHint.has_value()) {
+        m_currentIndex = *indexHint;
+    }
+    sanitizeIndex();
+
+    // Raise signal
+    emit playlistChanged(totalCount());
+}
+
+void PlaylistManager::clearPlaylist() {
+    m_playlist.clear();
+    sanitizeIndex();
+    emit playlistChanged(this->totalCount());
+}
+
+// endregion
+
+// region: Playlist Operations
+
+void PlaylistManager::appendToPlaylist(const QString &file)
+{
+    return appendToPlaylist(urlFromString(file));
+}
+
+void PlaylistManager::appendToPlaylist(const QUrl &url)
+{
+    m_playlist.append(url);
+    sanitizeIndex();
+    emit playlistChanged(totalCount());
+}
+
+bool PlaylistManager::insertIntoPlaylist(qsizetype index, const QString &file)
+{
+    return insertIntoPlaylist(index, urlFromString(file));
+}
+
+bool PlaylistManager::insertIntoPlaylist(qsizetype index, const QUrl &url)
+{
+    if (index < 0 || index > totalCount()) {
+        return false;
+    } else {
+        m_playlist.insert(index, url);
+        sanitizeIndex();
+        emit playlistChanged(totalCount());
+        return true;
+    }
+}
+
+bool PlaylistManager::removeFromPlaylist(qsizetype index)
+{
+    if (index < 0 || index >= totalCount()) {
+        return false;
+    } else {
+        m_playlist.removeAt(index);
+        sanitizeIndex();
+        emit playlistChanged(totalCount());
+        return true;
+    }
+}
+
+// endregion
+
+// region: Index Operations
+
+qsizetype PlaylistManager::totalCount() const
+{
+    return m_playlist.count();
+}
+
+std::optional<qsizetype> PlaylistManager::previousIndex() const
+{
+    if (!m_currentIndex.has_value() || totalCount() <= 0) return std::nullopt;
+    return (isFirstIndex() ? totalCount() - 1 : *m_currentIndex - 1);
+}
+
+std::optional<qsizetype> PlaylistManager::nextIndex() const
+{
+    if (!m_currentIndex.has_value() || totalCount() <= 0) return std::nullopt;
+    return (isLastIndex() ? 0 : *m_currentIndex + 1);
+}
+
+bool PlaylistManager::isFirstIndex() const
+{
+    return m_currentIndex.has_value() && *m_currentIndex == 0;
+}
+
+bool PlaylistManager::isLastIndex() const
+{
+    return m_currentIndex.has_value() && *m_currentIndex + 1 == totalCount();
+}
+
+std::optional<qsizetype> PlaylistManager::currentIndex() const
+{
+    return m_currentIndex;
+}
+
+bool PlaylistManager::setCurrentIndex(qsizetype index)
+{
+    if (!m_currentIndex.has_value()) {
+        return false;
+    }
+    if (index < 0 || index >= totalCount()) {
+        return false;
+    }
+    if (*m_currentIndex == index) {
+        return true;
+    }
+
+    m_currentIndex = index;
+    emit currentIndexChanged(index);
+    return true;
+}
+
+QUrl PlaylistManager::urlByIndex(qsizetype index) const
+{
+    return m_playlist.value(index);
+}
+
+QString PlaylistManager::localFileByIndex(qsizetype index) const
+{
+    return urlByIndex(index).toLocalFile();
+}
+
+// endregion
+
+// region: Misc
+
+void PlaylistManager::sanitizeIndex()
+{
+    auto cnt = totalCount();
+    if (cnt == 0) {
+        // If playlist is empty, current index should be invalid.
+        m_currentIndex = std::nullopt;
+    } else {
+        if (m_currentIndex.has_value()) {
+            // Clamp current index in playlist range.
+            // If it is already in range, not change was done.
+            auto currentIndex = *m_currentIndex;
+            if (currentIndex < 0) {
+                m_currentIndex = 0;
+            } else if (currentIndex >= cnt) {
+                m_currentIndex = cnt - 1;
+            } else {
+                ; // No change.
+            }
+        } else {
+            // If there is no set value for current index,
+            // set it at the beginning of playlist.
+            m_currentIndex = 0;
+        }
+    }
+}
+
+bool PlaylistManager::checkUrl(const QUrl& url)
+{
+    return url.isValid() && url.isLocalFile();
+}
+
+QUrl PlaylistManager::urlFromString(const QString& file)
+{
+    return QUrl::fromLocalFile(file);
+}
+
+// endregion

app/playlistmanager.h

@@ -1,54 +1,130 @@
-// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
-//
-// SPDX-License-Identifier: MIT
-
-#pragma once
-
-#include <QObject>
-
-class PlaylistManager : public QObject
-{
-    Q_OBJECT
-public:
-    enum PlaylistType {
-        PL_USERPLAYLIST, // Regular playlist, managed by user.
-        PL_SAMEFOLDER // PlaylistManager managed playlist, loaded from files from same folder.
-    };
-
-    explicit PlaylistManager(PlaylistType type = PL_USERPLAYLIST, QObject *parent = nullptr);
-    ~PlaylistManager();
-
-    void setPlaylistType(PlaylistType type);
-    PlaylistType playlistType() const;
-
-    QStringList autoLoadFilterSuffix() const;
-    void setAutoLoadFilterSuffix(const QStringList &nameFilters);
-
-    void clear();
-
-    void setPlaylist(const QList<QUrl> & urls);
-    void setCurrentFile(const QString & filePath);
-    void setCurrentIndex(int index);
-    int appendFile(const QString & filePath);
-    int indexOf(const QString & filePath);
-
-    int count() const;
-
-    std::tuple<int, QString> previousFile() const;
-    std::tuple<int, QString> nextFile() const;
-    std::tuple<int, QString> currentFile() const;
-    std::tuple<int, QUrl> currentFileUrl() const;
-
-    static QList<QUrl> convertToUrlList(const QStringList & files);
-
-signals:
-    void loaded(int length);
-
-private:
-    QList<QUrl> m_playlist;
-    PlaylistType m_type;
-    QString m_currentDir;
-    int m_currentIndex = -1;
-    QStringList m_autoLoadSuffix = {};
-};
-
+// SPDX-FileCopyrightText: 2025 Gary Wang <git@blumia.net>
+//
+// SPDX-License-Identifier: MIT
+
+#pragma once
+
+#include <QUrl>
+#include <QObject>
+#include <optional>
+
+/// The manager of playlist.
+class PlaylistManager : public QObject
+{
+    Q_OBJECT
+public:
+    /// Constructs a PlaylistManager with an optional parent QObject.
+    explicit PlaylistManager(QObject* parent = nullptr);
+    /// Destructor.
+    ~PlaylistManager();
+
+    /// Get the allowed file suffixes of this playlist.
+    /// @return The current list of allowed suffixes.
+    const QStringList& allowedSuffixes() const;
+    /// Set the allowed file suffixes of this playlist.
+    /// @remark This only works for "load the whole directory by one file" case.
+    /// @param[in] nameFilters The new list of allowed suffixes.
+    void setAllowedSuffixes(const QStringList& nameFilters);
+
+    /// Load user specified files as playlist.
+    /// @remark The wrapper for another overload.
+    /// @return True for successful load, otherwise false.
+    bool loadPlaylist(const QStringList& files);
+    /// Load user specified URLs as playlist.
+    /// @remark This function automatically dispatch these files into correct sub-load functions.
+    /// @return True for successful load, otherwise false.
+    bool loadPlaylist(const QList<QUrl>& urls);
+    /// Clear the entire playlist and reset current index.
+    void clearPlaylist();
+
+    /// Append a local file path to the playlist.
+    void appendToPlaylist(const QString& file);
+    /// Append a URL to the playlist.
+    void appendToPlaylist(const QUrl& url);
+    /// Insert a local file path at the given index.
+    /// @return True if inserted successfully, false if index is out of range.
+    bool insertIntoPlaylist(qsizetype index, const QString& file);
+    /// Insert a URL at the given index.
+    /// @return True if inserted successfully, false if index is out of range.
+    bool insertIntoPlaylist(qsizetype index, const QUrl& url);
+    /// Remove the entry at the given index.
+    /// @return True if removed successfully, false if index is out of range.
+    bool removeFromPlaylist(qsizetype index);
+
+    /// Returns the total number of items in the playlist.
+    /// @return Total count of entries in the playlist.
+    qsizetype totalCount() const;
+    /// Try fetching previous index.
+    /// @details This previous index is gallery-loop-aware.
+    /// @return std::nullopt if playlist is empty, otherwise the previous index considering gallery loop.
+    std::optional<qsizetype> previousIndex() const;
+    /// Try fetching next index.
+    /// @details This next index is gallery-loop-aware.
+    /// @return std::nullopt if playlist is empty, otherwise the next index considering gallery loop.
+    std::optional<qsizetype> nextIndex() const;
+    /// Check whether current index is the first index.
+    /// @return False if current index is not the first index or playlist is empty, otherwise true.
+    bool isFirstIndex() const;
+    /// Check whether current index is the last index.
+    /// @return False if current index is not the last index or playlist is empty, otherwise true.
+    bool isLastIndex() const;
+    /// Returns the current index.
+    /// @return std::nullopt if the playlist is empty, otherwise the current index.
+    std::optional<qsizetype> currentIndex() const;
+    /// Set the current index.
+    /// @remark Index only can be set when playlist is not empty.
+    /// @return True if successful set, including "not changed" set, otherwise false.
+    /// This return value only indicates whether we can set index and given index is valid for setting.
+    /// If "no changed" set occurs, this function returns true, but doesn't raise current index changed signal.
+    bool setCurrentIndex(qsizetype index);
+    /// Returns the URL at the given index.
+    /// @return The URL if index is valid.
+    /// This class guarantee that this QUrl is pointing to a local file.
+    QUrl urlByIndex(qsizetype index) const;
+    /// Returns the local file path at the given index.
+    /// @return The local file path if index is valid.
+    /// This class guarantee that local file path always is valid.
+    QString localFileByIndex(qsizetype index) const;
+
+signals:
+    void allowedSuffixesChanged(const QStringList& suffixes);
+    /// Raised when index was changed bu setter.
+    /// The argument holds the new current index.
+    /// Please note that this signal will NOT be raised by the whole playlist change caused index change.
+    void currentIndexChanged(qsizetype index);
+    /// The whole playlist was changed, involving loading, editing and deleting some or full entries.
+    /// The argument holds the total count of new play list.
+    void playlistChanged(qsizetype count);
+
+private:
+    /// The fundamental playlist setter.
+    /// @details All playlist load functions will call this function to set playlist at last.
+    /// @param[in] urls ALl urls in this list should be checked by checkUrl() function.
+    /// @param[in] indexHint Try to set current index to this index if possible.
+    void setPlaylist(const QList<QUrl>&& urls, std::optional<qsizetype> indexHint = std::nullopt);
+    /// Load playlist from a single file.
+    /// @details This function scans the same directory for siblings matching allowed suffixes, sorted naturally.
+    /// @return True if the playlist was loaded successfully, false otherwise.
+    bool loadSingleFilePlaylist(const QUrl& url);
+    /// Load playlist from multiple URLs directly.
+    /// @return True if all URLs are valid, false otherwise.
+    bool loadMultipleFilesPlaylist(const QList<QUrl>&& urls);
+    /// Load playlist from an M3U/M3U8 playlist file.
+    /// @return True if loaded successfully, false otherwise.
+    bool loadM3U8Playlist(const QUrl& url);
+
+    /// Make sure that current index is valid.
+    /// @details This function usually is used by those functions manipulating playlist.
+    void sanitizeIndex();
+
+    /// Check whether given QUrl is proper to be put into playlist.
+    /// @details Only the url pointing to local file can be put into playlist.
+    static bool checkUrl(const QUrl& url);
+    /// Convert a string to local file into a QUrl.
+    /// @param[in] file The string pointing to local file.
+    static QUrl urlFromString(const QString& file);
+
+    std::optional<qsizetype> m_currentIndex;
+    QList<QUrl> m_playlist;
+    QStringList m_allowedSuffixes;
+};

app/playlistscout.cpp

@@ -0,0 +1,25 @@
+// SPDX-FileCopyrightText: 2026 yyc12345 <yyc12321@outlook.com>
+//
+// SPDX-License-Identifier: MIT
+
+#include "playlistscout.h"
+
+#include "playlistscouts/qtscout.h"
+#include "playlistscouts/explorerscout.h"
+
+std::optional<PlaylistScout::ScoutResult> PlaylistScout::scout(
+    const QUrl &url, const QStringList &allowedSuffixes) {
+
+#ifdef Q_OS_WIN
+    // In Windows, Qt approach can not aware Windows Explorer custom sort order.
+    // So we need to try using Win32 functions for fetching it at first.
+    if (auto rv = PlaylistScout::Explorer::scout(url, allowedSuffixes); rv.has_value()) {
+        return rv;
+    }
+#endif // Q_OS_WIN
+
+    // TODO: We may add macOS Finder, KDE Dolphin and etc supports in future.
+
+    // Qt way is the last fallback.
+    return PlaylistScout::Qt::scout(url, allowedSuffixes);
+}

app/playlistscout.h

@@ -0,0 +1,31 @@
+// SPDX-FileCopyrightText: 2026 yyc12345 <yyc12321@outlook.com>
+//
+// SPDX-License-Identifier: MIT
+
+#pragma once
+
+#include <QUrl>
+#include <QStringList>
+#include <QList>
+#include <optional>
+
+namespace PlaylistScout {
+    /// The result of scout
+    struct ScoutResult {
+        /// The final fetched playlist (it can be empty).
+        /// Each item must be a QUrl pointing to a local file.
+        QList<QUrl> playlist;
+        /// The index of given file located in playlist.
+        /// Nullopt if it is not presented in playlist.
+        std::optional<qsizetype> indexHint;
+    };
+
+    /// @brief Scout available image files in given file's parent dir with given allowed suffixes.
+    /// @param[in] url The path to file whose parent dir is our target dir for finding image files.
+    /// @param[in] allowedSuffixes 
+    /// Each items in this list is a wildcard pattern for matching allowed file name, like \c *.png .
+    /// The fetched item will be preserved if its name matching any of them.
+    /// If this list is empty, there is no restrictions for finding files.
+    /// @return Scout result if success, otherwise nullopt.
+    std::optional<ScoutResult> scout(const QUrl &url, const QStringList &allowedSuffixes);
+}

app/playlistscouts/explorerscout.cpp

@@ -0,0 +1,332 @@
+// SPDX-FileCopyrightText: 2026 yyc12345 <yyc12321@outlook.com>
+//
+// SPDX-License-Identifier: MIT
+
+#include "explorerscout.h"
+
+#ifdef Q_OS_WIN
+
+#include <QDir>
+#include <QDebug>
+#include <QFileInfo>
+#include <QRegularExpression>
+
+#include <optional>
+
+#include <exdisp.h>     // IShellWindows, CLSID_ShellWindows
+#include <servprov.h>   // IServiceProvider
+#include <shlguid.h>    // SID_STopLevelBrowser
+#include <shlobj.h>
+
+// YYC MARK:
+// We use custom RAII wrappers instead of existing COM smart pointers because the
+// project may be built with MinGW, which does not have good compatibility with
+// CComPtr and Microsoft's WRL ComPtr (<wrl/client.h>).
+// Furthermore, PIDLs are not COM objects (they are freed via ILFree, not Release),
+// so no standard smart pointer covers them regardless of compiler.
+
+/// RAII wrapper for COM initialization (CoInitialize / CoUninitialize).
+/// Must be declared before any COM objects (e.g., ComPtr, UniquePidl) so that
+/// CoUninitialize runs after all COM objects are released during scope exit.
+class ComGuard {
+public:
+    ComGuard() : m_hr(CoInitialize(nullptr)) {}
+    ~ComGuard() { if (SUCCEEDED(m_hr)) CoUninitialize(); }
+    ComGuard(const ComGuard&) = delete;
+    ComGuard& operator=(const ComGuard&) = delete;
+
+    bool IsInitialized() const { return SUCCEEDED(m_hr); }
+
+private:
+    HRESULT m_hr;
+};
+
+/// RAII wrapper for COM interface pointers.
+template <typename T>
+class ComPtr {
+public:
+    ComPtr() = default;
+    ComPtr(std::nullptr_t) {}
+    ~ComPtr() { Reset(); }
+    ComPtr(const ComPtr&) = delete;
+    ComPtr& operator=(const ComPtr&) = delete;
+    ComPtr(ComPtr&& other) noexcept : m_ptr(other.m_ptr) { other.m_ptr = nullptr; }
+    ComPtr& operator=(ComPtr&& other) noexcept {
+        if (this != &other) {
+            Reset();
+            m_ptr = other.m_ptr;
+            other.m_ptr = nullptr;
+        }
+        return *this;
+    }
+
+    T* operator->() const { return m_ptr; }
+    T* Get() const { return m_ptr; }
+    T** GetAddressOf() { return &m_ptr; }
+    explicit operator bool() const { return m_ptr != nullptr; }
+    void Reset() { if (m_ptr) { m_ptr->Release(); m_ptr = nullptr; } }
+
+private:
+    T* m_ptr = nullptr;
+};
+
+/// RAII wrapper for PIDL (Item ID List).
+class UniquePidl {
+public:
+    UniquePidl() = default;
+    explicit UniquePidl(LPITEMIDLIST pidl) : m_pidl(pidl) {}
+    ~UniquePidl() { Reset(); }
+    UniquePidl(const UniquePidl&) = delete;
+    UniquePidl& operator=(const UniquePidl&) = delete;
+    UniquePidl(UniquePidl&& other) noexcept : m_pidl(other.m_pidl) { other.m_pidl = nullptr; }
+    UniquePidl& operator=(UniquePidl&& other) noexcept {
+        if (this != &other) {
+            Reset();
+            m_pidl = other.m_pidl;
+            other.m_pidl = nullptr;
+        }
+        return *this;
+    }
+
+    LPCITEMIDLIST Get() const { return m_pidl; }
+    LPITEMIDLIST* GetAddressOf() { return &m_pidl; }
+    explicit operator bool() const { return m_pidl != nullptr; }
+    void Reset() { if (m_pidl) { ILFree(m_pidl); m_pidl = nullptr; } }
+
+private:
+    LPITEMIDLIST m_pidl = nullptr;
+};
+
+/// Outputs a diagnostic warning for debugging Windows Explorer integration failures.
+static void ReportError(const QString& detail)
+{
+    qWarning("Windows Explorer file list fetch error: %s",
+             qPrintable(detail));
+}
+
+/// Normalizes a Windows directory path for case-insensitive comparison:
+/// converts to native separators, lowercases, and ensures a trailing backslash.
+static QString NormalizePath(const QString& path)
+{
+    QString result = QDir::toNativeSeparators(path).toLower();
+    if (!result.endsWith(QChar('\\'))) {
+        result += QChar('\\');
+    }
+    return result;
+}
+
+/// Checks whether the Explorer window represented by the given IDispatch is
+/// displaying the target folder. Returns its IFolderView2 on match, or null.
+static ComPtr<IFolderView2> TryMatchWindow(IDispatch* dispatch, const QString& normalizedTarget)
+{
+    // Navigate: IDispatch -> IServiceProvider -> IShellBrowser.
+    ComPtr<IServiceProvider> serviceProvider;
+    if (FAILED(dispatch->QueryInterface(IID_PPV_ARGS(serviceProvider.GetAddressOf())))) {
+        return nullptr;
+    }
+
+    ComPtr<IShellBrowser> shellBrowser;
+    if (FAILED(serviceProvider->QueryService(SID_STopLevelBrowser,
+            IID_PPV_ARGS(shellBrowser.GetAddressOf())))) {
+        return nullptr;
+    }
+
+    // IShellBrowser -> active IShellView.
+    ComPtr<IShellView> shellView;
+    if (FAILED(shellBrowser->QueryActiveShellView(shellView.GetAddressOf()))) {
+        return nullptr;
+    }
+
+    // Retrieve the folder's path via IPersistIDList.
+    ComPtr<IPersistIDList> persistIdList;
+    if (FAILED(shellView->QueryInterface(IID_PPV_ARGS(persistIdList.GetAddressOf())))) {
+        return nullptr;
+    }
+
+    UniquePidl folderPidl;
+    if (FAILED(persistIdList->GetIDList(folderPidl.GetAddressOf()))) {
+        return nullptr;
+    }
+
+    PWSTR pathStr = nullptr;
+    if (FAILED(SHGetNameFromIDList(folderPidl.Get(), SIGDN_DESKTOPABSOLUTEPARSING, &pathStr))) {
+        return nullptr;
+    }
+
+    QString windowPath = NormalizePath(QString::fromWCharArray(pathStr));
+    CoTaskMemFree(pathStr);
+
+    if (windowPath != normalizedTarget) {
+        return nullptr;
+    }
+
+    // Path matches — query IFolderView2 from the ShellView.
+    ComPtr<IFolderView2> folderView2;
+    if (FAILED(shellView->QueryInterface(IID_PPV_ARGS(folderView2.GetAddressOf())))) {
+        return nullptr;
+    }
+    return folderView2;
+}
+
+/// Tries to find a live Explorer window that is currently displaying the given
+/// folder path. Returns the IFolderView2 from that window, or an empty ComPtr.
+///
+/// Explorer's sort order is stored only in the running Explorer process's memory.
+/// Creating a new shell view via IShellFolder::CreateViewObject yields a default
+/// sort (always by name), so we must find the actual live IFolderView2 instead.
+///
+/// Reference:
+/// - https://www.stephenli.ca/getting-windows-explorers-current-directory-sort-order
+/// - https://github.com/d2phap/ImageGlass/blob/75a296287f338edcf409eee3917531b25ff5d927/v9/Components/ImageGlass.Base/FileSystem/FileFinder.cs
+/// - NuGet Package: D2Phap.EggShell
+static ComPtr<IFolderView2> FindLiveFolderView(const QString& targetFolderPath)
+{
+    // Create the Shell windows collection (all open Explorer windows).
+    ComPtr<IShellWindows> shellWindows;
+    if (FAILED(CoCreateInstance(CLSID_ShellWindows, nullptr, CLSCTX_ALL,
+            IID_PPV_ARGS(shellWindows.GetAddressOf())))) {
+        ReportError("Failed to create IShellWindows instance");
+        return nullptr;
+    }
+
+    QString normalizedTarget = NormalizePath(targetFolderPath);
+
+    // 1. Try the Desktop window first — it may contain the file the user opened.
+    {
+        VARIANT varLoc;
+        VariantInit(&varLoc);
+        varLoc.vt = VT_I4;
+        varLoc.lVal = 0;
+
+        VARIANT varLocRoot;
+        VariantInit(&varLocRoot);
+
+        long desktopHwnd = 0;
+        ComPtr<IDispatch> desktopDispatch;
+        HRESULT findHr = shellWindows->FindWindowSW(
+            &varLoc, &varLocRoot, SWC_DESKTOP,
+            &desktopHwnd, SWFO_NEEDDISPATCH,
+            desktopDispatch.GetAddressOf());
+
+        VariantClear(&varLoc);
+        VariantClear(&varLocRoot);
+
+        if (SUCCEEDED(findHr) && desktopDispatch) {
+            ComPtr<IFolderView2> result = TryMatchWindow(desktopDispatch.Get(), normalizedTarget);
+            if (result) return result;
+        }
+    }
+
+    // 2. Iterate regular Explorer windows.
+    LONG count = 0;
+    shellWindows->get_Count(&count);
+
+    for (LONG i = 0; i < count; i++) {
+        VARIANT varIndex;
+        VariantInit(&varIndex);
+        varIndex.vt = VT_I4;
+        varIndex.lVal = i;
+
+        ComPtr<IDispatch> dispatch;
+        HRESULT itemHr = shellWindows->Item(varIndex, dispatch.GetAddressOf());
+        VariantClear(&varIndex);
+
+        if (FAILED(itemHr) || !dispatch) {
+            continue;
+        }
+
+        ComPtr<IFolderView2> result = TryMatchWindow(dispatch.Get(), normalizedTarget);
+        if (result) return result;
+    }
+
+    return nullptr;
+}
+
+std::optional<PlaylistScout::ScoutResult> PlaylistScout::Explorer::scout(
+    const QUrl &url, const QStringList &allowedSuffixes) {
+    PlaylistScout::ScoutResult rv;
+
+    QFileInfo info(url.toLocalFile());
+    QString folderPath = info.path();
+    QString currentFileName = info.fileName();
+
+    // Pre-compile wildcard suffix filters into regular expressions for performance.
+    QList<QRegularExpression> nameRegexps;
+    for (const QString &pattern : allowedSuffixes) {
+        nameRegexps.append(QRegularExpression(
+            QRegularExpression::wildcardToRegularExpression(pattern),
+            QRegularExpression::CaseInsensitiveOption));
+    }
+
+    // Initialize COM. The ComGuard must be declared before any COM objects
+    // below so that CoUninitialize runs after all of them are released.
+    ComGuard comGuard;
+    if (!comGuard.IsInitialized()) {
+        ReportError("COM initialization failed");
+        return std::nullopt;
+    }
+
+    // Find a live Explorer window that is currently displaying the target folder.
+    ComPtr<IFolderView2> folderView2 = FindLiveFolderView(folderPath);
+    if (!folderView2) {
+        ReportError("No open Explorer window matches the folder: " + folderPath);
+        return std::nullopt;
+    }
+
+    // Get items already sorted in Explorer's view order, as an IShellItemArray.
+    // SVGIO_ALLVIEW returns all items; SVGIO_FLAG_VIEWORDER respects the view's sort.
+    ComPtr<IShellItemArray> itemArray;
+    if (FAILED(folderView2->Items(SVGIO_ALLVIEW | SVGIO_FLAG_VIEWORDER,
+            IID_PPV_ARGS(itemArray.GetAddressOf())))) {
+        ReportError("IFolderView2::Items(SVGIO_ALLVIEW | SVGIO_FLAG_VIEWORDER) failed");
+        return std::nullopt;
+    }
+
+    DWORD itemCount = 0;
+    itemArray->GetCount(&itemCount);
+
+    // Enumerate sorted items, filter by pattern, and build the playlist.
+    for (DWORD i = 0; i < itemCount; i++) {
+        ComPtr<IShellItem> shellItem;
+        if (FAILED(itemArray->GetItemAt(i, shellItem.GetAddressOf()))) {
+            continue;
+        }
+
+        // Get the full parsing path of the item.
+        PWSTR pathStr = nullptr;
+        if (FAILED(shellItem->GetDisplayName(SIGDN_DESKTOPABSOLUTEPARSING, &pathStr)) || !pathStr) {
+            continue;
+        }
+        QString filePath = QString::fromWCharArray(pathStr);
+        CoTaskMemFree(pathStr);
+
+        // Skip directories — the view may include folders alongside files.
+        QFileInfo fileInfo(filePath);
+        if (!fileInfo.isFile()) {
+            continue;
+        }
+
+        QString fileName = fileInfo.fileName();
+
+        // Match against compiled wildcard patterns.
+        bool matches = nameRegexps.isEmpty();
+        for (const QRegularExpression &re : std::as_const(nameRegexps)) {
+            if (re.match(fileName).hasMatch()) {
+                matches = true;
+                break;
+            }
+        }
+        if (!matches) {
+            continue;
+        }
+
+        rv.playlist.append(QUrl::fromLocalFile(filePath));
+        if (fileName == currentFileName) {
+            rv.indexHint = rv.playlist.size() - 1;
+        }
+    }
+
+    return rv;
+}
+
+#endif // Q_OS_WIN

app/playlistscouts/explorerscout.h

@@ -0,0 +1,16 @@
+// SPDX-FileCopyrightText: 2026 yyc12345 <yyc12321@outlook.com>
+//
+// SPDX-License-Identifier: MIT
+
+#pragma once
+
+#include "../playlistscout.h"
+#include <QtSystemDetection>
+
+#ifdef Q_OS_WIN
+
+namespace PlaylistScout::Explorer {
+    std::optional<ScoutResult> scout(const QUrl &url, const QStringList &allowedSuffixes);
+}
+
+#endif // Q_OS_WIN

app/playlistscouts/qtscout.cpp

@@ -0,0 +1,40 @@
+// SPDX-FileCopyrightText: 2025 Gary Wang <git@blumia.net>
+// SPDX-FileCopyrightText: 2026 yyc12345 <yyc12321@outlook.com>
+//
+// SPDX-License-Identifier: MIT
+
+#include "qtscout.h"
+
+#include <QFileInfo>
+#include <QDir>
+#include <QCollator>
+
+std::optional<PlaylistScout::ScoutResult> PlaylistScout::Qt::scout(
+    const QUrl &url, const QStringList &allowedSuffixes) {
+    PlaylistScout::ScoutResult rv;
+
+    QFileInfo info(url.toLocalFile());
+    QDir dir(info.path());
+    QString currentFileName = info.fileName();
+
+    QStringList entryList = dir.entryList(
+        allowedSuffixes, QDir::Files | QDir::NoSymLinks, QDir::NoSort);
+
+    QCollator collator;
+    collator.setNumericMode(true);
+
+    std::sort(entryList.begin(), entryList.end(), collator);
+
+    for (qsizetype i = 0; i < entryList.count(); i++) {
+        const QString &fileName = entryList.at(i);
+        const QString &oneEntry = dir.absoluteFilePath(fileName);
+        const QUrl &url = QUrl::fromLocalFile(oneEntry);
+
+        rv.playlist.append(url);
+        if (fileName == currentFileName) {
+            rv.indexHint = i;
+        }
+    }
+
+    return rv;
+}

app/playlistscouts/qtscout.h

@@ -0,0 +1,11 @@
+// SPDX-FileCopyrightText: 2026 yyc12345 <yyc12321@outlook.com>
+//
+// SPDX-License-Identifier: MIT
+
+#pragma once
+
+#include "../playlistscout.h"
+
+namespace PlaylistScout::Qt {
+    std::optional<ScoutResult> scout(const QUrl &url, const QStringList &allowedSuffixes);
+}

app/settings.cpp

@@ -1,116 +1,174 @@
-// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
-//
-// SPDX-License-Identifier: MIT
-
-#include "settings.h"
-
-#include <QApplication>
-#include <QStandardPaths>
-#include <QDebug>
-#include <QDir>
-#include <QMetaEnum>
-
-namespace QEnumHelper
-{
-    template <typename E>
-    E fromString(const QString &text, const E defaultValue)
-    {
-        bool ok;
-        E result = static_cast<E>(QMetaEnum::fromType<E>().keyToValue(text.toUtf8(), &ok));
-        if (!ok) {
-            return defaultValue;
-        }
-        return result;
-    }
-
-    template <typename E>
-    QString toString(E value)
-    {
-        const int intValue = static_cast<int>(value);
-        return QString::fromUtf8(QMetaEnum::fromType<E>().valueToKey(intValue));
-    }
-}
-
-Settings *Settings::m_settings_instance = nullptr;
-
-Settings *Settings::instance()
-{
-    if (!m_settings_instance) {
-        m_settings_instance = new Settings;
-    }
-
-    return m_settings_instance;
-}
-
-bool Settings::stayOnTop()
-{
-    return m_qsettings->value("stay_on_top", true).toBool();
-}
-
-Settings::DoubleClickBehavior Settings::doubleClickBehavior() const
-{
-    QString result = m_qsettings->value("double_click_behavior", "Close").toString();
-
-    return QEnumHelper::fromString<DoubleClickBehavior>(result, DoubleClickBehavior::Close);
-}
-
-Settings::MouseWheelBehavior Settings::mouseWheelBehavior() const
-{
-    QString result = m_qsettings->value("mouse_wheel_behavior", "Zoom").toString();
-
-    return QEnumHelper::fromString<MouseWheelBehavior>(result, MouseWheelBehavior::Zoom);
-}
-
-Settings::WindowSizeBehavior Settings::initWindowSizeBehavior() const
-{
-    QString result = m_qsettings->value("init_window_size_behavior", "Auto").toString();
-
-    return QEnumHelper::fromString<WindowSizeBehavior>(result, WindowSizeBehavior::Auto);
-}
-
-void Settings::setStayOnTop(bool on)
-{
-    m_qsettings->setValue("stay_on_top", on);
-    m_qsettings->sync();
-}
-
-void Settings::setDoubleClickBehavior(DoubleClickBehavior dcb)
-{
-    m_qsettings->setValue("double_click_behavior", QEnumHelper::toString(dcb));
-    m_qsettings->sync();
-}
-
-void Settings::setMouseWheelBehavior(MouseWheelBehavior mwb)
-{
-    m_qsettings->setValue("mouse_wheel_behavior", QEnumHelper::toString(mwb));
-    m_qsettings->sync();
-}
-
-void Settings::setInitWindowSizeBehavior(WindowSizeBehavior wsb)
-{
-    m_qsettings->setValue("init_window_size_behavior", QEnumHelper::toString(wsb));
-    m_qsettings->sync();
-}
-
-Settings::Settings()
-    : QObject(qApp)
-{
-    QString configPath;
-
-#ifdef FLAG_PORTABLE_MODE_SUPPORT
-    QString portableConfigDirPath = QDir(QCoreApplication::applicationDirPath()).absoluteFilePath("data");
-    QFileInfo portableConfigDirInfo(portableConfigDirPath);
-    if (portableConfigDirInfo.exists() && portableConfigDirInfo.isDir() && portableConfigDirInfo.isWritable()) {
-        // we can use it.
-        configPath = portableConfigDirPath;
-    }
-#endif // FLAG_PORTABLE_MODE_SUPPORT
-
-    // %LOCALAPPDATA% under Windows.
-    if (configPath.isEmpty()) {
-        configPath = QStandardPaths::writableLocation(QStandardPaths::ConfigLocation);
-    }
-
-    m_qsettings = new QSettings(QDir(configPath).absoluteFilePath("config.ini"), QSettings::IniFormat, this);
-}
-
+// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
+//
+// SPDX-License-Identifier: MIT
+
+#include "settings.h"
+
+#include <QApplication>
+#include <QStandardPaths>
+#include <QDebug>
+#include <QDir>
+#include <QAction>
+#include <QWidget>
+#include <QKeySequence>
+#include <QMetaEnum>
+
+Settings *Settings::instance()
+{
+    // SAFETY:
+    // This is a global singleton and it is leaked by design.
+    static Settings* INSTANCE = new Settings(nullptr);
+    return INSTANCE;
+}
+
+namespace QEnumHelper
+{
+    template <typename E>
+    E fromString(const QString &text, const E defaultValue)
+    {
+        bool ok;
+        E result = static_cast<E>(QMetaEnum::fromType<E>().keyToValue(text.toUtf8(), &ok));
+        if (!ok) {
+            return defaultValue;
+        }
+        return result;
+    }
+
+    template <typename E>
+    QString toString(E value)
+    {
+        const int intValue = static_cast<int>(value);
+        return QString::fromUtf8(QMetaEnum::fromType<E>().valueToKey(intValue));
+    }
+}
+
+bool Settings::showNavigatorView() const
+{
+    return m_qsettings->value("show_navigator_view", true).toBool();
+}
+
+bool Settings::useLightCheckerboard() const
+{
+    return m_qsettings->value("use_light_checkerboard", false).toBool();
+}
+
+bool Settings::loopGallery() const
+{
+    return m_qsettings->value("loop_gallery", true).toBool();
+}
+
+bool Settings::svgTiny12Only() const
+{
+    // Qt 6.7.0's SVG support is terrible caused by huge memory usage, see QTBUG-124287
+    // Qt 6.7.1's is somewhat better, memory issue seems fixed, but still laggy when zoom in, see QTBUG-126771.
+    // Qt 6.9.3 and Qt 6.10.1 seems no longer have the laggy issue, so let's make the default value different
+    // based on Qt version.
+#if QT_VERSION < QT_VERSION_CHECK(6, 9, 3)
+    return m_qsettings->value("svg_tiny12_only", true).toBool();
+#else
+    return m_qsettings->value("svg_tiny12_only", false).toBool();
+#endif // QT_VERSION < QT_VERSION_CHECK(6, 9, 3)
+}
+
+Settings::MouseWheelBehavior Settings::mouseWheelBehavior() const
+{
+    QString result = m_qsettings->value("mouse_wheel_behavior", "").toString();
+    return QEnumHelper::fromString<MouseWheelBehavior>(result, MouseWheelBehavior::Zoom);
+}
+
+Settings::WindowSizeBehavior Settings::initWindowSizeBehavior() const
+{
+    QString result = m_qsettings->value("init_window_size_behavior", "").toString();
+    return QEnumHelper::fromString<WindowSizeBehavior>(result, WindowSizeBehavior::Windowed);
+}
+
+Qt::HighDpiScaleFactorRoundingPolicy Settings::hiDpiScaleFactorBehavior() const
+{
+    QString result = m_qsettings->value("hidpi_scale_factor_behavior", "").toString();
+    return QEnumHelper::fromString<Qt::HighDpiScaleFactorRoundingPolicy>(result, Qt::HighDpiScaleFactorRoundingPolicy::PassThrough);
+}
+
+void Settings::setShowNavigatorView(bool on)
+{
+    m_qsettings->setValue("show_navigator_view", on);
+    m_qsettings->sync();
+}
+
+void Settings::setUseLightCheckerboard(bool light)
+{
+    m_qsettings->setValue("use_light_checkerboard", light);
+    m_qsettings->sync();
+}
+
+void Settings::setLoopGallery(bool on)
+{
+    m_qsettings->setValue("loop_gallery", on);
+    m_qsettings->sync();
+}
+
+void Settings::setSvgTiny12Only(bool on)
+{
+    m_qsettings->setValue("svg_tiny12_only", on);
+    m_qsettings->sync();
+}
+
+void Settings::setMouseWheelBehavior(MouseWheelBehavior mwb)
+{
+    m_qsettings->setValue("mouse_wheel_behavior", QEnumHelper::toString(mwb));
+    m_qsettings->sync();
+}
+
+void Settings::setInitWindowSizeBehavior(WindowSizeBehavior wsb)
+{
+    m_qsettings->setValue("init_window_size_behavior", QEnumHelper::toString(wsb));
+    m_qsettings->sync();
+}
+
+void Settings::setHiDpiScaleFactorBehavior(Qt::HighDpiScaleFactorRoundingPolicy hidpi)
+{
+    m_qsettings->setValue("hidpi_scale_factor_behavior", QEnumHelper::toString(hidpi));
+    m_qsettings->sync();
+}
+
+#if defined(FLAG_PORTABLE_MODE_SUPPORT) && defined(Q_OS_WIN)
+#include <windows.h>
+// QCoreApplication::applicationDirPath() parses the "applicationDirPath" from arg0, which...
+// 1. rely on a QApplication object instance
+//    but we need to call QGuiApplication::setHighDpiScaleFactorRoundingPolicy() before QApplication get created
+// 2. arg0 is NOT garanteed to be the path of execution
+//    see also: https://stackoverflow.com/questions/383973/is-args0-guaranteed-to-be-the-path-of-execution
+// This function is here mainly for #1.
+QString getApplicationDirPath()
+{
+    WCHAR buffer[MAX_PATH];
+    GetModuleFileNameW(NULL, buffer, MAX_PATH);
+    QString appPath = QString::fromWCharArray(buffer);
+
+    return appPath.left(appPath.lastIndexOf('\\'));
+}
+#endif // defined(FLAG_PORTABLE_MODE_SUPPORT) && defined(Q_OS_WIN)
+
+Settings::Settings(QObject *parent)
+    : QObject(parent)
+{
+    QString configPath;
+
+#if defined(FLAG_PORTABLE_MODE_SUPPORT) && defined(Q_OS_WIN)
+    QString portableConfigDirPath = QDir(getApplicationDirPath()).absoluteFilePath("data");
+    QFileInfo portableConfigDirInfo(portableConfigDirPath);
+    if (portableConfigDirInfo.exists() && portableConfigDirInfo.isDir() && portableConfigDirInfo.isWritable()) {
+        // we can use it.
+        configPath = portableConfigDirPath;
+    }
+#endif // defined(FLAG_PORTABLE_MODE_SUPPORT) && defined(Q_OS_WIN)
+
+    if (configPath.isEmpty()) {
+        // Should be %LOCALAPPDATA%\<APPNAME> under Windows, ~/.config/<APPNAME> under Linux.
+        configPath = QStandardPaths::writableLocation(QStandardPaths::AppConfigLocation);
+    }
+
+    m_qsettings = new QSettings(QDir(configPath).absoluteFilePath("config.ini"), QSettings::IniFormat, this);
+
+    qRegisterMetaType<QList<QKeySequence>>();
+}
+

app/settings.h

@@ -1,56 +1,52 @@
-// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
-//
-// SPDX-License-Identifier: MIT
-
-#pragma once
-
-#include <QObject>
-#include <QSettings>
-
-class Settings : public QObject
-{
-    Q_OBJECT
-public:
-    enum DoubleClickBehavior {
-        Ignore,
-        Close,
-        Maximize,
-    };
-    Q_ENUM(DoubleClickBehavior);
-
-    enum MouseWheelBehavior {
-        Zoom,
-        Switch,
-    };
-    Q_ENUM(MouseWheelBehavior);
-
-    enum WindowSizeBehavior {
-        Auto,
-        Maximized,
-    };
-    Q_ENUM(WindowSizeBehavior);
-
-    static Settings *instance();
-
-    bool stayOnTop();
-    DoubleClickBehavior doubleClickBehavior() const;
-    MouseWheelBehavior mouseWheelBehavior() const;
-    WindowSizeBehavior initWindowSizeBehavior() const;
-
-    void setStayOnTop(bool on);
-    void setDoubleClickBehavior(DoubleClickBehavior dcb);
-    void setMouseWheelBehavior(MouseWheelBehavior mwb);
-    void setInitWindowSizeBehavior(WindowSizeBehavior wsb);
-
-private:
-    Settings();
-
-    static Settings *m_settings_instance;
-
-    QSettings *m_qsettings;
-
-signals:
-
-public slots:
-};
-
+// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
+//
+// SPDX-License-Identifier: MIT
+
+#pragma once
+
+#include <QObject>
+#include <QSettings>
+
+class Settings : public QObject
+{
+    Q_OBJECT
+public:
+    enum MouseWheelBehavior {
+        Zoom,
+        Switch,
+    };
+    Q_ENUM(MouseWheelBehavior)
+
+    enum WindowSizeBehavior {
+        Maximized,
+        Windowed,
+    };
+    Q_ENUM(WindowSizeBehavior)
+
+    static Settings *instance();
+
+    bool showNavigatorView() const;
+    bool useLightCheckerboard() const;
+    bool loopGallery() const;
+    bool svgTiny12Only() const;
+    MouseWheelBehavior mouseWheelBehavior() const;
+    WindowSizeBehavior initWindowSizeBehavior() const;
+    Qt::HighDpiScaleFactorRoundingPolicy hiDpiScaleFactorBehavior() const;
+
+    void setShowNavigatorView(bool on);
+    void setUseLightCheckerboard(bool light);
+    void setLoopGallery(bool on);
+    void setSvgTiny12Only(bool on);
+    void setMouseWheelBehavior(MouseWheelBehavior mwb);
+    void setInitWindowSizeBehavior(WindowSizeBehavior wsb);
+    void setHiDpiScaleFactorBehavior(Qt::HighDpiScaleFactorRoundingPolicy hidpi);
+
+private:
+    Settings(QObject *parent = nullptr);
+
+    QSettings *m_qsettings;
+
+signals:
+
+public slots:
+};

app/settingsdialog.cpp

@@ -1,95 +1,145 @@
-// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
-//
-// SPDX-License-Identifier: MIT
-
-#include "settingsdialog.h"
-
-#include "settings.h"
-
-#include <QCheckBox>
-#include <QComboBox>
-#include <QFormLayout>
-#include <QStringListModel>
-
-SettingsDialog::SettingsDialog(QWidget *parent)
-    : QDialog(parent)
-    , m_stayOnTop(new QCheckBox)
-    , m_doubleClickBehavior(new QComboBox)
-    , m_mouseWheelBehavior(new QComboBox)
-    , m_initWindowSizeBehavior(new QComboBox)
-{
-    this->setWindowTitle(tr("Settings"));
-
-    QFormLayout * settingsForm = new QFormLayout(this);
-
-    static QList< QPair<Settings::DoubleClickBehavior, QString> > _dc_options {
-        { Settings::DoubleClickBehavior::Ignore, tr("Do nothing") },
-        { Settings::DoubleClickBehavior::Close, tr("Close the window") },
-        { Settings::DoubleClickBehavior::Maximize, tr("Toggle maximize") }
-    };
-
-    static QList< QPair<Settings::MouseWheelBehavior, QString> > _mw_options {
-        { Settings::MouseWheelBehavior::Zoom, tr("Zoom in and out") },
-        { Settings::MouseWheelBehavior::Switch, tr("View next or previous item") }
-    };
-
-    static QList< QPair<Settings::WindowSizeBehavior, QString> > _iws_options {
-        { Settings::WindowSizeBehavior::Auto, tr("Auto size") },
-        { Settings::WindowSizeBehavior::Maximized, tr("Maximized") }
-    };
-
-    QStringList dcbDropDown;
-    for (const QPair<Settings::DoubleClickBehavior, QString> & dcOption : _dc_options) {
-        dcbDropDown.append(dcOption.second);
-    }
-
-    QStringList mwbDropDown;
-    for (const QPair<Settings::MouseWheelBehavior, QString> & mwOption : _mw_options) {
-        mwbDropDown.append(mwOption.second);
-    }
-
-    QStringList iwsbDropDown;
-    for (const QPair<Settings::WindowSizeBehavior, QString> & iwsOption : _iws_options) {
-        iwsbDropDown.append(iwsOption.second);
-    }
-
-    settingsForm->addRow(tr("Stay on top when start-up"), m_stayOnTop);
-    settingsForm->addRow(tr("Double-click behavior"), m_doubleClickBehavior);
-    settingsForm->addRow(tr("Mouse wheel behavior"), m_mouseWheelBehavior);
-    settingsForm->addRow(tr("Default window size"), m_initWindowSizeBehavior);
-
-    m_stayOnTop->setChecked(Settings::instance()->stayOnTop());
-    m_doubleClickBehavior->setModel(new QStringListModel(dcbDropDown));
-    Settings::DoubleClickBehavior dcb = Settings::instance()->doubleClickBehavior();
-    m_doubleClickBehavior->setCurrentIndex(static_cast<int>(dcb));
-    m_mouseWheelBehavior->setModel(new QStringListModel(mwbDropDown));
-    Settings::MouseWheelBehavior mwb = Settings::instance()->mouseWheelBehavior();
-    m_mouseWheelBehavior->setCurrentIndex(static_cast<int>(mwb));
-    m_initWindowSizeBehavior->setModel(new QStringListModel(iwsbDropDown));
-    Settings::WindowSizeBehavior iwsb = Settings::instance()->initWindowSizeBehavior();
-    m_initWindowSizeBehavior->setCurrentIndex(static_cast<int>(iwsb));
-
-    connect(m_stayOnTop, &QCheckBox::stateChanged, this, [ = ](int state){
-        Settings::instance()->setStayOnTop(state == Qt::Checked);
-    });
-
-    connect(m_doubleClickBehavior, QOverload<int>::of(&QComboBox::currentIndexChanged), this, [ = ](int index){
-        Settings::instance()->setDoubleClickBehavior(_dc_options.at(index).first);
-    });
-
-    connect(m_mouseWheelBehavior, QOverload<int>::of(&QComboBox::currentIndexChanged), this, [ = ](int index){
-        Settings::instance()->setMouseWheelBehavior(_mw_options.at(index).first);
-    });
-
-    connect(m_initWindowSizeBehavior, QOverload<int>::of(&QComboBox::currentIndexChanged), this, [ = ](int index){
-        Settings::instance()->setInitWindowSizeBehavior(_iws_options.at(index).first);
-    });
-
-    this->setMinimumSize(300, 120); // not sure why it complain "Unable to set geometry"
-    setWindowFlag(Qt::WindowContextHelpButtonHint, false);
-}
-
-SettingsDialog::~SettingsDialog()
-{
-
-}
+// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
+//
+// SPDX-License-Identifier: MIT
+
+#include "settingsdialog.h"
+#include "ui_settingsdialog.h"
+
+#include "settings.h"
+
+#include <QApplication>
+#include <QTimer>
+#include <QStringListModel>
+#include <type_traits>
+
+template <typename E, typename = std::enable_if_t<std::is_enum_v<E>>>
+class EnumComboBoxTransformer {
+public:
+    using Pair = QPair<E, QString>;
+    using Pairs = QList<QPair<E, QString>>;
+
+    EnumComboBoxTransformer(Pairs &&pairs) : pairs(std::move(pairs)) {}
+    ~EnumComboBoxTransformer() = default;
+    Q_DISABLE_COPY_MOVE(EnumComboBoxTransformer)
+
+    /// Build Qt model used for QComboBox
+    QStringListModel* buildComboBoxModel(QObject *parent = nullptr) const {
+        QStringList dropDownEntries;
+        for (const auto& pair : std::as_const(this->pairs)) {
+            dropDownEntries.append(pair.second);
+        }
+        return new QStringListModel(dropDownEntries, parent);
+    }
+    /// Convert QComboBox index to enum value.
+    E to_value(int index) const {
+        return this->pairs.at(static_cast<qsizetype>(index)).first;
+    }
+    /// Convert enum value to QComboBox index.
+    int to_index(E value) const {
+        for (qsizetype i = 0; i < pairs.size(); ++i) {
+            if (pairs.at(i).first == value) {
+                return static_cast<int>(i);
+            }
+        }
+        // Value not found
+        throw std::invalid_argument("invalid enum value for finding index");
+    }
+
+private:
+    Pairs pairs;
+};
+
+static EnumComboBoxTransformer<Settings::MouseWheelBehavior, QString> MW_OPTIONS {
+    {
+        { Settings::MouseWheelBehavior::Zoom, QCoreApplication::translate("SettingsDialog", "Zoom in and out") },
+        { Settings::MouseWheelBehavior::Switch, QCoreApplication::translate("SettingsDialog", "View next or previous item") }
+    }
+};
+
+static EnumComboBoxTransformer<Settings::WindowSizeBehavior, QString> IWS_OPTIONS {
+    {
+        { Settings::WindowSizeBehavior::Maximized, QCoreApplication::translate("SettingsDialog", "Maximized") },
+        { Settings::WindowSizeBehavior::Windowed, QCoreApplication::translate("SettingsDialog", "Windowed") }
+    }
+};
+
+static EnumComboBoxTransformer<Qt::HighDpiScaleFactorRoundingPolicy, QString> HIDPI_OPTIONS {
+    {
+        { Qt::HighDpiScaleFactorRoundingPolicy::Round, QCoreApplication::translate("SettingsDialog", "Round (Integer scaling)", "This option means round up for .5 and above") },
+        { Qt::HighDpiScaleFactorRoundingPolicy::Ceil, QCoreApplication::translate("SettingsDialog", "Ceil (Integer scaling)", "This option means always round up") },
+        { Qt::HighDpiScaleFactorRoundingPolicy::Floor, QCoreApplication::translate("SettingsDialog", "Floor (Integer scaling)", "This option means always round down") },
+        { Qt::HighDpiScaleFactorRoundingPolicy::PassThrough, QCoreApplication::translate("SettingsDialog", "Follow system (Fractional scaling)", "This option means don't round") }
+    }
+};
+
+SettingsDialog::SettingsDialog(QWidget *parent)
+    : QDialog(parent), ui(new QT_PREPEND_NAMESPACE(Ui::SettingsDialog))
+{
+    ui->setupUi(this);
+    setWindowFlag(Qt::WindowContextHelpButtonHint, false);
+
+    auto* settings = Settings::instance();
+    ui->m_showNavigatorView->setChecked(Settings::instance()->showNavigatorView());
+    ui->m_useLightCheckerboard->setChecked(settings->useLightCheckerboard());
+    ui->m_loopGallery->setChecked(settings->loopGallery());
+    ui->m_svgTiny12Only->setChecked(settings->svgTiny12Only());
+    ui->m_mouseWheelBehavior->setModel(MW_OPTIONS.buildComboBoxModel(this));
+    Settings::MouseWheelBehavior mwb = settings->mouseWheelBehavior();
+    ui->m_mouseWheelBehavior->setCurrentIndex(MW_OPTIONS.to_index(mwb));
+    ui->m_initWindowSizeBehavior->setModel(IWS_OPTIONS.buildComboBoxModel(this));
+    Settings::WindowSizeBehavior iwsb = settings->initWindowSizeBehavior();
+    ui->m_initWindowSizeBehavior->setCurrentIndex(IWS_OPTIONS.to_index(iwsb));
+    ui->m_hiDpiRoundingPolicyBehavior->setModel(HIDPI_OPTIONS.buildComboBoxModel(this));
+    Qt::HighDpiScaleFactorRoundingPolicy hidpi = settings->hiDpiScaleFactorBehavior();
+    ui->m_hiDpiRoundingPolicyBehavior->setCurrentIndex(HIDPI_OPTIONS.to_index(hidpi));
+
+#if QT_VERSION >= QT_VERSION_CHECK(6, 7, 0)
+# define QCHECKBOX_CHECKSTATECHANGED QCheckBox::checkStateChanged
+# define QT_CHECKSTATE Qt::CheckState
+#else
+# define QCHECKBOX_CHECKSTATECHANGED QCheckBox::stateChanged
+# define QT_CHECKSTATE int
+#endif // QT_VERSION >= QT_VERSION_CHECK(6, 7, 0)
+
+    connect(ui->m_showNavigatorView, &QCHECKBOX_CHECKSTATECHANGED, this, [ = ](QT_CHECKSTATE state){
+        Settings::instance()->setShowNavigatorView(state == Qt::Checked);
+    });
+
+    connect(ui->m_useLightCheckerboard, &QCHECKBOX_CHECKSTATECHANGED, this, [ = ](QT_CHECKSTATE state){
+        Settings::instance()->setUseLightCheckerboard(state == Qt::Checked);
+    });
+
+    connect(ui->m_loopGallery, &QCHECKBOX_CHECKSTATECHANGED, this, [ = ](QT_CHECKSTATE state){
+        Settings::instance()->setLoopGallery(state == Qt::Checked);
+    });
+
+    connect(ui->m_svgTiny12Only, &QCHECKBOX_CHECKSTATECHANGED, this, [ = ](QT_CHECKSTATE state){
+        Settings::instance()->setSvgTiny12Only(state == Qt::Checked);
+    });
+
+    connect(ui->m_mouseWheelBehavior, QOverload<int>::of(&QComboBox::currentIndexChanged), this, [ = ](int index){
+        Settings::instance()->setMouseWheelBehavior(MW_OPTIONS.to_value(index));
+    });
+
+    connect(ui->m_initWindowSizeBehavior, QOverload<int>::of(&QComboBox::currentIndexChanged), this, [ = ](int index){
+        Settings::instance()->setInitWindowSizeBehavior(IWS_OPTIONS.to_value(index));
+    });
+
+    connect(ui->m_hiDpiRoundingPolicyBehavior, QOverload<int>::of(&QComboBox::currentIndexChanged), this, [ = ](int index){
+        Settings::instance()->setHiDpiScaleFactorBehavior(HIDPI_OPTIONS.to_value(index));
+    });
+
+    // YYC MARK:
+    // Use adjustSize() to make sure all ComboBox are expanded by its items.
+    // Because items are added after inserting them into layout.
+    // It is inviable to call this function in ctor because this relys on Qt event system.
+    // It only can be done by QTimer::singleShot().
+    QTimer::singleShot(0, this, [this](){
+        this->adjustSize();
+    });
+}
+
+SettingsDialog::~SettingsDialog()
+{
+    delete ui;
+}

app/settingsdialog.h

@@ -1,31 +1,27 @@
-// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
-//
-// SPDX-License-Identifier: MIT
-
-#ifndef SETTINGSDIALOG_H
-#define SETTINGSDIALOG_H
-
-#include <QObject>
-#include <QDialog>
-
-class QCheckBox;
-class QComboBox;
-class SettingsDialog : public QDialog
-{
-    Q_OBJECT
-public:
-    explicit SettingsDialog(QWidget *parent = nullptr);
-    ~SettingsDialog();
-
-signals:
-
-public slots:
-
-private:
-    QCheckBox * m_stayOnTop = nullptr;
-    QComboBox * m_doubleClickBehavior = nullptr;
-    QComboBox * m_mouseWheelBehavior = nullptr;
-    QComboBox * m_initWindowSizeBehavior = nullptr;
-};
-
-#endif // SETTINGSDIALOG_H
+// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
+//
+// SPDX-License-Identifier: MIT
+
+#ifndef SETTINGSDIALOG_H
+#define SETTINGSDIALOG_H
+
+#include <QDialog>
+
+QT_BEGIN_NAMESPACE
+namespace Ui {
+class SettingsDialog;
+}
+QT_END_NAMESPACE
+
+class SettingsDialog : public QDialog
+{
+    Q_OBJECT
+public:
+    explicit SettingsDialog(QWidget *parent = nullptr);
+    ~SettingsDialog();
+
+private:
+    QT_PREPEND_NAMESPACE(Ui::SettingsDialog) *ui;
+};
+
+#endif // SETTINGSDIALOG_H

app/settingsdialog.ui

@@ -0,0 +1,88 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<ui version="4.0">
+ <class>SettingsDialog</class>
+ <widget class="QDialog" name="SettingsDialog">
+  <property name="windowModality">
+   <enum>Qt::NonModal</enum>
+  </property>
+  <property name="windowTitle">
+   <string>Settings</string>
+  </property>
+  <layout class="QHBoxLayout" name="mainLayout">
+   <item>
+    <widget class="QTabWidget" name="settingsTabs">
+     <property name="currentIndex">
+      <number>0</number>
+     </property>
+     <widget class="QWidget" name="optionsTab">
+      <attribute name="title">
+       <string>Options</string>
+      </attribute>
+      <layout class="QFormLayout" name="settingsForm">
+        <item row="0" column="0" colspan="2">
+         <widget class="QCheckBox" name="m_showNavigatorView">
+          <property name="text">
+           <string>Show navigation view</string>
+          </property>
+         </widget>
+        </item>
+        <item row="1" column="0" colspan="2">
+         <widget class="QCheckBox" name="m_useLightCheckerboard">
+          <property name="text">
+           <string>Use light-color checkerboard</string>
+          </property>
+         </widget>
+        </item>
+        <item row="2" column="0" colspan="2">
+         <widget class="QCheckBox" name="m_loopGallery">
+          <property name="text">
+           <string>Loop the loaded gallery</string>
+          </property>
+         </widget>
+        </item>
+        <item row="3" column="0" colspan="2">
+         <widget class="QCheckBox" name="m_svgTiny12Only">
+          <property name="text">
+           <string>Limit SVG support to SVG Tiny 1.2</string>
+          </property>
+         </widget>
+        </item>
+       <item row="4" column="0">
+         <widget class="QLabel" name="m_mouseWheelBehaviorLabel">
+         <property name="text">
+          <string>Mouse wheel behavior</string>
+         </property>
+        </widget>
+       </item>
+       <item row="4" column="1">
+        <widget class="QComboBox" name="m_mouseWheelBehavior"/>
+       </item>
+       <item row="5" column="0">
+         <widget class="QLabel" name="m_initWindowSizeBehaviorLabel">
+         <property name="text">
+          <string>Default window size</string>
+         </property>
+        </widget>
+       </item>
+       <item row="5" column="1">
+        <widget class="QComboBox" name="m_initWindowSizeBehavior"/>
+       </item>
+       <item row="6" column="0">
+         <widget class="QLabel" name="m_hiDpiRoundingPolicyBehaviorLabel">
+         <property name="text">
+          <string>HiDPI scale factor rounding policy</string>
+         </property>
+        </widget>
+       </item>
+       <item row="6" column="1">
+        <widget class="QComboBox" name="m_hiDpiRoundingPolicyBehavior"/>
+       </item>
+      </layout>
+     </widget>
+    </widget>
+   </item>
+  </layout>
+ </widget>
+ <resources/>
+ <connections/>
+</ui>

app/toolbutton.cpp

@@ -1,38 +0,0 @@
-// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
-//
-// SPDX-License-Identifier: MIT
-
-#include "toolbutton.h"
-
-#include "actionmanager.h"
-#include "opacityhelper.h"
-
-#include <QPainter>
-#include <QGraphicsOpacityEffect>
-#include <QPropertyAnimation>
-
-ToolButton::ToolButton(bool hoverColor, QWidget *parent)
-    : QPushButton(parent)
-    , m_opacityHelper(new OpacityHelper(this))
-{
-    setFlat(true);
-    QString qss = "QPushButton {"
-                  "background: transparent;"
-                  "}";
-    if (hoverColor) {
-        qss += "QPushButton:hover {"
-               "background: red;"
-               "}";
-    }
-    setStyleSheet(qss);
-}
-
-void ToolButton::setIconResourcePath(const QString &iconp)
-{
-    this->setIcon(ActionManager::loadHidpiIcon(iconp, this->iconSize()));
-}
-
-void ToolButton::setOpacity(qreal opacity, bool animated)
-{
-    m_opacityHelper->setOpacity(opacity, animated);
-}

app/toolbutton.h

@@ -1,25 +0,0 @@
-// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
-//
-// SPDX-License-Identifier: MIT
-
-#ifndef TOOLBUTTON_H
-#define TOOLBUTTON_H
-
-#include <QPushButton>
-
-class OpacityHelper;
-class ToolButton : public QPushButton
-{
-    Q_OBJECT
-public:
-    ToolButton(bool hoverColor = false, QWidget * parent = nullptr);
-    void setIconResourcePath(const QString &iconp);
-
-public slots:
-    void setOpacity(qreal opacity, bool animated = true);
-
-private:
-    OpacityHelper * m_opacityHelper;
-};
-
-#endif // TOOLBUTTON_H

app/translations/PineapplePictures_ja.ts

@@ -1,716 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!DOCTYPE TS>
-<TS version="2.1" language="ja">
-<context>
-    <name>AboutDialog</name>
-    <message>
-        <location filename="../aboutdialog.cpp" line="23"/>
-        <source>About</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../aboutdialog.cpp" line="26"/>
-        <source>Launch application with image file path as argument to load the file.</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../aboutdialog.cpp" line="27"/>
-        <source>Drag and drop image file onto the window is also supported.</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../aboutdialog.cpp" line="28"/>
-        <source>None of the operations in this application will alter the pictures on disk.</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../aboutdialog.cpp" line="29"/>
-        <source>Context menu option explanation:</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../aboutdialog.cpp" line="36"/>
-        <source>Make window stay on top of all other windows.</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../aboutdialog.cpp" line="39"/>
-        <source>Avoid close window accidentally. (eg. by double clicking the window)</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../aboutdialog.cpp" line="47"/>
-        <source>Version: %1</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../aboutdialog.cpp" line="53"/>
-        <source>Logo designed by %1</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../aboutdialog.cpp" line="55"/>
-        <source>Built with Qt %1 (%2)</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../aboutdialog.cpp" line="56"/>
-        <source>Source code</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../aboutdialog.cpp" line="66"/>
-        <source>Contributors</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../aboutdialog.cpp" line="68"/>
-        <source>List of contributors on GitHub</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../aboutdialog.cpp" line="69"/>
-        <source>Thanks to all people who contributed to this project.</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../aboutdialog.cpp" line="73"/>
-        <source>Translators</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../aboutdialog.cpp" line="74"/>
-        <source>I would like to thank the following people who volunteered to translate this application.</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../aboutdialog.cpp" line="118"/>
-        <source>%1 is built on the following free software libraries:</source>
-        <comment>Free as in freedom</comment>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../aboutdialog.cpp" line="142"/>
-        <source>&amp;Special Thanks</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../aboutdialog.cpp" line="144"/>
-        <source>&amp;Third-party Libraries</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../aboutdialog.cpp" line="80"/>
-        <source>Your Rights</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../aboutdialog.cpp" line="50"/>
-        <source>Copyright (c) %1 %2</source>
-        <comment>%1 is year, %2 is the name of copyright holder(s)</comment>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../aboutdialog.cpp" line="82"/>
-        <source>%1 is released under the MIT License.</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../aboutdialog.cpp" line="83"/>
-        <source>This license grants people a number of freedoms:</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../aboutdialog.cpp" line="84"/>
-        <source>You are free to use %1, for any purpose</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../aboutdialog.cpp" line="85"/>
-        <source>You are free to distribute %1</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../aboutdialog.cpp" line="86"/>
-        <source>You can study how %1 works and change it</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../aboutdialog.cpp" line="87"/>
-        <source>You can distribute changed versions of %1</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../aboutdialog.cpp" line="89"/>
-        <source>The MIT license guarantees you this freedom. Nobody is ever permitted to take it away.</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../aboutdialog.cpp" line="117"/>
-        <source>Third-party Libraries used by %1</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../aboutdialog.cpp" line="140"/>
-        <source>&amp;Help</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../aboutdialog.cpp" line="141"/>
-        <source>&amp;About</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../aboutdialog.cpp" line="143"/>
-        <source>&amp;License</source>
-        <translation type="unfinished"></translation>
-    </message>
-</context>
-<context>
-    <name>GraphicsScene</name>
-    <message>
-        <location filename="../graphicsscene.cpp" line="57"/>
-        <source>Drag image here</source>
-        <translation type="unfinished"></translation>
-    </message>
-</context>
-<context>
-    <name>GraphicsView</name>
-    <message>
-        <location filename="../graphicsview.cpp" line="333"/>
-        <source>File url list is empty</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../graphicsview.cpp" line="52"/>
-        <source>File is not a valid image</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../graphicsview.cpp" line="57"/>
-        <location filename="../graphicsview.cpp" line="62"/>
-        <source>Image data is invalid or currently unsupported</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../graphicsview.cpp" line="341"/>
-        <source>Image data is invalid</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../graphicsview.cpp" line="348"/>
-        <source>Not supported mimedata: %1</source>
-        <translation type="unfinished"></translation>
-    </message>
-</context>
-<context>
-    <name>MainWindow</name>
-    <message>
-        <location filename="../mainwindow.cpp" line="160"/>
-        <source>File url list is empty</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../mainwindow.cpp" line="403"/>
-        <source>&amp;Copy</source>
-        <translation>コピー(&amp;C)</translation>
-    </message>
-    <message>
-        <location filename="../actionmanager.cpp" line="83"/>
-        <source>Copy P&amp;ixmap</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../actionmanager.cpp" line="84"/>
-        <source>Copy &amp;File Path</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../actionmanager.cpp" line="100"/>
-        <source>Properties</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../aboutdialog.cpp" line="35"/>
-        <location filename="../actionmanager.cpp" line="86"/>
-        <source>Stay on top</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../aboutdialog.cpp" line="38"/>
-        <location filename="../actionmanager.cpp" line="87"/>
-        <source>Protected mode</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../actionmanager.cpp" line="72"/>
-        <source>Zoom in</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../actionmanager.cpp" line="73"/>
-        <source>Zoom out</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../actionmanager.cpp" line="80"/>
-        <source>Flip &amp;Horizontally</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../actionmanager.cpp" line="85"/>
-        <source>&amp;Paste</source>
-        <translation>貼り付け(&amp;P)</translation>
-    </message>
-    <message>
-        <location filename="../actionmanager.cpp" line="74"/>
-        <source>Toggle Checkerboard</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../actionmanager.cpp" line="68"/>
-        <source>&amp;Open...</source>
-        <translation>開く(&amp;O)</translation>
-    </message>
-    <message>
-        <location filename="../actionmanager.cpp" line="70"/>
-        <source>Actual size</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../actionmanager.cpp" line="71"/>
-        <source>Toggle maximize</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../actionmanager.cpp" line="75"/>
-        <source>Rotate right</source>
-        <translation>右に回転</translation>
-    </message>
-    <message>
-        <location filename="../actionmanager.cpp" line="77"/>
-        <source>Previous image</source>
-        <translation>前の画像</translation>
-    </message>
-    <message>
-        <location filename="../actionmanager.cpp" line="78"/>
-        <source>Next image</source>
-        <translation>次の画像</translation>
-    </message>
-    <message>
-        <location filename="../actionmanager.cpp" line="88"/>
-        <source>Configure...</source>
-        <translation>設定...</translation>
-    </message>
-    <message>
-        <location filename="../actionmanager.cpp" line="89"/>
-        <source>Help</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../actionmanager.cpp" line="92"/>
-        <source>Show in File Explorer</source>
-        <comment>File Explorer is the name of explorer.exe under Windows</comment>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../actionmanager.cpp" line="98"/>
-        <source>Show in directory</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../actionmanager.cpp" line="101"/>
-        <source>Quit</source>
-        <translation>終了</translation>
-    </message>
-</context>
-<context>
-    <name>MetadataDialog</name>
-    <message>
-        <location filename="../metadatadialog.cpp" line="80"/>
-        <source>Image Metadata</source>
-        <translation type="unfinished"></translation>
-    </message>
-</context>
-<context>
-    <name>MetadataModel</name>
-    <message>
-        <location filename="../metadatamodel.cpp" line="37"/>
-        <source>Origin</source>
-        <comment>Section name.</comment>
-        <translation>元の場所</translation>
-    </message>
-    <message>
-        <location filename="../metadatamodel.cpp" line="38"/>
-        <source>Image</source>
-        <comment>Section name.</comment>
-        <translation>イメージ</translation>
-    </message>
-    <message>
-        <location filename="../metadatamodel.cpp" line="42"/>
-        <source>File</source>
-        <comment>Section name.</comment>
-        <translation>ファイル</translation>
-    </message>
-    <message>
-        <location filename="../metadatamodel.cpp" line="39"/>
-        <source>Camera</source>
-        <comment>Section name.</comment>
-        <translation>カメラ</translation>
-    </message>
-    <message>
-        <location filename="../metadatamodel.cpp" line="29"/>
-        <source>%1 File</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../metadatamodel.cpp" line="36"/>
-        <source>Description</source>
-        <comment>Section name.</comment>
-        <translation>説明</translation>
-    </message>
-    <message>
-        <location filename="../metadatamodel.cpp" line="40"/>
-        <source>Advanced photo</source>
-        <comment>Section name.</comment>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../metadatamodel.cpp" line="41"/>
-        <source>GPS</source>
-        <comment>Section name.</comment>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../metadatamodel.cpp" line="46"/>
-        <source>Dimensions</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../metadatamodel.cpp" line="48"/>
-        <source>Aspect ratio</source>
-        <translation>アスペクト比</translation>
-    </message>
-    <message>
-        <location filename="../metadatamodel.cpp" line="52"/>
-        <source>Frame count</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../metadatamodel.cpp" line="56"/>
-        <source>Name</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../metadatamodel.cpp" line="58"/>
-        <source>Item type</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../metadatamodel.cpp" line="60"/>
-        <source>Folder path</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../metadatamodel.cpp" line="62"/>
-        <source>Size</source>
-        <translation>サイズ</translation>
-    </message>
-    <message>
-        <location filename="../metadatamodel.cpp" line="64"/>
-        <source>Date created</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../metadatamodel.cpp" line="66"/>
-        <source>Date modified</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../metadatamodel.cpp" line="73"/>
-        <source>Title</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../metadatamodel.cpp" line="75"/>
-        <source>Subject</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../metadatamodel.cpp" line="77"/>
-        <source>Rating</source>
-        <translation>評価</translation>
-    </message>
-    <message>
-        <location filename="../metadatamodel.cpp" line="79"/>
-        <source>Tags</source>
-        <translation>タグ</translation>
-    </message>
-    <message>
-        <location filename="../metadatamodel.cpp" line="81"/>
-        <source>Comments</source>
-        <translation>コメント</translation>
-    </message>
-    <message>
-        <location filename="../metadatamodel.cpp" line="84"/>
-        <source>Authors</source>
-        <translation>作成者</translation>
-    </message>
-    <message>
-        <location filename="../metadatamodel.cpp" line="86"/>
-        <source>Date taken</source>
-        <translation>撮影日時</translation>
-    </message>
-    <message>
-        <location filename="../metadatamodel.cpp" line="92"/>
-        <source>Program name</source>
-        <translation>プログラム名</translation>
-    </message>
-    <message>
-        <location filename="../metadatamodel.cpp" line="94"/>
-        <source>Copyright</source>
-        <translation>著作権</translation>
-    </message>
-    <message>
-        <location filename="../metadatamodel.cpp" line="97"/>
-        <source>Horizontal resolution</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../metadatamodel.cpp" line="99"/>
-        <source>Vertical resolution</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../metadatamodel.cpp" line="101"/>
-        <source>Resolution unit</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../metadatamodel.cpp" line="103"/>
-        <source>Colour representation</source>
-        <translation>色の表現</translation>
-    </message>
-    <message>
-        <location filename="../metadatamodel.cpp" line="106"/>
-        <source>Camera maker</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../metadatamodel.cpp" line="108"/>
-        <source>Camera model</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../metadatamodel.cpp" line="110"/>
-        <source>F-stop</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../metadatamodel.cpp" line="112"/>
-        <source>Exposure time</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../metadatamodel.cpp" line="114"/>
-        <source>ISO speed</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../metadatamodel.cpp" line="116"/>
-        <source>Exposure bias</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../metadatamodel.cpp" line="118"/>
-        <source>Focal length</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../metadatamodel.cpp" line="120"/>
-        <source>Max aperture</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../metadatamodel.cpp" line="122"/>
-        <source>Metering mode</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../metadatamodel.cpp" line="124"/>
-        <source>Flash mode</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../metadatamodel.cpp" line="126"/>
-        <source>35mm focal length</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../metadatamodel.cpp" line="129"/>
-        <source>Lens model</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../metadatamodel.cpp" line="131"/>
-        <source>Brightness</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../metadatamodel.cpp" line="133"/>
-        <source>Exposure program</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../metadatamodel.cpp" line="135"/>
-        <source>Saturation</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../metadatamodel.cpp" line="137"/>
-        <source>Sharpness</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../metadatamodel.cpp" line="139"/>
-        <source>White balance</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../metadatamodel.cpp" line="141"/>
-        <source>Digital zoom</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../metadatamodel.cpp" line="143"/>
-        <source>EXIF version</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../metadatamodel.cpp" line="146"/>
-        <source>Latitude reference</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../metadatamodel.cpp" line="148"/>
-        <source>Latitude</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../metadatamodel.cpp" line="150"/>
-        <source>Longitude reference</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../metadatamodel.cpp" line="152"/>
-        <source>Longitude</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../metadatamodel.cpp" line="154"/>
-        <source>Altitude reference</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../metadatamodel.cpp" line="156"/>
-        <source>Altitude</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../metadatamodel.cpp" line="166"/>
-        <source>%1 x %2</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../metadatamodel.cpp" line="184"/>
-        <source>%1 : %2</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../metadatamodel.cpp" line="309"/>
-        <source>Property</source>
-        <translation>プロパティ</translation>
-    </message>
-    <message>
-        <location filename="../metadatamodel.cpp" line="309"/>
-        <source>Value</source>
-        <translation>値</translation>
-    </message>
-</context>
-<context>
-    <name>SettingsDialog</name>
-    <message>
-        <location filename="../settingsdialog.cpp" line="17"/>
-        <source>Settings</source>
-        <translation>設定</translation>
-    </message>
-    <message>
-        <location filename="../settingsdialog.cpp" line="22"/>
-        <source>Do nothing</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../settingsdialog.cpp" line="23"/>
-        <source>Close the window</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../settingsdialog.cpp" line="24"/>
-        <source>Toggle maximize</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../settingsdialog.cpp" line="28"/>
-        <source>Zoom in and out</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../settingsdialog.cpp" line="29"/>
-        <source>View next or previous item</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../settingsdialog.cpp" line="33"/>
-        <source>Auto size</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../settingsdialog.cpp" line="34"/>
-        <source>Maximized</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../settingsdialog.cpp" line="52"/>
-        <source>Stay on top when start-up</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../settingsdialog.cpp" line="53"/>
-        <source>Double-click behavior</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../settingsdialog.cpp" line="54"/>
-        <source>Mouse wheel behavior</source>
-        <translation>マウスホイールの挙動</translation>
-    </message>
-    <message>
-        <location filename="../settingsdialog.cpp" line="55"/>
-        <source>Default window size</source>
-        <translation type="unfinished"></translation>
-    </message>
-</context>
-<context>
-    <name>main</name>
-    <message>
-        <location filename="../main.cpp" line="31"/>
-        <source>Pineapple Pictures</source>
-        <translation type="unfinished"></translation>
-    </message>
-    <message>
-        <location filename="../main.cpp" line="35"/>
-        <source>File list.</source>
-        <translation type="unfinished"></translation>
-    </message>
-</context>
-</TS>

appveyor.yml

@@ -1,150 +0,0 @@
-image:
-  - Visual Studio 2019
-environment:
-  CMAKE_INSTALL_PREFIX: C:\projects\cmake
-  LIBZ: C:\projects\zlib
-  LIBEXPAT: C:\projects\libexpat
-  LIBAVIF: C:\projects\libavif
-  LIBEXIV2: C:\projects\exiv2
-  PPKG: C:\projects\ppkg
-  matrix:
-    - build_name: mingw81_64_qt5_15_2
-      QTDIR: C:\Qt\5.15.2\mingw81_64
-      MINGW64: C:\Qt\Tools\mingw810_64
-
-install:
-  - mkdir %CMAKE_INSTALL_PREFIX%
-  - mkdir %LIBZ%
-  - mkdir %LIBEXPAT%
-  - mkdir %LIBAVIF%
-  - mkdir %LIBEXIV2%
-  - mkdir %PPKG%
-  - cd %APPVEYOR_BUILD_FOLDER%
-  - git submodule update --init --recursive
-  - set PATH=%PATH%;%CMAKE_INSTALL_PREFIX%;%QTDIR%\bin;%MINGW64%\bin;%PPKG%
-  - set CC=%MINGW64%\bin\gcc.exe
-  - set CXX=%MINGW64%\bin\g++.exe
-
-build_script:
-# prepare
-  - mkdir 3rdparty
-  - cinst ninja
-  - cd %PPKG%
-  - curl -fsSL -o ppkg.exe https://github.com/BLumia/pineapple-package-manager/releases/latest/download/ppkg.exe
-  - cd %APPVEYOR_BUILD_FOLDER%
-# download and install zlib for KArchive
-  - cd %LIBZ%
-  - curl -fsSL -o zlib1213.zip https://zlib.net/zlib1213.zip
-  - 7z x zlib1213.zip -y
-  - cd zlib-1.2.13
-  - mkdir build
-  - cd build
-  - cmake .. -G "Ninja" -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=%CMAKE_INSTALL_PREFIX%
-  - cmake --build . --config Release
-  - cmake --build . --config Release --target install/strip
-  - cd %APPVEYOR_BUILD_FOLDER%
-# install ECM so we can build KImageFormats
-  - cd 3rdparty
-  - git clone -q https://invent.kde.org/frameworks/extra-cmake-modules.git
-  - git rev-parse HEAD
-  - cd extra-cmake-modules
-  - cmake -G "Ninja" . -DCMAKE_INSTALL_PREFIX=%CMAKE_INSTALL_PREFIX% -DBUILD_TESTING=OFF
-  - cmake --build .
-  - cmake --build . --target install
-  - cd %APPVEYOR_BUILD_FOLDER%
-# install AOM for libavif AV1 decoding support...
-  - cd 3rdparty
-  #- git clone -b v3.2.0 --depth 1 https://aomedia.googlesource.com/aom
-  #- cd aom
-  #- mkdir build.libavif
-  #- cd build.libavif
-  #- cmake .. -G "Ninja" -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=%CMAKE_INSTALL_PREFIX% -DENABLE_DOCS=OFF -DBUILD_SHARED_LIBS=ON -DAOM_TARGET_CPU=generic -DENABLE_TESTS=OFF -DENABLE_TESTDATA=OFF -DENABLE_TOOLS=OFF -DENABLE_EXAMPLES=0
-  #- cmake --build . --config Release
-  #- cmake --build . --config Release --target install/strip
-  - mkdir aom
-  - cd aom
-  - curl -fsSL -o ppkg-aom.zip https://sourceforge.net/projects/pineapple-package-manager/files/packages/mingw-w64-x86_64-windows/aom-3.2.0-2.zip
-  - ppkg ppkg-aom.zip
-  - 7z x ppkg-aom.zip LICENSE -y
-  - cd %APPVEYOR_BUILD_FOLDER%
-# install libavif for avif format support of KImageFormats
-  - cd %LIBAVIF%
-  - curl -fsSL -o libavif-v0_10_1.zip https://github.com/AOMediaCodec/libavif/archive/v0.10.1.zip
-  - 7z x libavif-v0_10_1.zip -y
-  - cd libavif-0.10.1
-  - mkdir build
-  - cd build
-  - cmake .. -G "Ninja" -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=%CMAKE_INSTALL_PREFIX% -DAVIF_CODEC_AOM=ON
-  - cmake --build . --config Release
-  - cmake --build . --config Release --target install/strip
-  - cd %APPVEYOR_BUILD_FOLDER%
-# install KArchive for kra format support of KImageFormats
-  - cd 3rdparty
-  - git clone -q https://invent.kde.org/frameworks/karchive.git
-  - git rev-parse HEAD
-  - cd karchive
-  - mkdir build
-  - cd build
-  - cmake .. -G "Ninja" -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=%CMAKE_INSTALL_PREFIX%
-  - cmake --build . --config Release
-  - cmake --build . --config Release --target install/strip
-  - cd %APPVEYOR_BUILD_FOLDER%
-# build libexpat for libexiv2
-  - cd %LIBEXPAT%
-  - curl -fsSL -o R_2_4_8.zip https://github.com/libexpat/libexpat/archive/R_2_4_8.zip
-  - 7z x R_2_4_8.zip -y
-  - cd libexpat-R_2_4_8/expat/
-  - cmake -G "Ninja" . -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=%CMAKE_INSTALL_PREFIX% -DEXPAT_BUILD_EXAMPLES=OFF -DEXPAT_BUILD_TESTS=OFF -DEXPAT_BUILD_TOOLS=OFF
-  - cmake --build . --target install/strip
-  - cd %APPVEYOR_BUILD_FOLDER%
-# build libexiv2
-  - cd %LIBEXIV2%
-  - curl -fsSL -o v0.27.5.zip https://github.com/Exiv2/exiv2/archive/v0.27.5.zip
-  - 7z x v0.27.5.zip -y
-  - cd exiv2-0.27.5
-  - cmake -G "Ninja" . -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=%CMAKE_INSTALL_PREFIX% -DEXIV2_BUILD_SAMPLES=OFF -DEXIV2_ENABLE_WIN_UNICODE=ON
-  - cmake --build . --target install/strip
-  - cd %APPVEYOR_BUILD_FOLDER%
-# install KImageFormats
-  - cd 3rdparty
-  - git clone -q https://invent.kde.org/frameworks/kimageformats.git
-  - git rev-parse HEAD
-  - cd kimageformats
-  - mkdir build
-  - cd build
-  - cmake .. -G "Ninja" -DCMAKE_BUILD_TYPE=Release -DKDE_INSTALL_QTPLUGINDIR=%QTDIR%\plugins
-  - cmake --build . --config Release
-  - cmake --build . --config Release --target install/strip
-  - cd %APPVEYOR_BUILD_FOLDER%
-# finally...
-  - mkdir build
-  - cd build
-  - cmake .. -G "Unix Makefiles" -DCMAKE_BUILD_TYPE=Release -DCMAKE_MAKE_PROGRAM=mingw32-make -DCMAKE_INSTALL_PREFIX='%cd%'
-  - cmake --build . --config Release
-  - cmake --build . --config Release --target install/strip
-# fixme: I don't know how to NOT make the binary installed to the ./bin/ folder...
-  - cd bin
-  - copy %APPVEYOR_BUILD_FOLDER%\LICENSE .
-  - copy %CMAKE_INSTALL_PREFIX%\bin\libaom.dll
-  - copy %CMAKE_INSTALL_PREFIX%\bin\libexpat.dll
-  - copy %CMAKE_INSTALL_PREFIX%\bin\libexiv2.dll
-  - copy %CMAKE_INSTALL_PREFIX%\bin\libavif.dll
-  - copy %CMAKE_INSTALL_PREFIX%\bin\libzlib.dll
-  - copy C:\projects\cmake\bin\libKF5Archive.dll .
-  - windeployqt --verbose=2 --no-quick-import --no-translations --no-opengl-sw --no-angle --no-system-d3d-compiler .\ppic.exe
-# copy 3rdparty licenses for the libs we vendored for windows...
-  - mkdir licenses
-  - cd licenses
-  - copy %APPVEYOR_BUILD_FOLDER%\3rdparty\aom\LICENSE License.aom.txt
-  - copy %APPVEYOR_BUILD_FOLDER%\3rdparty\karchive\LICENSES\LGPL-2.0-or-later.txt License.KArchive.txt
-  - copy %APPVEYOR_BUILD_FOLDER%\3rdparty\kimageformats\LICENSES\LGPL-2.1-or-later.txt License.kimageformats.txt
-  - copy %LIBEXPAT%\libexpat-R_2_4_8\expat\COPYING License.expat.txt
-  - copy %LIBAVIF%\libavif-0.10.1\LICENSE License.libavif.txt
-  - copy %LIBEXIV2%\exiv2-0.27.5\COPYING License.exiv2.txt
-# TODO: Qt, zlib
-  - cd ..
-# for debug..
-  - tree /f
-
-artifacts:
-  - path: build\bin

assets/htmls/about.html

@@ -0,0 +1,29 @@
+<center>
+    <p>
+        <img width='128' height='128' src=':/icons/app-icon.png'/>
+        <br/>
+        <!-- Application name -->
+        <span>%1</span>
+        <br/>
+        <!-- Version info -->
+        <span>%2</span>
+    </p>
+    <hr/>
+    <p>
+        <!-- Upstream author and fork author -->
+        <span>%3</span><span>:&nbsp;</span><a href='https://github.com/BLumia'>@BLumia</a>
+        <br/>
+        <span>%4</span><span>:&nbsp;</span><a href='https://github.com/yyc12345'>@yyc12345</a>
+        <br/>
+        <!-- Icon author -->
+        <span>%5</span><span>:&nbsp;</span><a href='https://github.com/Lovelyblack'>@Lovelyblack</a>
+    </p>
+    <hr/>
+    <p>
+        <!-- Built Qt version info -->
+        <span>%6</span>
+        <br/>
+        <!-- Source code -->
+        <span>%7</span><span>:&nbsp;</span><a href='https://github.com/BLumia/pineapple-pictures'>GitHub</a>
+    </p>
+</center>

assets/htmls/help.html

@@ -0,0 +1,29 @@
+<!-- General help -->
+<h1 align='center'>%1</h1>
+<ul>
+    <li>
+        <span>%2</span>
+        <ul>
+            <li>%3</li>
+            <li>%4</li>
+        </ul>
+    </li>
+    <li>%5</li>
+    <li>%6</li>
+</ul>
+<hr/>
+<!-- Context menu option help -->
+<h1 align='center'>%7</h1>
+<!-- Context menu option list -->
+<ul>
+    <li>
+        <b>%8</b><span>:</span>
+        <br/>
+        <span>%9</span>
+    </li>
+    <li>
+        <b>%10</b><span>:</span>
+        <br/>
+        <span>%11</span>
+    </li>
+</ul>

assets/htmls/license.html

@@ -0,0 +1,29 @@
+<!-- License -->
+<h1 align='center'><b>%1</b></h1>
+<p>%2</p>
+<hr/>
+<!-- VErbatime license -->
+<h1 align='center'><b>%3</b></h1>
+<pre>
+Expat/MIT License
+
+Copyright &copy; 2026 BLumia
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+</pre>

assets/htmls/special-thanks.html

@@ -0,0 +1,32 @@
+<!-- Contributor title -->
+<h1 align='center'>%1</h1>
+<!-- Contributor list -->
+<a href='https://github.com/BLumia/pineapple-pictures/graphs/contributors'>%2</a>
+<!-- The message to thank these contributors -->
+<p>%3</p>
+
+<!-- Translator title -->
+<h1 align='center'>%4</h1>
+<!-- The message to thank these translators -->
+<p>%5</p>
+<ul>
+<li><u>Catalan</u>: Toni Estévez</li>
+<li><u>Chinese (Simplified)</u>: Percy Hong</li>
+<li><u>Dutch</u>: Heimen Stoffels</li>
+<li><u>French</u>: J. Lavoie, K. Herbert, Maxime Leroy</li>
+<li><u>German</u>: K. Herbert, J. Lavoie, sal0max</li>
+<li><u>Indonesian</u>: liimee, Reza Almanda</li>
+<li><u>Italian</u>: albanobattistella</li>
+<li><u>Japanese</u>: Black Cat, mmahhi, Percy Hong</li>
+<li><u>Korean</u>: VenusGirl</li>
+<li><u>Norwegian Bokmål</u>: Allan Nordhøy, ovl-1</li>
+<li><u>Punjabi (Pakistan)</u>: bgo-eiu</li>
+<li><u>Russian</u>: Sergey Shornikov, Artem, Andrey</li>
+<li><u>Sinhala</u>: HelaBasa</li>
+<li><u>Slovenian</u>: Andrej Poženel - SDT</li>
+<li><u>Spanish</u>: Toni Estévez, Génesis Toxical, William(ѕ)ⁿ, gallegonovato</li>
+<li><u>Tamil</u>: தமிழ்நேரம் (TamilNeram)</li>
+<li><u>Turkish</u>: E-Akcaer, Oğuz Ersen, Sabri Ünal</li>
+<li><u>Ukrainian</u>: Dan, volkov, Сергій</li>
+<li><u>Vietnamese</u>: Loc Huynh</li>
+</ul>

assets/htmls/third-party-libs.html

@@ -0,0 +1,15 @@
+<!-- Title -->
+<h1 align='center'><b>%1</b></h1>
+<!-- List intro message -->
+<p>%2</p>
+<p>%3</p>
+<ul>
+    <li>
+        <a href='https://www.qt.io/'>Qt</a><span>: </span>
+        <span>GPLv2 + GPLv3 + LGPLv2.1 + LGPLv3</span>
+    </li>
+    <li style="display: none;">
+        <a href='https://www.exiv2.org/'>Exiv2</a><span>: </span>
+        <span>GPLv2</span>
+    </li>
+</ul>

assets/icons/go-next.svg

@@ -1,15 +0,0 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
-<svg width="100%" height="100%" viewBox="0 0 75 75" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xml:space="preserve" xmlns:serif="http://www.serif.com/" style="fill-rule:evenodd;clip-rule:evenodd;">
-    <g transform="matrix(1,0,0,1,-119,-102)">
-        <g id="go-next" transform="matrix(1.25,0,0,1.44231,119,-7.61538)">
-            <rect x="0" y="76" width="60" height="52" style="fill:none;"/>
-            <g transform="matrix(0.8,0,0,0.693333,0.260244,25.056)">
-                <circle cx="37.175" cy="110.977" r="33.175" style="fill-opacity:0.15;stroke:white;stroke-width:2px;"/>
-            </g>
-            <g id="path867" transform="matrix(0.8,0,0,0.693333,1.80436,76.0055)">
-                <path d="M31.578,26.175L42.911,37.508L31.578,48.809" style="fill:none;fill-rule:nonzero;stroke:white;stroke-width:2px;"/>
-            </g>
-        </g>
-    </g>
-</svg>

assets/icons/go-previous.svg

@@ -1,15 +0,0 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
-<svg width="100%" height="100%" viewBox="0 0 75 75" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xml:space="preserve" xmlns:serif="http://www.serif.com/" style="fill-rule:evenodd;clip-rule:evenodd;">
-    <g transform="matrix(1,0,0,1,-39,-102)">
-        <g id="go-previous" transform="matrix(1.25,0,0,1.44231,39,-7.61538)">
-            <rect x="0" y="76" width="60" height="52" style="fill:none;"/>
-            <g transform="matrix(0.8,0,0,0.693333,0.260244,25.056)">
-                <circle cx="37.175" cy="110.977" r="33.175" style="fill-opacity:0.15;stroke:white;stroke-width:2px;"/>
-            </g>
-            <g id="path867" transform="matrix(0.8,0,0,0.693333,-1.8205,76.0055)">
-                <path d="M43.442,26.175L32.109,37.508L43.442,48.809" style="fill:none;fill-rule:nonzero;stroke:white;stroke-width:2px;"/>
-            </g>
-        </g>
-    </g>
-</svg>

assets/icons/object-rotate-right.svg

@@ -1,17 +0,0 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
-<svg width="100%" height="100%" viewBox="0 0 32 32" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xml:space="preserve" xmlns:serif="http://www.serif.com/" style="fill-rule:evenodd;clip-rule:evenodd;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:1.5;">
-    <g transform="matrix(1,0,0,1,-74,-7.10543e-15)">
-        <g id="object-rotate-right" transform="matrix(1,0,0,1,74,7.10543e-15)">
-            <rect x="0" y="0" width="32" height="32" style="fill:none;"/>
-            <g transform="matrix(1,0,0,1,-1,-0.275147)">
-                <g transform="matrix(1,0,0,1,-74,-7.10543e-15)">
-                    <path d="M100,18C100,22.967 95.967,27 91,27C86.033,27 82,22.967 82,18C82,13.033 86.033,9 91,9" style="fill:none;stroke:white;stroke-width:2px;"/>
-                </g>
-                <g transform="matrix(0.984136,-0.177418,0.177418,0.984136,-74.2676,16.4198)">
-                    <path d="M89,13L93,9L89,5" style="fill:none;stroke:white;stroke-width:2px;"/>
-                </g>
-            </g>
-        </g>
-    </g>
-</svg>

assets/icons/view-background-checkerboard.svg

@@ -1,24 +0,0 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
-<svg width="100%" height="100%" viewBox="0 0 32 32" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xml:space="preserve" xmlns:serif="http://www.serif.com/" style="fill-rule:evenodd;clip-rule:evenodd;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:1.5;">
-    <g transform="matrix(1,0,0,1,0,-37)">
-        <g id="view-background-checkerboard" transform="matrix(1,0,0,1,0,37)">
-            <rect x="0" y="0" width="32" height="32" style="fill:none;"/>
-            <g id="rect814" transform="matrix(0.964431,0,0,0.907545,0.187581,-988.266)">
-                <rect x="6.027" y="1095.56" width="10.369" height="11.019" style="fill:white;fill-opacity:0.87;"/>
-            </g>
-            <g id="rect814-4" transform="matrix(0.984615,0,0,0.898704,-0.143354,-978.502)">
-                <rect x="16.396" y="1106.6" width="10.156" height="11.127" style="fill:white;fill-opacity:0.87;"/>
-            </g>
-            <g id="rect814-2" transform="matrix(0.963684,0,0,0.898697,0.199828,-978.495)">
-                <rect x="6.019" y="1106.6" width="10.377" height="11.127" style="fill:white;fill-opacity:0.07;"/>
-            </g>
-            <g id="rect814-2-6" transform="matrix(0.980558,0,0,0.898693,-0.0768322,-978.47)">
-                <rect x="16.396" y="1095.45" width="10.198" height="11.127" style="fill:white;fill-opacity:0.07;"/>
-            </g>
-            <g transform="matrix(1,0,0,0.952381,-74,-34)">
-                <rect x="80" y="42" width="20" height="21" style="fill:none;stroke:white;stroke-width:2.05px;"/>
-            </g>
-        </g>
-    </g>
-</svg>

assets/icons/view-fullscreen.svg

@@ -1,24 +0,0 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
-<svg width="100%" height="100%" viewBox="0 0 32 32" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xml:space="preserve" xmlns:serif="http://www.serif.com/" style="fill-rule:evenodd;clip-rule:evenodd;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:1.5;">
-    <g transform="matrix(1,0,0,1,-37,-37)">
-        <g id="view-fullscreen" transform="matrix(1,0,0,1,37,37)">
-            <rect x="0" y="0" width="32" height="32" style="fill:none;"/>
-            <g transform="matrix(1,0,0,1,-36,-37)">
-                <path d="M42,49L42,43L48,43" style="fill:none;stroke:white;stroke-width:2px;"/>
-            </g>
-            <g transform="matrix(-1,1.22465e-16,1.22465e-16,1,68,-37)">
-                <path d="M42,49L42,43L48,43" style="fill:none;stroke:white;stroke-width:2px;"/>
-            </g>
-            <g transform="matrix(1,-2.46519e-32,-2.46519e-32,-1,-36,69)">
-                <path d="M42,49L42,43L48,43" style="fill:none;stroke:white;stroke-width:2px;"/>
-            </g>
-            <g transform="matrix(1.11111,0,0,1.14286,-42.3333,-42.8571)">
-                <rect x="48" y="48" width="9" height="7" style="fill:none;stroke:white;stroke-width:1.77px;"/>
-            </g>
-            <g transform="matrix(-1,-1.22465e-16,1.22465e-16,-1,68,69)">
-                <path d="M42,49L42,43L48,43" style="fill:none;stroke:white;stroke-width:2px;"/>
-            </g>
-        </g>
-    </g>
-</svg>

assets/icons/window-close.svg

@@ -1,71 +0,0 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!-- Created with Inkscape (http://www.inkscape.org/) -->
-
-<svg
-   xmlns:dc="http://purl.org/dc/elements/1.1/"
-   xmlns:cc="http://creativecommons.org/ns#"
-   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
-   xmlns:svg="http://www.w3.org/2000/svg"
-   xmlns="http://www.w3.org/2000/svg"
-   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
-   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
-   width="32"
-   height="32"
-   viewBox="0 0 8.4666665 8.4666669"
-   version="1.1"
-   id="svg8"
-   inkscape:version="0.92.4 (5da689c313, 2019-01-14)"
-   sodipodi:docname="window-close.svg">
-  <defs
-     id="defs2" />
-  <sodipodi:namedview
-     id="base"
-     pagecolor="#000000"
-     bordercolor="#666666"
-     borderopacity="1.0"
-     inkscape:pageopacity="0.69803922"
-     inkscape:pageshadow="2"
-     inkscape:zoom="22.627417"
-     inkscape:cx="19.29838"
-     inkscape:cy="15.79404"
-     inkscape:document-units="px"
-     inkscape:current-layer="layer1"
-     showgrid="false"
-     units="px"
-     inkscape:pagecheckerboard="true"
-     inkscape:window-width="1920"
-     inkscape:window-height="1001"
-     inkscape:window-x="-9"
-     inkscape:window-y="-9"
-     inkscape:window-maximized="1" />
-  <metadata
-     id="metadata5">
-    <rdf:RDF>
-      <cc:Work
-         rdf:about="">
-        <dc:format>image/svg+xml</dc:format>
-        <dc:type
-           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
-        <dc:title />
-      </cc:Work>
-    </rdf:RDF>
-  </metadata>
-  <g
-     inkscape:label="Layer 1"
-     inkscape:groupmode="layer"
-     id="layer1"
-     transform="translate(0,-288.5333)">
-    <path
-       style="fill:none;stroke:#ffffff;stroke-width:0.396875;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;stroke-miterlimit:4;stroke-dasharray:none"
-       d="m 2.100237,290.55098 4.3234589,4.22265"
-       id="path817"
-       inkscape:connector-curvature="0"
-       sodipodi:nodetypes="cc" />
-    <path
-       style="fill:none;stroke:#ffffff;stroke-width:0.396875;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;stroke-miterlimit:4;stroke-dasharray:none"
-       d="m 2.099406,294.78651 4.3414732,-4.24185"
-       id="path819"
-       inkscape:connector-curvature="0"
-       sodipodi:nodetypes="cc" />
-  </g>
-</svg>

assets/icons/zoom-in.svg

@@ -1,17 +0,0 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
-<svg width="100%" height="100%" viewBox="0 0 32 32" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xml:space="preserve" xmlns:serif="http://www.serif.com/" style="fill-rule:evenodd;clip-rule:evenodd;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:1.5;">
-    <rect id="zoom-in" x="0" y="0" width="32" height="32" style="fill:none;"/>
-    <g id="zoom-in1" serif:id="zoom-in">
-        <g>
-            <g transform="matrix(1,0,0,1,-1,0)">
-                <circle cx="16" cy="15" r="9" style="fill:none;stroke:white;stroke-width:2px;"/>
-            </g>
-            <g transform="matrix(0.8,0.8,-0.8,0.8,27.6,-17.2)">
-                <path d="M21,28L26,28" style="fill:none;stroke:white;stroke-width:2.65px;"/>
-            </g>
-            <path d="M11,15L19,15" style="fill:none;stroke:white;stroke-width:2px;"/>
-            <path d="M15,11L15,19" style="fill:none;stroke:white;stroke-width:2px;"/>
-        </g>
-    </g>
-</svg>

assets/icons/zoom-original.svg

@@ -1,24 +0,0 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
-<svg width="100%" height="100%" viewBox="0 0 32 32" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xml:space="preserve" xmlns:serif="http://www.serif.com/" style="fill-rule:evenodd;clip-rule:evenodd;stroke-linecap:square;stroke-miterlimit:1.5;">
-    <g transform="matrix(1,0,0,1,-74,-37)">
-        <g id="zoom-original" transform="matrix(1,0,0,1,74,37)">
-            <rect x="0" y="0" width="32" height="32" style="fill:none;"/>
-            <g transform="matrix(1,0,0,1,-73,-37)">
-                <path d="M85,57L85,49L84,49" style="fill:none;stroke:white;stroke-width:2px;"/>
-            </g>
-            <g transform="matrix(1,0,0,1,-74,-37)">
-                <rect x="89" y="50" width="2" height="2" style="fill:white;"/>
-            </g>
-            <g transform="matrix(1,0,0,1,-74,-33)">
-                <rect x="89" y="50" width="2" height="2" style="fill:white;"/>
-            </g>
-            <g transform="matrix(1,0,0,1,-64,-37)">
-                <path d="M85,57L85,49L84,49" style="fill:none;stroke:white;stroke-width:2px;"/>
-            </g>
-            <g transform="matrix(1,0,0,0.952381,-74,-34)">
-                <rect x="80" y="42" width="20" height="21" style="fill:none;stroke:white;stroke-width:2.05px;stroke-linecap:round;stroke-linejoin:round;"/>
-            </g>
-        </g>
-    </g>
-</svg>

assets/icons/zoom-out.svg

@@ -1,18 +0,0 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
-<svg width="100%" height="100%" viewBox="0 0 32 32" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xml:space="preserve" xmlns:serif="http://www.serif.com/" style="fill-rule:evenodd;clip-rule:evenodd;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:1.5;">
-    <g transform="matrix(1,0,0,1,-74,0)">
-        <g id="zoom-out" transform="matrix(1,0,0,1,74,0)">
-            <rect x="0" y="0" width="32" height="32" style="fill:none;"/>
-            <g>
-                <g transform="matrix(1,0,0,1,-1,0)">
-                    <circle cx="16" cy="15" r="9" style="fill:none;stroke:white;stroke-width:2px;"/>
-                </g>
-                <g transform="matrix(0.8,0.8,-0.8,0.8,27.6,-17.2)">
-                    <path d="M21,28L26,28" style="fill:none;stroke:white;stroke-width:2.65px;"/>
-                </g>
-                <path d="M11,15L19,15" style="fill:none;stroke:white;stroke-width:2px;"/>
-            </g>
-        </g>
-    </g>
-</svg>

assets/pineapple-pictures.rc

@@ -1,17 +0,0 @@
-IDI_ICON1               ICON    DISCARDABLE     "icons/app-icon.ico"
-1               VERSIONINFO
-BEGIN
-    BLOCK "StringFileInfo"
-    BEGIN
-        BLOCK "040904E4"
-        BEGIN
-            VALUE "FileDescription", "Pineapple Pictures - Image Viewer"
-            VALUE "LegalCopyright", "MIT/Expat License - Copyright (C) 2020 Gary Wang"
-            VALUE "ProductName", "Pineapple Pictures"
-        END
-    END
-    BLOCK "VarFileInfo"
-    BEGIN
-        VALUE "Translation", 0x409, 1200
-    END
-END

assets/plain/translators.html

@@ -1,14 +0,0 @@
-<ul>
-<li><u>Catalan</u>: Toni Estévez</li>
-<li><u>Chinese (Simplified)</u>: Percy Hong</li>
-<li><u>Dutch</u>: Heimen Stoffels</li>
-<li><u>French</u>: J. Lavoie, K. Herbert, Maxime Leroy</li>
-<li><u>German</u>: K. Herbert, J. Lavoie, sal0max</li>
-<li><u>Indonesian</u>: liimee</li>
-<li><u>Norwegian Bokmål</u>: Allan Nordhøy</li>
-<li><u>Punjabi (Pakistan)</u>: bgo-eiu</li>
-<li><u>Russian</u>: Sergey Shornikov, Artem, Andrey</li>
-<li><u>Sinhala</u>: HelaBasa</li>
-<li><u>Spanish</u>: Toni Estévez, Génesis Toxical, William(ѕ)ⁿ</li>
-<li><u>Turkish</u>: E-Akcaer, Oğuz Ersen</li>
-</ul>

assets/resources.qrc

@@ -1,15 +1,23 @@
 <RCC>
     <qresource prefix="/">
-        <file>icons/zoom-in.svg</file>
-        <file>icons/zoom-out.svg</file>
-        <file>icons/view-fullscreen.svg</file>
-        <file>icons/zoom-original.svg</file>
-        <file>icons/object-rotate-right.svg</file>
-        <file>icons/view-background-checkerboard.svg</file>
-        <file>icons/app-icon.svg</file>
-        <file>icons/window-close.svg</file>
-        <file>icons/go-next.svg</file>
-        <file>icons/go-previous.svg</file>
-        <file>plain/translators.html</file>
+        <!-- In-app icon resources -->
+        <file>icons/app-icon.png</file>
+        <file>icons/image-info.png</file>
+        <file>icons/fit-to-screen.png</file>
+        <file>icons/fit-to-size.png</file>
+        <file>icons/zoom-in.png</file>
+        <file>icons/zoom-out.png</file>
+        <file>icons/rotate-left.png</file>
+        <file>icons/rotate-right.png</file>
+        <file>icons/go-next.png</file>
+        <file>icons/go-previous.png</file>
+        <file>icons/flip-horizontal.png</file>
+        <file>icons/flip-vertical.png</file>
+        <!-- HTML resources -->
+        <file>htmls/help.html</file>
+        <file>htmls/about.html</file>
+        <file>htmls/special-thanks.html</file>
+        <file>htmls/license.html</file>
+        <file>htmls/third-party-libs.html</file>
     </qresource>
 </RCC>

cmake/FindLibExiv2.cmake

@@ -1,96 +0,0 @@
-#.rst:
-# FindLibExiv2
-# ------------
-#
-# Try to find the Exiv2 library.
-#
-# This will define the following variables:
-#
-# ``LibExiv2_FOUND``
-#     True if (the requested version of) Exiv2 is available
-#
-# ``LibExiv2_VERSION``
-#     The version of Exiv2
-#
-# ``LibExiv2_INCLUDE_DIRS``
-#     The include dirs of Exiv2 for use with target_include_directories()
-#
-# ``LibExiv2_LIBRARIES``
-#     The Exiv2 library for use with target_link_libraries().
-#     This can be passed to target_link_libraries() instead of
-#     the ``LibExiv2::LibExiv2`` target
-#
-# If ``LibExiv2_FOUND`` is TRUE, it will also define the following imported
-# target:
-#
-# ``LibExiv2::LibExiv2``
-#     The Exiv2 library
-#
-# In general we recommend using the imported target, as it is easier to use.
-# Bear in mind, however, that if the target is in the link interface of an
-# exported library, it must be made available by the package config file.
-#
-# Since 5.53.0.
-#
-#=============================================================================
-# SPDX-FileCopyrightText: 2018 Christophe Giboudeaux <christophe@krop.fr>
-# SPDX-FileCopyrightText: 2010 Alexander Neundorf <neundorf@kde.org>
-# SPDX-FileCopyrightText: 2008 Gilles Caulier <caulier.gilles@gmail.com>
-#
-# SPDX-License-Identifier: BSD-3-Clause
-#=============================================================================
-
-find_package(PkgConfig QUIET)
-pkg_check_modules(PC_EXIV2 QUIET exiv2)
-
-find_path(LibExiv2_INCLUDE_DIRS NAMES exiv2/exif.hpp
-    HINTS ${PC_EXIV2_INCLUDEDIR}
-)
-
-find_library(LibExiv2_LIBRARIES NAMES exiv2 libexiv2
-    HINTS ${PC_EXIV2_LIBRARY_DIRS}
-)
-
-set(LibExiv2_VERSION ${PC_EXIV2_VERSION})
-
-if(NOT LibExiv2_VERSION AND DEFINED LibExiv2_INCLUDE_DIRS)
-    # With exiv >= 0.27, the version #defines are in exv_conf.h instead of version.hpp
-    foreach(_exiv2_version_file "version.hpp" "exv_conf.h")
-        if(EXISTS "${LibExiv2_INCLUDE_DIRS}/exiv2/${_exiv2_version_file}")
-            file(READ "${LibExiv2_INCLUDE_DIRS}/exiv2/${_exiv2_version_file}" _exiv_version_file_content)
-            string(REGEX MATCH "#define EXIV2_MAJOR_VERSION[ ]+\\([0-9]+\\)" EXIV2_MAJOR_VERSION_MATCH ${_exiv_version_file_content})
-            string(REGEX MATCH "#define EXIV2_MINOR_VERSION[ ]+\\([0-9]+\\)" EXIV2_MINOR_VERSION_MATCH ${_exiv_version_file_content})
-            string(REGEX MATCH "#define EXIV2_PATCH_VERSION[ ]+\\([0-9]+\\)" EXIV2_PATCH_VERSION_MATCH ${_exiv_version_file_content})
-            if(EXIV2_MAJOR_VERSION_MATCH)
-                string(REGEX REPLACE ".*_MAJOR_VERSION[ ]+\\((.*)\\)" "\\1" EXIV2_MAJOR_VERSION ${EXIV2_MAJOR_VERSION_MATCH})
-                string(REGEX REPLACE ".*_MINOR_VERSION[ ]+\\((.*)\\)" "\\1" EXIV2_MINOR_VERSION ${EXIV2_MINOR_VERSION_MATCH})
-                string(REGEX REPLACE ".*_PATCH_VERSION[ ]+\\((.*)\\)" "\\1"  EXIV2_PATCH_VERSION  ${EXIV2_PATCH_VERSION_MATCH})
-            endif()
-        endif()
-    endforeach()
-
-    set(LibExiv2_VERSION "${EXIV2_MAJOR_VERSION}.${EXIV2_MINOR_VERSION}.${EXIV2_PATCH_VERSION}")
-endif()
-
-include(FindPackageHandleStandardArgs)
-find_package_handle_standard_args(LibExiv2
-    FOUND_VAR LibExiv2_FOUND
-    REQUIRED_VARS  LibExiv2_LIBRARIES LibExiv2_INCLUDE_DIRS
-    VERSION_VAR  LibExiv2_VERSION
-)
-
-mark_as_advanced(LibExiv2_INCLUDE_DIRS LibExiv2_LIBRARIES)
-
-if(LibExiv2_FOUND AND NOT TARGET LibExiv2::LibExiv2)
-    add_library(LibExiv2::LibExiv2 UNKNOWN IMPORTED)
-    set_target_properties(LibExiv2::LibExiv2 PROPERTIES
-        IMPORTED_LOCATION "${LibExiv2_LIBRARIES}"
-        INTERFACE_INCLUDE_DIRECTORIES "${LibExiv2_INCLUDE_DIRS}"
-    )
-endif()
-
-include(FeatureSummary)
-set_package_properties(LibExiv2 PROPERTIES
-    URL "https://www.exiv2.org"
-    DESCRIPTION "Image metadata support"
-)

dist/MacOSXBundleInfo.plist.in

@@ -0,0 +1,136 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>CFBundleDevelopmentRegion</key>
+    <string>English</string>
+    <key>CFBundleExecutable</key>
+    <string>${MACOSX_BUNDLE_EXECUTABLE_NAME}</string>
+    <key>CFBundleGetInfoString</key>
+    <string>${MACOSX_BUNDLE_INFO_STRING}</string>
+    <key>CFBundleIconFile</key>
+    <string>${MACOSX_BUNDLE_ICON_FILE}</string>
+    <key>CFBundleIdentifier</key>
+    <string>${MACOSX_BUNDLE_GUI_IDENTIFIER}</string>
+    <key>CFBundleInfoDictionaryVersion</key>
+    <string>6.0</string>
+    <key>CFBundleLongVersionString</key>
+    <string>${MACOSX_BUNDLE_LONG_VERSION_STRING}</string>
+    <key>CFBundleName</key>
+    <string>${MACOSX_BUNDLE_BUNDLE_NAME}</string>
+    <key>CFBundlePackageType</key>
+    <string>APPL</string>
+    <key>CFBundleShortVersionString</key>
+    <string>${MACOSX_BUNDLE_SHORT_VERSION_STRING}</string>
+    <key>CFBundleSignature</key>
+    <string>????</string>
+    <key>CFBundleVersion</key>
+    <string>${MACOSX_BUNDLE_BUNDLE_VERSION}</string>
+    <key>CSResourcesFileMapped</key>
+    <true/>
+    <key>NSHumanReadableCopyright</key>
+    <string>${MACOSX_BUNDLE_COPYRIGHT}</string>
+    <!-- FIXME: this list can't be automatically generated by Qt's CMake API, don't know why. -->
+    <key>CFBundleLocalizations</key>
+    <array>
+        <string>en</string>
+        <string>ca</string>
+        <string>de</string>
+        <string>es</string>
+        <string>fr</string>
+        <string>id</string>
+        <string>it</string>
+        <string>ja</string>
+        <string>ko</string>
+        <string>nb_NO</string>
+        <string>nl</string>
+        <string>pa_PK</string>
+        <string>ru</string>
+        <string>si</string>
+        <string>ta</string>
+        <string>tr</string>
+        <string>uk</string>
+        <string>zh_CN</string>
+    </array>
+    <key>CFBundleDocumentTypes</key>
+    <array>
+        <!-- JPEG -->
+        <dict>
+            <key>CFBundleTypeName</key>
+            <string>JPEG Image</string>
+            <key>CFBundleTypeExtensions</key>
+            <array>
+                <string>jpg</string>
+                <string>jpeg</string>
+                <string>jfif</string>
+            </array>
+            <key>CFBundleTypeMIMETypes</key>
+            <array>
+                <string>image/jpeg</string>
+            </array>
+            <key>CFBundleTypeRole</key>
+            <string>Viewer</string>
+        </dict>
+        <!-- PNG -->
+        <dict>
+            <key>CFBundleTypeName</key>
+            <string>PNG Image</string>
+            <key>CFBundleTypeExtensions</key>
+            <array>
+                <string>png</string>
+            </array>
+            <key>CFBundleTypeMIMETypes</key>
+            <array>
+                <string>image/png</string>
+            </array>
+            <key>CFBundleTypeRole</key>
+            <string>Viewer</string>
+        </dict>
+        <!-- WebP -->
+        <dict>
+            <key>CFBundleTypeName</key>
+            <string>WebP Image</string>
+            <key>CFBundleTypeExtensions</key>
+            <array>
+                <string>webp</string>
+            </array>
+            <key>CFBundleTypeMIMETypes</key>
+            <array>
+                <string>image/webp</string>
+            </array>
+            <key>CFBundleTypeRole</key>
+            <string>Viewer</string>
+        </dict>
+        <!-- GIF -->
+        <dict>
+            <key>CFBundleTypeName</key>
+            <string>GIF Image</string>
+            <key>CFBundleTypeExtensions</key>
+            <array>
+                <string>gif</string>
+            </array>
+            <key>CFBundleTypeMIMETypes</key>
+            <array>
+                <string>image/gif</string>
+            </array>
+            <key>CFBundleTypeRole</key>
+            <string>Viewer</string>
+        </dict>
+        <!-- SVG -->
+        <dict>
+            <key>CFBundleTypeName</key>
+            <string>SVG Image</string>
+            <key>CFBundleTypeExtensions</key>
+            <array>
+                <string>svg</string>
+            </array>
+            <key>CFBundleTypeMIMETypes</key>
+            <array>
+                <string>image/svg+xml</string>
+            </array>
+            <key>CFBundleTypeRole</key>
+            <string>Viewer</string>
+        </dict>
+    </array>
+</dict>
+</plist>

dist/appstream/net.blumia.pineapple-pictures.metainfo.xml

@@ -1,19 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<component type="desktop-application">
-  <id>net.blumia.pineapple-pictures</id>
-  <metadata_license>CC0-1.0</metadata_license>
-  <project_license>MIT</project_license>
-  <name>Pineapple Pictures</name>
-  <name xml:lang="zh-CN">菠萝看图</name>
-  <summary>Image Viewer</summary>
-  <summary xml:lang="zh-CN">图像查看器</summary>
-  <description>
-    <p>Pineapple Pictures is a lightweight and easy-to-use image viewer that comes with a handy navigation thumbnail when zoom-in, and doesn't contain any image management support.</p>
-    <p xml:lang="zh-CN">菠萝看图是一个轻量级易用的图像查看器，在图片放大时提供了方便的鸟瞰导航功能，且不包含任何图片管理功能。</p>
-  </description>
-  <url type="homepage">https://github.com/BLumia/pineapple-pictures</url>
-  <url type="bugtracker">https://github.com/BLumia/pineapple-pictures/issues</url>
-  <provides>
-    <binary>ppic</binary>
-  </provides>
-</component>