chore: reduce the length of the error message in cmake

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

@@ -0,0 +1,45 @@
+name: macOS CI
+
+on: [push, pull_request, workflow_dispatch]
+
+jobs:
+  build:
+
+    runs-on: macos-latest
+
+    steps:
+    - 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: 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: |
+        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

@@ -0,0 +1,17 @@
+# SPDX-FileCopyrightText: 2022 Free Software Foundation Europe e.V. <https://fsfe.org>
+#
+# SPDX-License-Identifier: CC0-1.0
+
+name: REUSE Compliance Check
+
+on: [push, pull_request]
+
+jobs:
+  reuse-compliance-check:
+    runs-on: ubuntu-latest
+    steps: 
+    - name: Checkout
+      uses: actions/checkout@v4
+
+    - name: REUSE Compliance Check
+      uses: fsfe/reuse-action@v5

.github/workflows/ubuntu.yml

@@ -0,0 +1,34 @@
+name: Ubuntu CI
+
+on: [push, pull_request, workflow_dispatch]
+
+jobs:
+  ubuntu-24-04-build:
+    runs-on: ubuntu-24.04
+    steps:
+      - 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 qt6-base-dev qt6-svg-dev qt6-tools-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@v6
+        with:
+          name: ubuntu-24.04-deb-package
+          path: build/*.deb

.github/workflows/windows.yml

@@ -0,0 +1,108 @@
+name: Windows CI
+
+on: [push, pull_request, workflow_dispatch]
+
+jobs:
+  msvc-cmake-build:
+
+    strategy:
+      matrix:
+        include:
+          - qt_ver: '6.11.2'
+            vs: '2022'
+            aqt_arch: 'win64_msvc2022_64'
+            msvc_arch: 'x64'
+
+    runs-on: windows-2022
+
+    steps:
+    - 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: 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 }}
+        :: ------ 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

@@ -1,8 +1,22 @@
 # User files
 *.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/

CMakeLists.txt

@@ -1,38 +1,92 @@
-project (pineapple-pictures)
+# SPDX-FileCopyrightText: 2022 - 2025 Gary Wang <git@blumia.net>
+#
+# SPDX-License-Identifier: MIT
 
-cmake_minimum_required (VERSION 3.9.5)
+cmake_minimum_required(VERSION 3.16)
 
-include (GNUInstallDirs)
+project(pineapple-pictures VERSION 1.6.0) # don't forget to update NEWS file and AppStream metadata.
 
+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)
+
+set (CMAKE_CXX_STANDARD 17)
+set (CMAKE_CXX_STANDARD_REQUIRED ON)
 set (CMAKE_AUTOMOC ON)
 set (CMAKE_AUTORCC ON)
-set (QT_MINIMUM_VERSION "5.7.1")
+set (CMAKE_AUTOUIC ON)
 
-find_package(Qt5 ${QT_MINIMUM_VERSION} CONFIG REQUIRED Widgets Svg LinguistTools)
+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(exiv2)
+    set_package_properties(exiv2 PROPERTIES
+        URL "https://www.exiv2.org"
+        DESCRIPTION "image metadata support"
+        TYPE RECOMMENDED
+        PURPOSE "Bring better image metadata support"
+    )
+endif ()
 
 set (PPIC_CPP_FILES
-    main.cpp
+    app/main.cpp
-    mainwindow.cpp
+    app/mainwindow.cpp
-    graphicsview.cpp
+    app/actionmanager.cpp
-    graphicsscene.cpp
+    app/graphicsview.cpp
-    bottombuttongroup.cpp
+    app/graphicsscene.cpp
-    navigatorview.cpp
+    app/bottombuttongroup.cpp
-    opacityhelper.cpp
+    app/navigatorview.cpp
-    toolbutton.cpp
+    app/settings.cpp
+    app/settingsdialog.cpp
+    app/aboutdialog.cpp
+    app/metadatamodel.cpp
+    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
-    mainwindow.h
+    app/mainwindow.h
-    graphicsview.h
+    app/actionmanager.h
-    graphicsscene.h
+    app/graphicsview.h
-    bottombuttongroup.h
+    app/graphicsscene.h
-    navigatorview.h
+    app/bottombuttongroup.h
-    opacityhelper.h
+    app/navigatorview.h
-    toolbutton.h
+    app/settings.h
+    app/settingsdialog.h
+    app/aboutdialog.h
+    app/metadatamodel.h
+    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
-    resources.qrc
+    assets/resources.qrc
 )
 
 set (PPIC_RC_FILES
@@ -42,74 +96,208 @@ set (PPIC_RC_FILES
 set (EXE_NAME ppic)
 
 # Translation
-file (GLOB PPIC_TS_FILES languages/*.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 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 Windows RC file template via MetaGlot (exit code: ${METAGLOT_RESULT}).")
+    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)
 
-# Extra build settings
+if (Qt6_VERSION VERSION_GREATER_EQUAL "6.9.0")
-if (WIN32)
+    set(ADD_TRANSLATIONS_ADDITIONAL_ARGS MERGE_QT_TRANSLATIONS)
-    set_property (
+endif()
-        TARGET ${EXE_NAME}
+
-        PROPERTY WIN32_EXECUTABLE true
+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}
+        Exiv2::exiv2lib
+    )
+    target_compile_definitions(${EXE_NAME} PRIVATE
+        HAVE_EXIV2_VERSION="${exiv2_VERSION}"
     )
 endif ()
 
-# Helper macros for install settings
+if (TARGET Qt6::DBus)
-macro (ppic_convert_to_relative_path _var)
+    target_link_libraries (${EXE_NAME}
-    # Make sure _var is a relative path
+        Qt${QT_VERSION_MAJOR}::DBus
-    if (IS_ABSOLUTE "${${_var}}")
+    )
-        file (RELATIVE_PATH ${_var} "${CMAKE_INSTALL_PREFIX}" "${${_var}}")
+    target_compile_definitions(${EXE_NAME} PRIVATE
+        HAVE_QTDBUS
+    )
+endif()
+
+# Extra build settings
+if (WIN32)
+    target_compile_definitions(${EXE_NAME} PRIVATE
+        FLAG_PORTABLE_MODE_SUPPORT=1
+    )
+endif ()
+
+# Helper macros for parsing and setting project version from `git describe --long` result
+macro (ppic_set_version_via_describe _describe_long)
+    string (
+        REGEX REPLACE
+        "^([0-9a-z.]*)-[0-9]+-g[0-9a-f]*$"
+        "\\1"
+        _tag_parts
+        "${_describe_long}"
+    )
+    list (GET _tag_parts 0 _matched_tag_version)
+    if ("${_matched_tag_version}" MATCHES "^[0-9]+\\.[0-9]+\\.[0-9]+$")
+        string (
+            REGEX REPLACE
+            "^([0-9]+)\\.([0-9]+)\\.([0-9]+).*$"
+            "\\1;\\2;\\3"
+            _ver_parts
+            "${_matched_tag_version}"
+        )
+        list (GET _ver_parts 0 CPACK_PACKAGE_VERSION_MAJOR)
+        list (GET _ver_parts 1 CPACK_PACKAGE_VERSION_MINOR)
+        list (GET _ver_parts 2 CPACK_PACKAGE_VERSION_PATCH)
     endif ()
 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.")
+    if (GIT_FOUND)
+        execute_process (
+            COMMAND ${GIT_EXECUTABLE} describe --tags --always --long
+            WORKING_DIRECTORY ${CMAKE_SOURCE_DIR}
+            OUTPUT_VARIABLE _git_describe_long
+        )
+        string (REGEX REPLACE "\n" "" _git_describe_long "${_git_describe_long}")
+        ppic_set_version_via_describe(${_git_describe_long})
+        target_compile_definitions(${EXE_NAME} PRIVATE
+            GIT_DESCRIBE_VERSION_STRING="${_git_describe_long}"
+        )
+    endif ()
+endif ()
+
 # Install settings
 if (WIN32)
-    # FIXME: try to avoid install to a "bin" subfolder under windows...
+    set_target_properties(${EXE_NAME} PROPERTIES
-    #        when fixed, don't forget to update the CI config file...
+        WIN32_EXECUTABLE TRUE
-    set (BIN_INSTALL_DIR "") # seems useless, don't know why...
+    )
+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 icons/app-icon.svg
+        DIRECTORY dist/freedesktop-icons/
-        DESTINATION "${CMAKE_INSTALL_DATADIR}/icons/hicolor/48x48/apps"
+        DESTINATION "${CMAKE_INSTALL_DATADIR}/icons/hicolor"
-        RENAME pineapple-pictures.svg
     )
 
-    # 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 .desktop via MetaGlot (exit code: ${METAGLOT_DESKTOP_RESULT}).")
+    endif ()
+
     install (
-        FILES pineapple-pictures.desktop
+        FILES ${PPIC_DESKTOP_FILE}
         DESTINATION "${CMAKE_INSTALL_DATAROOTDIR}/applications"
     )
+
+    # 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 .metainfo.xml via MetaGlot (exit code: ${METAGLOT_METAINFO_RESULT}).")
+    endif ()
+
+    install (
+        FILES ${PPIC_METAINFO_FILE}
+        DESTINATION "${CMAKE_INSTALL_DATAROOTDIR}/metainfo"
+    )
 endif()
 
 set (INSTALL_TARGETS_DEFAULT_ARGS
-    RUNTIME DESTINATION ${BIN_INSTALL_DIR}
+    BUNDLE DESTINATION .
-    LIBRARY DESTINATION ${LIB_INSTALL_DIR}
+    RUNTIME DESTINATION ${CMAKE_INSTALL_BINDIR}
-    ARCHIVE DESTINATION ${LIB_INSTALL_DIR} COMPONENT Devel
+    LIBRARY DESTINATION ${CMAKE_INSTALL_LIBDIR}
+    ARCHIVE DESTINATION ${CMAKE_INSTALL_LIBDIR} COMPONENT Devel
 )
 
 install (
@@ -117,32 +305,41 @@ 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 ()
+endif()
 
-install (
+if (DEFINED QM_FILE_INSTALL_DIR)
-    FILES ${PPIC_QM_FILES}
+    install(
-    DESTINATION ${QM_FILE_INSTALL_DIR}
+        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
 set (CPACK_GENERATOR "TBZ2")
-set (CPACK_PACKAGE_NAME "PineapplePictures")
+set (CPACK_PACKAGE_NAME "pineapple-pictures")
 set (CPACK_PACKAGE_DESCRIPTION_SUMMARY "Yet another image viewer")
 set (CPACK_PACKAGE_VENDOR "Gary Wang")
-set (CPACK_PACKAGE_CONTACT "https://github.com/BLumia/PineapplePictures/issues/")
+set (CPACK_PACKAGE_CONTACT "https://github.com/BLumia/pineapple-pictures/issues/")
 if (WIN32)
     # ...
 elseif (APPLE)
     # ...
 elseif (UNIX)
-    set(CPACK_SYSTEM_NAME "${CMAKE_SYSTEM_NAME}-${CMAKE_SYSTEM_PROCESSOR}")
+    set (CPACK_SYSTEM_NAME "${CMAKE_SYSTEM_NAME}-${CMAKE_SYSTEM_PROCESSOR}")
+    set (CPACK_DEBIAN_PACKAGE_SHLIBDEPS ON)
+    set (CPACK_DEBIAN_PACKAGE_RECOMMENDS "kimageformat6-plugins")
 endif()
 
 include(CPack)

LICENSE

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

LICENSES/CC0-1.0.txt

@@ -0,0 +1,121 @@
+Creative Commons Legal Code
+
+CC0 1.0 Universal
+
+    CREATIVE COMMONS CORPORATION IS NOT A LAW FIRM AND DOES NOT PROVIDE
+    LEGAL SERVICES. DISTRIBUTION OF THIS DOCUMENT DOES NOT CREATE AN
+    ATTORNEY-CLIENT RELATIONSHIP. CREATIVE COMMONS PROVIDES THIS
+    INFORMATION ON AN "AS-IS" BASIS. CREATIVE COMMONS MAKES NO WARRANTIES
+    REGARDING THE USE OF THIS DOCUMENT OR THE INFORMATION OR WORKS
+    PROVIDED HEREUNDER, AND DISCLAIMS LIABILITY FOR DAMAGES RESULTING FROM
+    THE USE OF THIS DOCUMENT OR THE INFORMATION OR WORKS PROVIDED
+    HEREUNDER.
+
+Statement of Purpose
+
+The laws of most jurisdictions throughout the world automatically confer
+exclusive Copyright and Related Rights (defined below) upon the creator
+and subsequent owner(s) (each and all, an "owner") of an original work of
+authorship and/or a database (each, a "Work").
+
+Certain owners wish to permanently relinquish those rights to a Work for
+the purpose of contributing to a commons of creative, cultural and
+scientific works ("Commons") that the public can reliably and without fear
+of later claims of infringement build upon, modify, incorporate in other
+works, reuse and redistribute as freely as possible in any form whatsoever
+and for any purposes, including without limitation commercial purposes.
+These owners may contribute to the Commons to promote the ideal of a free
+culture and the further production of creative, cultural and scientific
+works, or to gain reputation or greater distribution for their Work in
+part through the use and efforts of others.
+
+For these and/or other purposes and motivations, and without any
+expectation of additional consideration or compensation, the person
+associating CC0 with a Work (the "Affirmer"), to the extent that he or she
+is an owner of Copyright and Related Rights in the Work, voluntarily
+elects to apply CC0 to the Work and publicly distribute the Work under its
+terms, with knowledge of his or her Copyright and Related Rights in the
+Work and the meaning and intended legal effect of CC0 on those rights.
+
+1. Copyright and Related Rights. A Work made available under CC0 may be
+protected by copyright and related or neighboring rights ("Copyright and
+Related Rights"). Copyright and Related Rights include, but are not
+limited to, the following:
+
+  i. the right to reproduce, adapt, distribute, perform, display,
+     communicate, and translate a Work;
+ ii. moral rights retained by the original author(s) and/or performer(s);
+iii. publicity and privacy rights pertaining to a person's image or
+     likeness depicted in a Work;
+ iv. rights protecting against unfair competition in regards to a Work,
+     subject to the limitations in paragraph 4(a), below;
+  v. rights protecting the extraction, dissemination, use and reuse of data
+     in a Work;
+ vi. database rights (such as those arising under Directive 96/9/EC of the
+     European Parliament and of the Council of 11 March 1996 on the legal
+     protection of databases, and under any national implementation
+     thereof, including any amended or successor version of such
+     directive); and
+vii. other similar, equivalent or corresponding rights throughout the
+     world based on applicable law or treaty, and any national
+     implementations thereof.
+
+2. Waiver. To the greatest extent permitted by, but not in contravention
+of, applicable law, Affirmer hereby overtly, fully, permanently,
+irrevocably and unconditionally waives, abandons, and surrenders all of
+Affirmer's Copyright and Related Rights and associated claims and causes
+of action, whether now known or unknown (including existing as well as
+future claims and causes of action), in the Work (i) in all territories
+worldwide, (ii) for the maximum duration provided by applicable law or
+treaty (including future time extensions), (iii) in any current or future
+medium and for any number of copies, and (iv) for any purpose whatsoever,
+including without limitation commercial, advertising or promotional
+purposes (the "Waiver"). Affirmer makes the Waiver for the benefit of each
+member of the public at large and to the detriment of Affirmer's heirs and
+successors, fully intending that such Waiver shall not be subject to
+revocation, rescission, cancellation, termination, or any other legal or
+equitable action to disrupt the quiet enjoyment of the Work by the public
+as contemplated by Affirmer's express Statement of Purpose.
+
+3. Public License Fallback. Should any part of the Waiver for any reason
+be judged legally invalid or ineffective under applicable law, then the
+Waiver shall be preserved to the maximum extent permitted taking into
+account Affirmer's express Statement of Purpose. In addition, to the
+extent the Waiver is so judged Affirmer hereby grants to each affected
+person a royalty-free, non transferable, non sublicensable, non exclusive,
+irrevocable and unconditional license to exercise Affirmer's Copyright and
+Related Rights in the Work (i) in all territories worldwide, (ii) for the
+maximum duration provided by applicable law or treaty (including future
+time extensions), (iii) in any current or future medium and for any number
+of copies, and (iv) for any purpose whatsoever, including without
+limitation commercial, advertising or promotional purposes (the
+"License"). The License shall be deemed effective as of the date CC0 was
+applied by Affirmer to the Work. Should any part of the License for any
+reason be judged legally invalid or ineffective under applicable law, such
+partial invalidity or ineffectiveness shall not invalidate the remainder
+of the License, and in such case Affirmer hereby affirms that he or she
+will not (i) exercise any of his or her remaining Copyright and Related
+Rights in the Work or (ii) assert any associated claims and causes of
+action with respect to the Work, in either case contrary to Affirmer's
+express Statement of Purpose.
+
+4. Limitations and Disclaimers.
+
+ a. No trademark or patent rights held by Affirmer are waived, abandoned,
+    surrendered, licensed or otherwise affected by this document.
+ b. Affirmer offers the Work as-is and makes no representations or
+    warranties of any kind concerning the Work, express, implied,
+    statutory or otherwise, including without limitation warranties of
+    title, merchantability, fitness for a particular purpose, non
+    infringement, or the absence of latent or other defects, accuracy, or
+    the present or absence of errors, whether or not discoverable, all to
+    the greatest extent permissible under applicable law.
+ c. Affirmer disclaims responsibility for clearing rights of other persons
+    that may apply to the Work or any use thereof, including without
+    limitation any person's Copyright and Related Rights in the Work.
+    Further, Affirmer disclaims responsibility for obtaining any necessary
+    consents, permissions or other rights required for any use of the
+    Work.
+ d. Affirmer understands and acknowledges that Creative Commons is not a
+    party to this document and has no duty or obligation with respect to
+    this CC0 or use of the Work.

LICENSES/MIT.txt

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) <year> <copyright holders>
+
+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.

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

PineapplePictures.pro

@@ -1,60 +0,0 @@
-#-------------------------------------------------
-#
-# Project created by QtCreator 2019-09-26T23:36:07
-#
-#-------------------------------------------------
-
-QT       += core gui svg
-
-greaterThan(QT_MAJOR_VERSION, 4): QT += widgets
-
-TARGET = PineapplePictures
-TEMPLATE = app
-
-# The following define makes your compiler emit warnings if you use
-# any feature of Qt which has been marked as deprecated (the exact warnings
-# depend on your compiler). Please consult the documentation of the
-# deprecated API in order to know how to port your code away from it.
-DEFINES += QT_DEPRECATED_WARNINGS
-
-# You can also make your code fail to compile if you use deprecated APIs.
-# In order to do so, uncomment the following line.
-# You can also select to disable deprecated APIs only up to a certain version of Qt.
-#DEFINES += QT_DISABLE_DEPRECATED_BEFORE=0x060000    # disables all the APIs deprecated before Qt 6.0.0
-
-CONFIG += c++11 lrelease embed_translations
-
-SOURCES += \
-        main.cpp \
-        mainwindow.cpp \
-    graphicsview.cpp \
-    bottombuttongroup.cpp \
-    graphicsscene.cpp \
-    navigatorview.cpp \
-    opacityhelper.cpp \
-    toolbutton.cpp
-
-HEADERS += \
-        mainwindow.h \
-    graphicsview.h \
-    bottombuttongroup.h \
-    graphicsscene.h \
-    navigatorview.h \
-    opacityhelper.h \
-    toolbutton.h
-
-TRANSLATIONS = \
-    languages/PineapplePictures.ts \
-    languages/PineapplePictures_zh_CN.ts
-
-# Default rules for deployment.
-qnx: target.path = /tmp/$${TARGET}/bin
-else: unix:!android: target.path = /opt/$${TARGET}/bin
-!isEmpty(target.path): INSTALLS += target
-
-RESOURCES += \
-    resources.qrc
-
-# Generate fron svg:
-# magick convert -background none ./app-icon.svg -define icon:auto-resize=64,48,32,16 app-icon.ico
-RC_ICONS = icons/app-icon.ico

README.md

@@ -1,29 +1,84 @@
-Yet another image viewer.
+# Sarasas Chip Workshop Picture
-
+
-|CI|Build Status|
+Yet another legacy Windows Photo Viewer with cross-platform support.
-|---|---|
+
-|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)|
+> [!IMPORTANT]
-
+> SarasaCW Picture are still in refactoring. Please do not use it until this message removes.
-![Pineapple Pictures - Main Window](https://repository-images.githubusercontent.com/211888654/21fb6300-269f-11ea-8e85-953e5d57da44)
+
-
+## Summary
-## Get it!
+
-
+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.
- - [GitHub Release Page](https://github.com/BLumia/PineapplePictures/releases)
+
- - Archlinux AUR: [pineapple-pictures-git](https://aur.archlinux.org/packages/pineapple-pictures-git/)
+SarasaCW Picture is the **hard fork** of [Pineapple Pictures](https://github.com/BLumia/pineapple-pictures) since Pineapple Pictures 1.4.1 version.
-
+
-## Help Translation!
+<!--
-
+
-[Translate this project on Transifex!](https://www.transifex.com/blumia/pineapple-pictures/)
+|CI|Build Status|
-
+|---|---|
-Feel free to open up an issue to request an new language to translate.
+|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)|
-## Uncleaned shits inside(TM):
+|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)|
-
+
- - Mixed `CR LF` and `LF`.
+![Pineapple Pictures - Main Window](https://repository-images.githubusercontent.com/211888654/e8697600-e370-11eb-9b2a-b71e05262954)
- - Ugly action icons.
+
- - For windows build, win32 APIs are used.
+## Get it!
- - No drag-window-border-to-resize support under non-windows platforms (I use <kbd>Meta+Drag</kbd> to resize window under my x11 desktop).
+
-
+### Maintained by the original author
-## License
+
-
+- [GitHub Release Page](https://github.com/BLumia/pineapple-pictures/releases)
-This program released under MIT license
+- [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

@@ -0,0 +1,87 @@
+# 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

@@ -0,0 +1,99 @@
+// 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

@@ -0,0 +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
+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

@@ -0,0 +1,208 @@
+// 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

@@ -0,0 +1,60 @@
+// 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

@@ -0,0 +1,45 @@
+// 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

@@ -0,0 +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 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

@@ -0,0 +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()
+{
+
+}
+
+#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

@@ -0,0 +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

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/graphicsscene.cpp

@@ -0,0 +1,280 @@
+// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
+//
+// SPDX-License-Identifier: MIT
+
+#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 <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:
+    PGraphicsPixmapItem(const QPixmap &pixmap, QGraphicsItem *parent = nullptr)
+        : QGraphicsPixmapItem(pixmap, parent)
+    {}
+
+    enum { Type = UserType + 1 };
+    int type() const override { return Type; }
+
+    void setScaleHint(float scaleHint) {
+        m_scaleHint = scaleHint;
+    }
+
+    const QPixmap & scaledPixmap(float scaleHint) {
+        if (qFuzzyCompare(scaleHint, m_cachedScaleHint)) return m_cachedPixmap;
+        QSizeF resizedScale(boundingRect().size());
+        resizedScale *= scaleHint;
+        QPixmap && sourcePixmap = pixmap();
+        m_cachedPixmap = sourcePixmap.scaled(
+             resizedScale.toSize() * sourcePixmap.devicePixelRatioF(),
+             Qt::KeepAspectRatio,
+             Qt::SmoothTransformation);
+        m_cachedScaleHint = scaleHint;
+        return m_cachedPixmap;
+    }
+
+    void paint(QPainter *painter, const QStyleOptionGraphicsItem *option,
+               QWidget *widget) override
+    {
+        if (transformationMode() == Qt::FastTransformation) {
+            return QGraphicsPixmapItem::paint(painter, option, widget);
+        } else {
+//            painter->setRenderHints(QPainter::Antialiasing);
+            painter->drawPixmap(QRectF(offset(), boundingRect().size()).toRect(),
+                                scaledPixmap(m_scaleHint));
+        }
+    }
+
+private:
+    float m_scaleHint = 1;
+    float m_cachedScaleHint = -1;
+    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", "The same meaning of MainWindow's hint."));
+    connect(qGuiApp->styleHints(), &QStyleHints::colorSchemeChanged, this, &GraphicsScene::updateStyle);
+}
+
+GraphicsScene::~GraphicsScene()
+{
+
+}
+
+void GraphicsScene::showImage(const QPixmap &pixmap)
+{
+    this->clear();
+    PGraphicsPixmapItem * pixmapItem = new PGraphicsPixmapItem(pixmap);
+    this->addItem(pixmapItem);
+    pixmapItem->setShapeMode(QGraphicsPixmapItem::BoundingRectShape);
+    m_theThing = pixmapItem;
+    this->setSceneRect(m_theThing->boundingRect());
+}
+
+void GraphicsScene::showText(const QString &text)
+{
+    this->clear();
+    QGraphicsTextItem * textItem = this->addText(text);
+    textItem->setDefaultTextColor(ColorSchemaToTextForeground(qGuiApp->styleHints()->colorScheme()));
+    m_theThing = textItem;
+    this->setSceneRect(m_theThing->boundingRect());
+}
+
+void GraphicsScene::showSvg(const QString &filepath)
+{
+    this->clear();
+    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());
+}
+
+void GraphicsScene::showAnimated(const QString &filepath)
+{
+    this->clear();
+
+    PGraphicsMovieItem * animatedItem = new PGraphicsMovieItem();
+    QMovie * movie = new QMovie(filepath);
+    movie->start();
+    animatedItem->setMovie(movie);
+    this->addItem(animatedItem);
+    m_theThing = animatedItem;
+
+    this->setSceneRect(m_theThing->boundingRect());
+}
+
+bool GraphicsScene::trySetTransformationMode(Qt::TransformationMode mode, float scaleHint)
+{
+    PGraphicsPixmapItem * pixmapItem = qgraphicsitem_cast<PGraphicsPixmapItem *>(m_theThing);
+    if (pixmapItem) {
+        pixmapItem->setTransformationMode(mode);
+        pixmapItem->setScaleHint(scaleHint);
+        return true;
+    }
+
+    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);
+    if (pixmapItem) {
+        return pixmapItem->pixmap();
+    }
+
+    QPixmap pixmap(sceneRect().toRect().size());
+    pixmap.fill(Qt::transparent);
+    QPainter p(&pixmap);
+    render(&p, sceneRect());
+
+    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

@@ -0,0 +1,48 @@
+// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
+//
+// SPDX-License-Identifier: MIT
+
+#ifndef GRAPHICSSCENE_H
+#define GRAPHICSSCENE_H
+
+#include <QGraphicsScene>
+
+class GraphicsScene : public QGraphicsScene
+{
+    Q_OBJECT
+public:
+    GraphicsScene(QObject *parent = nullptr);
+    ~GraphicsScene();
+
+    void showImage(const QPixmap &pixmap);
+    void showText(const QString &text);
+    void showSvg(const QString &filepath);
+    void showAnimated(const QString &filepath);
+
+    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 = nullptr;
+};
+
+#endif // GRAPHICSSCENE_H

app/graphicsview.cpp

@@ -0,0 +1,517 @@
+// 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

@@ -0,0 +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);
+
+    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

@@ -0,0 +1,96 @@
+// 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.cpp

@@ -0,0 +1,584 @@
+// SPDX-FileCopyrightText: 2025 Gary Wang <git@blumia.net>
+//
+// SPDX-License-Identifier: MIT
+
+#include "mainwindow.h"
+#include "ui_mainwindow.h"
+
+#include "settings.h"
+#include "bottombuttongroup.h"
+#include "graphicsview.h"
+#include "navigatorview.h"
+#include "graphicsscene.h"
+#include "settingsdialog.h"
+#include "aboutdialog.h"
+#include "metadatamodel.h"
+#include "metadatadialog.h"
+#include "actionmanager.h"
+#include "playlistmanager.h"
+
+#include <QMouseEvent>
+#include <QMovie>
+#include <QDebug>
+#include <QGraphicsTextItem>
+#include <QApplication>
+#include <QStyle>
+#include <QScreen>
+#include <QMenu>
+#include <QShortcut>
+#include <QClipboard>
+#include <QMimeData>
+#include <QWindow>
+#include <QFile>
+#include <QTimer>
+#include <QFileDialog>
+#include <QFileSystemWatcher>
+#include <QStandardPaths>
+#include <QStringBuilder>
+#include <QProcess>
+#include <QDesktopServices>
+#include <QMessageBox>
+
+#ifdef HAVE_QTDBUS
+#include <QDBusInterface>
+#include <QDBusConnectionInterface>
+#endif // HAVE_QTDBUS
+
+using namespace Qt::Literals::StringLiterals;
+
+MainWindow::MainWindow(QWidget *parent)
+    : QWidget(parent)
+    , ui(new QT_PREPEND_NAMESPACE(Ui::MainWindow))
+    , m_am(new ActionManager)
+    , m_pm(new PlaylistManager(this))
+    , m_fileSystemWatcher(new QFileSystemWatcher(this))
+{
+    ui->setupUi(this);
+    this->setWindowFlags(Qt::Window | Qt::WindowTitleHint | Qt::WindowSystemMenuHint | Qt::WindowMinMaxButtonsHint | Qt::WindowCloseButtonHint);
+
+    // YYC MARK:
+    // Blumis set original value is 350 x 330.
+    // It is too small for modern device,
+    // so I level it up to SVGA resolution 800 x 600.
+    this->setMinimumSize(800, 600);
+    this->setWindowIcon(QIcon(u":/icons/app-icon.png"_s));
+    this->setAcceptDrops(true);
+
+    // Initialize playlist manager
+    m_pm->setAllowedSuffixes(supportedImageFormats());
+
+    // Initialize graphics scene
+    GraphicsScene * scene = new GraphicsScene(this);
+    // Setup graphics view (main photo view)
+    ui->m_gv->setScene(scene);
+    // Setup navigator view (right-bottom corner thumbnail view)
+    ui->m_nav->setScene(scene);
+    ui->m_nav->setMainView(ui->m_gv);
+    ui->m_nav->fitInView(ui->m_nav->sceneRect(), Qt::KeepAspectRatio);
+    // Binding graphics and navigator views signals
+    connect(ui->m_gv, &GraphicsView::navigatorViewRequired,
+            this, [this](bool required, const QTransform & tf){
+        if (Settings::instance()->showNavigatorView()){
+            ui->m_nav->setTransform(GraphicsView::resetScale(tf));
+            ui->m_nav->fitInView(ui->m_nav->sceneRect(), Qt::KeepAspectRatio);
+            ui->m_nav->setVisible(required);
+            ui->m_navPH->setVisible(required);
+            ui->m_nav->updateMainViewportRegion();
+        } else {
+            ui->m_nav->setVisible(false);
+            ui->m_navPH->setVisible(false);
+        }
+    });
+    connect(ui->m_gv, &GraphicsView::viewportRectChanged,
+            ui->m_nav, &NavigatorView::updateMainViewportRegion);
+
+    // Setup action manager
+    m_am->setupAction(this);
+    // Setup bottom button group
+    ui->m_bottomButtonGroup->addActions({
+        m_am->actionActualSize,
+        m_am->actionFitToScreen,
+        m_am->actionZoomIn,
+        m_am->actionZoomOut,
+        m_am->actionPrevPicture,
+        m_am->actionProperties,
+        m_am->actionNextPicture,
+        m_am->actionRotateCounterClockwise,
+        m_am->actionRotateClockwise,
+        m_am->actionFlipHorizontal,
+        m_am->actionFlipVertical,
+    });
+    // Setup right click menus
+    {
+        ui->m_subMenuCopy->addAction(m_am->actionCopyPixmap);
+        ui->m_subMenuCopy->addAction(m_am->actionCopyFilePath);
+    }
+    {
+        ui->m_subMenuTransform->addAction(m_am->actionActualSize);
+        ui->m_subMenuTransform->addAction(m_am->actionFitToScreen);
+        ui->m_subMenuTransform->addAction(m_am->actionFitByWidth);
+        ui->m_subMenuTransform->addAction(m_am->actionFitByHeight);
+        ui->m_subMenuTransform->addAction(m_am->actionZoomIn);
+        ui->m_subMenuTransform->addAction(m_am->actionZoomOut);
+
+        ui->m_subMenuTransform->addSeparator();
+
+        ui->m_subMenuTransform->addAction(m_am->actionFlipHorizontal);
+        ui->m_subMenuTransform->addAction(m_am->actionFlipVertical);
+        ui->m_subMenuTransform->addAction(m_am->actionRotateClockwise);
+        ui->m_subMenuTransform->addAction(m_am->actionRotateCounterClockwise);
+    }
+    {
+        ui->m_menu->addMenu(ui->m_subMenuCopy);
+
+        ui->m_menu->addSeparator();
+
+        ui->m_menu->addAction(m_am->actionPrevPicture);
+        ui->m_menu->addAction(m_am->actionNextPicture);
+
+        ui->m_menu->addSeparator();
+
+        ui->m_menu->addMenu(ui->m_subMenuTransform);
+
+        ui->m_menu->addSeparator();
+
+        ui->m_menu->addAction(m_am->actionToggleAvoidResetTransform);
+        ui->m_menu->addAction(m_am->actionToggleCheckerboard);
+        ui->m_menu->addAction(m_am->actionTogglePauseAnimation);
+        ui->m_menu->addAction(m_am->actionAnimationNextFrame);
+
+        ui->m_menu->addSeparator();
+
+        ui->m_menu->addAction(m_am->actionTrash);
+        ui->m_menu->addAction(m_am->actionLocateInFileManager);
+        ui->m_menu->addAction(m_am->actionProperties);
+
+        ui->m_menu->addSeparator();
+
+        ui->m_menu->addAction(m_am->actionSettings);
+        ui->m_menu->addAction(m_am->actionHelp);
+    }
+
+    // Connect playlist manager and file watcher signals for photo browsering.
+    connect(m_pm, &PlaylistManager::playlistChanged, this, std::bind(&MainWindow::updateActionState, this));
+
+    connect(m_pm, &PlaylistManager::playlistChanged, this, std::bind(&MainWindow::galleryCurrent, this, false));
+    connect(m_pm, &PlaylistManager::currentIndexChanged, this, std::bind(&MainWindow::galleryCurrent, this, false));
+
+    connect(m_fileSystemWatcher, &QFileSystemWatcher::fileChanged, this, [this](){
+        QTimer::singleShot(500, this, std::bind(&MainWindow::galleryCurrent, this, true));
+    });
+
+    // Change window location
+    centerWindow();
+
+    QTimer::singleShot(0, this, [this](){
+        m_am->setupShortcuts();
+    });
+
+}
+
+MainWindow::~MainWindow()
+{
+    delete ui;
+}
+
+void MainWindow::showFiles(const QStringList &files)
+{
+    m_pm->loadPlaylist(files);
+    ui->m_nav->fitInView(ui->m_nav->sceneRect(), Qt::KeepAspectRatio);
+}
+
+void MainWindow::showFiles(const QList<QUrl>& urls)
+{
+    m_pm->loadPlaylist(urls);
+    ui->m_nav->fitInView(ui->m_nav->sceneRect(), Qt::KeepAspectRatio);
+}
+
+void MainWindow::initWindowSize()
+{
+    switch (Settings::instance()->initWindowSizeBehavior()) {
+    case Settings::WindowSizeBehavior::Maximized:
+        showMaximized();
+        break;
+    case Settings::WindowSizeBehavior::Windowed:
+    default:
+        showNormal();
+        break;
+    }
+}
+
+void MainWindow::clearGallery()
+{
+    m_pm->clearPlaylist();
+}
+
+void MainWindow::galleryPrev()
+{
+    const bool loopGallery = Settings::instance()->loopGallery();
+    if (!loopGallery && m_pm->isFirstIndex()) return;
+
+    auto index = m_pm->previousIndex();
+    if (index.has_value()) {
+        m_pm->setCurrentIndex(*index);
+    }
+}
+
+void MainWindow::galleryNext()
+{
+    const bool loopGallery = Settings::instance()->loopGallery();
+    if (!loopGallery && m_pm->isLastIndex()) return;
+
+    auto index = m_pm->nextIndex();
+    if (index.has_value()) {
+        m_pm->setCurrentIndex(*index);
+    }
+}
+
+void MainWindow::galleryCurrent(bool fromFileWatcher)
+{
+    auto index = m_pm->currentIndex();
+    if (index.has_value()) {
+        QString localFilePath = m_pm->localFileByIndex(*index);
+        ui->m_gv->showFileFromPath(localFilePath);
+        if (!fromFileWatcher) {
+            updateFileWatcher(localFilePath);
+            setWindowTitle(m_pm->urlByIndex(*index).fileName());
+        }
+    } else {
+        ui->m_gv->showText(tr("Drag image here"));
+        setWindowTitle(QString());
+        updateFileWatcher();
+    }
+
+    updateActionState();
+}
+
+QStringList MainWindow::supportedImageFormats()
+{
+    QStringList formatFilters {
+#if QT_VERSION < QT_VERSION_CHECK(6, 8, 0)
+        QStringLiteral("*.jfif")
+#endif // QT_VERSION < QT_VERSION_CHECK(6, 8, 0)
+    };
+    for (const QByteArray &item : QImageReader::supportedImageFormats()) {
+        formatFilters.append(QStringLiteral("*.") % QString::fromLocal8Bit(item));
+    }
+    return formatFilters;
+}
+
+void MainWindow::wheelEvent(QWheelEvent *event)
+{
+    QPoint numDegrees = event->angleDelta() / 8;
+    bool needWeelEvent = false, wheelUp = false;
+    bool actionIsZoom = event->modifiers().testFlag(Qt::ControlModifier)
+            || Settings::instance()->mouseWheelBehavior() == Settings::MouseWheelBehavior::Zoom;
+
+    // NOTE: Only checking angleDelta since the QWheelEvent::pixelDelta() doc says
+    //       pixelDelta() value is driver specific and unreliable on X11...
+    //       We are not scrolling the canvas, just zoom in or out, so it probably
+    //       doesn't matter here.
+    if (!numDegrees.isNull() && numDegrees.y() != 0) {
+        needWeelEvent = true;
+        wheelUp = numDegrees.y() > 0;
+    }
+
+    if (needWeelEvent) {
+        if (actionIsZoom) {
+            if (wheelUp) {
+                on_actionZoomIn_triggered();
+            } else {
+                on_actionZoomOut_triggered();
+            }
+        } else {
+            if (wheelUp) {
+                galleryPrev();
+            } else {
+                galleryNext();
+            }
+        }
+        event->accept();
+    } else {
+        QWidget::wheelEvent(event);
+    }
+}
+
+void MainWindow::contextMenuEvent(QContextMenuEvent *event)
+{
+    ui->m_menu->exec(mapToGlobal(event->pos()));
+
+    return QWidget::contextMenuEvent(event);
+}
+
+void MainWindow::dragEnterEvent(QDragEnterEvent *event)
+{
+    if (event->mimeData()->hasUrls()) {
+        event->acceptProposedAction();
+    } else {
+        event->ignore();
+    }
+
+    return QWidget::dragEnterEvent(event);
+}
+
+void MainWindow::dragMoveEvent(QDragMoveEvent *event)
+{
+    Q_UNUSED(event)
+}
+
+void MainWindow::dropEvent(QDropEvent *event)
+{
+    event->acceptProposedAction();
+
+    const QMimeData * mimeData = event->mimeData();
+    if (mimeData->hasUrls()) {
+        showFiles(mimeData->urls());
+    } else {
+        ui->m_gv->showText(tr("Not supported mimedata: %1").arg(mimeData->formats().first()));
+    }
+}
+
+void MainWindow::centerWindow()
+{
+    this->setGeometry(
+        QStyle::alignedRect(
+            Qt::LeftToRight,
+            Qt::AlignCenter,
+            this->size(),
+            qApp->screenAt(QCursor::pos())->availableGeometry()
+        )
+    );
+}
+
+void MainWindow::toggleAvoidResetTransform()
+{
+    ui->m_gv->setAvoidResetTransform(!ui->m_gv->isAvoidResetTransform());
+}
+
+void MainWindow::toggleFullscreen()
+{
+    if (isFullScreen()) {
+        showNormal();
+    } else {
+        showFullScreen();
+    }
+}
+
+void MainWindow::toggleMaximize()
+{
+    if (isMaximized()) {
+        showNormal();
+    } else {
+        showMaximized();
+    }
+}
+
+QSize MainWindow::sizeHint() const
+{
+    return QSize(710, 530);
+}
+
+// region: Action Trigger
+
+void MainWindow::on_actionCopyPixmap_triggered()
+{
+    QClipboard *cb = QApplication::clipboard();
+    cb->setPixmap(ui->m_gv->scene()->renderToPixmap());
+}
+
+void MainWindow::on_actionCopyFilePath_triggered()
+{
+    auto index = m_pm->currentIndex();
+    if (!index.has_value()) return;
+
+    QClipboard *cb = QApplication::clipboard();
+    cb->setText(m_pm->localFileByIndex(*index));
+}
+
+void MainWindow::on_actionPrevPicture_triggered()
+{
+    galleryPrev();
+}
+
+void MainWindow::on_actionNextPicture_triggered()
+{
+    galleryNext();
+}
+
+void MainWindow::on_actionActualSize_triggered()
+{
+    ui->m_gv->resetScale();
+    ui->m_gv->setEnableAutoFitToScreen(false);
+}
+
+void MainWindow::on_actionFitToScreen_triggered()
+{
+    ui->m_gv->fitInView(ui->m_nav->sceneRect(), Qt::KeepAspectRatio);
+    ui->m_gv->setEnableAutoFitToScreen(ui->m_gv->scaleFactor() <= 1);
+}
+
+void MainWindow::on_actionFitByWidth_triggered()
+{
+    ui->m_gv->fitByOrientation(Qt::Orientation::Horizontal);
+}
+
+void MainWindow::on_actionFitByHeight_triggered()
+{
+    ui->m_gv->fitByOrientation(Qt::Orientation::Vertical);
+}
+
+void MainWindow::on_actionZoomIn_triggered()
+{
+    if (ui->m_gv->scaleFactor() < 1000) {
+        ui->m_gv->zoomView(1.25);
+    }
+}
+
+void MainWindow::on_actionZoomOut_triggered()
+{
+    ui->m_gv->zoomView(0.8);
+}
+
+void MainWindow::on_actionFlipHorizontal_triggered()
+{
+    ui->m_gv->flipView(true);
+}
+
+void MainWindow::on_actionFlipVertical_triggered()
+{
+    ui->m_gv->flipView(false);
+}
+
+void MainWindow::on_actionRotateClockwise_triggered()
+{
+    ui->m_gv->rotateView(true);
+    ui->m_gv->displayScene();
+}
+
+void MainWindow::on_actionRotateCounterClockwise_triggered()
+{
+    ui->m_gv->rotateView(false);
+    ui->m_gv->displayScene();
+}
+
+void MainWindow::on_actionToggleAvoidResetTransform_triggered()
+{
+    toggleAvoidResetTransform();
+}
+
+void MainWindow::on_actionToggleCheckerboard_triggered()
+{
+    ui->m_gv->toggleCheckerboard(QGuiApplication::queryKeyboardModifiers().testFlag(Qt::ShiftModifier));
+}
+
+void MainWindow::on_actionTogglePauseAnimation_triggered()
+{
+    ui->m_gv->scene()->togglePauseAnimation();
+}
+
+void MainWindow::on_actionAnimationNextFrame_triggered()
+{
+    ui->m_gv->scene()->skipAnimationFrame(1);
+}
+
+void MainWindow::on_actionTrash_triggered()
+{
+    auto index = m_pm->currentIndex();
+    if (!index.has_value()) return;
+    if (!m_pm->urlByIndex(*index).isLocalFile()) return;
+
+    QFile file(m_pm->localFileByIndex(*index));
+    QFileInfo fileInfo(file.fileName());
+
+    QMessageBox::StandardButton result = QMessageBox::question(this, tr("Move to Trash"),
+                                                               tr("Are you sure you want to move \"%1\" to recycle bin?").arg(fileInfo.fileName()));
+    if (result == QMessageBox::Yes) {
+        bool succ = file.moveToTrash();
+        if (!succ) {
+            QMessageBox::warning(this, tr("Failed to move file to trash"),
+                                 tr("Move to trash failed, it might caused by file permission issue, file system limitation, or platform limitation."));
+        } else {
+            m_pm->removeFromPlaylist(*index);
+        }
+    }
+}
+
+void MainWindow::on_actionLocateInFileManager_triggered()
+{
+    auto index = m_pm->currentIndex();
+    if (!index.has_value()) return;
+    QUrl currentFileUrl = m_pm->urlByIndex(*index);
+    if (!currentFileUrl.isValid()) return;
+
+    QFileInfo fileInfo(currentFileUrl.toLocalFile());
+    if (!fileInfo.exists()) return;
+
+    QUrl && folderUrl = QUrl::fromLocalFile(fileInfo.absolutePath());
+
+#ifdef Q_OS_WIN
+    QProcess::startDetached("explorer", QStringList() << "/select," << QDir::toNativeSeparators(fileInfo.absoluteFilePath()));
+#elif defined(Q_OS_LINUX) and defined(HAVE_QTDBUS)
+    // Use https://www.freedesktop.org/wiki/Specifications/file-manager-interface/ if possible
+    const QDBusConnectionInterface * dbusIface = QDBusConnection::sessionBus().interface();
+    if (!dbusIface || !dbusIface->isServiceRegistered(QLatin1String("org.freedesktop.FileManager1"))) {
+        QDesktopServices::openUrl(folderUrl);
+        return;
+    }
+    QDBusInterface fm1Iface(u"org.freedesktop.FileManager1"_s,
+                            u"/org/freedesktop/FileManager1"_s,
+                            u"org.freedesktop.FileManager1"_s);
+    fm1Iface.setTimeout(1000);
+    fm1Iface.callWithArgumentList(QDBus::Block, "ShowItems", {
+                                      QStringList{currentFileUrl.toString()},
+                                      QString()
+                                  });
+    if (fm1Iface.lastError().isValid()) {
+        QDesktopServices::openUrl(folderUrl);
+    }
+#else
+    QDesktopServices::openUrl(folderUrl);
+#endif // Q_OS_WIN
+}
+
+void MainWindow::on_actionProperties_triggered()
+{
+    auto index = m_pm->currentIndex();
+    if (!index.has_value()) return;
+    QUrl currentFileUrl = m_pm->urlByIndex(*index);
+    if (!currentFileUrl.isValid()) return;
+
+    MetadataModel * md = new MetadataModel();
+    md->setFile(currentFileUrl.toLocalFile());
+
+    MetadataDialog * ad = new MetadataDialog(this);
+    ad->setMetadataModel(md);
+    ad->exec();
+    ad->deleteLater();
+}
+
+void MainWindow::on_actionSettings_triggered()
+{
+    SettingsDialog * sd = new SettingsDialog(this);
+    sd->exec();
+    sd->deleteLater();
+}
+
+void MainWindow::on_actionHelp_triggered()
+{
+    AboutDialog * ad = new AboutDialog(this);
+    ad->exec();
+    ad->deleteLater();
+}
+
+// endregion
+
+bool MainWindow::updateFileWatcher(const QString &basePath)
+{
+    m_fileSystemWatcher->removePaths(m_fileSystemWatcher->files());
+    if (!basePath.isEmpty()) return m_fileSystemWatcher->addPath(basePath);
+    return false;
+}
+
+void MainWindow::updateActionState() {
+    m_am->updateActionState(m_pm, ui->m_gv);
+}

app/mainwindow.h

@@ -0,0 +1,97 @@
+// 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

@@ -0,0 +1,113 @@
+// 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

@@ -0,0 +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
+
+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

@@ -0,0 +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>
+
+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

@@ -0,0 +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

app/navigatorview.cpp

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

app/playlistmanager.cpp

@@ -0,0 +1,295 @@
+// 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

@@ -0,0 +1,130 @@
+// 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

@@ -0,0 +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 <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

@@ -0,0 +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 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

@@ -0,0 +1,145 @@
+// 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

@@ -0,0 +1,27 @@
+// 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>

appveyor.yml

@@ -1,27 +0,0 @@
-environment:
-  matrix:
-    - build_name: mingw73_32_qt5_12_5
-      QTPATH: C:\Qt\5.12.5\mingw73_32
-      MINGW32: C:\Qt\Tools\mingw730_32
-#    - build_name: msvc2017_64
-#      QTPATH: C:\Qt\5.11.2\msvc2017_64
-#      MINGW32: C:\Qt\Tools\mingw530_32
-
-install:
-  - cd %APPVEYOR_BUILD_FOLDER%
-  - git submodule update --init --recursive
-  - set PATH=%PATH%;%QTPATH%\bin;%MINGW32%\bin
-
-build_script:
-  - mkdir build
-  - cd build
-  - cmake -G "Unix Makefiles" -DCMAKE_MAKE_PROGRAM=mingw32-make -DCMAKE_INSTALL_PREFIX='%cd%' ..\
-  - mingw32-make
-  - mingw32-make install
-# fixme: I don't know how to NOT make the binary installed to the ./bin/ folder...
-  - cd bin
-  - windeployqt --no-quick-import --no-translations --no-opengl-sw --no-angle --no-system-d3d-compiler --release .\ppic.exe
-  - tree
-
-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/resources.qrc

@@ -0,0 +1,23 @@
+<RCC>
+    <qresource prefix="/">
+        <!-- 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>

bottombuttongroup.cpp

@@ -1,68 +0,0 @@
-#include "bottombuttongroup.h"
-
-#include "opacityhelper.h"
-
-#include <functional>
-
-#include <QPushButton>
-#include <QVBoxLayout>
-#include <QDebug>
-
-BottomButtonGroup::BottomButtonGroup(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)"
-                        "}"
-                        "QPushButton {"
-                        "background-color:rgba(225,255,255,0);"
-                        "color: white;"
-                        "border-style: none;"
-                        "}");
-
-    auto newBtn = [](QString text, std::function<void()> func) -> QPushButton * {
-        QPushButton * btn = new QPushButton(QIcon(QStringLiteral(":/icons/") + text), "");
-        btn->setIconSize(QSize(40, 40));
-        btn->setFixedSize(40, 40);
-        connect(btn, &QAbstractButton::clicked, btn, func);
-        return btn;
-    };
-    addButton(newBtn("zoom-original", [this]() {
-        emit resetToOriginalBtnClicked();
-    }));
-    addButton(newBtn("view-fullscreen", [this]() {
-        emit toggleWindowMaximum();
-    }));
-    addButton(newBtn("zoom-in", [this]() {
-        emit zoomInBtnClicked();
-    }));
-    addButton(newBtn("zoom-out", [this]() {
-        emit zoomOutBtnClicked();
-    }));
-    addButton(newBtn("view-background-checkerboard", [this]() {
-        emit toggleCheckerboardBtnClicked();
-    }));
-    addButton(newBtn("object-rotate-right", [this]() {
-        emit rotateRightBtnClicked();
-    }));
-}
-
-void BottomButtonGroup::setOpacity(qreal opacity, bool animated)
-{
-    m_opacityHelper->setOpacity(opacity, animated);
-}
-
-void BottomButtonGroup::addButton(QAbstractButton *button)
-{
-    layout()->addWidget(button);
-    updateGeometry();
-}

bottombuttongroup.h

@@ -1,29 +0,0 @@
-#ifndef BOTTOMBUTTONGROUP_H
-#define BOTTOMBUTTONGROUP_H
-
-#include <QAbstractButton>
-#include <QGroupBox>
-
-class OpacityHelper;
-class BottomButtonGroup : public QGroupBox
-{
-    Q_OBJECT
-public:
-    explicit BottomButtonGroup(QWidget *parent = nullptr);
-
-    void setOpacity(qreal opacity, bool animated = true);
-    void addButton(QAbstractButton *button);
-
-signals:
-    void resetToOriginalBtnClicked();
-    void toggleWindowMaximum();
-    void zoomInBtnClicked();
-    void zoomOutBtnClicked();
-    void toggleCheckerboardBtnClicked();
-    void rotateRightBtnClicked();
-
-private:
-    OpacityHelper * m_opacityHelper;
-};
-
-#endif // BOTTOMBUTTONGROUP_H

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/net.blumia.pineapple-pictures.desktop.liquid

@@ -0,0 +1,18 @@
+[Desktop Entry]
+Type=Application
+Name={{ default.strings.name | desktop_escape }}
+GenericName={{ default.strings.generic_name | desktop_escape }}
+Comment={{ default.strings.comment | desktop_escape }}
+Exec=ppic %F
+Icon=net.blumia.pineapple-pictures
+Terminal=false
+StartupNotify=false
+Categories=Graphics;
+MimeType=image/bmp;image/bmp24;image/jpg;image/jpe;image/jpeg;image/jpeg24;image/jng;image/pcd;image/pcx;image/png;image/tif;image/tiff;image/tiff24;image/dds;image/gif;image/sgi;image/j2k;image/jp2;image/pct;image/wdp;image/arw;image/icb;image/dng;image/vda;image/vst;image/svg;image/ptif;image/mef;image/xbm;image/svg+xml;
+Keywords={{ default.strings.keywords | desktop_escape }}
+{% for lang in languages %}
+Name[{{ lang.locale }}]={{ lang.strings.name | desktop_escape }}
+GenericName[{{ lang.locale }}]={{ lang.strings.generic_name | desktop_escape }}
+Comment[{{ lang.locale }}]={{ lang.strings.comment | desktop_escape }}
+Keywords[{{ lang.locale }}]={{ lang.strings.keywords | desktop_escape }}
+{% endfor %}

dist/net.blumia.pineapple-pictures.desktop.toml

@@ -0,0 +1,18 @@
+version = 1
+source_language = "en"
+
+[strings.name]
+msgid = "Pineapple Pictures"
+comment = "Display name of the application."
+
+[strings.generic_name]
+msgid = "Image Viewer"
+comment = "Generic name describing the application category."
+
+[strings.comment]
+msgid = "Pineapple Pictures is a lightweight image viewer"
+comment = "Tooltip-like description of the application."
+
+[strings.keywords]
+msgid = "Picture;Image;Viewer;Jpg;Jpeg;Png;"
+comment = "Search keywords. Semicolon separated list; the trailing semicolon is required."

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

@@ -0,0 +1,384 @@
+<?xml version="1.0" encoding="utf-8"?>
+<component type="desktop-application">
+  <id>net.blumia.pineapple-pictures</id>
+  <name>{{ default.strings.name | xml_escape }}</name>
+{% for lang in languages %}
+  <name xml:lang="{{ lang.lang }}">{{ lang.strings.name | xml_escape }}</name>
+{% endfor %}
+  <summary>{{ default.strings.summary | xml_escape }}</summary>
+{% for lang in languages %}
+  <summary xml:lang="{{ lang.lang }}">{{ lang.strings.summary | xml_escape }}</summary>
+{% endfor %}
+  <metadata_license>CC0-1.0</metadata_license>
+  <project_license>MIT</project_license>
+  <description>
+    <p>{{ default.strings.description | xml_escape }}</p>
+{% for lang in languages %}
+    <p xml:lang="{{ lang.lang }}">{{ lang.strings.description | xml_escape }}</p>
+{% endfor %}
+  </description>
+  <developer id="net.blumia">
+    <name>{{ default.strings.developer_name | xml_escape }}</name>
+{% for lang in languages %}
+    <name xml:lang="{{ lang.lang }}">{{ lang.strings.developer_name | xml_escape }}</name>
+{% endfor %}
+  </developer>
+  <launchable type="desktop-id">net.blumia.pineapple-pictures.desktop</launchable>
+  <url type="homepage">https://github.com/BLumia/pineapple-pictures</url>
+  <url type="bugtracker">https://github.com/BLumia/pineapple-pictures/issues</url>
+  <url type="donation">https://ko-fi.com/blumia</url>
+  <url type="translate">https://hosted.weblate.org/projects/pineapple-pictures/</url>
+  <url type="vcs-browser">https://github.com/BLumia/pineapple-pictures</url>
+  <provides>
+    <binary>ppic</binary>
+  </provides>
+  <screenshots>
+    <screenshot type="default">
+      <caption>{{ default.strings.screenshot_caption_main | xml_escape }}</caption>
+{% for lang in languages %}
+      <caption xml:lang="{{ lang.lang }}">{{ lang.strings.screenshot_caption_main | xml_escape }}</caption>
+{% endfor %}
+      <image type="source" width="1503" height="640">https://pineapple-pictures.sourceforge.io/ppic-gui-static.png</image>
+    </screenshot>
+    <screenshot>
+      <caption>{{ default.strings.screenshot_caption_raster | xml_escape }}</caption>
+{% for lang in languages %}
+      <caption xml:lang="{{ lang.lang }}">{{ lang.strings.screenshot_caption_raster | xml_escape }}</caption>
+{% endfor %}
+      <image type="source" width="771" height="553">https://pineapple-pictures.sourceforge.io/ppic-zoom-raster.png</image>
+    </screenshot>
+    <screenshot>
+      <caption>{{ default.strings.screenshot_caption_vector | xml_escape }}</caption>
+{% for lang in languages %}
+      <caption xml:lang="{{ lang.lang }}">{{ lang.strings.screenshot_caption_vector | xml_escape }}</caption>
+{% endfor %}
+      <image type="source" width="771" height="553">https://pineapple-pictures.sourceforge.io/ppic-zoom-svg.png</image>
+    </screenshot>
+  </screenshots>
+  <releases>
+    <release type="stable" version="1.6.0" date="2026-08-22T00:00:00Z">
+      <description>
+        <p>This release adds the following features:</p>
+        <ul>
+          <li>Allow dragging window from titlebar to move window when maximized</li>
+          <li>Add an option to show/hide bird-eye view</li>
+        </ul>
+        <p>This release fixes the following bugs:</p>
+        <ul>
+          <li>Maximize the window when the image size matches the screen size</li>
+          <li>Fix window might stuck when drag move on some ill-formed window manager</li>
+          <li>Make titlebar respect RTL layout</li>
+        </ul>
+        <p>This release includes the following changes:</p>
+        <ul>
+          <li>Update translations</li>
+          <li>Update Qt version to 6.11.2 for Windows and macOS pre-built binaries</li>
+        </ul>
+        <p>With contributions from:</p>
+        <p>Tech-Tac, Heimen Stoffels (vistaus), VenusGirl, Oğuz Ersen</p>
+      </description>
+    </release>
+    <release type="stable" version="1.5.0" date="2026-07-04T00:00:00Z">
+      <description>
+        <p>This release adds the following features:</p>
+        <ul>
+          <li>Introduced an optional titlebar that display file name and allows drag and double-click to move and toggle maximize state</li>
+          <li>Windows: Now the application will use the system's built-in animation for open window animation</li>
+        </ul>
+        <p>This release fixes the following bug:</p>
+        <ul>
+          <li>Show empty url list should also reset window title to blank</li>
+        </ul>
+        <p>This release includes the following changes:</p>
+        <ul>
+          <li>Update translations</li>
+          <li>Add vcs-browser link to AppStream metadata</li>
+        </ul>
+        <p>With contributions from:</p>
+        <p>Heimen Stoffels (vistaus), VenusGirl (VenusGirl)</p>
+      </description>
+    </release>
+    <release type="stable" version="1.4.1" date="2026-04-05T00:00:00Z">
+      <description>
+        <p>This release includes the following changes:</p>
+        <ul>
+          <li>Update translations</li>
+          <li>Update Qt version to 6.10.3 for Windows and macOS pre-built binaries</li>
+        </ul>
+        <p>With contributions from:</p>
+        <p>Heimen Stoffels (vistaus), Loc Huynh (hthienloc)</p>
+      </description>
+    </release>
+    <release type="stable" version="1.4.0" date="2026-02-11T00:00:00Z">
+      <description>
+        <p>This release adds the following features:</p>
+        <ul>
+          <li>Action to save image as new file with different format</li>
+          <li>Add Vietnamese and Slovenian translation</li>
+        </ul>
+        <p>This release includes the following changes:</p>
+        <ul>
+          <li>Update copyright year to 2026</li>
+          <li>Update translations</li>
+          <li>Update Qt version to 6.10.2 for Windows and macOS pre-built binaries</li>
+        </ul>
+        <p>With contributions from:</p>
+        <p>Loc Huynh, Sabri Ünal, VenusGirl, Andrej Poženel, Andrey</p>
+      </description>
+    </release>
+    <release type="stable" version="1.3.0" date="2025-12-20T00:00:00Z">
+      <description>
+        <p>This release adds the following features:</p>
+        <ul>
+          <li>New option to limit SVG support to SVG Tiny 1.2 standard</li>
+          <li>Windows: ship tools and configurations that help user associate image files to this program</li>
+        </ul>
+        <p>This release fixes the following bugs:</p>
+        <ul>
+          <li>Fix window not appear at the screen that the mouse cursor is at</li>
+          <li>Fix Windows prebuilt binary having AVIF plugin included but not actually support it</li>
+        </ul>
+        <p>This release includes the following changes:</p>
+        <ul>
+          <li>CPack DEB: will now recommend "kimageformat6-plugins" instead of the KF5 version</li>
+          <li>Update translations</li>
+          <li>Update exiv2 version for Windows binary build</li>
+        </ul>
+        <p>With contributions from:</p>
+        <p>VenusGirl, Andrey</p>
+      </description>
+    </release>
+    <release type="stable" version="1.2.1" date="2025-11-22T00:00:00Z">
+      <description>
+        <p>This release fixes the following bug:</p>
+        <ul>
+          <li>Fix incorrect color when display some CMYK images.</li>
+        </ul>
+        <p>This release includes the following changes:</p>
+        <ul>
+          <li>Now use Qt 6.10.1 for pre-built binary</li>
+          <li>Update README description and AppStream metainfo</li>
+          <li>Update translations</li>
+          <li>Update libavif, AOM and expat version for Windows binary build</li>
+        </ul>
+        <p>With contributions from:</p>
+        <p>albanobattistella</p>
+      </description>
+    </release>
+    <release type="stable" version="1.2.0" date="2025-09-21T00:00:00Z">
+      <description>
+        <p>This release adds the following features:</p>
+        <ul>
+          <li>Long image mode that detect extra wide image and auto fit by its thin side</li>
+          <li>Windows: Add product version to binary metadata / resource file</li>
+        </ul>
+        <p>This release includes the following changes:</p>
+        <ul>
+          <li>Update translations</li>
+          <li>Update libavif version for Windows binary build</li>
+        </ul>
+        <p>With contributions from:</p>
+        <p>Heimen Stoffels, albanobattistella, Sabri Ünal</p>
+      </description>
+    </release>
+    <release type="stable" version="1.1.1" date="2025-08-02T00:00:00Z">
+      <description>
+        <p>This release adds the following feature:</p>
+        <ul>
+          <li>Click dock icon should show window when it's hidden on macOS</li>
+        </ul>
+        <p>This release fixes the following bug:</p>
+        <ul>
+          <li>Ensure "Fit by Width" position the view to the beginning of the image</li>
+        </ul>
+        <p>This release includes the following changes:</p>
+        <ul>
+          <li>Update translations</li>
+          <li>Update Exiv2 version for Windows binary build</li>
+        </ul>
+        <p>With contributions from:</p>
+        <p>Heimen Stoffels, VenusGirl, தமிழ்நேரம்</p>
+      </description>
+    </release>
+    <release type="stable" version="1.1.0" date="2025-07-06T00:00:00Z">
+      <description>
+        <p>This release adds the following features:</p>
+        <ul>
+          <li>New option to disable built-in close window animation</li>
+          <li>New option to disable gallery looping</li>
+          <li>Support load m3u8 as image gallery playlist</li>
+        </ul>
+        <p>This release includes the following change:</p>
+        <ul>
+          <li>Drop Qt 5 support</li>
+        </ul>
+        <p>With contributions from:</p>
+        <p>Heimen Stoffels, albanobattistella, தமிழ்நேரம்</p>
+      </description>
+    </release>
+    <release type="stable" version="1.0.0" date="2025-05-03T00:00:00Z">
+      <description>
+        <p>This release adds the following features:</p>
+        <ul>
+          <li>Support enforces windowed mode on start-up</li>
+          <li>Reload image automatically when current image gets updated</li>
+        </ul>
+        <p>This release fixes the following bug:</p>
+        <ul>
+          <li>Display correct text language on macOS</li>
+        </ul>
+        <p>This release includes the following changes:</p>
+        <ul>
+          <li>Use native text for shortcut editor's label</li>
+          <li>Display native commandline message when possible</li>
+          <li>Merge Qt translations into app applications as well</li>
+        </ul>
+        <p>With contributions from:</p>
+        <p>Heimen Stoffels, albanobattistella, mmahhi</p>
+      </description>
+    </release>
+    <release type="stable" version="0.9.2" date="2025-03-05T00:00:00Z">
+      <description>
+        <p>This release fixes the following bug:</p>
+        <ul>
+          <li>Refer to the right exiv2 CMake module so it can be found on Linux</li>
+        </ul>
+        <p>This release includes the following changes:</p>
+        <ul>
+          <li>Convert DEP5 to REUSE.toml for better REUSE compliance</li>
+          <li>Update translations</li>
+        </ul>
+        <p>With contributions from:</p>
+        <p>Pino Toscano, TamilNeram</p>
+      </description>
+    </release>
+    <release type="stable" version="0.9.1" date="2025-01-25T00:00:00Z">
+      <description>
+        <p>This release adds the following features:</p>
+        <ul>
+          <li>Option to double-click to fullscreen</li>
+          <li>Build-time option to embed translation resources</li>
+        </ul>
+        <p>This release fixes the following bugs:</p>
+        <ul>
+          <li>Fix window size not adjusted when open file on macOS</li>
+          <li>Should center window according to available screen geometry</li>
+        </ul>
+        <p>This release includes the following changes:</p>
+        <ul>
+          <li>Change close window bahavior on macOS</li>
+          <li>Update translations</li>
+        </ul>
+        <p>With contributions from:</p>
+        <p>albanobattistella, Sabri Ünal</p>
+      </description>
+    </release>
+    <release type="stable" version="0.9.0" date="2024-12-08T00:00:00Z">
+      <description>
+        <p>This release adds the following features:</p>
+        <ul>
+          <li>Support custom shortcuts for existing actions</li>
+          <li>Actions for frame-by-frame animated image playback support</li>
+        </ul>
+        <p>This release includes the following changes:</p>
+        <ul>
+          <li>Initial macOS bundle support</li>
+          <li>bump minimum required CMake version to 3.16</li>
+          <li>Update translations</li>
+        </ul>
+        <p>With contributions from:</p>
+        <p>albanobattistella, VenusGirl, gallegonovato, Sabri Ünal</p>
+      </description>
+    </release>
+    <release type="stable" version="0.8.2.1" date="2024-10-27T00:00:00Z">
+      <description>
+        <p>This release fixes the following bug:</p>
+        <ul>
+          <li>Cannot load translations caused by a change in 0.8.2</li>
+        </ul>
+      </description>
+    </release>
+    <release type="stable" version="0.8.2" date="2024-10-26T00:00:00Z">
+      <description>
+        <p>This release adds the following feature:</p>
+        <ul>
+          <li>New option to allow use light-color checkerboard by default</li>
+        </ul>
+        <p>With contributions from:</p>
+        <p>albanobattistella, mmahhi, gallegonovato</p>
+      </description>
+    </release>
+    <release type="stable" version="0.8.1" date="2024-08-25T00:00:00Z">
+      <description>
+        <p>This release adds the following feature:</p>
+        <ul>
+          <li>New command line option to list all supported formats</li>
+        </ul>
+        <p>With contributions from:</p>
+        <p>albanobattistella, mmahhi, ovl-1, gallegonovato, Oğuz Ersen</p>
+      </description>
+    </release>
+    <release type="stable" version="0.8.0" date="2024-06-29T00:00:00Z">
+      <description>
+        <p>This release adds the following feature:</p>
+        <ul>
+          <li>Support move image file to trash</li>
+        </ul>
+        <p>With contributions from:</p>
+        <p>albanobattistella, mmahhi, gallegonovato, Oğuz Ersen</p>
+      </description>
+    </release>
+    <release type="stable" version="0.7.4" date="2024-04-04T00:00:00Z">
+      <description>
+        <p>This release adds the following feature:</p>
+        <ul>
+          <li>Add some icons for corresponding menu actions</li>
+        </ul>
+        <p>With contributions from:</p>
+        <p>Reza Almanda, mmahhi, Oğuz Ersen, volkov, Сергій</p>
+      </description>
+    </release>
+    <release type="stable" version="0.7.3" date="2023-10-24T00:00:00Z">
+      <description>
+        <p>This release adds the following feature:</p>
+        <ul>
+          <li>Add "Keep transformation" to menu</li>
+        </ul>
+        <p>With contributions from:</p>
+        <p>mmahhi, VenusGirl, albanobattistella, gallegonovato, Heimen Stoffels</p>
+      </description>
+    </release>
+    <release type="stable" version="0.7.2" date="2023-08-27T00:00:00Z">
+      <description>
+        <p>This release adds the following feature:</p>
+        <ul>
+          <li>Add an option in setting dialog to tweak the High-DPI scaling rounding policy (might only works in Qt 6 build)</li>
+        </ul>
+        <p>This release fixes the following bugs:</p>
+        <ul>
+          <li>Remove image size limit for Qt 6 build</li>
+          <li>Fix application icon install location under Linux</li>
+        </ul>
+        <p>With contributions from:</p>
+        <p>Heimen Stoffels, Andrey, Dan, gallegonovato, albanobattistella, Sabri Ünal</p>
+      </description>
+    </release>
+    <release type="stable" version="0.7.1" date="2023-07-08T00:00:00Z">
+      <description>
+        <p>This release adds the following features:</p>
+        <ul>
+          <li>TIF and TIFF format files in the same folder will now be automatically added to the gallery</li>
+          <li>Built-in window resizing now also supports Linux desktop. (macOS might also works as well)</li>
+        </ul>
+        <p>This release fixes the following bugs:</p>
+        <ul>
+          <li>Settings dialog will automatedly use a suitable size instead of a hard-coded one</li>
+          <li>Fix default configuration file location under Linux. (was `~/.config/config.ini`, now it's `~/.config/Pineapple Pictures/config.ini`)</li>
+        </ul>
+        <p>With contributions from:</p>
+        <p>yyc12345</p>
+      </description>
+    </release>
+  </releases>
+  <content_rating type="oars-1.1"/>
+</component>

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

@@ -0,0 +1,30 @@
+version = 1
+source_language = "en"
+
+[strings.name]
+msgid = "Pineapple Pictures"
+comment = "Display name of the application."
+
+[strings.summary]
+msgid = "Image Viewer"
+comment = "One-line summary shown in software centers."
+
+[strings.description]
+msgid = "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."
+comment = "Description paragraph shown in the details page."
+
+[strings.developer_name]
+msgid = "Gary (BLumia) Wang et al."
+comment = "Name of the application developers."
+
+[strings.screenshot_caption_main]
+msgid = "Main window when an image file is loaded"
+comment = "Caption of the primary screenshot."
+
+[strings.screenshot_caption_raster]
+msgid = "Zooming in a raster image"
+comment = "Caption of the raster image zooming screenshot."
+
+[strings.screenshot_caption_vector]
+msgid = "Zooming in a vector image"
+comment = "Caption of the vector image zooming screenshot."

dist/pineapple-pictures.rc.in.liquid

@@ -0,0 +1,72 @@
+// Generated by MetaGlot. DO NOT EDIT.
+// Sources: dist/pineapple-pictures.rc.in.toml, locales/winrc/*.po (CMake placeholders are substituted later).
+
+#pragma code_page(65001)
+
+// ---------------------------------------------------------------------------
+// Icon resources (referenced from the registry as "<exe path>,-<id>")
+// ---------------------------------------------------------------------------
+
+101 ICON "@CMAKE_CURRENT_SOURCE_DIR@/dist/winrc-icos/app.ico" // app
+102 ICON "@CMAKE_CURRENT_SOURCE_DIR@/dist/winrc-icos/bmp.ico" // bmp
+103 ICON "@CMAKE_CURRENT_SOURCE_DIR@/dist/winrc-icos/gif.ico" // gif
+104 ICON "@CMAKE_CURRENT_SOURCE_DIR@/dist/winrc-icos/jpg.ico" // jpg
+105 ICON "@CMAKE_CURRENT_SOURCE_DIR@/dist/winrc-icos/png.ico" // png
+
+// ---------------------------------------------------------------------------
+// String tables (file type descriptions, referenced as "@<exe path>,-<id>")
+// ---------------------------------------------------------------------------
+
+{% for lang in languages -%}
+// {{ lang.name }}
+LANGUAGE {{ lang.primary }}, {{ lang.sublanguage }}
+STRINGTABLE
+BEGIN
+{%- for i in (1000..1028) -%}
+{% assign key = i | to_string %}
+    {{ i }} "{{ lang.strings[key] | rc_escape }}"
+{%- endfor %}
+END
+
+{% endfor -%}
+// ---------------------------------------------------------------------------
+// Version information (one VERSIONINFO resource per language; Windows picks by resource language)
+// ---------------------------------------------------------------------------
+
+{% for lang in languages -%}
+LANGUAGE {{ lang.primary }}, {{ lang.sublanguage }}
+1 VERSIONINFO
+FILEVERSION @PROJECT_VERSION_MAJOR@, @PROJECT_VERSION_MINOR@, @PROJECT_VERSION_PATCH@, 0
+PRODUCTVERSION @PROJECT_VERSION_MAJOR@, @PROJECT_VERSION_MINOR@, @PROJECT_VERSION_PATCH@, 0
+FILEFLAGSMASK 0x3fL
+#ifdef _DEBUG
+FILEFLAGS 0x1L
+#else
+FILEFLAGS 0x0L
+#endif
+FILEOS 0x40004L // VOS_NT_WINDOWS32
+FILETYPE 0x1L // VFT_APP
+FILESUBTYPE 0x0L // VFT2_UNKNOWN
+BEGIN
+    BLOCK "StringFileInfo"
+    BEGIN
+        BLOCK "{{ lang.block_key }}"
+        BEGIN
+            VALUE "Comments", "https://github.com/BLumia/pineapple-pictures"
+            VALUE "CompanyName", "Gary Wang"
+            VALUE "FileDescription", "{{ lang.strings.file_description | rc_escape }}"
+            VALUE "FileVersion", "@PROJECT_VERSION@"
+            VALUE "InternalName", "ppic"
+            VALUE "LegalCopyright", "MIT/Expat License - Copyright (C) 2026 Gary Wang"
+            VALUE "OriginalFilename", "ppic.exe"
+            VALUE "ProductName", "{{ lang.strings.product_name | rc_escape }}"
+            VALUE "ProductVersion", "@PROJECT_VERSION@"
+        END
+    END
+    BLOCK "VarFileInfo"
+    BEGIN
+        VALUE "Translation", {{ lang.langid }}, {{ lang.code_page }}
+    END
+END
+
+{% endfor -%}

dist/pineapple-pictures.rc.in.toml

@@ -0,0 +1,127 @@
+version = 1
+source_language = "en"
+
+[strings.1000]
+msgid = "Pineapple Pictures"
+context = "Explorer"
+comment = "Application friendly name shown by Explorer, e.g. in the 'Open with' menu."
+
+[strings.1001]
+msgid = "JPEG Image"
+comment = "File type name for: jpg, jpeg, jfif"
+
+[strings.1002]
+msgid = "GIF Animation Image"
+comment = "File type name for: gif"
+
+[strings.1003]
+msgid = "PNG Image"
+comment = "File type name for: png"
+
+[strings.1004]
+msgid = "Scalable Vector Graphics"
+comment = "File type name for: svg"
+
+[strings.1005]
+msgid = "WebP Image"
+comment = "File type name for: webp"
+
+[strings.1006]
+msgid = "AV1 Image File"
+comment = "File type name for: avif"
+
+[strings.1007]
+msgid = "Windows Icon Image"
+comment = "File type name for: ico"
+
+[strings.1008]
+msgid = "Apple Icon Image"
+comment = "File type name for: icns"
+
+[strings.1009]
+msgid = "Photoshop Document"
+comment = "File type name for: psd, psb, pdd, psdt"
+
+[strings.1010]
+msgid = "Krita Document"
+comment = "File type name for: kra"
+
+[strings.1011]
+msgid = "GIMP Document"
+comment = "File type name for: xcf"
+
+[strings.1012]
+msgid = "TARGA Image"
+comment = "File type name for: tga"
+
+[strings.1013]
+msgid = "Tagged Image File Format"
+comment = "File type name for: tif, tiff"
+
+[strings.1014]
+msgid = "Bitmap"
+comment = "File type name for: bmp"
+
+[strings.1015]
+msgid = "Wireless Bitmap"
+comment = "File type name for: wbmp"
+
+[strings.1016]
+msgid = "DirectDraw Surface"
+comment = "File type name for: dds"
+
+[strings.1017]
+msgid = "High Dynamic Range Image"
+comment = "File type name for: hdr"
+
+[strings.1018]
+msgid = "Interchange File Format"
+comment = "File type name for: iff"
+
+[strings.1019]
+msgid = "Softimage Picture"
+comment = "File type name for: pic"
+
+[strings.1020]
+msgid = "PiCture eXchange PC Paintbrush Image"
+comment = "File type name for: pcx"
+
+[strings.1021]
+msgid = "Quite OK Image"
+comment = "File type name for: qoi"
+
+[strings.1022]
+msgid = "Sun Raster Image"
+comment = "File type name for: ras, sun"
+
+[strings.1023]
+msgid = "OpenRaster Image"
+comment = "File type name for: ora"
+
+[strings.1024]
+msgid = "Animated Cursor"
+comment = "File type name for: ani"
+
+[strings.1025]
+msgid = "Portable Float Map"
+comment = "File type name for: pfm, phm"
+
+[strings.1026]
+msgid = "Silicon Graphics Image"
+comment = "File type name for: rgb, rgba, bw, sgi"
+
+[strings.1027]
+msgid = "Pixar Raster Image"
+comment = "File type name for: pxr"
+
+[strings.1028]
+msgid = "Scitex Continuous Tone"
+comment = "File type name for: sct"
+
+[strings.file_description]
+msgid = "Pineapple Pictures - Image Viewer"
+comment = "File description of the executable."
+
+[strings.product_name]
+msgid = "Pineapple Pictures"
+comment = "Display name of the product."

graphicsscene.cpp

@@ -1,71 +0,0 @@
-#include "graphicsscene.h"
-
-#include <QGraphicsSceneMouseEvent>
-#include <QMimeData>
-#include <QDebug>
-#include <QGraphicsItem>
-#include <QUrl>
-#include <QGraphicsSvgItem>
-#include <QMovie>
-#include <QLabel>
-#include <QPainter>
-
-GraphicsScene::GraphicsScene(QObject *parent)
-    : QGraphicsScene(parent)
-{
-    showText(tr("Drag image here"));
-}
-
-GraphicsScene::~GraphicsScene()
-{
-
-}
-
-void GraphicsScene::showImage(const QPixmap &pixmap)
-{
-    this->clear();
-    m_theThing = this->addPixmap(pixmap);
-    this->setSceneRect(m_theThing->boundingRect());
-}
-
-void GraphicsScene::showText(const QString &text)
-{
-    this->clear();
-    QGraphicsTextItem * textItem = this->addText(text);
-    textItem->setDefaultTextColor(QColor("White"));
-    m_theThing = textItem;
-    this->setSceneRect(m_theThing->boundingRect());
-}
-
-void GraphicsScene::showSvg(const QString &filepath)
-{
-    this->clear();
-    QGraphicsSvgItem * svgItem = new QGraphicsSvgItem(filepath);
-    this->addItem(svgItem);
-    m_theThing = svgItem;
-    this->setSceneRect(m_theThing->boundingRect());
-}
-
-void GraphicsScene::showGif(const QString &filepath)
-{
-    this->clear();
-    QMovie * movie = new QMovie(filepath);
-    QLabel * label = new QLabel;
-    label->setStyleSheet("background-color:rgba(225,255,255,0);");
-    label->setMovie(movie);
-    this->addWidget(label);
-    movie->start();
-    m_theThing = this->addRect(QRect(QPoint(0, 0), label->sizeHint()),
-                               QPen(Qt::transparent));
-    this->setSceneRect(m_theThing->boundingRect());
-}
-
-QPixmap GraphicsScene::renderToPixmap()
-{
-    QPixmap pixmap(sceneRect().toRect().size());
-    pixmap.fill(Qt::transparent);
-    QPainter p(&pixmap);
-    render(&p, sceneRect());
-
-    return pixmap;
-}

graphicsscene.h

@@ -1,24 +0,0 @@
-#ifndef GRAPHICSSCENE_H
-#define GRAPHICSSCENE_H
-
-#include <QGraphicsScene>
-
-class GraphicsScene : public QGraphicsScene
-{
-    Q_OBJECT
-public:
-    GraphicsScene(QObject *parent = nullptr);
-    ~GraphicsScene();
-
-    void showImage(const QPixmap &pixmap);
-    void showText(const QString &text);
-    void showSvg(const QString &filepath);
-    void showGif(const QString &filepath);
-
-    QPixmap renderToPixmap();
-
-private:
-    QGraphicsItem * m_theThing;
-};
-
-#endif // GRAPHICSSCENE_H

graphicsview.cpp

@@ -1,306 +0,0 @@
-#include "graphicsview.h"
-
-#include "graphicsscene.h"
-
-#include <QDebug>
-#include <QMouseEvent>
-#include <QScrollBar>
-#include <QMimeData>
-#include <QImageReader>
-
-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::showFileFromUrl(const QUrl &url, bool doRequestGallery)
-{
-    emit navigatorViewRequired(false, 0);
-
-    QString filePath(url.toLocalFile());
-
-    if (filePath.endsWith(".svg")) {
-        showSvg(filePath);
-    } else if (filePath.endsWith(".gif")) {
-        showGif(filePath);
-    } else {
-        QImageReader imageReader(filePath);
-        imageReader.setAutoTransform(true);
-        imageReader.setDecideFormatFromContent(true);
-        QImage::Format imageFormat = imageReader.imageFormat();
-        if (imageFormat == QImage::Format_Invalid) {
-            showText(tr("File is not a valid image"));
-        } else {
-            showImage(QPixmap::fromImageReader(&imageReader));
-        }
-    }
-
-    if (doRequestGallery) {
-        emit requestGallery(filePath);
-    }
-}
-
-void GraphicsView::showImage(const QPixmap &pixmap)
-{
-    resetTransform();
-    scene()->showImage(pixmap);
-    checkAndDoFitInView();
-}
-
-void GraphicsView::showImage(const QImage &image)
-{
-    resetTransform();
-    scene()->showImage(QPixmap::fromImage(image));
-    checkAndDoFitInView();
-}
-
-void GraphicsView::showText(const QString &text)
-{
-    resetTransform();
-    scene()->showText(text);
-    checkAndDoFitInView();
-}
-
-void GraphicsView::showSvg(const QString &filepath)
-{
-    resetTransform();
-    scene()->showSvg(filepath);
-    checkAndDoFitInView();
-}
-
-void GraphicsView::showGif(const QString &filepath)
-{
-    resetTransform();
-    scene()->showGif(filepath);
-    checkAndDoFitInView();
-}
-
-GraphicsScene *GraphicsView::scene() const
-{
-    return qobject_cast<GraphicsScene*>(QGraphicsView::scene());
-}
-
-void GraphicsView::setScene(GraphicsScene *scene)
-{
-    return QGraphicsView::setScene(scene);
-}
-
-qreal GraphicsView::scaleFactor() const
-{
-    int angle = static_cast<int>(m_rotateAngle);
-    if (angle == 0 || angle == 180) {
-        return qAbs(transform().m11());
-    } else {
-        return qAbs(transform().m12());
-    }
-}
-
-void GraphicsView::resetTransform()
-{
-    m_rotateAngle = 0;
-    QGraphicsView::resetTransform();
-}
-
-void GraphicsView::zoomView(qreal scaleFactor)
-{
-    m_enableFitInView = false;
-    scale(scaleFactor, scaleFactor);
-    emit navigatorViewRequired(!isThingSmallerThanWindowWith(transform()), m_rotateAngle);
-}
-
-void GraphicsView::resetScale()
-{
-    resetWithScaleAndRotate(1, m_rotateAngle);
-    emit navigatorViewRequired(!isThingSmallerThanWindowWith(transform()), m_rotateAngle);
-}
-
-void GraphicsView::rotateView(qreal rotateAngel)
-{
-    m_rotateAngle += rotateAngel;
-    m_rotateAngle = static_cast<int>(m_rotateAngle) % 360;
-    resetWithScaleAndRotate(1, m_rotateAngle);
-}
-
-void GraphicsView::fitInView(const QRectF &rect, Qt::AspectRatioMode aspectRadioMode)
-{
-    QGraphicsView::fitInView(rect, aspectRadioMode);
-}
-
-void GraphicsView::checkAndDoFitInView()
-{
-    if (!isThingSmallerThanWindowWith(transform())) {
-        m_enableFitInView = true;
-        fitInView(sceneRect(), Qt::KeepAspectRatio);
-    }
-}
-
-void GraphicsView::toggleCheckerboard()
-{
-    setCheckerboardEnabled(!m_checkerboardEnabled);
-}
-
-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)
-{
-    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) {
-        QTransform tf;
-        tf.rotate(m_rotateAngle);
-        if (isThingSmallerThanWindowWith(tf) && 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 {
-            fitInView(sceneRect(), Qt::KeepAspectRatio);
-        }
-    } else {
-        emit navigatorViewRequired(!isThingSmallerThanWindowWith(transform()), m_rotateAngle);
-    }
-    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 {
-            showFileFromUrl(urls.first());
-        }
-    } 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)
-{
-    m_checkerboardEnabled = enabled;
-    if (m_checkerboardEnabled) {
-        // Prepare background check-board pattern
-        QPixmap tilePixmap(0x20, 0x20);
-        tilePixmap.fill(QColor(35, 35, 35, 110));
-        QPainter tilePainter(&tilePixmap);
-        QColor color(40, 40, 40, 110);
-        tilePainter.fillRect(0, 0, 0x10, 0x10, color);
-        tilePainter.fillRect(0x10, 0x10, 0x10, 0x10, color);
-        tilePainter.end();
-
-        setBackgroundBrush(tilePixmap);
-    } else {
-        setBackgroundBrush(Qt::transparent);
-    }
-}
-
-void GraphicsView::resetWithScaleAndRotate(qreal scaleFactor, qreal rotateAngle)
-{
-    QGraphicsView::resetTransform();
-    scale(scaleFactor, scaleFactor);
-    rotate(rotateAngle);
-}