feat: remove close window animation

custom window is not the goal of this project.
we remove it and use system default window instead.

CMakeLists.txt

@@ -4,7 +4,7 @@
 
 cmake_minimum_required(VERSION 3.16)
 
-project(pineapple-pictures VERSION 1.5.0) # don't forget to update NEWS file and AppStream metadata.
+project(pineapple-pictures VERSION 1.4.1) # don't forget to update NEWS file and AppStream metadata.
 
 include(GNUInstallDirs)
 include(FeatureSummary)
@@ -16,11 +16,10 @@ set (CMAKE_CXX_STANDARD 17)
 set (CMAKE_CXX_STANDARD_REQUIRED ON)
 set (CMAKE_AUTOMOC ON)
 set (CMAKE_AUTORCC ON)
-set (CMAKE_AUTOUIC ON)
 
 find_package(QT NAMES Qt6 REQUIRED COMPONENTS Core)
 
-set (QT_MINIMUM_VERSION "6.5")
+set (QT_MINIMUM_VERSION "6.4")
 
 find_package(Qt${QT_VERSION_MAJOR} ${QT_MINIMUM_VERSION} REQUIRED
     COMPONENTS Widgets Svg SvgWidgets LinguistTools
@@ -39,12 +38,15 @@ endif ()
 
 set (PPIC_CPP_FILES
     app/main.cpp
+    app/framelesswindow.cpp
     app/mainwindow.cpp
     app/actionmanager.cpp
     app/graphicsview.cpp
     app/graphicsscene.cpp
     app/bottombuttongroup.cpp
     app/navigatorview.cpp
+    app/opacityhelper.cpp
+    app/toolbutton.cpp
     app/settings.cpp
     app/settingsdialog.cpp
     app/aboutdialog.cpp
@@ -52,19 +54,20 @@ set (PPIC_CPP_FILES
     app/metadatadialog.cpp
     app/exiv2wrapper.cpp
     app/playlistmanager.cpp
+    app/shortcutedit.cpp
     app/fileopeneventhandler.cpp
-    app/playlistscout.cpp
-    app/playlistscouts/qtscout.cpp
-    app/playlistscouts/explorerscout.cpp
 )
 
 set (PPIC_HEADER_FILES
+    app/framelesswindow.h
     app/mainwindow.h
     app/actionmanager.h
     app/graphicsview.h
     app/graphicsscene.h
     app/bottombuttongroup.h
     app/navigatorview.h
+    app/opacityhelper.h
+    app/toolbutton.h
     app/settings.h
     app/settingsdialog.h
     app/aboutdialog.h
@@ -72,17 +75,8 @@ set (PPIC_HEADER_FILES
     app/metadatadialog.h
     app/exiv2wrapper.h
     app/playlistmanager.h
+    app/shortcutedit.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
@@ -107,7 +101,6 @@ endif ()
 add_executable (${EXE_NAME}
     ${PPIC_HEADER_FILES}
     ${PPIC_CPP_FILES}
-    ${PPIC_UI_FILES}
     ${PPIC_QRC_FILES}
     ${PPIC_RC_FILES}
 )
@@ -124,11 +117,6 @@ 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)

NEWS

@@ -1,21 +1,3 @@
-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

app/aboutdialog.cpp

@@ -3,94 +3,176 @@
 // SPDX-License-Identifier: MIT
 
 #include "aboutdialog.h"
-#include "ui_aboutdialog.h"
 
+#include <QAbstractButton>
+#include <QDialogButtonBox>
+#include <QTextBrowser>
+#include <QTabWidget>
+#include <QVBoxLayout>
 #include <QApplication>
+#include <QLabel>
+#include <QPushButton>
 #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))
+    : QDialog(parent)
+    , m_tabWidget(new QTabWidget)
+    , m_buttonBox(new QDialogButtonBox)
+    , m_helpTextEdit(new QTextBrowser)
+    , m_aboutTextEdit(new QTextBrowser)
+    , m_specialThanksTextEdit(new QTextBrowser)
+    , m_licenseTextEdit(new QTextBrowser)
+    , m_3rdPartyLibsTextEdit(new QTextBrowser)
 {
-    ui->setupUi(this);
+    this->setWindowTitle(tr("About"));
-    setWindowFlag(Qt::WindowContextHelpButtonHint, false);
 
+    const QStringList helpStr {
+        u"<p>%1</p>"_s.arg(tr("Launch application with image file path as argument to load the file.")),
+        u"<p>%1</p>"_s.arg(tr("Drag and drop image file onto the window is also supported.")),
+        u"<p>%1</p>"_s.arg(tr("None of the operations in this application will alter the pictures on disk.")),
+        u"<p>%1</p>"_s.arg(tr("Context menu option explanation:")),
+        u"<ul>"_s,
         // 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":/plain/help.html"_s)
+        u"<li><b>%1</b>:<br/>%2</li>"_s
-        .arg(tr("General Help"))
+            .arg(QCoreApplication::translate("MainWindow", "Stay on top"))
-        .arg(tr("Launch application with image file path as argument to load the file."))
+            .arg(tr("Make window stay on top of all other windows.")),
-        .arg(tr("Passing in a single image file will load all the images in that directory and start viewing from that image."))
+        u"<li><b>%1</b>:<br/>%2</li>"_s
-        .arg(tr("Passing in multiple image files lets you view them one by one."))
+            .arg(QCoreApplication::translate("MainWindow", "Protected mode"))
-        .arg(tr("Drag and drop image file onto the window is also supported."))
+            .arg(tr("Avoid close window accidentally. (eg. by double clicking the window)")),
-        .arg(tr("None of the operations in this application will alter the pictures on disk."))
+        u"<li><b>%1</b>:<br/>%2</li>"_s
-        .arg(tr("Context Menu Help"))
+            .arg(QCoreApplication::translate("MainWindow", "Keep transformation", "The 'transformation' means the flip/rotation status that currently applied to the image view"))
-        .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("Avoid resetting the zoom/rotation/flip state that was applied to the image view when switching between images."))
+        u"</ul>"_s
-        .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 QStringList aboutStr {
-    const QString APP_VERSION_ARG =
+        u"<center><img width='128' height='128' src=':/icons/app-icon.svg'/><br/>"_s,
+        qApp->applicationDisplayName(),
+        (u"<br/>"_s + tr("Version: %1").arg(
 #ifdef GIT_DESCRIBE_VERSION_STRING
-        GIT_DESCRIBE_VERSION_STRING;
+            GIT_DESCRIBE_VERSION_STRING
 #else
-        qApp->applicationVersion();
+            qApp->applicationVersion()
 #endif // GIT_DESCRIBE_VERSION_STRING
-    const QString QT_VERSION_ARG = QT_VERSION_STR;
+        )),
-    const QString QT_ARCH_ARG = QSysInfo::buildCpuArchitecture();
+        u"<hr/>"_s,
-    const QString ABOUT_HTML = loadEmbeddedHtml(u":/plain/about.html"_s)
+        tr("Copyright (c) %1 %2", "%1 is year, %2 is the name of copyright holder(s)")
-        .arg(APP_NAME_ARG)
+            .arg(u"2026"_s, u"<a href='https://github.com/BLumia'>@BLumia</a>"_s),
-        .arg(tr("Version: %1").arg(APP_VERSION_ARG))
+        u"<br/>"_s,
-        .arg(tr("Upstream author"))
+        tr("Logo designed by %1").arg(u"<a href='https://github.com/Lovelyblack'>@Lovelyblack</a>"_s),
-        .arg(tr("Hard fork author"))
+        u"<hr/>"_s,
-        .arg(tr("Logo designer"))
+        tr("Built with Qt %1 (%2)").arg(QT_VERSION_STR, QSysInfo::buildCpuArchitecture()),
-        .arg(tr("Built with Qt %1 (%2)").arg(QT_VERSION_ARG).arg(QT_ARCH_ARG))
+        QStringLiteral("<br/><a href='%1'>%2</a>").arg("https://github.com/BLumia/pineapple-pictures", tr("Source code")),
-        .arg(tr("Source code"));
+        u"</center>"_s
+    };
 
-    const QString SPECIAL_THANKS_HTML = loadEmbeddedHtml(u":/plain/special-thanks.html"_s)
+    QFile translaterHtml(u":/plain/translators.html"_s);
-        .arg(tr("Contributors"))
+    bool canOpenFile = translaterHtml.open(QIODevice::ReadOnly);
-        .arg(tr("List of contributors on GitHub"))
+    const QByteArray & translatorList = canOpenFile ? translaterHtml.readAll() : QByteArrayLiteral("");
-        .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":/plain/license.html"_s)
+    const QStringList specialThanksStr {
-        .arg(tr("License"))
+        u"<h1 align='center'>%1</h1><a href='%2'>%3</a><p>%4</p>"_s.arg(
-        .arg(tr("This application is released under the MIT License."))
+            tr("Contributors"),
-        .arg(tr("License Verbatim Copy"));
+            u"https://github.com/BLumia/pineapple-pictures/graphs/contributors"_s,
+            tr("List of contributors on GitHub"),
+            tr("Thanks to all people who contributed to this project.")
+        ),
 
-    const QString THIRD_PARTY_LIBS_HTML = loadEmbeddedHtml(u":/plain/third-party-libs.html"_s)
+        u"<h1 align='center'>%1</h1><p>%2</p>%3"_s.arg(
-        .arg(tr("Third-party Libraries"))
+            tr("Translators"),
-        .arg(tr("This application is built on the following free software libraries.", "Free as in freedom"))
+            tr("I would like to thank the following people who volunteered to translate this application."),
-        .arg(tr("Some of them are optional and might not be included with this distribution depending on the build environment."));
+            translatorList
+        )
+    };
 
-    ui->m_helpTextEdit->setHtml(HELP_HTML);
+    const QStringList licenseStr {
-    ui->m_aboutTextEdit->setHtml(ABOUT_HTML);
+        u"<h1 align='center'><b>%1</b></h1>"_s.arg(tr("Your Rights")),
-    ui->m_specialThanksTextEdit->setHtml(SPECIAL_THANKS_HTML);
+        u"<p>%1</p><p>%2</p><ul><li>%3</li><li>%4</li><li>%5</li><li>%6</li></ul>"_s.arg(
-    ui->m_licenseTextEdit->setHtml(LICENSE_HTML);
+            tr("%1 is released under the MIT License."), // %1
-    ui->m_3rdPartyLibsTextEdit->setHtml(THIRD_PARTY_LIBS_HTML);
+            tr("This license grants people a number of freedoms:"), // %2
+            tr("You are free to use %1, for any purpose"), // %3
+            tr("You are free to distribute %1"), // %4
+            tr("You can study how %1 works and change it"), // %5
+            tr("You can distribute changed versions of %1") // %6
+        ).arg(u"<i>%1</i>"_s),
+        u"<p>%1</p>"_s.arg(tr("The MIT license guarantees you this freedom. Nobody is ever permitted to take it away.")),
+        u"<hr/><pre>%2</pre>"_s
+    };
 
-    connect(ui->m_buttonBox, QOverload<QAbstractButton *>::of(&QDialogButtonBox::clicked), this, [this](QAbstractButton * btn){
+    const QString mitLicense(QStringLiteral(R"(Expat/MIT License
-        Q_UNUSED(btn)
+
+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.
+)"));
+
+    const QStringList thirdPartyLibsStr {
+        u"<h1 align='center'><b>%1</b></h1>"_s.arg(tr("Third-party Libraries used by %1")),
+        tr("%1 is built on the following free software libraries:", "Free as in freedom"),
+        u"<ul>"_s,
+#ifdef HAVE_EXIV2_VERSION
+        u"<li><a href='%1'>%2</a>: %3</li>"_s.arg("https://www.exiv2.org/", "Exiv2", "GPLv2"),
+#endif // EXIV2_VERSION
+        u"<li><a href='%1'>%2</a>: %3</li>"_s.arg("https://www.qt.io/", "Qt", "GPLv2 + GPLv3 + LGPLv2.1 + LGPLv3"),
+        u"</ul>"_s
+    };
+
+    m_helpTextEdit->setText(helpStr.join('\n'));
+
+    m_aboutTextEdit->setText(aboutStr.join('\n'));
+    m_aboutTextEdit->setOpenExternalLinks(true);
+
+    m_specialThanksTextEdit->setText(specialThanksStr.join('\n'));
+    m_specialThanksTextEdit->setOpenExternalLinks(true);
+
+    m_licenseTextEdit->setText(licenseStr.join('\n').arg(qApp->applicationDisplayName(), mitLicense));
+
+    m_3rdPartyLibsTextEdit->setText(thirdPartyLibsStr.join('\n').arg(u"<i>%1</i>"_s).arg(qApp->applicationDisplayName()));
+    m_3rdPartyLibsTextEdit->setOpenExternalLinks(true);
+
+    m_tabWidget->addTab(m_helpTextEdit, tr("&Help"));
+    m_tabWidget->addTab(m_aboutTextEdit, tr("&About"));
+    m_tabWidget->addTab(m_specialThanksTextEdit, tr("&Special Thanks"));
+    m_tabWidget->addTab(m_licenseTextEdit, tr("&License"));
+    m_tabWidget->addTab(m_3rdPartyLibsTextEdit, tr("&Third-party Libraries"));
+
+    m_buttonBox->setStandardButtons(QDialogButtonBox::Close);
+    connect(m_buttonBox, QOverload<QAbstractButton *>::of(&QDialogButtonBox::clicked), this, [this](){
         this->close();
     });
 
+    setLayout(new QVBoxLayout);
+
+    layout()->addWidget(m_tabWidget);
+    layout()->addWidget(m_buttonBox);
+
     setMinimumSize(361, 161); // not sure why it complain "Unable to set geometry"
+    setWindowFlag(Qt::WindowContextHelpButtonHint, false);
 }
 
 AboutDialog::~AboutDialog()
 {
-    delete ui;
+
 }
 
 QSize AboutDialog::sizeHint() const

app/aboutdialog.h

@@ -8,9 +8,9 @@
 #include <QDialog>
 
 QT_BEGIN_NAMESPACE
-namespace Ui {
+class QTextBrowser;
-class AboutDialog;
+class QTabWidget;
-}
+class QDialogButtonBox;
 QT_END_NAMESPACE
 
 class AboutDialog : public QDialog
@@ -23,7 +23,14 @@ public:
     QSize sizeHint() const override;
 
 private:
-    QT_PREPEND_NAMESPACE(Ui::AboutDialog) *ui;
+    QTabWidget * m_tabWidget = nullptr;
+    QDialogButtonBox * m_buttonBox = nullptr;
+
+    QTextBrowser * m_helpTextEdit = nullptr;
+    QTextBrowser * m_aboutTextEdit = nullptr;
+    QTextBrowser * m_specialThanksTextEdit = nullptr;
+    QTextBrowser * m_licenseTextEdit = nullptr;
+    QTextBrowser * m_3rdPartyLibsTextEdit = nullptr;
 };
 
 #endif // ABOUTDIALOG_H

app/aboutdialog.ui

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

@@ -4,17 +4,19 @@
 
 #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))
+#define ICON_NAME(name)\
+    QStringLiteral(":/icons/" #name ".svg")
+
+#define ACTION_NAME(s) QStringLiteral(STRIFY(s))
+#define STRIFY(s) #s
+
+QIcon ActionManager::loadHidpiIcon(const QString &resp, QSize sz)
 {
     QSvgRenderer r(resp);
     QPixmap pm = QPixmap(sz * qApp->devicePixelRatio());
@@ -27,110 +29,87 @@ static QIcon loadHidpiIcon(const QString &resp, QSize sz = QSize(32, 32))
 
 void ActionManager::setupAction(MainWindow *mainWindow)
 {
-    // region: Action and Its Icon Creation
-
-    // Declare some convenient macros and lambdas.
-
-    #define ICON_NAME(name)\
-        QStringLiteral(":/icons/" #name ".svg")
-
-    #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)->setIcon(iconFromTheme ? QIcon::fromTheme(i) : ActionManager::loadHidpiIcon(i));
         (*a)->setObjectName(an);
         w->addAction(*a);
     };
-
+    #define CREATE_NEW_ICON_ACTION(w, a, i) create_action(w, &a, ICON_NAME(i), ACTION_NAME(a))
-    /// 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)
-
-    // TODO: We may replace all Qt theme icons to our custom icon for visual consistency.
-    // TODO: Some icons are invalid.
-
-    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, zoom-original);
-    CREATE_NEW_ICON_ACTION(mainWindow, actionFitToScreen, app-icon);
+    CREATE_NEW_ICON_ACTION(mainWindow, actionToggleMaximize, view-fullscreen);
-    CREATE_NEW_ICON_ACTION(mainWindow, actionFitByWidth, app-icon);
-    CREATE_NEW_ICON_ACTION(mainWindow, actionFitByHeight, app-icon);
     CREATE_NEW_ICON_ACTION(mainWindow, actionZoomIn, zoom-in);
     CREATE_NEW_ICON_ACTION(mainWindow, actionZoomOut, zoom-out);
-
+    CREATE_NEW_ICON_ACTION(mainWindow, actionToggleCheckerboard, view-background-checkerboard);
-    CREATE_NEW_ICON_ACTION(mainWindow, actionFlipHorizontal, app-icon);
-    CREATE_NEW_ICON_ACTION(mainWindow, actionFlipVertical, app-icon);
     CREATE_NEW_ICON_ACTION(mainWindow, actionRotateClockwise, object-rotate-right);
-    CREATE_NEW_ICON_ACTION(mainWindow, actionRotateCounterClockwise, app-icon);
+    #undef CREATE_NEW_ICON_ACTION
+
+    #define CREATE_NEW_ACTION(w, a) create_action(w, &a, QString(), ACTION_NAME(a))
+    #define CREATE_NEW_THEMEICON_ACTION(w, a, i) create_action(w, &a, QLatin1String(STRIFY(i)), ACTION_NAME(a), true)
+    CREATE_NEW_ACTION(mainWindow, actionRotateCounterClockwise);
+    CREATE_NEW_ACTION(mainWindow, actionPrevPicture);
+    CREATE_NEW_ACTION(mainWindow, actionNextPicture);
 
-    CREATE_NEW_ACTION(mainWindow, actionToggleAvoidResetTransform);
-    CREATE_NEW_ACTION(mainWindow, actionToggleCheckerboard);
     CREATE_NEW_ACTION(mainWindow, actionTogglePauseAnimation);
     CREATE_NEW_ACTION(mainWindow, actionAnimationNextFrame);
 
+    CREATE_NEW_THEMEICON_ACTION(mainWindow, actionOpen, document-open);
+    CREATE_NEW_ACTION(mainWindow, actionHorizontalFlip);
+    CREATE_NEW_ACTION(mainWindow, actionFitInView);
+    CREATE_NEW_ACTION(mainWindow, actionFitByWidth);
+    CREATE_NEW_THEMEICON_ACTION(mainWindow, actionCopyPixmap, edit-copy);
+    CREATE_NEW_ACTION(mainWindow, actionCopyFilePath);
+    CREATE_NEW_THEMEICON_ACTION(mainWindow, actionPaste, edit-paste);
     CREATE_NEW_THEMEICON_ACTION(mainWindow, actionTrash, edit-delete);
-    CREATE_NEW_THEMEICON_ACTION(mainWindow, actionLocateInFileManager, system-file-manager);
+    CREATE_NEW_ACTION(mainWindow, actionToggleStayOnTop);
-    CREATE_NEW_THEMEICON_ACTION(mainWindow, actionProperties, document-properties);
+    CREATE_NEW_ACTION(mainWindow, actionToggleProtectMode);
-
+    CREATE_NEW_ACTION(mainWindow, actionToggleAvoidResetTransform);
     CREATE_NEW_ACTION(mainWindow, actionSettings);
     CREATE_NEW_THEMEICON_ACTION(mainWindow, actionHelp, system-help);
-
+    CREATE_NEW_THEMEICON_ACTION(mainWindow, actionLocateInFileManager, system-file-manager);
-    // Remove convenient macros
+    CREATE_NEW_THEMEICON_ACTION(mainWindow, actionProperties, document-properties);
-
+    CREATE_NEW_ACTION(mainWindow, actionQuitApp);
-    #undef CREATE_NEW_ICON_ACTION
-    #undef CREATE_NEW_THEMEICON_ACTION
     #undef CREATE_NEW_ACTION
+    #undef CREATE_NEW_THEMEICON_ACTION
 
-    #undef STRIFY
+    retranslateUi(mainWindow);
-    #undef ACTION_NAME
-    #undef ICON_NAME
 
-    // endregion
+    QMetaObject::connectSlotsByName(mainWindow);
+}
 
-    // region: Setup Checkable Action
+void ActionManager::retranslateUi(MainWindow *mainWindow)
+{
+    Q_UNUSED(mainWindow);
 
-    actionToggleAvoidResetTransform->setCheckable(true);
+    actionOpen->setText(QCoreApplication::translate("MainWindow", "&Open...", nullptr));
-    actionToggleCheckerboard->setCheckable(true);
-    actionTogglePauseAnimation->setCheckable(true);
 
-    // endregion
+    actionActualSize->setText(QCoreApplication::translate("MainWindow", "Actual size", nullptr));
-
+    actionToggleMaximize->setText(QCoreApplication::translate("MainWindow", "Toggle maximize", nullptr));
-    // region: Action Translatable Text Setup
+    actionZoomIn->setText(QCoreApplication::translate("MainWindow", "Zoom in", nullptr));
-
+    actionZoomOut->setText(QCoreApplication::translate("MainWindow", "Zoom out", nullptr));
-    actionCopyPixmap->setText(QCoreApplication::translate("MainWindow", "Copy P&ixmap", nullptr));
+    actionToggleCheckerboard->setText(QCoreApplication::translate("MainWindow", "Toggle Checkerboard", nullptr));
-    actionCopyFilePath->setText(QCoreApplication::translate("MainWindow", "Copy &File Path", nullptr));
+    actionRotateClockwise->setText(QCoreApplication::translate("MainWindow", "Rotate right", nullptr));
+    actionRotateCounterClockwise->setText(QCoreApplication::translate("MainWindow", "Rotate left", 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));
 
+    actionHorizontalFlip->setText(QCoreApplication::translate("MainWindow", "Flip &Horizontally", nullptr));
+    actionFitInView->setText(QCoreApplication::translate("MainWindow", "Fit to view", nullptr));
+    actionFitByWidth->setText(QCoreApplication::translate("MainWindow", "Fit to width", nullptr));
+    actionCopyPixmap->setText(QCoreApplication::translate("MainWindow", "Copy P&ixmap", nullptr));
+    actionCopyFilePath->setText(QCoreApplication::translate("MainWindow", "Copy &File Path", nullptr));
+    actionPaste->setText(QCoreApplication::translate("MainWindow", "&Paste", nullptr));
     actionTrash->setText(QCoreApplication::translate("MainWindow", "Move to Trash", nullptr));
+    actionToggleStayOnTop->setText(QCoreApplication::translate("MainWindow", "Stay on top", nullptr));
+    actionToggleProtectMode->setText(QCoreApplication::translate("MainWindow", "Protected mode", nullptr));
+    actionToggleAvoidResetTransform->setText(QCoreApplication::translate("MainWindow", "Keep transformation", "The 'transformation' means the flip/rotation status that currently applied to the image view"));
+    actionSettings->setText(QCoreApplication::translate("MainWindow", "Configure...", nullptr));
+    actionHelp->setText(QCoreApplication::translate("MainWindow", "Help", nullptr));
 #ifdef Q_OS_WIN
     actionLocateInFileManager->setText(
         QCoreApplication::translate(
@@ -142,73 +121,33 @@ void ActionManager::setupAction(MainWindow *mainWindow)
     actionLocateInFileManager->setText(QCoreApplication::translate("MainWindow", "Show in directory", nullptr));
 #endif // Q_OS_WIN
     actionProperties->setText(QCoreApplication::translate("MainWindow", "Properties", nullptr));
-
+    actionQuitApp->setText(QCoreApplication::translate("MainWindow", "Quit", nullptr));
-    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);
+    actionOpen->setShortcut(QKeySequence::Open);
-
-    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);
-
+    actionPrevPicture->setShortcuts({
+        QKeySequence(Qt::Key_PageUp),
+        QKeySequence(Qt::Key_Left),
+    });
+    actionNextPicture->setShortcuts({
+        QKeySequence(Qt::Key_PageDown),
+        QKeySequence(Qt::Key_Right),
+    });
+    actionHorizontalFlip->setShortcut(QKeySequence(Qt::CTRL | Qt::Key_R));
+    actionCopyPixmap->setShortcut(QKeySequence::Copy);
+    actionPaste->setShortcut(QKeySequence::Paste);
     actionTrash->setShortcut(QKeySequence::Delete);
-    actionProperties->setShortcut(QKeySequence(Qt::CTRL | Qt::Key_I));
-
-    actionSettings->setShortcut(QKeySequence::Preferences);
     actionHelp->setShortcut(QKeySequence::HelpContents);
-}
+    actionSettings->setShortcut(QKeySequence::Preferences);
-
+    actionProperties->setShortcut(QKeySequence(Qt::CTRL | Qt::Key_I));
-void ActionManager::updateActionState(PlaylistManager* pm, GraphicsView* gv)
+    actionQuitApp->setShortcuts({
-{
+        QKeySequence(Qt::Key_Space),
-    const auto* gs = gv->scene();
+        QKeySequence(Qt::Key_Escape)
-    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

@@ -8,11 +8,7 @@
 #include <QAction>
 
 class MainWindow;
-class PlaylistManager;
-class GraphicsView;
 
-/// Action Manager is separated from Main Window
-/// to manage all actions specifically.
 class ActionManager
 {
 public:
@@ -20,41 +16,43 @@ public:
     ~ActionManager() = default;
 
     void setupAction(MainWindow * mainWindow);
+    void retranslateUi(MainWindow *MainWindow);
     void setupShortcuts();
 
-public slots:
+    static QIcon loadHidpiIcon(const QString &resp, QSize sz = QSize(32, 32));
-    void updateActionState(PlaylistManager* pm, GraphicsView* gv);
 
 public:
-    QAction *actionCopyPixmap;
+    QAction *actionOpen;
-    QAction *actionCopyFilePath;
+
+    QAction *actionActualSize;
+    QAction *actionToggleMaximize;
+    QAction *actionZoomIn;
+    QAction *actionZoomOut;
+    QAction *actionToggleCheckerboard;
+    QAction *actionRotateClockwise;
+    QAction *actionRotateCounterClockwise;
 
     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 *actionHorizontalFlip;
+    QAction *actionFitInView;
+    QAction *actionFitByWidth;
+    QAction *actionCopyPixmap;
+    QAction *actionCopyFilePath;
+    QAction *actionPaste;
     QAction *actionTrash;
-    QAction *actionLocateInFileManager;
+    QAction *actionToggleStayOnTop;
-    QAction *actionProperties;
+    QAction *actionToggleProtectMode;
-
+    QAction *actionToggleAvoidResetTransform;
     QAction *actionSettings;
     QAction *actionHelp;
+    QAction *actionLocateInFileManager;
+    QAction *actionProperties;
+    QAction *actionQuitApp;
 };
 
 #endif // ACTIONMANAGER_H

app/bottombuttongroup.cpp

@@ -4,42 +4,54 @@
 
 #include "bottombuttongroup.h"
 
+#include "opacityhelper.h"
+
 #include <QToolButton>
 #include <QVBoxLayout>
 #include <QDebug>
 
-BottomButtonGroup::BottomButtonGroup(QWidget *parent)
+BottomButtonGroup::BottomButtonGroup(const std::vector<QAction *> &actionList, QWidget *parent)
     : QGroupBox (parent)
+    , m_opacityHelper(new OpacityHelper(this))
 {
     QHBoxLayout * mainLayout = new QHBoxLayout(this);
     mainLayout->setSizeConstraint(QLayout::SetFixedSize);
     this->setLayout(mainLayout);
     this->setSizePolicy(QSizePolicy::Minimum, QSizePolicy::Minimum);
-    this->setStyleSheet(R"#(
+    this->setStyleSheet("BottomButtonGroup {"
-BottomButtonGroup {
+                        "border: 1px solid gray;"
-    border-style: none;
+                        "border-top-left-radius: 10px;"
-    background: transparent;
+                        "border-top-right-radius: 10px;"
-}
+                        "border-style: none;"
-QToolButton {
+                        "background-color:rgba(0,0,0,120)"
-    background: transparent;
+                        "}"
-    border-style: none;
+                        "QToolButton {"
-}
+                        "background:transparent;"
-)#");
+                        "}"
-}
+                        "QToolButton:!focus {"
+                        "border-style: none;"
+                        "}");
 
-void BottomButtonGroup::addActions(const std::vector<QAction *> & actionList) {
+    auto newActionBtn = [this](QAction * action) -> QToolButton * {
-    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
+        return btn;
-        layout()->addWidget(btn);
+    };
+
+    for (QAction * action : actionList) {
+        addButton(newActionBtn(action));
     }
-    updateGeometry();
 }
 
-void BottomButtonGroup::addAction(QAction* action) {
+void BottomButtonGroup::setOpacity(qreal opacity, bool animated)
-    addActions({action});
+{
+    m_opacityHelper->setOpacity(opacity, animated);
+}
+
+void BottomButtonGroup::addButton(QAbstractButton *button)
+{
+    layout()->addWidget(button);
+    updateGeometry();
 }

app/bottombuttongroup.h

@@ -10,14 +10,18 @@
 #include <QAbstractButton>
 #include <QGroupBox>
 
+class OpacityHelper;
 class BottomButtonGroup : public QGroupBox
 {
     Q_OBJECT
 public:
-    explicit BottomButtonGroup(QWidget *parent = nullptr);
+    explicit BottomButtonGroup(const std::vector<QAction *> & actionList, QWidget *parent = nullptr);
 
-    void addActions(const std::vector<QAction *> & actionList);
+    void setOpacity(qreal opacity, bool animated = true);
-    void addAction(QAction* action);
+    void addButton(QAbstractButton *button);
+
+private:
+    OpacityHelper * m_opacityHelper;
 };
 
 #endif // BOTTOMBUTTONGROUP_H

app/framelesswindow.cpp

@@ -0,0 +1,32 @@
+// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
+// SPDX-FileCopyrightText: 2023 Tad Young <yyc12321@outlook.com>
+//
+// SPDX-License-Identifier: MIT
+
+#include "framelesswindow.h"
+
+#include <QMouseEvent>
+#include <QHoverEvent>
+#include <QApplication>
+#include <QVBoxLayout>
+#include <QWindow>
+
+FramelessWindow::FramelessWindow(QWidget *parent)
+    : QWidget(parent)
+    , m_centralLayout(new QVBoxLayout(this))
+{
+    this->setWindowFlags(Qt::Window | Qt::WindowTitleHint | Qt::WindowSystemMenuHint | Qt::WindowMinMaxButtonsHint | Qt::WindowCloseButtonHint);
+
+    m_centralLayout->setContentsMargins(QMargins());
+}
+
+void FramelessWindow::setCentralWidget(QWidget *widget)
+{
+    if (m_centralWidget) {
+        m_centralLayout->removeWidget(m_centralWidget);
+        m_centralWidget->deleteLater();
+    }
+
+    m_centralLayout->addWidget(widget);
+    m_centralWidget = widget;
+}

app/framelesswindow.h

@@ -0,0 +1,27 @@
+// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
+//
+// SPDX-License-Identifier: MIT
+
+#ifndef FRAMELESSWINDOW_H
+#define FRAMELESSWINDOW_H
+
+#include <QWidget>
+
+QT_BEGIN_NAMESPACE
+class QVBoxLayout;
+QT_END_NAMESPACE
+
+class FramelessWindow : public QWidget
+{
+    Q_OBJECT
+public:
+    explicit FramelessWindow(QWidget *parent = nullptr);
+
+    void setCentralWidget(QWidget * widget);
+
+private:
+    QVBoxLayout * m_centralLayout = nullptr;
+    QWidget * m_centralWidget = nullptr; // just a pointer, doesn't take the ownership.
+};
+
+#endif // FRAMELESSWINDOW_H

app/graphicsscene.cpp

@@ -6,9 +6,6 @@
 
 #include "settings.h"
 
-#include <QStyleHints>
-#include <QOperatingSystemVersion>
-#include <QGuiApplication>
 #include <QGraphicsSceneMouseEvent>
 #include <QMimeData>
 #include <QDebug>
@@ -19,33 +16,6 @@
 #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:
@@ -129,8 +99,7 @@ private:
 GraphicsScene::GraphicsScene(QObject *parent)
     : QGraphicsScene(parent)
 {
-    showText(tr("Drag image here", "The same meaning of MainWindow's hint."));
+    showText(tr("Drag image here"));
-    connect(qGuiApp->styleHints(), &QStyleHints::colorSchemeChanged, this, &GraphicsScene::updateStyle);
 }
 
 GraphicsScene::~GraphicsScene()
@@ -152,7 +121,7 @@ void GraphicsScene::showText(const QString &text)
 {
     this->clear();
     QGraphicsTextItem * textItem = this->addText(text);
-    textItem->setDefaultTextColor(ColorSchemaToTextForeground(qGuiApp->styleHints()->colorScheme()));
+    textItem->setDefaultTextColor(QColor("White"));
     m_theThing = textItem;
     this->setSceneRect(m_theThing->boundingRect());
 }
@@ -200,58 +169,28 @@ bool GraphicsScene::trySetTransformationMode(Qt::TransformationMode mode, float
     return false;
 }
 
-/// Fetch graphics item as our custom animated item.
-/// Return nullptr means this item is not animated item.
-static PGraphicsMovieItem* fetchAnimatedItem(QGraphicsItem *item) {
-    return qgraphicsitem_cast<PGraphicsMovieItem *>(item);
-}
-
-bool GraphicsScene::canPauseAnimation() const {
-    return fetchAnimatedItem(m_theThing) != nullptr;
-}
-
-bool GraphicsScene::isPauseAnimation() const {
-    auto* animatedItem = fetchAnimatedItem(m_theThing);
-    if (animatedItem != nullptr) {
-        return animatedItem->movie()->state() == QMovie::Paused;
-    } else {
-        return false;
-    }
-}
-
 bool GraphicsScene::togglePauseAnimation()
 {
-    auto* animatedItem = fetchAnimatedItem(m_theThing);
+    PGraphicsMovieItem * animatedItem = qgraphicsitem_cast<PGraphicsMovieItem *>(m_theThing);
-    if (animatedItem != nullptr) {
+    if (animatedItem) {
         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);
+    PGraphicsMovieItem * animatedItem = qgraphicsitem_cast<PGraphicsMovieItem *>(m_theThing);
-
+    if (animatedItem) {
-    // 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;
+        animatedItem->movie()->setPaused(true);
         return animatedItem->movie()->jumpToFrame(targetFrame);
     }
+    return false;
+}
 
 QPixmap GraphicsScene::renderToPixmap()
 {
@@ -267,14 +206,3 @@ QPixmap GraphicsScene::renderToPixmap()
 
     return pixmap;
 }
-
-void GraphicsScene::updateStyle(Qt::ColorScheme colorScheme) {
-    Q_UNUSED(colorScheme)
-
-    QGraphicsItem * item = this->m_theThing;
-    if (item == nullptr) return;
-    QGraphicsTextItem * textItem = qgraphicsitem_cast<QGraphicsTextItem*>(item);
-    if (textItem == nullptr) return;
-
-    textItem->setDefaultTextColor(ColorSchemaToTextForeground(colorScheme));
-}

app/graphicsscene.h

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

app/graphicsview.cpp

@@ -7,8 +7,6 @@
 #include "graphicsscene.h"
 #include "settings.h"
 
-#include <QStyleHints>
-#include <QOperatingSystemVersion>
 #include <QDebug>
 #include <QColorSpace>
 #include <QMouseEvent>
@@ -25,12 +23,11 @@ GraphicsView::GraphicsView(QWidget *parent)
     setVerticalScrollBarPolicy(Qt::ScrollBarAlwaysOff);
     setResizeAnchor(QGraphicsView::AnchorUnderMouse);
     setTransformationAnchor(QGraphicsView::AnchorUnderMouse);
+    setStyleSheet("background-color: rgba(0, 0, 0, 220);"
+                  "border-radius: 3px;");
     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);
 }
@@ -140,7 +137,7 @@ void GraphicsView::resetTransform()
 
 void GraphicsView::zoomView(qreal scaleFactor)
 {
-    m_enableFitToScreen = false;
+    m_enableFitInView = false;
     scale(scaleFactor, scaleFactor);
     applyTransformationModeByScaleFactor();
     emit navigatorViewRequired(!isThingSmallerThanWindowWith(transform()), transform());
@@ -224,19 +221,6 @@ void GraphicsView::fitByOrientation(Qt::Orientation ori, bool scaleDownOnly)
     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
@@ -289,7 +273,7 @@ void GraphicsView::fitByOrientation(Qt::Orientation ori, bool scaleDownOnly)
         centerOn(sceneLeftCenter);
     }
 
-    m_enableFitToScreen = false;
+    m_enableFitInView = false;
 
     applyTransformationModeByScaleFactor();
     emit navigatorViewRequired(!isThingSmallerThanWindowWith(transform()), transform());
@@ -312,7 +296,7 @@ void GraphicsView::displayScene()
         emit navigatorViewRequired(false, transform());
     }
 
-    m_enableFitToScreen = true;
+    m_enableFitInView = true;
     m_firstUserMediaLoaded = true;
 }
 
@@ -326,12 +310,12 @@ bool GraphicsView::isSceneBiggerThanView() const
 }
 
 // Automately do fit in view when viewport(window) smaller than image original size.
-void GraphicsView::setEnableAutoFitToScreen(bool enable)
+void GraphicsView::setEnableAutoFitInView(bool enable)
 {
-    m_enableFitToScreen = enable;
+    m_enableFitInView = enable;
 }
 
-bool GraphicsView::isAvoidResetTransform() const
+bool GraphicsView::avoidResetTransform() const
 {
     return m_avoidResetTransform;
 }
@@ -341,15 +325,6 @@ 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);
@@ -364,37 +339,9 @@ QTransform GraphicsView::resetScale(const QTransform & orig)
                       orig.dx(),             orig.dy());
 }
 
-void GraphicsView::updateStyle(Qt::ColorScheme colorScheme) {
+void GraphicsView::toggleCheckerboard(bool invertCheckerboardColor)
-    // YYC MARK:
+{
-    // If we are using Windows 10 and lower system or Qt which do not support "Windows 11"
+    setCheckerboardEnabled(!m_checkerboardEnabled, invertCheckerboardColor);
-    // 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)
@@ -440,11 +387,11 @@ void GraphicsView::wheelEvent(QWheelEvent *event)
 
 void GraphicsView::resizeEvent(QResizeEvent *event)
 {
-    if (m_enableFitToScreen) {
+    if (m_enableFitInView) {
         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
+            // but we leave the m_enableFitInView value unchanged in case
             // user resize down the window again.
         } else if (originalSizeSmallerThanWindow && scaleFactor() < 1) {
             resetScale();

app/graphicsview.h

@@ -38,22 +38,19 @@ public:
 
     void displayScene();
     bool isSceneBiggerThanView() const;
-    void setEnableAutoFitToScreen(bool enable = true);
+    void setEnableAutoFitInView(bool enable = true);
 
-    bool isAvoidResetTransform() const;
+    bool avoidResetTransform() 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:
+public slots:
-    void updateStyle(Qt::ColorScheme colorScheme);
+    void toggleCheckerboard(bool invertCheckerboardColor = false);
 
 private:
     void mousePressEvent(QMouseEvent * event) override;
@@ -72,7 +69,7 @@ private:
     // 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_enableFitInView = false;
     bool m_avoidResetTransform = false;
     bool m_checkerboardEnabled = false;
     bool m_useLightCheckerboard = false;

app/main.cpp

@@ -4,6 +4,7 @@
 
 #include "mainwindow.h"
 
+#include "playlistmanager.h"
 #include "settings.h"
 
 #ifdef Q_OS_MACOS
@@ -67,19 +68,21 @@ int main(int argc, char *argv[])
     a.installEventFilter(fileOpenEventHandler);
     a.connect(fileOpenEventHandler, &FileOpenEventHandler::fileOpen, [&w](const QUrl & url){
         if (w.isHidden()) {
+            w.setWindowOpacity(1);
             w.showNormal();
         } else {
             w.activateWindow();
         }
-        w.showFiles({url});
+        w.showUrls({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.showUrls({});
-            w.galleryCurrent(false);
+            w.galleryCurrent(true, true);
+            w.setWindowOpacity(1);
             w.showNormal();
             w.raise();
             w.activateWindow();
@@ -87,8 +90,12 @@ int main(int argc, char *argv[])
     });
 #endif // Q_OS_MACOS
 
-    QStringList fileList = parser.positionalArguments();
+    QStringList urlStrList = parser.positionalArguments();
-    w.showFiles(fileList);
+    QList<QUrl> && urlList = PlaylistManager::convertToUrlList(urlStrList);
+
+    if (!urlList.isEmpty()) {
+        w.showUrls(urlList);
+    }
 
     w.initWindowSize();
 

app/mainwindow.h

@@ -5,19 +5,25 @@
 #ifndef MAINWINDOW_H
 #define MAINWINDOW_H
 
-#include <QWidget>
+#include "framelesswindow.h"
+
+#include <QParallelAnimationGroup>
+#include <QPropertyAnimation>
+#include <QPushButton>
 
 QT_BEGIN_NAMESPACE
+class QGraphicsOpacityEffect;
+class QGraphicsView;
 class QFileSystemWatcher;
-namespace Ui {
-class MainWindow;
-}
 QT_END_NAMESPACE
 
 class ActionManager;
 class PlaylistManager;
-
+class ToolButton;
-class MainWindow : public QWidget
+class GraphicsView;
+class NavigatorView;
+class BottomButtonGroup;
+class MainWindow : public FramelessWindow
 {
     Q_OBJECT
 
@@ -25,26 +31,42 @@ public:
     explicit MainWindow(QWidget *parent = nullptr);
     ~MainWindow() override;
 
-    void showFiles(const QStringList& files);
+    void showUrls(const QList<QUrl> &urls);
-    void showFiles(const QList<QUrl>& urls);
     void initWindowSize();
+    void adjustWindowSizeBySceneRect();
+    QUrl currentImageFileUrl() const;
 
     void clearGallery();
     void galleryPrev();
     void galleryNext();
-    void galleryCurrent(bool fromFileWatcher);
+    void galleryCurrent(bool showLoadImageHintWhenEmpty, bool reloadImage);
 
     static QStringList supportedImageFormats();
 
 protected slots:
+    void showEvent(QShowEvent *event) override;
+    void enterEvent(QEnterEvent *event) override;
+    void leaveEvent(QEvent *event) override;
+    void mousePressEvent(QMouseEvent *event) override;
+    void mouseMoveEvent(QMouseEvent *event) override;
+    void mouseReleaseEvent(QMouseEvent *event) override;
+    void mouseDoubleClickEvent(QMouseEvent *event) override;
     void wheelEvent(QWheelEvent *event) override;
+    void resizeEvent(QResizeEvent *event) override;
     void contextMenuEvent(QContextMenuEvent *event) override;
     void dragEnterEvent(QDragEnterEvent *event) override;
     void dragMoveEvent(QDragMoveEvent *event) override;
     void dropEvent(QDropEvent *event) override;
 
     void centerWindow();
+    void closeWindow();
+    void updateWidgetsPosition();
+    void toggleProtectedMode();
+    void toggleStayOnTop();
     void toggleAvoidResetTransform();
+    bool stayOnTop() const;
+    bool canPaste() const;
+    void quitAppAction(bool force = false);
     void toggleFullscreen();
     void toggleMaximize();
 
@@ -52,46 +74,55 @@ protected:
     QSize sizeHint() const override;
 
 private slots:
-    void on_actionCopyPixmap_triggered();
+    void on_actionOpen_triggered();
-    void on_actionCopyFilePath_triggered();
+
+    void on_actionActualSize_triggered();
+    void on_actionToggleMaximize_triggered();
+    void on_actionZoomIn_triggered();
+    void on_actionZoomOut_triggered();
+    void on_actionToggleCheckerboard_triggered();
+    void on_actionRotateClockwise_triggered();
+    void on_actionRotateCounterClockwise_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_actionHorizontalFlip_triggered();
+    void on_actionFitInView_triggered();
+    void on_actionFitByWidth_triggered();
+    void on_actionCopyPixmap_triggered();
+    void on_actionCopyFilePath_triggered();
+    void on_actionPaste_triggered();
     void on_actionTrash_triggered();
-    void on_actionLocateInFileManager_triggered();
+    void on_actionToggleStayOnTop_triggered();
-    void on_actionProperties_triggered();
+    void on_actionToggleProtectMode_triggered();
-
+    void on_actionToggleAvoidResetTransform_triggered();
     void on_actionSettings_triggered();
     void on_actionHelp_triggered();
+    void on_actionProperties_triggered();
+    void on_actionLocateInFileManager_triggered();
+    void on_actionQuitApp_triggered();
 
 private:
     bool updateFileWatcher(const QString & basePath = QString());
-    void updateActionState();
+    void updateGalleryButtonsVisibility();
 
 private:
-    QT_PREPEND_NAMESPACE(Ui::MainWindow) *ui;
-    
     ActionManager *m_am;
     PlaylistManager *m_pm;
+
+    QPoint m_oldMousePos;
     QFileSystemWatcher *m_fileSystemWatcher;
+    ToolButton *m_prevButton;
+    ToolButton *m_nextButton;
+    GraphicsView *m_graphicsView;
+    NavigatorView *m_gv;
+    BottomButtonGroup *m_bottomButtonGroup;
+    bool m_protectedMode = false;
+    bool m_clickedOnWindow = false;
 };
 
 #endif // MAINWINDOW_H

app/mainwindow.ui

@@ -1,172 +0,0 @@
-<?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>
-   <property name="icon">
-    <iconset theme="edit-copy"/>
-   </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

@@ -3,12 +3,12 @@
 // SPDX-License-Identifier: MIT
 
 #include "metadatadialog.h"
-#include "ui_metadatadialog.h"
 
 #include <QDialogButtonBox>
 #include <QPainter>
 #include <QStyledItemDelegate>
 #include <QTreeView>
+#include <QVBoxLayout>
 #include <QHeaderView>
 
 #include "metadatamodel.h"
@@ -73,33 +73,30 @@ protected:
 };
 
 MetadataDialog::MetadataDialog(QWidget *parent)
-    : QDialog(parent), ui(new QT_PREPEND_NAMESPACE(Ui::MetadataDialog))
+    : QDialog(parent)
+    , m_treeView(new PropertyTreeView(this))
 {
-    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);
+    setWindowTitle(tr("Image Metadata"));
+
+    QDialogButtonBox * buttonBox = new QDialogButtonBox(QDialogButtonBox::Close);
+
+    setLayout(new QVBoxLayout);
+    layout()->addWidget(m_treeView);
+    layout()->addWidget(buttonBox);
+
+    connect(buttonBox, &QDialogButtonBox::rejected, this, &QDialog::close);
+
+    setWindowFlag(Qt::WindowContextHelpButtonHint, false);
 }
 
 MetadataDialog::~MetadataDialog()
 {
-    delete ui;
+
 }
 
 void MetadataDialog::setMetadataModel(MetadataModel * model)

app/metadatadialog.h

@@ -11,12 +11,6 @@ QT_BEGIN_NAMESPACE
 class QTreeView;
 QT_END_NAMESPACE
 
-QT_BEGIN_NAMESPACE
-namespace Ui {
-class MetadataDialog;
-}
-QT_END_NAMESPACE
-
 class MetadataModel;
 class MetadataDialog : public QDialog
 {
@@ -31,7 +25,6 @@ public:
 
 private:
     QTreeView * m_treeView = nullptr;
-    QT_PREPEND_NAMESPACE(Ui::MetadataDialog) *ui;
 };
 
 #endif // METADATADIALOG_H

app/metadatadialog.ui

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

@@ -5,9 +5,8 @@
 #include "navigatorview.h"
 
 #include "graphicsview.h"
+#include "opacityhelper.h"
 
-#include <QStyleHints>
-#include <QOperatingSystemVersion>
 #include <QMouseEvent>
 #include <QDebug>
 #include <QTimer>
@@ -15,12 +14,12 @@
 NavigatorView::NavigatorView(QWidget *parent)
     : QGraphicsView (parent)
     , m_viewportRegion(this->rect())
+    , m_opacityHelper(new OpacityHelper(this))
 {
     setHorizontalScrollBarPolicy(Qt::ScrollBarAlwaysOff);
     setVerticalScrollBarPolicy(Qt::ScrollBarAlwaysOff);
-
+    setStyleSheet("background-color: rgba(0, 0, 0, 120);"
-    updateStyle(qGuiApp->styleHints()->colorScheme());
+                  "border-radius: 3px;");
-    connect(qGuiApp->styleHints(), &QStyleHints::colorSchemeChanged, this, &NavigatorView::updateStyle);
 }
 
 // doesn't take or manage its ownership
@@ -29,6 +28,11 @@ void NavigatorView::setMainView(GraphicsView *mainView)
     m_mainView = mainView;
 }
 
+void NavigatorView::setOpacity(qreal opacity, bool animated)
+{
+    m_opacityHelper->setOpacity(opacity, animated);
+}
+
 void NavigatorView::updateMainViewportRegion()
 {
     // Use QTimer::singleShot with lambda to delay the update
@@ -41,39 +45,6 @@ void NavigatorView::updateMainViewportRegion()
     });
 }
 
-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;

app/navigatorview.h

@@ -7,6 +7,7 @@
 
 #include <QGraphicsView>
 
+class OpacityHelper;
 class GraphicsView;
 class NavigatorView : public QGraphicsView
 {
@@ -15,13 +16,11 @@ public:
     NavigatorView(QWidget *parent = nullptr);
 
     void setMainView(GraphicsView *mainView);
+    void setOpacity(qreal opacity, bool animated = true);
 
 public slots:
     void updateMainViewportRegion();
 
-private slots:
-    void updateStyle(Qt::ColorScheme colorScheme);
-
 private:
     void mousePressEvent(QMouseEvent * event) override;
     void mouseMoveEvent(QMouseEvent * event) override;
@@ -33,6 +32,7 @@ private:
     bool m_mouseDown = false;
     QPolygon m_viewportRegion;
     QGraphicsView *m_mainView = nullptr;
+    OpacityHelper *m_opacityHelper = nullptr;
 };
 
 #endif // NAVIGATORVIEW_H

app/opacityhelper.cpp

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

app/opacityhelper.h

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

app/playlistmanager.cpp

@@ -3,107 +3,194 @@
 // SPDX-License-Identifier: MIT
 
 #include "playlistmanager.h"
-#include "playlistscout.h"
 
 #include <QCollator>
 #include <QDir>
 #include <QFileInfo>
 #include <QUrl>
 
-PlaylistManager::PlaylistManager(QObject *parent)
+PlaylistModel::PlaylistModel(QObject *parent)
-    : QObject(parent)
+    : QAbstractListModel(parent)
-    , m_currentIndex(std::nullopt)
-    , m_playlist()
-    , m_allowedSuffixes()
 {
 
 }
 
+PlaylistModel::~PlaylistModel()
+= default;
+
+void PlaylistModel::setPlaylist(const QList<QUrl> &urls)
+{
+    beginResetModel();
+    m_playlist = urls;
+    endResetModel();
+}
+
+QModelIndex PlaylistModel::loadPlaylist(const QList<QUrl> & urls)
+{
+    if (urls.isEmpty()) return {};
+    if (urls.count() == 1) {
+        return loadPlaylist(urls.constFirst());
+    } else {
+        setPlaylist(urls);
+        return index(0);
+    }
+}
+
+QModelIndex PlaylistModel::loadPlaylist(const QUrl &url)
+{
+    QFileInfo info(url.toLocalFile());
+    QDir dir(info.path());
+    QString && currentFileName = info.fileName();
+
+    if (dir.path() == m_currentDir) {
+        int idx = indexOf(url);
+        return idx == -1 ? appendToPlaylist(url) : index(idx);
+    }
+
+    QStringList entryList = dir.entryList(
+        m_autoLoadSuffixes,
+        QDir::Files | QDir::NoSymLinks, QDir::NoSort);
+
+    QCollator collator;
+    collator.setNumericMode(true);
+
+    std::sort(entryList.begin(), entryList.end(), collator);
+
+    QList<QUrl> playlist;
+
+    int idx = -1;
+    for (int i = 0; i < entryList.count(); i++) {
+        const QString & fileName = entryList.at(i);
+        const QString & oneEntry = dir.absoluteFilePath(fileName);
+        const QUrl & url = QUrl::fromLocalFile(oneEntry);
+        playlist.append(url);
+        if (fileName == currentFileName) {
+            idx = i;
+        }
+    }
+    if (idx == -1) {
+        idx = playlist.count();
+        playlist.append(url);
+    }
+    m_currentDir = dir.path();
+
+    setPlaylist(playlist);
+
+    return index(idx);
+}
+
+QModelIndex PlaylistModel::appendToPlaylist(const QUrl &url)
+{
+    const int lastIndex = rowCount();
+    beginInsertRows(QModelIndex(), lastIndex, lastIndex);
+    m_playlist.append(url);
+    endInsertRows();
+    return index(lastIndex);
+}
+
+bool PlaylistModel::removeAt(int index)
+{
+    if (index < 0 || index >= rowCount()) return false;
+    beginRemoveRows(QModelIndex(), index, index);
+    m_playlist.removeAt(index);
+    endRemoveRows();
+    return true;
+}
+
+int PlaylistModel::indexOf(const QUrl &url) const
+{
+    return m_playlist.indexOf(url);
+}
+
+QUrl PlaylistModel::urlByIndex(int index) const
+{
+    return m_playlist.value(index);
+}
+
+QStringList PlaylistModel::autoLoadFilterSuffixes() const
+{
+    return m_autoLoadSuffixes;
+}
+
+QHash<int, QByteArray> PlaylistModel::roleNames() const
+{
+    QHash<int, QByteArray> result = QAbstractListModel::roleNames();
+    result.insert(UrlRole, "url");
+    return result;
+}
+
+int PlaylistModel::rowCount(const QModelIndex &parent) const
+{
+    return m_playlist.count();
+}
+
+QVariant PlaylistModel::data(const QModelIndex &index, int role) const
+{
+    if (!index.isValid()) return {};
+
+    switch (role) {
+    case Qt::DisplayRole:
+        return m_playlist.at(index.row()).fileName();
+    case UrlRole:
+        return m_playlist.at(index.row());
+    }
+
+    return {};
+}
+
+PlaylistManager::PlaylistManager(QObject *parent)
+    : QObject(parent)
+{
+    connect(&m_model, &PlaylistModel::rowsRemoved, this,
+            [this](const QModelIndex &, int, int) {
+                if (m_model.rowCount() <= m_currentIndex) {
+                    setProperty("currentIndex", m_currentIndex - 1);
+                }
+            });
+
+    auto onRowCountChanged = [this](){
+        emit totalCountChanged(m_model.rowCount());
+    };
+
+    connect(&m_model, &PlaylistModel::rowsInserted, this, onRowCountChanged);
+    connect(&m_model, &PlaylistModel::rowsRemoved, this, onRowCountChanged);
+    connect(&m_model, &PlaylistModel::modelReset, this, onRowCountChanged);
+}
+
 PlaylistManager::~PlaylistManager()
 {
 
 }
 
-// region: Allowed Suffixes Operations
+PlaylistModel *PlaylistManager::model()
-
+{
-const QStringList& PlaylistManager::allowedSuffixes() const {
+    return &m_model;
-    return m_allowedSuffixes;
 }
 
-void PlaylistManager::setAllowedSuffixes(const QStringList& nameFilters) {
+void PlaylistManager::setPlaylist(const QList<QUrl> &urls)
-    m_allowedSuffixes = nameFilters;
+{
-    emit allowedSuffixesChanged(m_allowedSuffixes);
+    m_model.setPlaylist(urls);
 }
 
-// endregion
+QModelIndex PlaylistManager::loadPlaylist(const QList<QUrl> &urls)
-
+{
-// region: Playlist Loader and Reset
+    QModelIndex idx = m_model.loadPlaylist(urls);
-
+    setProperty("currentIndex", idx.row());
-bool PlaylistManager::loadPlaylist(const QStringList& files) {
+    return idx;
-    // 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);
+QModelIndex PlaylistManager::loadPlaylist(const QUrl &url)
+{
+    QModelIndex idx = m_model.loadPlaylist(url);
+    setProperty("currentIndex", idx.row());
+    return idx;
 }
 
-bool PlaylistManager::loadPlaylist(const QList<QUrl>& urls) {
+QModelIndex PlaylistManager::loadM3U8Playlist(const QUrl &url)
-    // 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)) {
+        QList<QUrl> urls;
         while (!file.atEnd()) {
             QString line = file.readLine();
             if (line.startsWith('#')) {
@@ -111,185 +198,86 @@ bool PlaylistManager::loadM3U8Playlist(const QUrl& url) {
             }
             QFileInfo fileInfo(file);
             QUrl item = QUrl::fromUserInput(line, fileInfo.absolutePath());
-            if (!checkUrl(item)) {
-                return false;
-            }
             urls.append(item);
         }
+        return loadPlaylist(urls);
     } else {
-        return false;
+        return {};
+    }
 }
 
-    setPlaylist(std::move(urls));
+int PlaylistManager::totalCount() const
-    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));
+    return m_model.rowCount();
 }
 
-void PlaylistManager::appendToPlaylist(const QUrl &url)
+QModelIndex PlaylistManager::previousIndex() const
 {
-    m_playlist.append(url);
+    int count = totalCount();
-    sanitizeIndex();
+    if (count == 0) return {};
-    emit playlistChanged(totalCount());
+
+    return m_model.index(isFirstIndex() ? count - 1 : m_currentIndex - 1);
 }
 
-bool PlaylistManager::insertIntoPlaylist(qsizetype index, const QString &file)
+QModelIndex PlaylistManager::nextIndex() const
 {
-    return insertIntoPlaylist(index, urlFromString(file));
+    int count = totalCount();
+    if (count == 0) return {};
+
+    return m_model.index(isLastIndex() ? 0 : m_currentIndex + 1);
 }
 
-bool PlaylistManager::insertIntoPlaylist(qsizetype index, const QUrl &url)
+QModelIndex PlaylistManager::curIndex() const
 {
-    if (index < 0 || index > totalCount()) {
+    return m_model.index(m_currentIndex);
-        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;
+    return m_currentIndex == 0;
 }
 
 bool PlaylistManager::isLastIndex() const
 {
-    return m_currentIndex.has_value() && *m_currentIndex + 1 == totalCount();
+    return m_currentIndex + 1 == totalCount();
 }
 
-std::optional<qsizetype> PlaylistManager::currentIndex() const
+void PlaylistManager::setCurrentIndex(const QModelIndex &index)
 {
-    return m_currentIndex;
+    if (index.isValid() && index.row() >= 0 && index.row() < totalCount()) {
+        setProperty("currentIndex", index.row());
+    }
 }
 
-bool PlaylistManager::setCurrentIndex(qsizetype index)
+QUrl PlaylistManager::urlByIndex(const QModelIndex &index)
 {
-    if (!m_currentIndex.has_value()) {
+    return m_model.urlByIndex(index.row());
-        return false;
-    }
-    if (index < 0 || index >= totalCount()) {
-        return false;
-    }
-    if (*m_currentIndex == index) {
-        return true;
 }
 
-    m_currentIndex = index;
+QString PlaylistManager::localFileByIndex(const QModelIndex &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
+bool PlaylistManager::removeAt(const QModelIndex &index)
-
-// region: Misc
-
-void PlaylistManager::sanitizeIndex()
 {
-    auto cnt = totalCount();
+    return m_model.removeAt(index.row());
-    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)
+void PlaylistManager::setAutoLoadFilterSuffixes(const QStringList &nameFilters)
 {
-    return url.isValid() && url.isLocalFile();
+    m_model.setProperty("autoLoadFilterSuffixes", nameFilters);
 }
 
-QUrl PlaylistManager::urlFromString(const QString& file)
+QList<QUrl> PlaylistManager::convertToUrlList(const QStringList &files)
 {
-    return QUrl::fromLocalFile(file);
+    QList<QUrl> urlList;
+    for (const QString & str : std::as_const(files)) {
+        QUrl url = QUrl::fromLocalFile(str);
+        if (url.isValid()) {
+            urlList.append(url);
+        }
     }
 
-// endregion
+    return urlList;
+}

app/playlistmanager.h

@@ -5,126 +5,84 @@
 #pragma once
 
 #include <QUrl>
-#include <QObject>
+#include <QAbstractListModel>
-#include <optional>
+
+class PlaylistModel : public QAbstractListModel
+{
+    Q_OBJECT
+public:
+    enum PlaylistRole {
+        UrlRole = Qt::UserRole
+    };
+    Q_ENUM(PlaylistRole)
+    Q_PROPERTY(QStringList autoLoadFilterSuffixes MEMBER m_autoLoadSuffixes NOTIFY autoLoadFilterSuffixesChanged)
+
+    explicit PlaylistModel(QObject *parent = nullptr);
+    ~PlaylistModel() override;
+
+    void setPlaylist(const QList<QUrl> & urls);
+    QModelIndex loadPlaylist(const QList<QUrl> & urls);
+    QModelIndex loadPlaylist(const QUrl & url);
+    QModelIndex appendToPlaylist(const QUrl & url);
+    bool removeAt(int index);
+    int indexOf(const QUrl & url) const;
+    QUrl urlByIndex(int index) const;
+    QStringList autoLoadFilterSuffixes() const;
+
+    QHash<int, QByteArray> roleNames() const override;
+    int rowCount(const QModelIndex &parent = QModelIndex()) const override;
+    QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const override;
+
+signals:
+    void autoLoadFilterSuffixesChanged(QStringList suffixes);
+
+private:
+    // model data
+    QList<QUrl> m_playlist;
+    // properties
+    QStringList m_autoLoadSuffixes = {};
+    // internal
+    QString m_currentDir;
+};
 
-/// The manager of playlist.
 class PlaylistManager : public QObject
 {
     Q_OBJECT
 public:
-    /// Constructs a PlaylistManager with an optional parent QObject.
+    Q_PROPERTY(int currentIndex MEMBER m_currentIndex NOTIFY currentIndexChanged)
+    Q_PROPERTY(QStringList autoLoadFilterSuffixes WRITE setAutoLoadFilterSuffixes)
+    Q_PROPERTY(PlaylistModel * model READ model CONSTANT)
+
     explicit PlaylistManager(QObject *parent = nullptr);
-    /// Destructor.
     ~PlaylistManager();
 
-    /// Get the allowed file suffixes of this playlist.
+    PlaylistModel * model();
-    /// @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.
+    void setPlaylist(const QList<QUrl> & url);
-    /// @remark The wrapper for another overload.
+    Q_INVOKABLE QModelIndex loadPlaylist(const QList<QUrl> & urls);
-    /// @return True for successful load, otherwise false.
+    Q_INVOKABLE QModelIndex loadPlaylist(const QUrl & url);
-    bool loadPlaylist(const QStringList& files);
+    Q_INVOKABLE QModelIndex loadM3U8Playlist(const QUrl & url);
-    /// 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.
+    int totalCount() const;
-    void appendToPlaylist(const QString& file);
+    QModelIndex previousIndex() const;
-    /// Append a URL to the playlist.
+    QModelIndex nextIndex() const;
-    void appendToPlaylist(const QUrl& url);
+    QModelIndex curIndex() const;
-    /// 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.
+    void setCurrentIndex(const QModelIndex & index);
-    /// @return std::nullopt if the playlist is empty, otherwise the current index.
+    QUrl urlByIndex(const QModelIndex & index);
-    std::optional<qsizetype> currentIndex() const;
+    QString localFileByIndex(const QModelIndex & index);
-    /// Set the current index.
+    bool removeAt(const QModelIndex & index);
-    /// @remark Index only can be set when playlist is not empty.
+
-    /// @return True if successful set, including "not changed" set, otherwise false.
+    void setAutoLoadFilterSuffixes(const QStringList &nameFilters);
-    /// 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.
+    static QList<QUrl> convertToUrlList(const QStringList & files);
-    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);
+    void currentIndexChanged(int index);
-    /// Raised when index was changed bu setter.
+    void totalCountChanged(int count);
-    /// 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.
+    int m_currentIndex = -1;
-    /// @details All playlist load functions will call this function to set playlist at last.
+    PlaylistModel m_model;
-    /// @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

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

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

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

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

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

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

@@ -13,14 +13,6 @@
 #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>
@@ -42,6 +34,22 @@ namespace QEnumHelper
     }
 }
 
+Settings *Settings::m_settings_instance = nullptr;
+
+Settings *Settings::instance()
+{
+    if (!m_settings_instance) {
+        m_settings_instance = new Settings;
+    }
+
+    return m_settings_instance;
+}
+
+bool Settings::stayOnTop() const
+{
+    return m_qsettings->value("stay_on_top", true).toBool();
+}
+
 bool Settings::useLightCheckerboard() const
 {
     return m_qsettings->value("use_light_checkerboard", false).toBool();
@@ -65,24 +73,40 @@ bool Settings::svgTiny12Only() const
 #endif // QT_VERSION < QT_VERSION_CHECK(6, 9, 3)
 }
 
+Settings::DoubleClickBehavior Settings::doubleClickBehavior() const
+{
+    QString result = m_qsettings->value("double_click_behavior", "Close").toString();
+
+    return QEnumHelper::fromString<DoubleClickBehavior>(result, DoubleClickBehavior::Close);
+}
+
 Settings::MouseWheelBehavior Settings::mouseWheelBehavior() const
 {
-    QString result = m_qsettings->value("mouse_wheel_behavior", "").toString();
+    QString result = m_qsettings->value("mouse_wheel_behavior", "Zoom").toString();
+
     return QEnumHelper::fromString<MouseWheelBehavior>(result, MouseWheelBehavior::Zoom);
 }
 
 Settings::WindowSizeBehavior Settings::initWindowSizeBehavior() const
 {
-    QString result = m_qsettings->value("init_window_size_behavior", "").toString();
+    QString result = m_qsettings->value("init_window_size_behavior", "Auto").toString();
-    return QEnumHelper::fromString<WindowSizeBehavior>(result, WindowSizeBehavior::Windowed);
+
+    return QEnumHelper::fromString<WindowSizeBehavior>(result, WindowSizeBehavior::Auto);
 }
 
 Qt::HighDpiScaleFactorRoundingPolicy Settings::hiDpiScaleFactorBehavior() const
 {
-    QString result = m_qsettings->value("hidpi_scale_factor_behavior", "").toString();
+    QString result = m_qsettings->value("hidpi_scale_factor_behavior", "PassThrough").toString();
+
     return QEnumHelper::fromString<Qt::HighDpiScaleFactorRoundingPolicy>(result, Qt::HighDpiScaleFactorRoundingPolicy::PassThrough);
 }
 
+void Settings::setStayOnTop(bool on)
+{
+    m_qsettings->setValue("stay_on_top", on);
+    m_qsettings->sync();
+}
+
 void Settings::setUseLightCheckerboard(bool light)
 {
     m_qsettings->setValue("use_light_checkerboard", light);
@@ -101,6 +125,12 @@ void Settings::setSvgTiny12Only(bool on)
     m_qsettings->sync();
 }
 
+void Settings::setDoubleClickBehavior(DoubleClickBehavior dcb)
+{
+    m_qsettings->setValue("double_click_behavior", QEnumHelper::toString(dcb));
+    m_qsettings->sync();
+}
+
 void Settings::setMouseWheelBehavior(MouseWheelBehavior mwb)
 {
     m_qsettings->setValue("mouse_wheel_behavior", QEnumHelper::toString(mwb));
@@ -119,6 +149,47 @@ void Settings::setHiDpiScaleFactorBehavior(Qt::HighDpiScaleFactorRoundingPolicy
     m_qsettings->sync();
 }
 
+void Settings::applyUserShortcuts(QWidget *widget)
+{
+    m_qsettings->beginGroup("shortcuts");
+    const QStringList shortcutNames = m_qsettings->allKeys();
+    for (const QString & name : shortcutNames) {
+        QList<QKeySequence> shortcuts = m_qsettings->value(name).value<QList<QKeySequence>>();
+        setShortcutsForAction(widget, name, shortcuts, false);
+    }
+    m_qsettings->endGroup();
+}
+
+bool Settings::setShortcutsForAction(QWidget *widget, const QString &objectName,
+                                     QList<QKeySequence> shortcuts, bool writeConfig)
+{
+    QAction * targetAction = nullptr;
+    for (QAction * action : widget->actions()) {
+        if (action->objectName() == objectName) {
+            targetAction = action;
+        } else {
+            for (const QKeySequence & shortcut : std::as_const(shortcuts)) {
+                if (action->shortcuts().contains(shortcut)) {
+                    return false;
+                }
+            }
+        }
+    }
+
+    if (targetAction) {
+        targetAction->setShortcuts(shortcuts);
+    }
+
+    if (targetAction && writeConfig) {
+        m_qsettings->beginGroup("shortcuts");
+        m_qsettings->setValue(objectName, QVariant::fromValue(shortcuts));
+        m_qsettings->endGroup();
+        m_qsettings->sync();
+    }
+
+    return true;
+}
+
 #if defined(FLAG_PORTABLE_MODE_SUPPORT) && defined(Q_OS_WIN)
 #include <windows.h>
 // QCoreApplication::applicationDirPath() parses the "applicationDirPath" from arg0, which...
@@ -137,8 +208,8 @@ QString getApplicationDirPath()
 }
 #endif // defined(FLAG_PORTABLE_MODE_SUPPORT) && defined(Q_OS_WIN)
 
-Settings::Settings(QObject *parent)
+Settings::Settings()
-    : QObject(parent)
+    : QObject(qApp)
 {
     QString configPath;
 

app/settings.h

@@ -11,6 +11,14 @@ class Settings : public QObject
 {
     Q_OBJECT
 public:
+    enum DoubleClickBehavior {
+        Ignore,
+        Close,
+        Maximize,
+        FullScreen,
+    };
+    Q_ENUM(DoubleClickBehavior)
+
     enum MouseWheelBehavior {
         Zoom,
         Switch,
@@ -18,6 +26,7 @@ public:
     Q_ENUM(MouseWheelBehavior)
 
     enum WindowSizeBehavior {
+        Auto,
         Maximized,
         Windowed,
     };
@@ -25,22 +34,32 @@ public:
 
     static Settings *instance();
 
+    bool stayOnTop() const;
     bool useLightCheckerboard() const;
     bool loopGallery() const;
     bool svgTiny12Only() const;
+    DoubleClickBehavior doubleClickBehavior() const;
     MouseWheelBehavior mouseWheelBehavior() const;
     WindowSizeBehavior initWindowSizeBehavior() const;
     Qt::HighDpiScaleFactorRoundingPolicy hiDpiScaleFactorBehavior() const;
 
+    void setStayOnTop(bool on);
     void setUseLightCheckerboard(bool light);
     void setLoopGallery(bool on);
     void setSvgTiny12Only(bool on);
+    void setDoubleClickBehavior(DoubleClickBehavior dcb);
     void setMouseWheelBehavior(MouseWheelBehavior mwb);
     void setInitWindowSizeBehavior(WindowSizeBehavior wsb);
     void setHiDpiScaleFactorBehavior(Qt::HighDpiScaleFactorRoundingPolicy hidpi);
 
+    void applyUserShortcuts(QWidget * widget);
+    bool setShortcutsForAction(QWidget * widget, const QString & objectName,
+                               QList<QKeySequence> shortcuts, bool writeConfig = true);
+
 private:
-    Settings(QObject *parent = nullptr);
+    Settings();
+
+    static Settings *m_settings_instance;
 
     QSettings *m_qsettings;
 

app/settingsdialog.cpp

@@ -3,94 +3,152 @@
 // SPDX-License-Identifier: MIT
 
 #include "settingsdialog.h"
-#include "ui_settingsdialog.h"
 
 #include "settings.h"
+#include "shortcutedit.h"
 
-#include <QApplication>
+#include <QAction>
-#include <QTimer>
+#include <QCheckBox>
+#include <QComboBox>
+#include <QFormLayout>
+#include <QKeySequenceEdit>
+#include <QScrollArea>
+#include <QSplitter>
 #include <QStringListModel>
-#include <type_traits>
+#include <QMessageBox>
-
-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))
+    : QDialog(parent)
+    , m_stayOnTop(new QCheckBox)
+    , m_useLightCheckerboard(new QCheckBox)
+    , m_loopGallery(new QCheckBox)
+    , m_svgTiny12Only(new QCheckBox)
+    , m_doubleClickBehavior(new QComboBox)
+    , m_mouseWheelBehavior(new QComboBox)
+    , m_initWindowSizeBehavior(new QComboBox)
+    , m_hiDpiRoundingPolicyBehavior(new QComboBox)
 {
-    ui->setupUi(this);
+    this->setWindowTitle(tr("Settings"));
-    setWindowFlag(Qt::WindowContextHelpButtonHint, false);
 
-    auto* settings = Settings::instance();
+    QHBoxLayout * mainLayout = new QHBoxLayout(this);
-    ui->m_useLightCheckerboard->setChecked(settings->useLightCheckerboard());
+    QTabWidget * settingsTabs = new QTabWidget(this);
-    ui->m_loopGallery->setChecked(settings->loopGallery());
+    mainLayout->addWidget(settingsTabs);
-    ui->m_svgTiny12Only->setChecked(settings->svgTiny12Only());
+
-    ui->m_mouseWheelBehavior->setModel(MW_OPTIONS.buildComboBoxModel(this));
+    QWidget * settingsFormHolder = new QWidget;
-    Settings::MouseWheelBehavior mwb = settings->mouseWheelBehavior();
+    QFormLayout * settingsForm = new QFormLayout(settingsFormHolder);
-    ui->m_mouseWheelBehavior->setCurrentIndex(MW_OPTIONS.to_index(mwb));
+    settingsTabs->addTab(settingsFormHolder, tr("Options"));
-    ui->m_initWindowSizeBehavior->setModel(IWS_OPTIONS.buildComboBoxModel(this));
+
-    Settings::WindowSizeBehavior iwsb = settings->initWindowSizeBehavior();
+    QSplitter * shortcutEditorSplitter = new QSplitter;
-    ui->m_initWindowSizeBehavior->setCurrentIndex(IWS_OPTIONS.to_index(iwsb));
+    shortcutEditorSplitter->setOrientation(Qt::Vertical);
-    ui->m_hiDpiRoundingPolicyBehavior->setModel(HIDPI_OPTIONS.buildComboBoxModel(this));
+    shortcutEditorSplitter->setChildrenCollapsible(false);
-    Qt::HighDpiScaleFactorRoundingPolicy hidpi = settings->hiDpiScaleFactorBehavior();
+    QScrollArea * shortcutScrollArea = new QScrollArea;
-    ui->m_hiDpiRoundingPolicyBehavior->setCurrentIndex(HIDPI_OPTIONS.to_index(hidpi));
+    shortcutEditorSplitter->addWidget(shortcutScrollArea);
+    shortcutScrollArea->setWidgetResizable(true);
+    shortcutScrollArea->setMinimumHeight(200);
+    QWidget * shortcutsFormHolder = new QWidget;
+    QFormLayout * shortcutsForm = new QFormLayout(shortcutsFormHolder);
+    shortcutScrollArea->setWidget(shortcutsFormHolder);
+    settingsTabs->addTab(shortcutEditorSplitter, tr("Shortcuts"));
+
+    for (const QAction * action : parent->actions()) {
+        ShortcutEdit * shortcutEdit = new ShortcutEdit;
+        shortcutEdit->setObjectName(QLatin1String("shortcut_") + action->objectName());
+        shortcutEdit->setShortcuts(action->shortcuts());
+        shortcutsForm->addRow(action->text(), shortcutEdit);
+        connect(shortcutEdit, &ShortcutEdit::editButtonClicked, this, [=](){
+            if (shortcutEditorSplitter->count() == 1) shortcutEditorSplitter->addWidget(new QWidget);
+            ShortcutEditor * shortcutEditor = new ShortcutEditor(shortcutEdit);
+            shortcutEditor->setDescription(tr("Editing shortcuts for action \"%1\":").arg(action->text()));
+            QWidget * oldEditor = shortcutEditorSplitter->replaceWidget(1, shortcutEditor);
+            shortcutEditorSplitter->setSizes({shortcutEditorSplitter->height(), 1});
+            oldEditor->deleteLater();
+        });
+        connect(shortcutEdit, &ShortcutEdit::applyShortcutsRequested, this, [=](QList<QKeySequence> newShortcuts){
+            bool succ = Settings::instance()->setShortcutsForAction(parent, shortcutEdit->objectName().mid(9),
+                                                                    newShortcuts);
+            if (!succ) {
+                QMessageBox::warning(this, tr("Failed to set shortcuts"),
+                                     tr("Please check if shortcuts are duplicated with existing shortcuts."));
+            }
+            shortcutEdit->setShortcuts(action->shortcuts());
+        });
+    }
+
+    static QList< QPair<Settings::DoubleClickBehavior, QString> > _dc_options {
+        { Settings::DoubleClickBehavior::Ignore, tr("Do nothing") },
+        { Settings::DoubleClickBehavior::Close, tr("Close the window") },
+        { Settings::DoubleClickBehavior::Maximize, tr("Toggle maximize") },
+        { Settings::DoubleClickBehavior::FullScreen, tr("Toggle fullscreen") }
+    };
+
+    static QList< QPair<Settings::MouseWheelBehavior, QString> > _mw_options {
+        { Settings::MouseWheelBehavior::Zoom, tr("Zoom in and out") },
+        { Settings::MouseWheelBehavior::Switch, tr("View next or previous item") }
+    };
+
+    static QList< QPair<Settings::WindowSizeBehavior, QString> > _iws_options {
+        { Settings::WindowSizeBehavior::Auto, tr("Auto size") },
+        { Settings::WindowSizeBehavior::Maximized, tr("Maximized") },
+        { Settings::WindowSizeBehavior::Windowed, tr("Windowed") }
+    };
+
+    static QList< QPair<Qt::HighDpiScaleFactorRoundingPolicy, QString> > _hidpi_options {
+        { Qt::HighDpiScaleFactorRoundingPolicy::Round, tr("Round (Integer scaling)", "This option means round up for .5 and above") },
+        { Qt::HighDpiScaleFactorRoundingPolicy::Ceil, tr("Ceil (Integer scaling)", "This option means always round up") },
+        { Qt::HighDpiScaleFactorRoundingPolicy::Floor, tr("Floor (Integer scaling)", "This option means always round down") },
+        { Qt::HighDpiScaleFactorRoundingPolicy::PassThrough, tr("Follow system (Fractional scaling)", "This option means don't round") }
+    };
+
+    QStringList dcbDropDown;
+    for (const QPair<Settings::DoubleClickBehavior, QString> & dcOption : _dc_options) {
+        dcbDropDown.append(dcOption.second);
+    }
+
+    QStringList mwbDropDown;
+    for (const QPair<Settings::MouseWheelBehavior, QString> & mwOption : _mw_options) {
+        mwbDropDown.append(mwOption.second);
+    }
+
+    QStringList iwsbDropDown;
+    for (const QPair<Settings::WindowSizeBehavior, QString> & iwsOption : _iws_options) {
+        iwsbDropDown.append(iwsOption.second);
+    }
+
+    QStringList hidpiDropDown;
+    for (const QPair<Qt::HighDpiScaleFactorRoundingPolicy, QString> & hidpiOption : _hidpi_options) {
+        hidpiDropDown.append(hidpiOption.second);
+    }
+
+    settingsForm->addRow(tr("Stay on top when start-up"), m_stayOnTop);
+    settingsForm->addRow(tr("Use light-color checkerboard"), m_useLightCheckerboard);
+    settingsForm->addRow(tr("Loop the loaded gallery"), m_loopGallery);
+    settingsForm->addRow(tr("Limit SVG support to SVG Tiny 1.2"), m_svgTiny12Only);
+    settingsForm->addRow(tr("Double-click behavior"), m_doubleClickBehavior);
+    settingsForm->addRow(tr("Mouse wheel behavior"), m_mouseWheelBehavior);
+    settingsForm->addRow(tr("Default window size"), m_initWindowSizeBehavior);
+    settingsForm->addRow(tr("HiDPI scale factor rounding policy"), m_hiDpiRoundingPolicyBehavior);
+
+    m_stayOnTop->setChecked(Settings::instance()->stayOnTop());
+    m_useLightCheckerboard->setChecked(Settings::instance()->useLightCheckerboard());
+    m_loopGallery->setChecked(Settings::instance()->loopGallery());
+    m_svgTiny12Only->setChecked(Settings::instance()->svgTiny12Only());
+    m_doubleClickBehavior->setModel(new QStringListModel(dcbDropDown));
+    Settings::DoubleClickBehavior dcb = Settings::instance()->doubleClickBehavior();
+    m_doubleClickBehavior->setCurrentIndex(static_cast<int>(dcb));
+    m_mouseWheelBehavior->setModel(new QStringListModel(mwbDropDown));
+    Settings::MouseWheelBehavior mwb = Settings::instance()->mouseWheelBehavior();
+    m_mouseWheelBehavior->setCurrentIndex(static_cast<int>(mwb));
+    m_initWindowSizeBehavior->setModel(new QStringListModel(iwsbDropDown));
+    Settings::WindowSizeBehavior iwsb = Settings::instance()->initWindowSizeBehavior();
+    m_initWindowSizeBehavior->setCurrentIndex(static_cast<int>(iwsb));
+    m_hiDpiRoundingPolicyBehavior->setModel(new QStringListModel(hidpiDropDown));
+    Qt::HighDpiScaleFactorRoundingPolicy hidpi = Settings::instance()->hiDpiScaleFactorBehavior();
+    for (int i = 0; i < _hidpi_options.count(); i++) {
+        if (_hidpi_options.at(i).first == hidpi) {
+            m_hiDpiRoundingPolicyBehavior->setCurrentIndex(i);
+            break;
+        }
+    }
 
 #if QT_VERSION >= QT_VERSION_CHECK(6, 7, 0)
 # define QCHECKBOX_CHECKSTATECHANGED QCheckBox::checkStateChanged
@@ -100,41 +158,43 @@ SettingsDialog::SettingsDialog(QWidget *parent)
 # define QT_CHECKSTATE int
 #endif // QT_VERSION >= QT_VERSION_CHECK(6, 7, 0)
 
-    connect(ui->m_useLightCheckerboard, &QCHECKBOX_CHECKSTATECHANGED, this, [ = ](QT_CHECKSTATE state){
+    connect(m_stayOnTop, &QCHECKBOX_CHECKSTATECHANGED, this, [ = ](QT_CHECKSTATE state){
+        Settings::instance()->setStayOnTop(state == Qt::Checked);
+    });
+
+    connect(m_useLightCheckerboard, &QCHECKBOX_CHECKSTATECHANGED, this, [ = ](QT_CHECKSTATE state){
         Settings::instance()->setUseLightCheckerboard(state == Qt::Checked);
     });
 
-    connect(ui->m_loopGallery, &QCHECKBOX_CHECKSTATECHANGED, this, [ = ](QT_CHECKSTATE state){
+    connect(m_loopGallery, &QCHECKBOX_CHECKSTATECHANGED, this, [ = ](QT_CHECKSTATE state){
         Settings::instance()->setLoopGallery(state == Qt::Checked);
     });
 
-    connect(ui->m_svgTiny12Only, &QCHECKBOX_CHECKSTATECHANGED, this, [ = ](QT_CHECKSTATE state){
+    connect(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){
+    connect(m_doubleClickBehavior, QOverload<int>::of(&QComboBox::currentIndexChanged), this, [ = ](int index){
-        Settings::instance()->setMouseWheelBehavior(MW_OPTIONS.to_value(index));
+        Settings::instance()->setDoubleClickBehavior(_dc_options.at(index).first);
     });
 
-    connect(ui->m_initWindowSizeBehavior, QOverload<int>::of(&QComboBox::currentIndexChanged), this, [ = ](int index){
+    connect(m_mouseWheelBehavior, QOverload<int>::of(&QComboBox::currentIndexChanged), this, [ = ](int index){
-        Settings::instance()->setInitWindowSizeBehavior(IWS_OPTIONS.to_value(index));
+        Settings::instance()->setMouseWheelBehavior(_mw_options.at(index).first);
     });
 
-    connect(ui->m_hiDpiRoundingPolicyBehavior, QOverload<int>::of(&QComboBox::currentIndexChanged), this, [ = ](int index){
+    connect(m_initWindowSizeBehavior, QOverload<int>::of(&QComboBox::currentIndexChanged), this, [ = ](int index){
-        Settings::instance()->setHiDpiScaleFactorBehavior(HIDPI_OPTIONS.to_value(index));
+        Settings::instance()->setInitWindowSizeBehavior(_iws_options.at(index).first);
     });
 
-    // YYC MARK:
+    connect(m_hiDpiRoundingPolicyBehavior, QOverload<int>::of(&QComboBox::currentIndexChanged), this, [ = ](int index){
-    // Use adjustSize() to make sure all ComboBox are expanded by its items.
+        Settings::instance()->setHiDpiScaleFactorBehavior(_hidpi_options.at(index).first);
-    // 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();
     });
+
+    adjustSize();
+    setWindowFlag(Qt::WindowContextHelpButtonHint, false);
 }
 
 SettingsDialog::~SettingsDialog()
 {
-    delete ui;
+
 }

app/settingsdialog.h

@@ -5,14 +5,11 @@
 #ifndef SETTINGSDIALOG_H
 #define SETTINGSDIALOG_H
 
+#include <QObject>
 #include <QDialog>
 
-QT_BEGIN_NAMESPACE
+class QCheckBox;
-namespace Ui {
+class QComboBox;
-class SettingsDialog;
-}
-QT_END_NAMESPACE
-
 class SettingsDialog : public QDialog
 {
     Q_OBJECT
@@ -20,8 +17,19 @@ public:
     explicit SettingsDialog(QWidget *parent = nullptr);
     ~SettingsDialog();
 
+signals:
+
+public slots:
+
 private:
-    QT_PREPEND_NAMESPACE(Ui::SettingsDialog) *ui;
+    QCheckBox * m_stayOnTop = nullptr;
+    QCheckBox * m_useLightCheckerboard = nullptr;
+    QCheckBox * m_loopGallery = nullptr;
+    QCheckBox * m_svgTiny12Only = nullptr;
+    QComboBox * m_doubleClickBehavior = nullptr;
+    QComboBox * m_mouseWheelBehavior = nullptr;
+    QComboBox * m_initWindowSizeBehavior = nullptr;
+    QComboBox * m_hiDpiRoundingPolicyBehavior = nullptr;
 };
 
 #endif // SETTINGSDIALOG_H

app/settingsdialog.ui

@@ -1,81 +0,0 @@
-<?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_useLightCheckerboard">
-          <property name="text">
-           <string>Use light-color checkerboard</string>
-          </property>
-         </widget>
-        </item>
-        <item row="1" column="0" colspan="2">
-         <widget class="QCheckBox" name="m_loopGallery">
-          <property name="text">
-           <string>Loop the loaded gallery</string>
-          </property>
-         </widget>
-        </item>
-        <item row="2" 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="3" column="0">
-         <widget class="QLabel" name="m_mouseWheelBehaviorLabel">
-         <property name="text">
-          <string>Mouse wheel behavior</string>
-         </property>
-        </widget>
-       </item>
-       <item row="3" column="1">
-        <widget class="QComboBox" name="m_mouseWheelBehavior"/>
-       </item>
-       <item row="4" column="0">
-         <widget class="QLabel" name="m_initWindowSizeBehaviorLabel">
-         <property name="text">
-          <string>Default window size</string>
-         </property>
-        </widget>
-       </item>
-       <item row="4" column="1">
-        <widget class="QComboBox" name="m_initWindowSizeBehavior"/>
-       </item>
-       <item row="5" column="0">
-         <widget class="QLabel" name="m_hiDpiRoundingPolicyBehaviorLabel">
-         <property name="text">
-          <string>HiDPI scale factor rounding policy</string>
-         </property>
-        </widget>
-       </item>
-       <item row="5" column="1">
-        <widget class="QComboBox" name="m_hiDpiRoundingPolicyBehavior"/>
-       </item>
-      </layout>
-     </widget>
-    </widget>
-   </item>
-  </layout>
- </widget>
- <resources/>
- <connections/>
-</ui>

app/shortcutedit.cpp

@@ -0,0 +1,126 @@
+// SPDX-FileCopyrightText: 2024 Gary Wang <opensource@blumia.net>
+//
+// SPDX-License-Identifier: MIT
+
+#include "shortcutedit.h"
+
+#include <QLabel>
+#include <QToolButton>
+#include <QHBoxLayout>
+#include <QFormLayout>
+#include <QDialogButtonBox>
+#include <QKeySequenceEdit>
+
+ShortcutEditor::ShortcutEditor(ShortcutEdit * shortcutEdit, QWidget * parent)
+    : QWidget(parent)
+    , m_descriptionLabel(new QLabel)
+    , m_shortcutEdit(shortcutEdit)
+    , m_shortcutLayout(new QFormLayout)
+{
+    Q_CHECK_PTR(m_shortcutEdit);
+
+    QDialogButtonBox * buttons = new QDialogButtonBox(QDialogButtonBox::Apply | QDialogButtonBox::Discard);
+
+    QVBoxLayout * layout = new QVBoxLayout(this);
+    layout->addWidget(m_descriptionLabel);
+    layout->addLayout(m_shortcutLayout);
+    layout->addWidget(buttons);
+
+    connect(buttons, &QDialogButtonBox::clicked, this, [=](QAbstractButton *button){
+        if ((QPushButton *)button == buttons->button(QDialogButtonBox::Apply)) {
+            applyShortcuts();
+        } else {
+            reloadShortcuts();
+        }
+    });
+    connect(shortcutEdit, &ShortcutEdit::shortcutsChanged, this, &ShortcutEditor::reloadShortcuts);
+
+    setSizePolicy(QSizePolicy::Preferred, QSizePolicy::Minimum);
+
+    reloadShortcuts();
+}
+
+void ShortcutEditor::setDescription(const QString &desc)
+{
+    m_descriptionLabel->setText(desc);
+}
+
+void ShortcutEditor::reloadShortcuts()
+{
+    if (!m_keySequenceEdits.isEmpty()) {
+        for (QKeySequenceEdit * keyseqEdit : m_keySequenceEdits) {
+            m_shortcutLayout->removeRow(keyseqEdit);
+        }
+        m_keySequenceEdits.clear();
+    }
+
+    QList<QKeySequence> shortcuts = m_shortcutEdit->shortcuts();
+    shortcuts.append(QKeySequence());
+    for (const QKeySequence & shortcut : shortcuts) {
+        QKeySequenceEdit * keyseqEdit = new QKeySequenceEdit(this);
+        keyseqEdit->setClearButtonEnabled(true);
+#if QT_VERSION >= QT_VERSION_CHECK(6, 5, 0)
+        keyseqEdit->setMaximumSequenceLength(1);
+#endif // QT_VERSION >= QT_VERSION_CHECK(6, 5, 0)
+        keyseqEdit->setKeySequence(shortcut);
+        m_keySequenceEdits.append(keyseqEdit);
+    }
+
+    for (int i = 0; i < m_keySequenceEdits.count(); i++) {
+        m_shortcutLayout->addRow(tr("Shortcut #%1").arg(i + 1), m_keySequenceEdits.at(i));
+    }
+}
+
+void ShortcutEditor::applyShortcuts()
+{
+    QList<QKeySequence> shortcuts;
+    for (const QKeySequenceEdit * keyseqEdit : m_keySequenceEdits) {
+        if (!keyseqEdit->keySequence().isEmpty() && !shortcuts.contains(keyseqEdit->keySequence())) {
+            shortcuts.append(keyseqEdit->keySequence());
+        }
+    }
+    emit m_shortcutEdit->applyShortcutsRequested(shortcuts);
+}
+
+// ----------------------------------------
+
+ShortcutEdit::ShortcutEdit(QWidget *parent)
+    : QWidget(parent)
+    , m_shortcutsLabel(new QLabel(this))
+    , m_setShortcutButton(new QToolButton(this))
+{
+    m_setShortcutButton->setText("...");
+
+    QHBoxLayout * layout = new QHBoxLayout(this);
+    layout->setContentsMargins(0, 0, 0, 0);
+    layout->addWidget(m_shortcutsLabel, 1);
+    layout->addWidget(m_setShortcutButton);
+
+    connect(this, &ShortcutEdit::shortcutsChanged, this, [=](){
+        QStringList shortcutTexts;
+        for (const QKeySequence & shortcut : std::as_const(m_shortcuts)) {
+            shortcutTexts.append(shortcut.toString(QKeySequence::NativeText));
+        }
+        m_shortcutsLabel->setText(shortcutTexts.isEmpty() ? tr("No shortcuts") : shortcutTexts.join(", "));
+        m_shortcutsLabel->setDisabled(shortcutTexts.isEmpty());
+    });
+
+    connect(m_setShortcutButton, &QToolButton::clicked, this, &ShortcutEdit::editButtonClicked);
+
+    adjustSize();
+}
+
+ShortcutEdit::~ShortcutEdit()
+{
+}
+
+QList<QKeySequence> ShortcutEdit::shortcuts() const
+{
+    return m_shortcuts;
+}
+
+void ShortcutEdit::setShortcuts(const QList<QKeySequence> &shortcuts)
+{
+    m_shortcuts = shortcuts;
+    emit shortcutsChanged();
+}

app/shortcutedit.h

@@ -0,0 +1,55 @@
+// SPDX-FileCopyrightText: 2024 Gary Wang <opensource@blumia.net>
+//
+// SPDX-License-Identifier: MIT
+
+#pragma once
+
+#include <QWidget>
+#include <QList>
+#include <QKeySequence>
+
+class QLabel;
+class QFormLayout;
+class QToolButton;
+class QKeySequenceEdit;
+class ShortcutEdit;
+class ShortcutEditor : public QWidget
+{
+    Q_OBJECT
+public:
+    explicit ShortcutEditor(ShortcutEdit * shortcutEdit, QWidget * parent = nullptr);
+    ~ShortcutEditor() = default;
+
+    void setDescription(const QString & desc);
+
+    void reloadShortcuts();
+    void applyShortcuts();
+
+private:
+    QLabel * m_descriptionLabel;
+    ShortcutEdit * m_shortcutEdit;
+    QFormLayout * m_shortcutLayout;
+    QList<QKeySequenceEdit *> m_keySequenceEdits;
+};
+
+class ShortcutEdit : public QWidget
+{
+    Q_OBJECT
+    Q_PROPERTY(QList<QKeySequence> shortcuts MEMBER m_shortcuts WRITE setShortcuts NOTIFY shortcutsChanged)
+public:
+    explicit ShortcutEdit(QWidget * parent = nullptr);
+    ~ShortcutEdit();
+
+    QList<QKeySequence> shortcuts() const;
+    void setShortcuts(const QList<QKeySequence> &shortcuts);
+
+signals:
+    void shortcutsChanged();
+    void editButtonClicked();
+    void applyShortcutsRequested(QList<QKeySequence> newShortcuts);
+
+private:
+    QList<QKeySequence> m_shortcuts;
+    QLabel * m_shortcutsLabel;
+    QToolButton * m_setShortcutButton;
+};

app/toolbutton.cpp

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

app/toolbutton.h

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

assets/plain/about.html

@@ -1,29 +0,0 @@
-<center>
-    <p>
-        <img width='128' height='128' src=':/icons/app-icon.svg'/>
-        <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/plain/help.html

@@ -1,29 +0,0 @@
-<!-- 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/plain/license.html

@@ -1,29 +0,0 @@
-<!-- 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/plain/third-party-libs.html

@@ -1,15 +0,0 @@
-<!-- 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/plain/translators.html

@@ -1,14 +1,3 @@
-<!-- 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>

assets/resources.qrc

@@ -10,10 +10,6 @@
         <file>icons/window-close.svg</file>
         <file>icons/go-next.svg</file>
         <file>icons/go-previous.svg</file>
-        <file>plain/help.html</file>
+        <file>plain/translators.html</file>
-        <file>plain/about.html</file>
-        <file>plain/special-thanks.html</file>
-        <file>plain/license.html</file>
-        <file>plain/third-party-libs.html</file>
     </qresource>
 </RCC>

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

@@ -53,7 +53,6 @@
   <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>
@@ -102,26 +101,6 @@
     </screenshot>
   </screenshots>
   <releases>
-    <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>