Added animation settings

PackCompiler should now be much more stable and cuts down on file writes. Instead of rewriting the file for each modification, the entire process now requires just 2 file writes per shader: 1 to extract and 1 to save the compiled shader. Also, the need to expose a setting for the location to the qsb binary is no longer needed as it uses QShaderBaker directly.

It should also be a bit faster now. Instead of compiling a generic set of versions, it only compiles the safe default or system reported supported versions for both SPIR-V and GLSL, when they are present. Only caveat would be if a user were to downgrade their GPU. They would potentially need to rebuild the packs they have installed.

AI_ASSETS

@@ -3,77 +3,89 @@
 
 ;Kero
 {
-    images/kero/kero_build_1.png,
-    placeholders,
-    chatgpt5
-}
-{
-    images/kero/kero_build_2.png,
-    placeholders,
-    chatgpt5
-}
-{
-    images/kero/kero_build_3.png,
-    placeholders,
-    chatgpt5
-}
-{
-    images/kero/kero_build_4.png,
-    placeholders,
-    chatgpt5
-}
-{
-    images/kero/kero_build_error.png,
-    placeholders,
-    chatgpt5
-}
-{
-    images/kero/kero_choice.png,
-    placeholders,
-    chatgpt5
-}
-{
-    images/kero/kero_hello.png,
-    placeholders,
-    chatgpt5
-}
-{
-    images/kero/kero_login.png,
-    placeholders,
-    chatgpt5
-}
-{
-    images/kero/kero_no_results.png,
-    placeholders,
-    chatgpt5
-}
-{
-    images/kero/kero_run_1.png,
-    placeholders,
-    chatgpt5
-}
-{
-    images/kero/kero_run_2.png,
-    placeholders,
-    chatgpt5
-}
-{
-    images/kero/kero_run_3.png,
-    placeholders,
-    chatgpt5
-}
-{
-    images/kero/kero_run_4.png,
-    placeholders,
-    chatgpt5
-}
-{
-    images/kero/kero_warning.png,
-    placeholders,
-    chatgpt5
-}
-{
-    images/kero/kero_success.png,
-    placeholders,
-    chatgpt5
+    {
+        images/kero/kero_build_1.png,
+        placeholders,
+        chatgpt5
+    },
+    {
+        images/kero/kero_build_2.png,
+        placeholders,
+        chatgpt5
+    },
+    {
+        images/kero/kero_build_3.png,
+        placeholders,
+        chatgpt5
+    },
+    {
+        images/kero/kero_build_4.png,
+        placeholders,
+        chatgpt5
+    },
+    {
+        images/kero/kero_build_error.png,
+        placeholders,
+        chatgpt5
+    },
+    {
+        images/kero/kero_choice.png,
+        placeholders,
+        chatgpt5
+    },
+    {
+        images/kero/kero_hello.png,
+        placeholders,
+        chatgpt5
+    },
+    {
+        images/kero/kero_login.png,
+        placeholders,
+        chatgpt5
+    },
+    {
+        images/kero/kero_no_results.png,
+        placeholders,
+        chatgpt5
+    },
+    {
+        images/kero/kero_run_1.png,
+        placeholders,
+        chatgpt5
+    },
+    {
+        images/kero/kero_run_2.png,
+        placeholders,
+        chatgpt5
+    },
+    {
+        images/kero/kero_run_3.png,
+        placeholders,
+        chatgpt5
+    },
+    {
+        images/kero/kero_run_4.png,
+        placeholders,
+        chatgpt5
+    },
+    {
+        images/kero/kero_warning.png,
+        placeholders,
+        chatgpt5
+    },
+    {
+        images/kero/kero_success.png,
+        placeholders,
+        chatgpt5
+    },
+    {
+        images/kero/kero_spotlight.png,
+        placeholders,
+        chatgpt5
+    },
+    {
+        images/kero/kero_star.png,
+        placeholders,
+        chatgpt5
+    }
 }

CMakeLists.txt

@@ -4,7 +4,7 @@ cmake_minimum_required(VERSION 3.21.1)
 option(LINK_INSIGHT "Link Qt Insight Tracker library" ON)
 option(BUILD_QDS_COMPONENTS "Build design studio components" ON)
 
-project(KomplexHub LANGUAGES CXX) 
+project(KomplexHub VERSION 1.0 LANGUAGES CXX)
 
 list(APPEND CMAKE_MODULE_PATH "${CMAKE_CURRENT_SOURCE_DIR}" "${CMAKE_CURRENT_SOURCE_DIR}/cmake")
 
@@ -21,7 +21,7 @@ set(QML_IMPORT_PATH ${QT_QML_OUTPUT_DIRECTORY}
 )
 
 find_package(
-  Qt6 6.8
+  Qt6
     REQUIRED COMPONENTS
       Core
       Gui
@@ -38,6 +38,7 @@ qt_standard_project_setup()
 
 qt_add_executable(${CMAKE_PROJECT_NAME}
 )
+set_target_properties(${CMAKE_PROJECT_NAME} PROPERTIES VERSION "1.0")
 
 qt_add_resources(${CMAKE_PROJECT_NAME} "configuration"
   PREFIX "/"
@@ -97,14 +98,16 @@ qt_add_resources(${CMAKE_PROJECT_NAME} "app_images"
     "images/kero/kero_run_3.png"
     "images/kero/kero_run_4.png"
     "images/kero/kero_success.png"
+    "images/kero/kero_spotlight.png"
+    "images/kero/kero_star.png"
     "images/kero/kero_warning.png"
 )
 
-target_compile_definitions(
-  ${CMAKE_PROJECT_NAME}
-  PUBLIC
-    KOMPLEX_LOCAL_DEV
-)
+# target_compile_definitions(
+#   ${CMAKE_PROJECT_NAME}
+#   PUBLIC
+#     KOMPLEX_LOCAL_DEV
+# )
 
 include(qds)
 

KomplexHubContent/App.qml

@@ -1,21 +1,50 @@
+/*
+ *  Komplex Wallpaper Engine
+ *  Copyright (C) 2026 @DigitalArtifex
+ *  https://digitalartifex.dev - https://github.com/DigitalArtifex
+ *
+ *  This program is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program.  If not, see <https://www.gnu.org/licenses/>
+ */
 import QtQuick
 import QtQuick.Controls 2.15
+import QtCore
+
 import KomplexHub
-import org.kde.kirigami as Kirigami
 
 ApplicationWindow {
 
+    id: window
     visible: true
     flags: Qt.Window
     title: "KomplexHub"
     color: "transparent"
     minimumWidth: 720
 
-    MainScreen {
-        antialiasing: true
+    MainScreen
+    {
         id: mainScreen
 
+        antialiasing: true
         anchors.fill: parent
     }
+
+    Settings
+    {
+        property alias x: window.x
+        property alias y: window.y
+        property alias width: window.width
+        property alias height: window.height
+    }
 }
 

KomplexHubContent/CMakeLists.txt

@@ -18,9 +18,20 @@ qt6_add_qml_module(KomplexHubContent
         "pages/UserProfilePage.qml"
         "pages/WallpaperSettingsPage.qml"
         "pages/VideoSearchPage.qml"
-        QML_FILES pages/FeaturedVideosPage.qml
-        QML_FILES pages/FeaturedPacksPage.qml
-        QML_FILES pages/FeaturedImagesPage.qml
+        "pages/FeaturedVideosPage.qml"
+        "pages/FeaturedPacksPage.qml"
+        "pages/FeaturedImagesPage.qml"
+        "pages/NewestPacksPage.qml"
+        "views/CompletedView.qml"
+        "views/DownloadView.qml"
+        "views/ErrorView.qml"
+        "views/ImageView.qml"
+        "views/PackView.qml"
+        "views/VideoView.qml"
+        RESOURCES views/CMakeLists.txt
+        RESOURCES pages/CMakeLists.txt
 )
 
+add_subdirectory(pages)
+add_subdirectory(views)
 

KomplexHubContent/MainScreen.qml

@@ -1,9 +1,22 @@
 /*
-This is a UI file (.ui.qml) that is intended to be edited in Qt Design Studio only.
-It is supposed to be strictly declarative and only uses a subset of QML. If you edit
-this file manually, you might introduce QML code that is not supported by Qt Design Studio.
-Check out https://doc.qt.io/qtcreator/creator-quick-ui-forms.html for details on .ui.qml files.
-*/
+ *  Komplex Wallpaper Engine
+ *  Copyright (C) 2026 @DigitalArtifex
+ *  https://digitalartifex.dev - https://github.com/DigitalArtifex
+ *
+ *  This program is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program.  If not, see <https://www.gnu.org/licenses/>
+ */
+import QtCore
 import QtQuick
 import QtQuick.Controls 2.0
 import QtQuick.Layouts
@@ -12,7 +25,8 @@ import KomplexHub.Controls
 import KomplexHub.Kero
 import KomplexHubContent
 
-Rectangle {
+Rectangle
+{
     property MenuButton currentMenuButton
     property bool popup: false
 
@@ -20,12 +34,14 @@ Rectangle {
 
     color: palette.window
 
-    RowLayout {
+    RowLayout
+    {
         id: windowRootLayout
         anchors.fill: parent
         spacing: 0
 
-        Rectangle {
+        Rectangle
+        {
             id: windowMenu
 
             Layout.fillWidth: false
@@ -58,10 +74,12 @@ Rectangle {
                         selected = false
                     }
 
-                    Behavior on opacity {
+                    Behavior on opacity
+                    {
                         NumberAnimation
                         {
-                            duration: 250
+                            duration: settings.animationsEnabled ?
+                                        settings.normalAnimationDuration : 0
                         }
                     }
                 }
@@ -81,7 +99,7 @@ Rectangle {
 
                     height: 64
                     width: 100
-                    text: "Home"
+                    text: qsTr("Home")
 
                     icon.height: 32
                     icon.width: 32
@@ -109,7 +127,7 @@ Rectangle {
 
                     height: 64
                     width: 100
-                    text: "Images"
+                    text: qsTr("Images")
 
                     icon.height: 32
                     icon.width: 32
@@ -132,7 +150,7 @@ Rectangle {
 
                     height: 64
                     width: 100
-                    text: "Videos"
+                    text: qsTr("Videos")
 
                     icon.height: 32
                     icon.width: 32
@@ -155,7 +173,7 @@ Rectangle {
 
                     height: 64
                     width: 100
-                    text: "Live"
+                    text: qsTr("Komplex")
 
                     icon.height: 32
                     icon.width: 32
@@ -178,7 +196,7 @@ Rectangle {
 
                     height: 64
                     width: 100
-                    text: "Installed"
+                    text: qsTr("Installed")
 
                     icon.height: 32
                     icon.width: 32
@@ -207,7 +225,7 @@ Rectangle {
 
                     height: 64
                     width: 100
-                    text: "Settings"
+                    text: qsTr("Settings")
 
                     icon.height: 32
                     icon.width: 32
@@ -228,7 +246,7 @@ Rectangle {
                 {
                     NumberAnimation
                     {
-                        duration: 250
+                        duration: settings.animationsEnabled ? settings.normalAnimationDuration : 0
                     }
                 }
             }
@@ -266,8 +284,12 @@ Rectangle {
                         pageLoader.setSearchTerm()
                     }
 
-                    Behavior on preferredHeight {
-                        NumberAnimation { duration: Constants.normalAnimationDuration }
+                    Behavior on preferredHeight
+                    {
+                        NumberAnimation
+                        {
+                            duration: settings.animationsEnabled ? settings.normalAnimationDuration : 0
+                        }
                     }
                 }
 
@@ -302,7 +324,7 @@ Rectangle {
                             id: pageLoaderAnimation
 
                             target: pageLoader
-                            duration: 150
+                            duration: settings.animationsEnabled ? settings.pageChangeAnimationDuration : 0
 
                             onFinished: () => {
                                 if(pageLoader.loading && pageLoader.opacity === 0)
@@ -369,7 +391,7 @@ Rectangle {
 
                         function isSearchPage()
                         {
-                            return (
+                            return(
                                 pageLoader.item instanceof ImageSearchPage ||
                                 pageLoader.item instanceof LiveSearchPage  ||
                                 pageLoader.item instanceof VideoSearchPage
@@ -381,23 +403,6 @@ Rectangle {
         }
     }
 
-    KeroBuildingAnimation
-    {
-        id: buildingOverlay
-
-        anchors.fill: parent
-        visible: false
-    }
-
-    KeroLoadingAnimation
-    {
-        id: loadingAnimation
-        anchors.fill: parent
-
-        visible: opacity > 0
-        opacity: 0
-    }
-
     Connections
     {
         id: popupConnection
@@ -414,7 +419,6 @@ Rectangle {
         currentMenuButton = homeMenubutton
         pageLoader.page = "pages/HomePage.qml"
         searchContainer.preferredHeight = 0
-        loadingAnimation.opacity = 0
     }
 
     states: [
@@ -446,4 +450,17 @@ Rectangle {
         }
 
     ]
+
+    Settings
+    {
+        id: settings
+        property bool animationsEnabled: true
+        //ms length of page change
+        property int pageChangeAnimationDuration: 250
+        property int pageFadeAnimationDuration: 250
+
+        property int slowAnimationDuration: 750
+        property int normalAnimationDuration: 250
+        property int fastAnimationDuration: 125
+    }
 }

KomplexHubContent/pages/CMakeLists.txt

@@ -0,0 +1,21 @@
+qt_add_library(KomplexHubPages STATIC)
+qt6_add_qml_module(KomplexHubPages
+    URI "KomplexHub.Pages"
+    VERSION 1.0
+    RESOURCE_PREFIX "/qt/qml"
+    QML_FILES
+        "HomePage.qml"
+        "ImageSearchPage.qml"
+        "InstalledWallpaperPage.qml"
+        "LiveSearchPage.qml"
+        "LoginPage.qml"
+        "SettingsPage.qml"
+        "UserProfilePage.qml"
+        "WallpaperSettingsPage.qml"
+        "VideoSearchPage.qml"
+        "FeaturedVideosPage.qml"
+        "FeaturedPacksPage.qml"
+        "FeaturedImagesPage.qml"
+        "NewestPacksPage.qml"
+        QML_FILES KomplexSettingsPage.qml
+)

KomplexHubContent/pages/FeaturedImagesPage.qml

@@ -1,3 +1,22 @@
+/*
+ *  Komplex Wallpaper Engine
+ *  Copyright (C) 2026 @DigitalArtifex
+ *  https://digitalartifex.dev - https://github.com/DigitalArtifex
+ *
+ *  This program is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program.  If not, see <https://www.gnu.org/licenses/>
+ */
+import QtCore
 import QtQuick
 import QtQuick.Controls
 import QtQuick.Layouts
@@ -5,13 +24,16 @@ import QtQuick.Layouts
 import KomplexHub
 import KomplexHub.Controls
 import KomplexHub.Kero
-import KomplexHubPlugin
+import KomplexHub.Plugin
+import KomplexHub.Views
+import KomplexHub.Pages
 
 Rectangle
 {
     id: rootItem
 
-    readonly property bool searchable: false
+    property string query
+    readonly property bool searchable: paginator.searchable
     property bool popup: false
     property int resultWidth: 256
     property int resultHeight: 245
@@ -20,48 +42,68 @@ Rectangle
 
     FeaturedImagesModel
     {
-        id: imagesModel
+        id: searchModel
         resultsPerPage: paginator.resultsPerPage
-        // windowSize: 80
+
+        Component.onCompleted: () => nextPage()
     }
 
-    PaginatorGrid
+    ColumnLayout
     {
-        id: paginator
-        anchors.fill: parent
-        model: imagesModel
-        loading: imagesModel.state === FeaturedImagesModel.Loading
+        id: resultsLayout
         visible: opacity > 0.01
+        anchors.fill: parent
+        anchors.margins: Constants.mediumMargin
 
-        delegate: ItemDelegate
+        KeroHeader
         {
-            id: resultDelegate
+            Layout.alignment: Qt.AlignTop
+            Layout.fillWidth: true
+            Layout.preferredHeight: 180
+            title: qsTr("Featured Images")
+            description: qsTr("A specially curated collection of images, courtesy of Pexels")
+        }
 
-            width: resultWidth
-            height: resultHeight
+        PaginatorGrid
+        {
+            Layout.alignment: Qt.AlignTop
+            Layout.fillHeight: true
+            Layout.fillWidth: true
 
-            required property string uuid
-            required property string author
-            required property string authorId
-            required property string authorUrl
-            required property string thumbnail
-            required property int index
+            id: paginator
+            model: searchModel
+            loading: model.state === FeaturedImagesModel.Loading
 
-            SearchResultItem
+            delegate: ItemDelegate
             {
-                anchors.fill: parent
-                author: parent.author
-                description: qsTr("No description available")
-                thumbnail: parent.thumbnail
-                uuid: parent.uuid
-                pexels: true
-                selected: paginator.currentIndex === parent.index
+                id: resultDelegate
 
-                onTriggered: () => paginator.currentIndex = parent.index
+                width: resultWidth
+                height: resultHeight
 
-                onViewMoreTriggered: () =>
+                required property string author
+                required property string description
+                required property string uuid
+                required property string thumbnail
+                required property string authorId
+                required property int index
+
+                SearchResultItem
                 {
-                    showVideoPopup(parent.index)
+                    anchors.fill: parent
+                    title: parent.author
+                    description: parent.description
+                    thumbnail: parent.thumbnail
+                    uuid: parent.uuid
+                    pexels: true
+                    selected: paginator.currentIndex === parent.index
+
+                    onTriggered: () => paginator.currentIndex = parent.index
+
+                    onViewMoreTriggered: () =>
+                    {
+                        showImagePopup(parent.index)
+                    }
                 }
             }
         }
@@ -77,53 +119,69 @@ Rectangle
 
         ImageView
         {
-            id: imageDetailsPopup
+            id: viewMoreImagePopup
             anchors.fill: parent
             opacity: 0
+            visible: opacity > 0.01
 
-            Behavior on opacity
-            {
+            Behavior on opacity {
                 NumberAnimation
                 {
-                    duration: 250
+                    duration: settings.animationsEnabled ?
+                                   settings.normalAnimationDuration : 0
                 }
             }
         }
 
-        Behavior on opacity
-        {
+        Behavior on opacity {
             NumberAnimation
             {
-                duration: 250
+                duration: settings.animationsEnabled ?
+                               settings.normalAnimationDuration : 0
             }
         }
     }
 
-    Component.onCompleted: () =>
+    function showImagePopup(index)
     {
-        imagesModel.nextPage()
-    }
-
-    function showVideoPopup(index)
-    {
-        imagesModel.setItem(index)
-        imageDetailsPopup.author = searchModel.data(searchModel.index(index,0), ImageSearchModel.AuthorRole)
-        imageDetailsPopup.authorUrl = searchModel.data(searchModel.index(index,0), ImageSearchModel.AuthorUrlRole)
-        imageDetailsPopup.uuid = searchModel.data(searchModel.index(index,0), ImageSearchModel.UuidRole)
-        imageDetailsPopup.thumbnail = searchModel.data(searchModel.index(index,0), ImageSearchModel.ThumbnailRole)
-        imageDetailsPopup.modelIndex = index
-        imageDetailsPopup.model = searchModel.itemModel
-        imageDetailsPopup.opacity = 1
-        paginator.opacity = 0
+        viewMoreImagePopup.author = searchModel.data(searchModel.index(index,0), FeaturedImagesModel.AuthorRole)
+        viewMoreImagePopup.authorUrl = searchModel.data(searchModel.index(index,0), FeaturedImagesModel.AuthorUrlRole)
+        viewMoreImagePopup.description = searchModel.data(searchModel.index(index,0), FeaturedImagesModel.DescriptionRole)
+        viewMoreImagePopup.uuid = searchModel.data(searchModel.index(index,0), FeaturedImagesModel.UuidRole)
+        viewMoreImagePopup.thumbnail = searchModel.data(searchModel.index(index,0), FeaturedImagesModel.LargeThumbnailRole)
+        viewMoreImagePopup.original = searchModel.data(searchModel.index(index,0), FeaturedImagesModel.OriginalUrlRole)
+        viewMoreImagePopup.portrait = searchModel.data(searchModel.index(index,0), FeaturedImagesModel.PortraitUrlRole)
+        viewMoreImagePopup.landscape = searchModel.data(searchModel.index(index,0), FeaturedImagesModel.LandscapeUrlRole)
+        viewMoreImagePopup.backgroundPortrait = searchModel.data(searchModel.index(index,0), FeaturedImagesModel.BackgroundPortraitRole)
+        viewMoreImagePopup.backgroundLandscape = searchModel.data(searchModel.index(index,0), FeaturedImagesModel.BackgroundLandscapeRole)
+        viewMoreImagePopup.fullScreen = searchModel.data(searchModel.index(index,0), FeaturedImagesModel.ScreenUrlRole)
+        viewMoreImagePopup.portraitSize = searchModel.data(searchModel.index(index,0), FeaturedImagesModel.PortraitSizeRole)
+        viewMoreImagePopup.landscapeSize = searchModel.data(searchModel.index(index,0), FeaturedImagesModel.LandscapeSizeRole)
+        viewMoreImagePopup.fullScreenSize = searchModel.data(searchModel.index(index,0), FeaturedImagesModel.ScreenSizeRole)
+        viewMoreImagePopup.opacity = 1
         popupContainer.opacity = 1
+        resultsLayout.opacity = 0
         rootItem.popup = true
     }
 
     function closePopup()
     {
-        imageDetailsPopup.opacity = 0
+        viewMoreImagePopup.opacity = 0
         popupContainer.opacity = 0
-        paginator.opacity = 1
+        resultsLayout.opacity = 1
         rootItem.popup = false
     }
+
+    Settings
+    {
+        id: settings
+        property bool animationsEnabled: true
+        //ms length of page change
+        property int pageChangeAnimationDuration: 250
+        property int pageFadeAnimationDuration: 250
+
+        property int slowAnimationDuration: 750
+        property int normalAnimationDuration: 250
+        property int fastAnimationDuration: 125
+    }
 }

KomplexHubContent/pages/FeaturedPacksPage.qml

@@ -1,3 +1,22 @@
+/*
+ *  Komplex Wallpaper Engine
+ *  Copyright (C) 2026 @DigitalArtifex
+ *  https://digitalartifex.dev - https://github.com/DigitalArtifex
+ *
+ *  This program is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program.  If not, see <https://www.gnu.org/licenses/>
+ */
+import QtCore
 import QtQuick
 import QtQuick.Controls
 import QtQuick.Layouts
@@ -5,12 +24,15 @@ import QtQuick.Layouts
 import KomplexHub
 import KomplexHub.Controls
 import KomplexHub.Kero
-import KomplexHubPlugin
+import KomplexHub.Plugin
+import KomplexHub.Views
+import KomplexHub.Pages
 
 Rectangle
 {
     id: rootItem
 
+    property string query
     readonly property bool searchable: false
     property bool popup: false
     property int resultWidth: 256
@@ -18,50 +40,71 @@ Rectangle
 
     color: palette.base
 
-    FeaturedPacksModel
+    NewestPacksModel
     {
         id: packsModel
         resultsPerPage: paginator.resultsPerPage
-        // windowSize: 80
+
+        Component.onCompleted: () => nextPage()
     }
 
-    PaginatorGrid
+    ColumnLayout
     {
-        id: paginator
-        anchors.fill: parent
-        model: packsModel
-        loading: packsModel.state === FeaturedPacksModel.Loading
+        id: resultsLayout
         visible: opacity > 0.01
+        anchors.fill: parent
+        anchors.margins: Constants.mediumMargin
 
-        delegate: ItemDelegate
+        KeroHeader
         {
-            id: resultDelegate
+            Layout.alignment: Qt.AlignTop
+            Layout.fillWidth: true
+            Layout.preferredHeight: 180
+            title: qsTr("Featured Live Wallpapers")
+            description: qsTr("Live Wallpaper Packs from Komplex or ShaderToy")
+        }
 
-            width: resultWidth
-            height: resultHeight
+        PaginatorGrid
+        {
+            Layout.alignment: Qt.AlignTop
+            Layout.fillHeight: true
+            Layout.fillWidth: true
 
-            required property string uuid
-            required property string author
-            required property string authorId
-            required property string authorUrl
-            required property string thumbnail
-            required property int index
+            id: paginator
+            model: packsModel
+            loading: model.state === NewestPacksModel.Loading
 
-            SearchResultItem
+            delegate: ItemDelegate
             {
-                anchors.fill: parent
-                author: parent.author
-                description: qsTr("No description available")
-                thumbnail: parent.thumbnail
-                uuid: parent.uuid
-                pexels: true
-                selected: paginator.currentIndex === parent.index
+                id: resultDelegate
 
-                onTriggered: () => paginator.currentIndex = parent.index
+                width: resultWidth
+                height: resultHeight
 
-                onViewMoreTriggered: () =>
+                required property string name
+                required property string author
+                required property string description
+                required property string uuid
+                required property string thumbnail
+                required property string authorId
+                required property int index
+
+                SearchResultItem
                 {
-                    showVideoPopup(parent.index)
+                    anchors.fill: parent
+                    title: parent.name
+                    author: parent.author
+                    description: parent.description
+                    thumbnail: parent.thumbnail
+                    uuid: parent.uuid
+                    selected: paginator.currentIndex === parent.index
+
+                    onTriggered: () => paginator.currentIndex = parent.index
+
+                    onViewMoreTriggered: () =>
+                    {
+                        showWallpaperPopup(parent.index)
+                    }
                 }
             }
         }
@@ -77,53 +120,60 @@ Rectangle
 
         PackView
         {
-            id: packDetailsPopup
+            id: viewMoreWallpaperPopup
             anchors.fill: parent
             opacity: 0
+            visible: opacity > 0.01
 
-            Behavior on opacity
-            {
+            Behavior on opacity {
                 NumberAnimation
                 {
-                    duration: 250
+                    duration: settings.animationsEnabled ?
+                                  settings.normalAnimationDuration : 0
                 }
             }
         }
 
-        Behavior on opacity
-        {
+        Behavior on opacity {
             NumberAnimation
             {
-                duration: 250
+                duration: settings.animationsEnabled ?
+                              settings.normalAnimationDuration : 0
             }
         }
     }
 
-    Component.onCompleted: () =>
+    function closePopup()
     {
-        packsModel.nextPage()
+        viewMoreWallpaperPopup.opacity = 0
+        popupContainer.opacity = 0
+        resultsLayout.opacity = 1
+        rootItem.popup = false
     }
 
-    function showVideoPopup(index)
+    function showWallpaperPopup(index)
     {
-        packsModel.setItem(index)
-        packDetailsPopup.author = searchModel.data(searchModel.index(index,0), VideoSearchModel.AuthorRole)
-        packDetailsPopup.authorUrl = searchModel.data(searchModel.index(index,0), VideoSearchModel.AuthorUrlRole)
-        packDetailsPopup.uuid = searchModel.data(searchModel.index(index,0), VideoSearchModel.UuidRole)
-        packDetailsPopup.thumbnail = searchModel.data(searchModel.index(index,0), VideoSearchModel.ThumbnailRole)
-        packDetailsPopup.modelIndex = index
-        packDetailsPopup.model = searchModel.itemModel
-        packDetailsPopup.opacity = 1
-        paginator.opacity = 0
+        viewMoreWallpaperPopup.author = packsModel.data(packsModel.index(index,0), NewestPacksModel.AuthorRole)
+        viewMoreWallpaperPopup.authorId = packsModel.data(packsModel.index(index,0), NewestPacksModel.AuthorIdRole)
+        viewMoreWallpaperPopup.description = packsModel.data(packsModel.index(index,0), NewestPacksModel.DescriptionRole)
+        viewMoreWallpaperPopup.thumbnail = packsModel.data(packsModel.index(index,0), NewestPacksModel.ThumbnailRole)
+        viewMoreWallpaperPopup.uuid = packsModel.data(packsModel.index(index,0), NewestPacksModel.UuidRole)
+        viewMoreWallpaperPopup.opacity = 1
         popupContainer.opacity = 1
+        resultsLayout.opacity = 0
         rootItem.popup = true
     }
 
-    function closePopup()
+    Settings
     {
-        packDetailsPopup.opacity = 0
-        popupContainer.opacity = 0
-        paginator.opacity = 1
-        rootItem.popup = false
+        id: settings
+        property bool animationsEnabled: true
+        //ms length of page change
+        property int pageChangeAnimationDuration: 250
+        property int pageFadeAnimationDuration: 250
+
+        property int slowAnimationDuration: 750
+        property int normalAnimationDuration: 250
+        property int fastAnimationDuration: 125
     }
 }

KomplexHubContent/pages/FeaturedVideosPage.qml

@@ -1,3 +1,22 @@
+/*
+ *  Komplex Wallpaper Engine
+ *  Copyright (C) 2026 @DigitalArtifex
+ *  https://digitalartifex.dev - https://github.com/DigitalArtifex
+ *
+ *  This program is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program.  If not, see <https://www.gnu.org/licenses/>
+ */
+import QtCore
 import QtQuick
 import QtQuick.Controls
 import QtQuick.Layouts
@@ -5,7 +24,9 @@ import QtQuick.Layouts
 import KomplexHub
 import KomplexHub.Controls
 import KomplexHub.Kero
-import KomplexHubPlugin
+import KomplexHub.Plugin
+import KomplexHub.Views
+import KomplexHub.Pages
 
 Rectangle
 {
@@ -25,43 +46,64 @@ Rectangle
         windowSize: 80
     }
 
-    PaginatorGrid
+    ColumnLayout
     {
-        id: paginator
-        anchors.fill: parent
-        model: videosModel
-        loading: videosModel.state === FeaturedVideosModel.Loading
+        id: resultsLayout
         visible: opacity > 0.01
+        anchors.fill: parent
+        anchors.margins: Constants.mediumMargin
 
-        delegate: ItemDelegate
+        KeroHeader
         {
-            id: resultDelegate
+            Layout.alignment: Qt.AlignTop
+            Layout.fillWidth: true
+            Layout.preferredHeight: 180
+            title: qsTr("Most Popular Videos")
+            description: qsTr("Most popular videos, provided courtesy of Pexels")
+            image: "qrc:/images/kero/kero_star.png"
+        }
 
-            width: resultWidth
-            height: resultHeight
+        PaginatorGrid
+        {
+            Layout.alignment: Qt.AlignTop
+            Layout.fillHeight: true
+            Layout.fillWidth: true
 
-            required property string uuid
-            required property string author
-            required property string authorId
-            required property string authorUrl
-            required property string thumbnail
-            required property int index
+            id: paginator
+            model: videosModel
+            loading: videosModel.state === FeaturedVideosModel.Loading
+            visible: opacity > 0.01
 
-            SearchResultItem
+            delegate: ItemDelegate
             {
-                anchors.fill: parent
-                author: parent.author
-                description: qsTr("No description available")
-                thumbnail: parent.thumbnail
-                uuid: parent.uuid
-                pexels: true
-                selected: paginator.currentIndex === parent.index
+                id: resultDelegate
 
-                onTriggered: () => paginator.currentIndex = parent.index
+                width: resultWidth
+                height: resultHeight
 
-                onViewMoreTriggered: () =>
+                required property string uuid
+                required property string author
+                required property string authorId
+                required property string authorUrl
+                required property string thumbnail
+                required property int index
+
+                SearchResultItem
                 {
-                    showVideoPopup(parent.index)
+                    anchors.fill: parent
+                    author: parent.author
+                    description: qsTr("")
+                    thumbnail: parent.thumbnail
+                    uuid: parent.uuid
+                    pexels: true
+                    selected: paginator.currentIndex === parent.index
+
+                    onTriggered: () => paginator.currentIndex = parent.index
+
+                    onViewMoreTriggered: () =>
+                    {
+                        showVideoPopup(parent.index)
+                    }
                 }
             }
         }
@@ -80,12 +122,14 @@ Rectangle
             id: videoDetailsPopup
             anchors.fill: parent
             opacity: 0
+            visible: opacity > 0.01
 
             Behavior on opacity
             {
                 NumberAnimation
                 {
-                    duration: 250
+                    duration: settings.animationsEnabled ?
+                                  settings.normalAnimationDuration : 0
                 }
             }
         }
@@ -94,7 +138,8 @@ Rectangle
         {
             NumberAnimation
             {
-                duration: 250
+                duration: settings.animationsEnabled ?
+                              settings.normalAnimationDuration : 0
             }
         }
     }
@@ -114,7 +159,7 @@ Rectangle
         videoDetailsPopup.modelIndex = index
         videoDetailsPopup.model = searchModel.itemModel
         videoDetailsPopup.opacity = 1
-        paginator.opacity = 0
+        resultsLayout.opacity = 0
         popupContainer.opacity = 1
         rootItem.popup = true
     }
@@ -123,7 +168,20 @@ Rectangle
     {
         videoDetailsPopup.opacity = 0
         popupContainer.opacity = 0
-        paginator.opacity = 1
+        resultsLayout.opacity = 1
         rootItem.popup = false
     }
+
+    Settings
+    {
+        id: settings
+        property bool animationsEnabled: true
+        //ms length of page change
+        property int pageChangeAnimationDuration: 250
+        property int pageFadeAnimationDuration: 250
+
+        property int slowAnimationDuration: 750
+        property int normalAnimationDuration: 250
+        property int fastAnimationDuration: 125
+    }
 }

KomplexHubContent/pages/ImageSearchPage.qml

@@ -1,3 +1,22 @@
+/*
+ *  Komplex Wallpaper Engine
+ *  Copyright (C) 2026 @DigitalArtifex
+ *  https://digitalartifex.dev - https://github.com/DigitalArtifex
+ *
+ *  This program is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program.  If not, see <https://www.gnu.org/licenses/>
+ */
+import QtCore
 import QtQuick
 import QtQuick.Controls
 import QtQuick.Layouts
@@ -5,7 +24,9 @@ import QtQuick.Layouts
 import KomplexHub
 import KomplexHub.Controls
 import KomplexHub.Kero
-import KomplexHubPlugin
+import KomplexHub.Plugin
+import KomplexHub.Views
+import KomplexHub.Pages
 
 Item
 {
@@ -81,7 +102,8 @@ Item
             Behavior on opacity {
                 NumberAnimation
                 {
-                    duration: 250
+                    duration: settings.animationsEnabled ?
+                                  settings.normalAnimationDuration : 0
                 }
             }
         }
@@ -89,7 +111,8 @@ Item
         Behavior on opacity {
             NumberAnimation
             {
-                duration: 250
+                duration: settings.animationsEnabled ?
+                              settings.normalAnimationDuration : 0
             }
         }
     }
@@ -123,4 +146,17 @@ Item
         paginator.opacity = 1
         rootItem.popup = false
     }
+
+    Settings
+    {
+        id: settings
+        property bool animationsEnabled: true
+        //ms length of page change
+        property int pageChangeAnimationDuration: 250
+        property int pageFadeAnimationDuration: 250
+
+        property int slowAnimationDuration: 750
+        property int normalAnimationDuration: 250
+        property int fastAnimationDuration: 125
+    }
 }

KomplexHubContent/pages/InstalledWallpaperPage.qml

@@ -1,11 +1,33 @@
+/*
+ *  Komplex Wallpaper Engine
+ *  Copyright (C) 2026 @DigitalArtifex
+ *  https://digitalartifex.dev - https://github.com/DigitalArtifex
+ *
+ *  This program is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program.  If not, see <https://www.gnu.org/licenses/>
+ */
+import QtCore
 import QtQuick
 import QtQuick.Controls
 import QtQuick.Layouts
 import QtQuick.Dialogs
+
 import KomplexHub
 import KomplexHub.Controls
 import KomplexHub.Kero
-import KomplexHubPlugin
+import KomplexHub.Plugin
+import KomplexHub.Views
+import KomplexHub.Pages
 
 Rectangle {
     id: root
@@ -135,4 +157,17 @@ Rectangle {
         }
 
     ]
+
+    Settings
+    {
+        id: settings
+        property bool animationsEnabled: true
+        //ms length of page change
+        property int pageChangeAnimationDuration: 250
+        property int pageFadeAnimationDuration: 250
+
+        property int slowAnimationDuration: 750
+        property int normalAnimationDuration: 250
+        property int fastAnimationDuration: 125
+    }
 }

KomplexHubContent/pages/KomplexSettingsPage.qml

@@ -0,0 +1,476 @@
+/*
+ *  Komplex Wallpaper Engine
+ *  Copyright (C) 2026 @DigitalArtifex
+ *  https://digitalartifex.dev - https://github.com/DigitalArtifex
+ *
+ *  This program is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program.  If not, see <https://www.gnu.org/licenses/>
+ */
+import QtCore
+import QtQuick
+import QtQuick.Controls
+import QtQuick.Layouts
+import KomplexHub
+
+Item
+{
+    property bool updated: updates.length > 0
+    property var updates: []
+
+    ColumnLayout
+    {
+        anchors.fill: parent
+        anchors.margins: Constants.largeMargin
+
+        Text
+        {
+            Layout.fillWidth: true
+
+            text: qsTr("Animation Settings")
+            font: Constants.h1Font
+            color: palette.text
+        }
+
+        Rectangle
+        {
+            Layout.fillWidth: true
+            Layout.preferredHeight: 320
+            Layout.margins: Constants.largeMargin
+
+            color: palette.base
+            border.color: palette.midlight
+
+            ColumnLayout
+            {
+                id: animationSettingsLayout
+
+                anchors.fill: parent
+                anchors.margins: Constants.largeMargin
+
+                RowLayout
+                {
+                    Layout.fillWidth: true
+                    Layout.preferredHeight: 36
+
+                    CheckBox
+                    {
+                        Layout.preferredHeight: 36
+                        property bool value: settings.animationsEnabled
+
+                        id: animationsEnabledCheckbox
+                        text: qsTr("Enable Animations")
+                        font: Constants.h3Font
+                        checked: value
+
+                        onCheckStateChanged:
+                        {
+                            if(updates.indexOf("enable"))
+                            {
+                                updates.splice(updates.indexOf("enable"), 1)
+                            }
+                            else
+                            {
+                                updates.push("enable")
+                            }
+
+                            value = checked
+                        }
+                    }
+                }
+                Rectangle
+                {
+                    Layout.fillHeight: true
+                    Layout.fillWidth: true
+
+                    color: "transparent"
+
+                    Rectangle
+                    {
+                        anchors.centerIn: parent
+                        anchors.right: parent.right
+                        anchors.left: parent.left
+                        height: 2
+                        color: palette.midlight
+                    }
+                }
+
+                RowLayout
+                {
+                    Layout.fillWidth: true
+                    Layout.preferredHeight: 36
+
+                    Text
+                    {
+                        Layout.fillWidth: true
+                        Layout.fillHeight: true
+
+                        text: qsTr("Slow Animation Duration (Ms)")
+                        font: Constants.h3Font
+                        color: palette.text
+                        verticalAlignment: Qt.AlignVCenter
+                    }
+
+                    TextField
+                    {
+                        property int value: settings.slowAnimationDuration
+
+                        Layout.fillHeight: true
+                        Layout.preferredWidth: 36 * 3
+
+                        id: slowAnimationDurationField
+                        inputMethodHints: Qt.ImhFormattedNumbersOnly
+                        horizontalAlignment: Text.AlignRight
+                        enabled: animationsEnabledCheckbox.value
+                        text: value
+
+                        onEditingFinished: () =>
+                        {
+                            if(updates.indexOf("slowAnimationDuration"))
+                            {
+                               updates.splice(updates.indexOf("slowAnimationDuration"), 1)
+                            }
+                            else
+                            {
+                               updates.push("slowAnimationDuration")
+                            }
+
+                            value = parseInt(text)
+                        }
+
+                        Keys.onPressed: (event) =>
+                        {
+                            if (event.key === Qt.Key_Return || event.key === Qt.Key_Enter)
+                            {
+                                slowAnimationDurationField.focus = false; // Unfocus the TextField
+                                event.accepted = true; // Prevent further propagation of the key event
+                            }
+                        }
+
+                        background: Rectangle
+                        {
+                            color: slowAnimationDurationField.activeFocus ? palette.base : "transparent"
+                            border.color: slowAnimationDurationField.activeFocus ? palette.highlight : "transparent"
+                            border.width: 1
+                            radius: 4
+                            anchors.fill: slowAnimationDurationField
+                            anchors.margins: -2
+                        }
+                    }
+                }
+
+                RowLayout
+                {
+                    Layout.fillWidth: true
+                    Layout.preferredHeight: 36
+
+                    Text
+                    {
+                        Layout.fillWidth: true
+                        Layout.fillHeight: true
+
+                        text: qsTr("Normal Animation Duration (Ms)")
+                        font: Constants.h3Font
+                        color: palette.text
+                        verticalAlignment: Qt.AlignVCenter
+                    }
+
+                    TextField
+                    {
+                        property int value: settings.normalAnimationDuration
+
+                        Layout.fillHeight: true
+                        Layout.preferredWidth: 36 * 3
+
+                        id: normalAnimationDurationField
+                        inputMethodHints: Qt.ImhFormattedNumbersOnly
+                        horizontalAlignment: Text.AlignRight
+                        enabled: animationsEnabledCheckbox.value
+                        text: value
+
+                        onEditingFinished: () =>
+                        {
+                            if(updates.indexOf("normalAnimationDuration"))
+                            {
+                                updates.splice(updates.indexOf("normalAnimationDuration"), 1)
+                            }
+                            else
+                            {
+                                updates.push("normalAnimationDuration")
+                            }
+
+                            value = parseInt(text)
+                        }
+
+                        Keys.onPressed: (event) =>
+                        {
+                            if (event.key === Qt.Key_Return || event.key === Qt.Key_Enter)
+                            {
+                                normalAnimationDurationField.focus = false; // Unfocus the TextField
+                                event.accepted = true; // Prevent further propagation of the key event
+                            }
+                        }
+
+                        background: Rectangle
+                        {
+                            color: normalAnimationDurationField.activeFocus ? palette.base : "transparent"
+                            border.color: normalAnimationDurationField.activeFocus ? palette.highlight : "transparent"
+                            border.width: 1
+                            radius: 4
+                            anchors.fill: normalAnimationDurationField
+                            anchors.margins: -2
+                        }
+                    }
+                }
+
+                RowLayout
+                {
+                    Layout.fillWidth: true
+                    Layout.preferredHeight: 36
+
+                    Text
+                    {
+                        Layout.fillWidth: true
+                        Layout.fillHeight: true
+
+                        text: qsTr("Fast Animation Duration (Ms)")
+                        font: Constants.h3Font
+                        color: palette.text
+                        verticalAlignment: Qt.AlignVCenter
+                    }
+
+                    TextField
+                    {
+                        property int value: settings.fastAnimationDuration
+
+                        Layout.fillHeight: true
+                        Layout.preferredWidth: 36 * 3
+
+                        id: fastAnimationDurationField
+                        inputMethodHints: Qt.ImhFormattedNumbersOnly
+                        horizontalAlignment: Text.AlignRight
+                        enabled: animationsEnabledCheckbox.value
+                        text: value
+
+                        onEditingFinished: () =>
+                        {
+                            if(updates.indexOf("normalAnimationDuration"))
+                            {
+                                updates.splice(updates.indexOf("normalAnimationDuration"), 1)
+                            }
+                            else
+                            {
+                                updates.push("normalAnimationDuration")
+                            }
+                            value = parseInt(text)
+                        }
+
+                        Keys.onPressed: (event) =>
+                        {
+                            if (event.key === Qt.Key_Return || event.key === Qt.Key_Enter)
+                            {
+                                fastAnimationDurationField.focus = false; // Unfocus the TextField
+                                event.accepted = true; // Prevent further propagation of the key event
+                            }
+                        }
+
+                        background: Rectangle
+                        {
+                            color: fastAnimationDurationField.activeFocus ? palette.base : "transparent"
+                            border.color: fastAnimationDurationField.activeFocus ? palette.highlight : "transparent"
+                            border.width: 1
+                            radius: 4
+                            anchors.fill: fastAnimationDurationField
+                            anchors.margins: -2
+                        }
+                    }
+                }
+
+                RowLayout
+                {
+                    Layout.fillWidth: true
+                    Layout.preferredHeight: 36
+
+                    Text
+                    {
+                        Layout.fillWidth: true
+                        Layout.fillHeight: true
+
+                        text: qsTr("Page Change Animation Duration (Ms)")
+                        font: Constants.h3Font
+                        color: palette.text
+                        verticalAlignment: Qt.AlignVCenter
+                    }
+
+                    TextField
+                    {
+                        property int value: settings.pageChangeAnimationDuration
+
+                        Layout.fillHeight: true
+                        Layout.preferredWidth: 36 * 3
+
+                        id: pageChangeAnimationDurationField
+                        inputMethodHints: Qt.ImhFormattedNumbersOnly
+                        horizontalAlignment: Text.AlignRight
+                        enabled: animationsEnabledCheckbox.value
+                        text: value
+
+                        onEditingFinished: () =>
+                        {
+                            if(updates.indexOf("pageChangeAnimationDuration"))
+                            {
+                                updates.splice(updates.indexOf("pageChangeAnimationDuration"), 1)
+                            }
+                            else
+                            {
+                                updates.push("pageChangeAnimationDuration")
+                            }
+                            value = parseInt(text)
+                        }
+
+                        Keys.onPressed: (event) =>
+                        {
+                            if (event.key === Qt.Key_Return || event.key === Qt.Key_Enter)
+                            {
+                                pageChangeAnimationDurationField.focus = false; // Unfocus the TextField
+                                event.accepted = true; // Prevent further propagation of the key event
+                            }
+                        }
+
+                        background: Rectangle
+                        {
+                            color: pageChangeAnimationDurationField.activeFocus ? palette.base : "transparent"
+                            border.color: pageChangeAnimationDurationField.activeFocus ? palette.highlight : "transparent"
+                            border.width: 1
+                            radius: 4
+                            anchors.fill: pageChangeAnimationDurationField
+                            anchors.margins: -2
+                        }
+                    }
+                }
+
+                RowLayout
+                {
+                    Layout.fillWidth: true
+                    Layout.preferredHeight: 36
+
+                    Text
+                    {
+                        Layout.fillWidth: true
+                        Layout.fillHeight: true
+
+                        text: qsTr("Page Fade Animation Duration (Ms)")
+                        font: Constants.h3Font
+                        color: palette.text
+                        verticalAlignment: Qt.AlignVCenter
+                    }
+
+                    TextField
+                    {
+                        property int value: settings.pageFadeAnimationDuration
+
+                        Layout.fillHeight: true
+                        Layout.preferredWidth: 36 * 3
+
+                        id: pageFadeAnimationDurationField
+                        inputMethodHints: Qt.ImhFormattedNumbersOnly
+                        horizontalAlignment: Text.AlignRight
+                        text: value
+                        enabled: animationsEnabledCheckbox.value
+
+                        onEditingFinished: () =>
+                        {
+                            if(updates.indexOf("pageChangeAnimationDuration"))
+                            {
+                                updates.splice(updates.indexOf("pageChangeAnimationDuration"), 1)
+                            }
+                            else
+                            {
+                                updates.push("pageChangeAnimationDuration")
+                            }
+                            value = parseInt(text)
+                        }
+
+                        Keys.onPressed: (event) =>
+                        {
+                            if (event.key === Qt.Key_Return || event.key === Qt.Key_Enter)
+                            {
+                                pageFadeAnimationDurationField.focus = false; // Unfocus the TextField
+                                event.accepted = true; // Prevent further propagation of the key event
+                            }
+                        }
+
+                        background: Rectangle
+                        {
+                            color: pageFadeAnimationDurationField.activeFocus ? palette.base : "transparent"
+                            border.color: pageFadeAnimationDurationField.activeFocus ? palette.highlight : "transparent"
+                            border.width: 1
+                            radius: 4
+                            anchors.fill: pageFadeAnimationDurationField
+                            anchors.margins: -2
+                        }
+                    }
+                }
+            }
+        }
+
+        Item
+        {
+            Layout.fillHeight: true
+            Layout.fillWidth: true
+        }
+    }
+
+    Settings
+    {
+        id: settings
+        property bool animationsEnabled: true
+
+        //ms length of page change
+        property int pageChangeAnimationDuration: 250
+        property int pageFadeAnimationDuration: 250
+
+        property int slowAnimationDuration: 750
+        property int normalAnimationDuration: 250
+        property int fastAnimationDuration: 125
+    }
+
+    function apply()
+    {
+        if(updated)
+        {
+            settings.animationsEnabled = animationsEnabledCheckbox.value
+            settings.slowAnimationDuration = slowAnimationDurationField.value
+            settings.normalAnimationDuration = normalAnimationDurationField.value
+            settings.fastAnimationDuration = fastAnimationDurationField.value
+            settings.pageChangeAnimationDuration = pageChangeAnimationDurationField.value
+            settings.pageFadeAnimationDuration = pageFadeAnimationDurationField.value
+
+            updates.splice(0, updates.length)
+        }
+    }
+
+    function reset()
+    {
+        if(updated)
+        {
+            animationsEnabledCheckbox.value = settings.animationsEnabled
+            slowAnimationDurationField.value = settings.slowAnimationDuration
+            normalAnimationDurationField.value = settings.normalAnimationDuration
+            fastAnimationDurationField.value = settings.fastAnimationDuration
+            pageChangeAnimationDurationField.value = settings.pageChangeAnimationDuration
+            pageFadeAnimationDurationField.value = settings.pageFadeAnimationDuration
+
+            updates.splice(0, updates.length)
+        }
+    }
+}

KomplexHubContent/pages/LiveSearchPage.qml

@@ -1,9 +1,31 @@
+/*
+ *  Komplex Wallpaper Engine
+ *  Copyright (C) 2026 @DigitalArtifex
+ *  https://digitalartifex.dev - https://github.com/DigitalArtifex
+ *
+ *  This program is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program.  If not, see <https://www.gnu.org/licenses/>
+ */
+import QtCore
 import QtQuick
 import QtQuick.Controls
+
 import KomplexHub
 import KomplexHub.Controls
 import KomplexHub.Kero
-import KomplexHubPlugin
+import KomplexHub.Plugin
+import KomplexHub.Views
+import KomplexHub.Pages
 
 Item
 {
@@ -33,8 +55,8 @@ Item
         {
             id: resultDelegate
 
-            width: 256
-            height: 245
+            width: resultWidth
+            height: resultHeight
 
             required property string name
             required property string author
@@ -47,7 +69,8 @@ Item
             SearchResultItem
             {
                 anchors.fill: parent
-                title: parent.author
+                title: parent.name
+                author: parent.author
                 description: parent.description
                 thumbnail: parent.thumbnail
                 uuid: parent.uuid
@@ -61,6 +84,15 @@ Item
                 }
             }
         }
+
+        Behavior on opacity
+        {
+            NumberAnimation
+            {
+                duration: settings.animationsEnabled ?
+                              settings.normalAnimationDuration : 0
+            }
+        }
     }
 
     Rectangle
@@ -69,27 +101,20 @@ Item
         anchors.fill: parent
         opacity: 0
         color: palette.base
+        visible: opacity > 0.01
 
         PackView
         {
             id: viewMoreWallpaperPopup
             anchors.fill: parent
-            opacity: 0
-            visible: opacity > 0.01
-            //model: videosModel.itemModel
-
-            Behavior on opacity {
-                NumberAnimation
-                {
-                    duration: 250
-                }
-            }
         }
 
-        Behavior on opacity {
+        Behavior on opacity
+        {
             NumberAnimation
             {
-                duration: 250
+                duration: settings.animationsEnabled ?
+                              settings.normalAnimationDuration : 0
             }
         }
     }
@@ -108,9 +133,22 @@ Item
         viewMoreWallpaperPopup.authorId = searchModel.data(searchModel.index(index,0), PackSearchModel.AuthorIdRole)
         viewMoreWallpaperPopup.description = searchModel.data(searchModel.index(index,0), PackSearchModel.DescriptionRole)
         viewMoreWallpaperPopup.thumbnail = searchModel.data(searchModel.index(index,0), PackSearchModel.ThumbnailRole)
-        viewMoreWallpaperPopup.opacity = 1
+        viewMoreWallpaperPopup.uuid = searchModel.data(searchModel.index(index,0), PackSearchModel.UuidRole)
         popupContainer.opacity = 1
         paginator.opacity = 0
         rootItem.popup = true
     }
+
+    Settings
+    {
+        id: settings
+        property bool animationsEnabled: true
+        //ms length of page change
+        property int pageChangeAnimationDuration: 250
+        property int pageFadeAnimationDuration: 250
+
+        property int slowAnimationDuration: 750
+        property int normalAnimationDuration: 250
+        property int fastAnimationDuration: 125
+    }
 }

KomplexHubContent/pages/LoginPage.qml

@@ -1,8 +1,32 @@
+/*
+ *  Komplex Wallpaper Engine
+ *  Copyright (C) 2026 @DigitalArtifex
+ *  https://digitalartifex.dev - https://github.com/DigitalArtifex
+ *
+ *  This program is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program.  If not, see <https://www.gnu.org/licenses/>
+ */
+import QtCore
 import QtQuick
 import QtQuick.Controls
 import QtQuick.Layouts
+
 import KomplexHub
 import KomplexHub.Controls
+import KomplexHub.Kero
+import KomplexHub.Plugin
+import KomplexHub.Views
+import KomplexHub.Pages
 
 Item {
     id: loginFormRoot
@@ -85,4 +109,17 @@ Item {
             }
         }
     }
+
+    Settings
+    {
+        id: settings
+        property bool animationsEnabled: true
+        //ms length of page change
+        property int pageChangeAnimationDuration: 250
+        property int pageFadeAnimationDuration: 250
+
+        property int slowAnimationDuration: 750
+        property int normalAnimationDuration: 250
+        property int fastAnimationDuration: 125
+    }
 }

KomplexHubContent/pages/NewestPacksPage.qml

@@ -0,0 +1,190 @@
+/*
+ *  Komplex Wallpaper Engine
+ *  Copyright (C) 2026 @DigitalArtifex
+ *  https://digitalartifex.dev - https://github.com/DigitalArtifex
+ *
+ *  This program is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program.  If not, see <https://www.gnu.org/licenses/>
+ */
+import QtCore
+import QtQuick
+import QtQuick.Controls
+import QtQuick.Layouts
+
+import KomplexHub
+import KomplexHub.Controls
+import KomplexHub.Kero
+import KomplexHub.Plugin
+import KomplexHub.Views
+import KomplexHub.Pages
+
+Rectangle
+{
+    id: rootItem
+
+    property string query
+    readonly property bool searchable: false
+    property bool popup: false
+    property int resultWidth: 256
+    property int resultHeight: 245
+
+    color: palette.base
+
+    NewestPacksModel
+    {
+        id: packsModel
+        resultsPerPage: paginator.resultsPerPage
+
+        Component.onCompleted: () => nextPage()
+    }
+
+    ColumnLayout
+    {
+        id: resultsLayout
+        visible: opacity > 0.01
+        anchors.fill: parent
+        anchors.margins: Constants.mediumMargin
+
+        KeroHeader
+        {
+            Layout.alignment: Qt.AlignTop
+            Layout.fillWidth: true
+            Layout.preferredHeight: 180
+            title: qsTr("Newest Live Wallpapers")
+            description: qsTr("Live Wallpaper Packs from Komplex or ShaderToy")
+            image: "qrc:/images/kero/kero_star.png"
+        }
+
+        PaginatorGrid
+        {
+            Layout.alignment: Qt.AlignTop
+            Layout.fillHeight: true
+            Layout.fillWidth: true
+
+            id: paginator
+            model: packsModel
+            loading: model.state === NewestPacksModel.Loading
+
+            delegate: ItemDelegate
+            {
+                id: resultDelegate
+
+                width: resultWidth
+                height: resultHeight
+
+                required property string name
+                required property string author
+                required property string description
+                required property string uuid
+                required property string thumbnail
+                required property string authorId
+                required property int index
+
+                SearchResultItem
+                {
+                    anchors.fill: parent
+                    title: parent.name
+                    author: parent.author
+                    description: parent.description
+                    thumbnail: parent.thumbnail
+                    uuid: parent.uuid
+                    selected: paginator.currentIndex === parent.index
+
+                    onTriggered: () => paginator.currentIndex = parent.index
+
+                    onViewMoreTriggered: () =>
+                    {
+                        showWallpaperPopup(parent.index)
+                    }
+                }
+            }
+        }
+
+        Behavior on opacity
+        {
+            NumberAnimation
+            {
+                duration: settings.animationsEnabled ?
+                              settings.normalAnimationDuration : 0
+            }
+        }
+    }
+
+    Rectangle
+    {
+        id: popupContainer
+        anchors.fill: parent
+        opacity: 0
+        visible: opacity > 0.01
+        color: palette.base
+
+        PackView
+        {
+            id: viewMoreWallpaperPopup
+            anchors.fill: parent
+            opacity: 0
+            visible: opacity > 0.01
+
+            Behavior on opacity
+            {
+                NumberAnimation
+                {
+                    duration: settings.animationsEnabled ?
+                                  settings.normalAnimationDuration : 0
+                }
+            }
+        }
+
+        Behavior on opacity
+        {
+            NumberAnimation
+            {
+                duration: settings.animationsEnabled ?
+                              settings.normalAnimationDuration : 0
+            }
+        }
+    }
+
+    function closePopup()
+    {
+        viewMoreWallpaperPopup.opacity = 0
+        popupContainer.opacity = 0
+        resultsLayout.opacity = 1
+        rootItem.popup = false
+    }
+
+    function showWallpaperPopup(index)
+    {
+        viewMoreWallpaperPopup.author = packsModel.data(packsModel.index(index,0), NewestPacksModel.AuthorRole)
+        viewMoreWallpaperPopup.authorId = packsModel.data(packsModel.index(index,0), NewestPacksModel.AuthorIdRole)
+        viewMoreWallpaperPopup.description = packsModel.data(packsModel.index(index,0), NewestPacksModel.DescriptionRole)
+        viewMoreWallpaperPopup.thumbnail = packsModel.data(packsModel.index(index,0), NewestPacksModel.ThumbnailRole)
+        viewMoreWallpaperPopup.opacity = 1
+        popupContainer.opacity = 1
+        resultsLayout.opacity = 0
+        rootItem.popup = true
+    }
+
+    Settings
+    {
+        id: settings
+        property bool animationsEnabled: true
+        //ms length of page change
+        property int pageChangeAnimationDuration: 250
+        property int pageFadeAnimationDuration: 250
+
+        property int slowAnimationDuration: 750
+        property int normalAnimationDuration: 250
+        property int fastAnimationDuration: 125
+    }
+}

KomplexHubContent/pages/SettingsPage.qml

@@ -1,11 +1,38 @@
+/*
+ *  Komplex Wallpaper Engine
+ *  Copyright (C) 2026 @DigitalArtifex
+ *  https://digitalartifex.dev - https://github.com/DigitalArtifex
+ *
+ *  This program is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program.  If not, see <https://www.gnu.org/licenses/>
+ */
+import QtCore
 import QtQuick
 import QtQuick.Controls
 import QtQuick.Layouts
+
 import KomplexHub
+import KomplexHub.Controls
 import KomplexHub.Kero
+import KomplexHub.Plugin
+import KomplexHub.Views
+import KomplexHub.Pages
 
 Item {
     readonly property bool searchable: false
+    property bool settingsUpdated: wallpaperSettingsUpdated || komplexSettingsUpdated
+    property bool wallpaperSettingsUpdated: wallpaperSettingsPage.updated && pageStack.currentIndex === 0
+    property bool komplexSettingsUpdated: komplexSettingsPage.updated && pageStack.currentIndex === 1
 
     id: settingsPageRoot
 
@@ -24,6 +51,9 @@ Item {
                 TabButton {
                     text: qsTr("Wallpaper")
                 }
+                TabButton {
+                    text: qsTr("Komplex")
+                }
                 TabButton {
                     text: qsTr("Account")
                 }
@@ -32,33 +62,53 @@ Item {
                 }
             }
 
-            StackLayout {
-
+            StackLayout
+            {
+                id: pageStack
                 Layout.fillHeight: true
                 Layout.fillWidth: true
                 currentIndex: bar.currentIndex
 
-                Item {
+                Item
+                {
                     id: wallpaperTab
 
                     Layout.fillHeight: true
                     Layout.fillWidth: true
 
-                    WallpaperSettingsPage {
+                    WallpaperSettingsPage
+                    {
+                        id: wallpaperSettingsPage
                         anchors.fill: parent
                     }
                 }
-                Item {
+                Item
+                {
+                    id: komplexTab
+
+                    Layout.fillHeight: true
+                    Layout.fillWidth: true
+
+                    KomplexSettingsPage
+                    {
+                        id: komplexSettingsPage
+                        anchors.fill: parent
+                    }
+                }
+                Item
+                {
                     id: accountTab
 
                     Layout.fillHeight: true
                     Layout.fillWidth: true
 
-                    UserProfilePage {
+                    UserProfilePage
+                    {
                         anchors.fill: parent
                     }
                 }
-                Item {
+                Item
+                {
                     Layout.fillHeight: true
                     Layout.fillWidth: true
                     property string title: qsTr("Hello!")
@@ -73,14 +123,17 @@ Pexels")
 
                     id: keroHelloAvatarRoot
 
-                    Rectangle {
+                    Rectangle
+                    {
                         anchors.fill: parent
                         color: "transparent"
 
-                        ColumnLayout {
+                        ColumnLayout
+                        {
                             anchors.fill: parent
 
-                            KeroHelloAvatar {
+                            KeroHelloAvatar
+                            {
                                 Layout.fillHeight: true
                                 Layout.fillWidth: true
                                 antialiasing: true
@@ -88,7 +141,8 @@ Pexels")
 
                             Item { Layout.preferredHeight: 36 }
 
-                            Text {
+                            Text
+                            {
                                 Layout.fillHeight: false
                                 Layout.fillWidth: true
                                 Layout.margins: Constants.largeMargin
@@ -101,7 +155,8 @@ Pexels")
                                 textFormat: Text.MarkdownText
                             }
 
-                            Text {
+                            Text
+                            {
                                 Layout.fillHeight: false
                                 Layout.fillWidth: true
                                 Layout.margins: Constants.largeMargin
@@ -116,16 +171,19 @@ Pexels")
 
                             Item { Layout.fillHeight: true }
 
-                            RowLayout {
+                            RowLayout
+                            {
                                 Layout.fillWidth: true
                                 Layout.alignment: Qt.AlignTop | Qt.AlignRight
 
-                                ColumnLayout {
+                                ColumnLayout
+                                {
                                     Layout.alignment: Qt.AlignTop | Qt.AlignRight
                                     Layout.margins: Constants.largeMargin
                                     Layout.fillHeight: true
 
-                                    Text {
+                                    Text
+                                    {
                                         text: qsTr("Contributors")
                                         color: palette.text.darker()
                                         font: Constants.h5Font
@@ -136,7 +194,8 @@ Pexels")
                                         textFormat: Text.MarkdownText
                                     }
 
-                                    Text {
+                                    Text
+                                    {
                                         id: contributorText
                                         text: keroHelloAvatarRoot.contributors
                                         color: palette.text.darker()
@@ -148,12 +207,14 @@ Pexels")
                                     }
                                 }
 
-                                ColumnLayout {
+                                ColumnLayout
+                                {
                                     Layout.alignment: Qt.AlignTop | Qt.AlignRight
                                     Layout.margins: Constants.largeMargin
                                     Layout.fillHeight: true
 
-                                    Text {
+                                    Text
+                                    {
                                         text: qsTr("Special Thanks")
                                         color: palette.text.darker()
                                         font: Constants.h5Font
@@ -164,7 +225,8 @@ Pexels")
                                         textFormat: Text.MarkdownText
                                     }
 
-                                    Text {
+                                    Text
+                                    {
                                         id: thanksText
                                         text: keroHelloAvatarRoot.thanks
                                         color: palette.text.darker()
@@ -178,10 +240,92 @@ Pexels")
                             }
                         }
                     }
+                }
+            }
 
+            Rectangle
+            {
+                Layout.fillWidth: true
+                Layout.preferredHeight: settingsUpdated ? 64 : 0
+                color: palette.base
+                border.color: palette.midlight
+                opacity: settingsUpdated ? 1 : 0
+
+                RowLayout
+                {
+                    anchors.fill: parent
+                    anchors.rightMargin: Constants.mediumMargin
+
+                    Item
+                    {
+                        Layout.fillHeight: true
+                        Layout.fillWidth: true
+                    }
+
+                    SquareButton
+                    {
+                        Layout.preferredHeight: 50
+                        Layout.preferredWidth: 160
+
+                        Layout.alignment: Qt.AlignRight | Qt.AlignVCenter
+                        icon.source: "qrc:/images/icons/icons8-reply-arrow.svg"
+                        text: qsTr("Reset")
+                    }
+
+                    SquareButton
+                    {
+                        Layout.preferredHeight: 50
+                        Layout.preferredWidth: 160
+                        Layout.alignment: Qt.AlignRight | Qt.AlignVCenter
+                        icon.source: "qrc:/images/icons/icons8-check-mark.svg"
+                        text: qsTr("Apply")
+                    }
+                }
+
+                Behavior on opacity
+                {
+                    NumberAnimation
+                    {
+                        duration: settings.animationsEnabled ?
+                                      settings.normalAnimationDuration : 0
+                    }
+                }
+
+                Behavior on height
+                {
+                    NumberAnimation
+                    {
+                        duration: settings.animationsEnabled ?
+                                      settings.normalAnimationDuration : 0
+                    }
                 }
             }
         }
+    }
 
+    function applyCurrentSettings()
+    {
+        if(pageStack.currentIndex === 0 && wallpaperSettingsPage.updated)
+        {
+            wallpaperSettingsPage.apply()
+        }
+
+        else if(pageStack.currentIndex === 1 && komplexSettingsPage.updated)
+        {
+            komplexSettingsPage.apply()
+        }
+    }
+
+    function resetCurrentSettings()
+    {
+        if(pageStack.currentIndex === 0 && wallpaperSettingsPage.updated)
+        {
+            wallpaperSettingsPage.reset()
+        }
+
+        else if(pageStack.currentIndex === 1 && komplexSettingsPage.updated)
+        {
+            komplexSettingsPage.reset()
+        }
     }
 }

KomplexHubContent/pages/UserProfilePage.qml

@@ -1,7 +1,32 @@
+/*
+ *  Komplex Wallpaper Engine
+ *  Copyright (C) 2026 @DigitalArtifex
+ *  https://digitalartifex.dev - https://github.com/DigitalArtifex
+ *
+ *  This program is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program.  If not, see <https://www.gnu.org/licenses/>
+ */
+import QtCore
 import QtQuick
 import QtQuick.Controls
 import QtQuick.Layouts
+
 import KomplexHub
+import KomplexHub.Controls
+import KomplexHub.Kero
+import KomplexHub.Plugin
+import KomplexHub.Views
+import KomplexHub.Pages
 
 Item {
     id: root
@@ -57,4 +82,17 @@ Item {
             }
         }
     }
+
+    Settings
+    {
+        id: settings
+        property bool animationsEnabled: true
+        //ms length of page change
+        property int pageChangeAnimationDuration: 250
+        property int pageFadeAnimationDuration: 250
+
+        property int slowAnimationDuration: 750
+        property int normalAnimationDuration: 250
+        property int fastAnimationDuration: 125
+    }
 }

KomplexHubContent/pages/VideoSearchPage.qml

@@ -1,3 +1,22 @@
+/*
+ *  Komplex Wallpaper Engine
+ *  Copyright (C) 2026 @DigitalArtifex
+ *  https://digitalartifex.dev - https://github.com/DigitalArtifex
+ *
+ *  This program is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program.  If not, see <https://www.gnu.org/licenses/>
+ */
+import QtCore
 import QtQuick
 import QtQuick.Controls
 import QtQuick.Layouts
@@ -5,7 +24,9 @@ import QtQuick.Layouts
 import KomplexHub
 import KomplexHub.Controls
 import KomplexHub.Kero
-import KomplexHubPlugin
+import KomplexHub.Plugin
+import KomplexHub.Views
+import KomplexHub.Pages
 
 Item
 {
@@ -64,6 +85,15 @@ Item
                 }
             }
         }
+
+        Behavior on opacity
+        {
+            NumberAnimation
+            {
+                duration: settings.animationsEnabled ?
+                              settings.normalAnimationDuration : 0
+            }
+        }
     }
 
     Rectangle
@@ -78,22 +108,16 @@ Item
         {
             id: viewMoreVideoPopup
             anchors.fill: parent
+            visible: opacity > 0.01
             opacity: 0
-
-            Behavior on opacity
-            {
-                NumberAnimation
-                {
-                    duration: 250
-                }
-            }
         }
 
         Behavior on opacity
         {
             NumberAnimation
             {
-                duration: 250
+                duration: settings.animationsEnabled ?
+                              settings.normalAnimationDuration : 0
             }
         }
     }
@@ -120,4 +144,17 @@ Item
         paginator.opacity = 1
         rootItem.popup = false
     }
+
+    Settings
+    {
+        id: settings
+        property bool animationsEnabled: true
+        //ms length of page change
+        property int pageChangeAnimationDuration: 250
+        property int pageFadeAnimationDuration: 250
+
+        property int slowAnimationDuration: 750
+        property int normalAnimationDuration: 250
+        property int fastAnimationDuration: 125
+    }
 }

KomplexHubContent/pages/WallpaperSettingsPage.qml

@@ -23,17 +23,36 @@
  */
 // pragma ComponentBehavior: Bound
 
+/*
+ *  Komplex Wallpaper Engine
+ *  Copyright (C) 2026 @DigitalArtifex
+ *  https://digitalartifex.dev - https://github.com/DigitalArtifex
+ *
+ *  This program is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program.  If not, see <https://www.gnu.org/licenses/>
+ */
+import QtCore
 import QtQuick
 import QtQuick.Controls
 import QtQuick.Dialogs
 import QtQuick.Layouts
-//import org.kde.kirigami as Kirigami
-//import org.kde.plasma.core as PlasmaCore
-import QtCore
 import Qt.labs.folderlistmodel 2.15
+
 import KomplexHub
 import KomplexHub.Controls
-import KomplexHubPlugin
+import KomplexHub.Plugin
+import KomplexHub.Views
+import KomplexHub.Pages
 
 //import com.github.digitalartifex.komplex 1.0 as Komplex
 
@@ -49,13 +68,9 @@ Item
 
     id: root
     property alias cfg_pauseMode: pauseModeCombo.currentIndex
-    property alias cfg_isPaused: runningCombo.checked
     property alias cfg_shaderSpeed: speedSlider.value
     property alias cfg_mouseSpeedBias: mouseBiasSlider.value
-    property bool cfg_infoPlasma6Preview_dismissed
-    property bool cfg_warningResources_dismissed
-    property bool cfg_emergencyHelp_dismissed
-    property bool cfg_infoiChannelSettings_dismissed
+    property alias cfg_enableMouseTracking: mouseTrackingCheckbox.checked
     property alias cfg_checkActiveScreen: activeScreenOnlyCheckbox.checked
     property alias cfg_excludeWindows: excludeWindows.windows
     property alias cfg_running: runningCombo.checked
@@ -74,6 +89,9 @@ Item
     property bool enableMouseTracking: true
     property real mouseTrackingBias: 0.5
 
+    property bool updated: updates.length > 0
+    property var updates: []
+
     Rectangle {
         anchors.fill: parent
         color: "transparent"
@@ -120,19 +138,17 @@ Item
                     currentIndex: manager.shaderPackIndex
                     displayText: currentIndex === -1 ? "Custom File" : currentText.replace("_", " ").charAt(0).toUpperCase() + currentText.replace("_", " ").slice(1)
 
-                    // onCurrentTextChanged:
-                    // {
-                    //     root.cfg_shader_package_index = currentIndex;
-
-                    //     if (root.cfg_shader_package_index === -1)
-                    //         return;
-
-                    //     var source = currentText
-                    //     shaderPackModel.loadMetadata(source)
-                    //     root.cfg_shader_package = "file://" + shaderPackModel.path(source)
-                    // }
-
-
+                    onCurrentIndexChanged:
+                    {
+                        if(updates.indexOf("wallpaper") >= 0 && value === manager.shaderPackIndex)
+                        {
+                            updates.slice(updates.indexOf("wallpaper"), 1)
+                        }
+                        else
+                        {
+                            updates.push("wallpaper")
+                        }
+                    }
                 }
 
                 Item { Layout.preferredHeight: Constants.smallMargin }
@@ -171,6 +187,15 @@ Item
                         onEditingFinished: () =>
                         {
                             value = parseInt(text)
+
+                            if(updates.indexOf("resolutionX") >= 0 && value === manager.resolutionX)
+                            {
+                                updates.slice(updates.indexOf("resolutionX"), 1)
+                            }
+                            else
+                            {
+                                updates.push("resolutionX")
+                            }
                         }
 
                         Keys.onPressed: (event) =>
@@ -193,7 +218,8 @@ Item
                         }
                     }
 
-                    Text {
+                    Text
+                    {
                         text: qsTr("Y")
                         font: Constants.h3Font
                         color: palette.text
@@ -202,7 +228,8 @@ Item
                         verticalAlignment: Text.AlignVCenter
                     }
 
-                    TextField {
+                    TextField
+                    {
                         property int value: manager.resolutionY
 
                         Layout.preferredHeight: 36
@@ -216,6 +243,15 @@ Item
                         onEditingFinished: () =>
                         {
                             value = parseInt(text)
+
+                            if(updates.indexOf("resolutionY") >= 0 && value === manager.resolutionY)
+                            {
+                                updates.slice(updates.indexOf("resolutionY"), 1)
+                            }
+                            else
+                            {
+                                updates.push("resolutionY")
+                            }
                         }
 
                         Keys.onPressed: (event) =>
@@ -245,7 +281,8 @@ Item
                 {
                     Layout.fillWidth: true
 
-                    Text {
+                    Text
+                    {
                         text: qsTr("Frame Rate")
                         font: Constants.h3Font
                         color: palette.text
@@ -260,7 +297,19 @@ Item
                         from: 1
                         to: 60
                         stepSize: 0.01
-                        onValueChanged: frameRateField.text = String(value.toFixed(2));
+                        onValueChanged:
+                        {
+                            frameRateField.text = String(value.toFixed(2));
+
+                            if(updates.indexOf("frameRate") >= 0 && value === manager.targetFramerate)
+                            {
+                               updates.slice(updates.indexOf("frameRate"), 1)
+                            }
+                            else
+                            {
+                               updates.push("frameRate")
+                            }
+                        }
 
                         Component.onCompleted: () => {
                             value = manager.targetFramerate
@@ -310,7 +359,8 @@ Item
                     id: speedLayout
                     Layout.fillWidth: true
 
-                    Text {
+                    Text
+                    {
                         text: qsTr("Shader Speed")
                         font: Constants.h3Font
                         color: palette.text
@@ -326,9 +376,22 @@ Item
                         from: -4.0
                         to: 4.0
                         stepSize: 0.01
-                        onValueChanged: shaderSpeedField.text = String(value.toFixed(2));
+                        onValueChanged:
+                        {
+                            if(updates.indexOf("shaderSpeed") >= 0 && value === manager.shaderSpeed)
+                            {
+                               updates.slice(updates.indexOf("shaderSpeed"), 1)
+                            }
+                            else
+                            {
+                               updates.push("shaderSpeed")
+                            }
 
-                        Component.onCompleted: () => {
+                            shaderSpeedField.text = String(value.toFixed(2));
+                        }
+
+                        Component.onCompleted: () =>
+                        {
                             value = manager.shaderSpeed
                         }
                     }
@@ -411,7 +474,17 @@ Item
                         ]
 
                         textRole: modelData
-                        //onCurrentIndexChanged: root.cfg_pauseMode = currentIndex
+                        onCurrentIndexChanged:
+                        {
+                            if(updates.indexOf("pauseMode") && currentIndex === manager.pauseMode)
+                            {
+                                updates.slice(updates.indexOf("pauseMode"), 1)
+                            }
+                            else
+                            {
+                                updates.push("pauseMode")
+                            }
+                        }
                         currentIndex: manager.pauseMode
                     }
                 }
@@ -431,7 +504,8 @@ Item
                 {
                     Layout.fillWidth: true
 
-                    Text {
+                    Text
+                    {
                         text: qsTr("Excluded Windows")
                         font: Constants.h3Font
                         color: palette.text
@@ -448,6 +522,15 @@ Item
                         onEditingFinished: () =>
                         {
                             windows = excludeWindows.text.trim().replace(/\s+/g, "").split(",");
+
+                            if(updates.indexOf("excludeWindows") >= 0 && windows === manager.excludedWindows)
+                            {
+                               updates.slice(updates.indexOf("excludeWindows"), 1)
+                            }
+                            else
+                            {
+                               updates.push("excludeWindows")
+                            }
                         }
 
                         ToolTip.visible: hovered
@@ -459,16 +542,27 @@ Item
 
                 CheckBox
                 {
-                    //Kirigami.FormData.label: i18nd("com.github.digitalartifex.komplex", cfg_isPaused ? "Playing" : "Paused")
-
                     id: runningCombo
                     checked: manager.running
                     text: qsTr("Shader Is Running")
+
+                    onCheckedChanged:
+                    {
+                        if(updates.indexOf("shaderRunning") > 0 && checked === manager.running)
+                        {
+                            updates.slice(updates.indexOf("shaderRunning"), 1)
+                        }
+                        else
+                        {
+                            updates.push("shaderRunning")
+                        }
+                    }
                 }
 
                 Item { Layout.preferredHeight: Constants.largeMargin }
 
-                Text {
+                Text
+                {
                     text: qsTr("Mouse Tracking")
                     font: Constants.h2Font
                     color: palette.text
@@ -480,14 +574,15 @@ Item
                 {
                     Layout.fillWidth: true
 
-                    Text {
-                        text: qsTr("Mouse Tracking Bias")
+                    Text
+                    {
+                        text: qsTr("Mouse Speed Bias")
                         font: Constants.h3Font
                         color: palette.text
                         verticalAlignment: Text.AlignVCenter
                         Layout.preferredHeight: 36
                     }
-                    //Kirigami.FormData.label: i18nd("com.github.digitalartifex.komplex", "Mouse bias:")
+
                     Slider
                     {
                         id: mouseBiasSlider
@@ -500,6 +595,15 @@ Item
                         onValueChanged: () =>
                         {
                             mouseBiasField.text = String(value.toFixed(2));
+
+                            if(updates.indexOf("mouseSpeedBias") >= 0 && value === manager.mouseTrackingBias)
+                            {
+                                updates.slice(updates.indexOf("mouseSpeedBias"), 1)
+                            }
+                            else
+                            {
+                                updates.push("mouseSpeedBias")
+                            }
                         }
                     }
                     TextField
@@ -546,19 +650,29 @@ Item
 
                 CheckBox
                 {
-                    //Kirigami.FormData.label: i18nd("com.github.digitalartifex.komplex", cfg_isPaused ? "Playing" : "Paused")
-
                     id: mouseTrackingCheckbox
                     checked: manager.mouseTrackingEnabled
                     text: qsTr("Mouse Tracking Enabled")
+
+                    onCheckedChanged:
+                    {
+                        if(updates.indexOf("mouseEnabled") >= 0 && currentIndex === manager.mouseTrackingEnabled)
+                        {
+                            updates.slice(updates.indexOf("mouseEnabled"), 1)
+                        }
+                        else
+                        {
+                            updates.push("mouseEnabled")
+                        }
+                    }
                 }
 
                 // Button
                 // {
                 //     visible: navBar.currentIndex === 2
                 //     id: kofiButton
-                //     Layout.preferredWidth: Kirigami.Units.gridUnit * 5
-                //     Layout.preferredHeight: Kirigami.Units.gridUnit * 3
+                //     Layout.preferredWidth: 4 * 5
+                //     Layout.preferredHeight: 4 * 3
 
                 //     contentItem: RowLayout
                 //     {
@@ -595,10 +709,9 @@ Item
 
                 RowLayout
                 {
-                    //Kirigami.FormData.label: i18nd("com.github.digitalartifex.komplex", "Author:")
                     Text
                     {
-                        Layout.preferredWidth: Kirigami.Units.gridUnit * 11
+                        Layout.preferredWidth: 4 * 11
                         text: shaderPackModel.metadata.author
                         horizontalAlignment: Text.AlignLeft
                         color: palette.text
@@ -607,10 +720,9 @@ Item
 
                 RowLayout
                 {
-                    //Kirigami.FormData.label: i18nd("com.github.digitalartifex.komplex", "Description:")
                     Text
                     {
-                        Layout.preferredWidth: Kirigami.Units.gridUnit * 16
+                        Layout.preferredWidth: 4 * 16
                         text: shaderPackModel.metadata.description
                         horizontalAlignment: Text.AlignLeft
                         color: palette.text
@@ -622,10 +734,9 @@ Item
 
                 RowLayout
                 {
-                    //Kirigami.FormData.label: i18nd("com.github.digitalartifex.komplex", "License:")
                     Text
                     {
-                        Layout.preferredWidth: Kirigami.Units.gridUnit * 11
+                        Layout.preferredWidth: 4 * 11
                         text: shaderPackModel.metadata.license
                         horizontalAlignment: Text.AlignLeft
                         color: palette.text
@@ -634,10 +745,9 @@ Item
 
                 RowLayout
                 {
-                    //Kirigami.FormData.label: i18nd("com.github.digitalartifex.komplex", "Version:")
                     Text
                     {
-                        Layout.preferredWidth: Kirigami.Units.gridUnit * 11
+                        Layout.preferredWidth: 4 * 11
                         text: shaderPackModel.metadata.version
                         horizontalAlignment: Text.AlignLeft
                         color: palette.text
@@ -646,4 +756,56 @@ Item
             }
         }
     }
+
+    Settings
+    {
+        id: settings
+        property bool animationsEnabled: true
+
+        //ms length of page change
+        property int pageChangeAnimationDuration: 250
+        property int pageFadeAnimationDuration: 250
+
+        property int slowAnimationDuration: 750
+        property int normalAnimationDuration: 250
+        property int fastAnimationDuration: 125
+    }
+
+    function apply()
+    {
+        if(updated)
+        {
+            manager.pauseMode = cfg_pauseMode
+            manager.shaderSpeed = cfg_shaderSpeed
+            manager.mouseTrackingBias = cfg_mouseSpeedBias
+            manager.mouseTrackingEnabled = cfg_enableMouseTracking
+            manager.onlyCheckActiveScreen = cfg_checkActiveScreen
+            manager.excludedWindows = cfg_excludeWindows
+            manager.running = cfg_running
+            manager.resolutionX = cfg_resolution_x
+            manager.resolutionY = cfg_resolution_y
+            manager.targetFramerate = cfg_framerate_limit
+
+            updates.splice(0, updates.length)
+        }
+    }
+
+    function reset()
+    {
+        if(updated)
+        {
+            cfg_pauseMode = manager.pauseMode
+            cfg_shaderSpeed = manager.shaderSpeed
+            cfg_mouseSpeedBias = manager.mouseTrackingBias
+            cfg_enableMouseTracking = manager.mouseTrackingEnabled
+            cfg_checkActiveScreen = manager.onlyCheckActiveScreen
+            cfg_excludeWindows = manager.excludedWindows
+            cfg_running = manager.running
+            cfg_resolution_x = manager.resolutionX
+            cfg_resolution_y = manager.resolutionY
+            cfg_framerate_limit = manager.targetFramerate
+
+            updates.splice(0, updates.length)
+        }
+    }
 }

KomplexHubContent/views/CMakeLists.txt

@@ -0,0 +1,13 @@
+qt_add_library(KomplexHubViews STATIC)
+qt6_add_qml_module(KomplexHubViews
+    URI "KomplexHub.Views"
+    VERSION 1.0
+    RESOURCE_PREFIX "/qt/qml"
+    QML_FILES
+        "CompletedView.qml"
+        "DownloadView.qml"
+        "ErrorView.qml"
+        "ImageView.qml"
+        "PackView.qml"
+        "VideoView.qml"
+)

KomplexHubContent/views/CompletedView.qml

@@ -0,0 +1,85 @@
+/*
+ *  Komplex Wallpaper Engine
+ *  Copyright (C) 2026 @DigitalArtifex
+ *  https://digitalartifex.dev - https://github.com/DigitalArtifex
+ *
+ *  This program is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program.  If not, see <https://www.gnu.org/licenses/>
+ */
+import QtCore
+import QtQuick
+import QtQuick.Controls
+import QtQuick.Layouts
+
+import KomplexHub
+import KomplexHub.Kero
+import KomplexHub.Controls
+import KomplexHub.Plugin
+
+Item
+{
+    property DownloadManager manager: null
+
+    ColumnLayout
+    {
+        anchors.fill: parent
+
+        VerticalSpacer { }
+
+        KeroSuccessAvatar
+        {
+            Layout.fillWidth: true
+            Layout.fillHeight: true
+            Layout.preferredHeight: 512
+            Layout.maximumHeight: 512
+        }
+
+        RowLayout
+        {
+            Layout.fillWidth: true
+            Layout.preferredHeight: 36
+            Layout.maximumHeight: 36
+            Layout.margins: Constants.largeMargin
+
+            Item
+            {
+                Layout.fillHeight: true
+                Layout.fillWidth: true
+            }
+            SquareButton
+            {
+                Layout.preferredWidth: 186
+                Layout.fillHeight: true
+                text: qsTr("Okay")
+
+                onTriggered: () =>
+                {
+                    if(manager != null)
+                    {
+                        manager.reset()
+                    }
+                }
+            }
+            SquareButton
+            {
+                Layout.preferredWidth: 186
+                Layout.fillHeight: true
+
+                text: qsTr("Set Wallpaper")
+                icon.source: "qrc:/images/icons/icons8-download.svg"
+            }
+        }
+
+        VerticalSpacer {}
+    }
+}

KomplexHubContent/views/DownloadView.qml

@@ -0,0 +1,150 @@
+/*
+ *  Komplex Wallpaper Engine
+ *  Copyright (C) 2026 @DigitalArtifex
+ *  https://digitalartifex.dev - https://github.com/DigitalArtifex
+ *
+ *  This program is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program.  If not, see <https://www.gnu.org/licenses/>
+ */
+import QtCore
+import QtQuick
+import QtQuick.Controls
+import QtQuick.Layouts
+import QtQuick.Effects
+
+import KomplexHub
+import KomplexHub.Controls
+import KomplexHub.Plugin
+import KomplexHub.Kero
+
+Item
+{
+    property string thumbnail
+    property DownloadManager manager
+
+    Rectangle
+    {
+        anchors.fill: parent
+        color: palette.base
+
+        BackgroundImage
+        {
+            source: thumbnail
+        }
+
+        ColumnLayout
+        {
+            anchors.fill: parent
+            anchors.margins: Constants.largeMargin
+
+            Item { Layout.preferredHeight: 64; Layout.fillWidth: true }
+
+            KeroBuildingAnimation
+            {
+                Layout.fillWidth: true
+                Layout.fillHeight: true
+            }
+
+            VerticalSpacer {}
+
+            Text
+            {
+                text: qsTr("Download Progress")
+                font: Constants.h3Font
+                color : palette.text
+                Layout.preferredHeight: Constants.largeMargin
+            }
+
+            RowLayout
+            {
+                Layout.fillWidth: true
+                Layout.preferredHeight: Constants.largeMargin
+
+                ProgressBar
+                {
+                    Layout.fillWidth: true
+                    value: manager.downloadProgress
+                }
+
+                Text
+                {
+                    text: manager.downloadedBytes
+                    font: Constants.h4Font
+                    color : palette.text
+                }
+
+                Text
+                {
+                    text: "/"
+                    font: Constants.h4Font
+                    color : palette.text
+                    Layout.preferredHeight: 32
+                }
+
+                Text
+                {
+                    text: manager.downloadSize
+                    font: Constants.h4Font
+                    color : palette.text
+                    Layout.preferredHeight: 32
+                }
+            }
+
+            Text
+            {
+                text: qsTr("Install Progress")
+                font: Constants.h3Font
+                color : palette.text
+                height: 32
+            }
+
+            RowLayout
+            {
+                Layout.fillWidth: true
+                Layout.preferredHeight: Constants.largeMargin
+
+                ProgressBar
+                {
+                    Layout.fillWidth: true
+                    value: manager.compileProgress
+                }
+
+                Text
+                {
+                    text: manager.compileStepsCompleted
+                    font: Constants.h4Font
+                    color : palette.text
+                    Layout.preferredHeight: Constants.largeMargin
+                }
+
+                Text
+                {
+                    text: "/"
+                    font: Constants.h4Font
+                    color : palette.text
+                    Layout.preferredHeight: Constants.largeMargin
+                }
+
+                Text
+                {
+                    text: manager.compileSteps
+                    font: Constants.h4Font
+                    color : palette.text
+                    Layout.preferredHeight: Constants.largeMargin
+                }
+            }
+
+            Item { Layout.preferredHeight: Constants.largeMargin * 2; Layout.fillWidth: true }
+        }
+    }
+}

KomplexHubContent/views/ErrorView.qml

@@ -0,0 +1,77 @@
+/*
+ *  Komplex Wallpaper Engine
+ *  Copyright (C) 2026 @DigitalArtifex
+ *  https://digitalartifex.dev - https://github.com/DigitalArtifex
+ *
+ *  This program is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program.  If not, see <https://www.gnu.org/licenses/>
+ */
+import QtCore
+import QtQuick
+import QtQuick.Controls
+import QtQuick.Layouts
+
+import KomplexHub
+import KomplexHub.Kero
+import KomplexHub.Controls
+import KomplexHub.Plugin
+
+Item
+{
+    property DownloadManager manager: null
+
+    ColumnLayout
+    {
+        anchors.fill: parent
+
+        VerticalSpacer { }
+
+        KeroWarningAvatar
+        {
+            Layout.fillWidth: true
+            Layout.fillHeight: true
+            Layout.preferredHeight: 512
+            Layout.maximumHeight: 512
+        }
+
+        RowLayout
+        {
+            Layout.fillWidth: true
+            Layout.preferredHeight: 36
+            Layout.maximumHeight: 36
+            Layout.margins: Constants.largeMargin
+
+            Item
+            {
+                Layout.fillHeight: true
+                Layout.fillWidth: true
+            }
+            SquareButton
+            {
+                Layout.preferredWidth: 186
+                Layout.fillHeight: true
+                text: qsTr("Okay")
+
+                onTriggered: () =>
+                {
+                    if(manager != null)
+                    {
+                        manager.reset()
+                    }
+                }
+            }
+        }
+
+        VerticalSpacer {}
+    }
+}

KomplexHubContent/views/ImageView.qml

@@ -0,0 +1,390 @@
+/*
+ *  Komplex Wallpaper Engine
+ *  Copyright (C) 2026 @DigitalArtifex
+ *  https://digitalartifex.dev - https://github.com/DigitalArtifex
+ *
+ *  This program is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program.  If not, see <https://www.gnu.org/licenses/>
+ */
+import QtCore
+import QtQuick
+import QtQuick.Controls
+import QtQuick.Layouts
+import QtQuick.Effects
+
+import KomplexHub
+import KomplexHub.Controls
+import KomplexHub.Kero
+import KomplexHub.Plugin
+
+Item
+{
+    property string uuid
+    property string author
+    property string authorUrl
+    property string description
+    property string thumbnail
+    property string portrait
+    property string landscape
+    property string fullScreen
+    property string portraitSize
+    property string landscapeSize
+    property string fullScreenSize
+    property string backgroundPortrait
+    property string backgroundLandscape
+
+    property int imageHeight
+    property int imageWidth
+
+    id: rootItem
+
+    DownloadManager
+    {
+        id: downloadManager
+    }
+
+    Rectangle
+    {
+        id: pageView
+        anchors.fill: parent
+        color: palette.base
+
+        BackgroundImage
+        {
+            anchors.fill: parent
+            source: width > height ? backgroundLandscape : backgroundPortrait
+        }
+
+        ColumnLayout
+        {
+            anchors.fill: parent
+            anchors.margins: Constants.largeMargin
+            spacing: Constants.largeMargin
+
+            ImageFrame
+            {
+                Layout.fillWidth: true
+                Layout.alignment: Qt.AlignTop | Qt.AlignHCenter
+                Layout.topMargin: Constants.largeMargin
+                Layout.preferredHeight: width / 1.77777777778
+                Layout.maximumWidth: 800
+
+                source: rootItem.thumbnail
+            }
+
+            Text
+            {
+                id: titleText
+                text: rootItem.author
+                color: palette.text
+                font.bold: true
+                font.pixelSize: Constants.h3Font.pixelSize
+                elide: Text.ElideRight
+
+                Layout.fillWidth: true
+                Layout.alignment: Qt.AlignTop | Qt.AlignLeft
+            }
+
+            Text
+            {
+                id: descriptionText
+                text: rootItem.description
+                color: palette.text
+                font.pointSize: Constants.h4Font.pixelSize
+                wrapMode: Text.WrapAtWordBoundaryOrAnywhere
+
+                Layout.alignment: Qt.AlignTop| Qt.AlignLeft
+                Layout.fillWidth: true
+            }
+
+            /** Spacer **/
+            Item
+            {
+                Layout.fillWidth: true
+                Layout.preferredHeight: 32
+            }
+
+            Text
+            {
+                text: qsTr("Available Downloads")
+                color: palette.text
+                font.bold: true
+                font.pixelSize: Constants.h3Font.pixelSize
+                elide: Text.ElideRight
+
+                Layout.fillWidth: true
+                Layout.alignment: Qt.AlignTop| Qt.AlignLeft
+            }
+
+            RowLayout
+            {
+                Layout.fillWidth: true
+
+                ComboBox
+                {
+                    id: downloadSelector
+                    model:[
+                        "Screen (" + fullScreenSize + ")",
+                        "Portrait (" + portraitSize + ")",
+                        "Landscape (" + landscapeSize + ")"
+                    ]
+                    Layout.fillWidth: true
+                    Layout.preferredHeight: 36
+                }
+                SquareButton
+                {
+                    Layout.preferredHeight: 36
+                    Layout.preferredWidth: 128
+                    text: qsTr("Download")
+                    icon.source: "qrc:/images/icons/icons8-download.svg"
+
+                    onTriggered: () => rootItem.download()
+                }
+            }
+
+            /** Spacer **/
+            Item { Layout.fillWidth: true; Layout.fillHeight: true }
+
+            RowLayout
+            {
+                Layout.fillWidth: true
+                Layout.alignment: Qt.AlignBottom
+
+                Text {
+                    text: qsTr("Images Provided Courtesy of Pexels")
+                    elide: Text.ElideLeft
+                    color: palette.text
+                    font.bold: true
+                    font.pixelSize: Constants.h6Font.pixelSize
+
+                    Layout.fillWidth: true
+                    Layout.alignment: Qt.AlignLeft
+                }
+
+                Image
+                {
+                    transform: Image.PreserveAspectFit
+                    source: "qrc:/images/icons/pexels-icon-filled-256.svg"
+
+                    Layout.alignment: Qt.AlignRight
+                    Layout.preferredHeight: 32
+                    Layout.preferredWidth: 32
+                }
+            }
+        }
+
+        Behavior on opacity
+        {
+            NumberAnimation
+            {
+                duration: 250
+            }
+        }
+
+        states:
+        [
+            State
+            {
+                name: "downloading"
+                when: downloadManager.state === DownloadManager.Downloading
+
+                PropertyChanges
+                {
+                    target: pageView
+                    opacity: 0
+                }
+
+                PropertyChanges
+                {
+                    target: downloadView
+                    opacity: 1
+                }
+
+                PropertyChanges
+                {
+                    target: completedView
+                    opacity: 0
+                }
+
+                PropertyChanges
+                {
+                    target: errorView
+                    opacity: 0
+                }
+            },
+            State
+            {
+                name: "complete"
+                when: downloadManager.state === DownloadManager.Complete
+
+                PropertyChanges
+                {
+                    target: pageView
+                    opacity: 0
+                }
+
+                PropertyChanges
+                {
+                    target: downloadView
+                    opacity: 0
+                }
+
+                PropertyChanges
+                {
+                    target: completedView
+                    opacity: 1
+                }
+
+                PropertyChanges
+                {
+                    target: errorView
+                    opacity: 0
+                }
+            },
+            State
+            {
+                name: "error"
+                when: downloadManager.state === DownloadManager.Error
+
+                PropertyChanges
+                {
+                    target: pageView
+                    opacity: 0
+                }
+
+                PropertyChanges
+                {
+                    target: downloadView
+                    opacity: 0
+                }
+
+                PropertyChanges
+                {
+                    target: completedView
+                    opacity: 0
+                }
+
+                PropertyChanges
+                {
+                    target: errorView
+                    opacity: 1
+                }
+            },
+            State
+            {
+                name: "idle"
+                when: downloadManager.state === DownloadManager.Idle
+
+                PropertyChanges
+                {
+                    target: pageView
+                    opacity: 1
+                }
+
+                PropertyChanges
+                {
+                    target: downloadView
+                    opacity: 0
+                }
+
+                PropertyChanges
+                {
+                    target: completedView
+                    opacity: 0
+                }
+
+                PropertyChanges
+                {
+                    target: errorView
+                    opacity: 0
+                }
+            }
+        ]
+    }
+
+    DownloadView
+    {
+        id: downloadView
+        anchors.fill: parent
+
+        manager: downloadManager
+        thumbnail: rootItem.thumbnail
+        opacity: 0
+        visible: opacity > 0.01
+
+        Behavior on opacity
+        {
+            NumberAnimation
+            {
+                duration: 250
+            }
+        }
+    }
+
+    CompletedView
+    {
+        id: completedView
+        anchors.fill: parent
+
+        opacity: 0
+        visible: opacity > 0.01
+        manager: downloadManager
+
+        Behavior on opacity
+        {
+            NumberAnimation
+            {
+                duration: 250
+            }
+        }
+    }
+
+    ErrorView
+    {
+        id: errorView
+        anchors.fill: parent
+
+        opacity: 0
+        visible: opacity > 0.01
+        manager: downloadManager
+
+        Behavior on opacity
+        {
+            NumberAnimation
+            {
+                duration: 250
+            }
+        }
+    }
+
+    function download()
+    {
+        let url = ""
+
+        switch(downloadSelector.currentIndex)
+        {
+            case 1:
+                url = portrait
+                break;
+            case 2:
+                url = landscape
+                break;
+            case 0:
+            default:
+                url = fullScreen
+                break;
+        }
+
+        downloadManager.downloadImage(author, authorUrl, description, url)
+    }
+}

KomplexHubContent/views/PackView.qml

@@ -0,0 +1,419 @@
+/*
+ *  Komplex Wallpaper Engine
+ *  Copyright (C) 2026 @DigitalArtifex
+ *  https://digitalartifex.dev - https://github.com/DigitalArtifex
+ *
+ *  This program is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program.  If not, see <https://www.gnu.org/licenses/>
+ */
+import QtCore
+import QtQuick
+import QtQuick.Controls
+import QtQuick.Layouts
+import QtQuick.Effects
+
+import KomplexHub
+import KomplexHub.Controls
+import KomplexHub.Kero
+import KomplexHub.Plugin
+
+Item
+{
+    property string uuid
+    property string author
+    property string authorId
+    property string description
+    property string thumbnail
+    property string name
+
+    property int imageHeight
+    property int imageWidth
+
+    id: rootItem
+
+    DownloadManager
+    {
+        id: downloadManager
+    }
+
+    Rectangle
+    {
+        id: pageView
+        anchors.fill: parent
+        color: palette.base
+
+        BackgroundImage
+        {
+            anchors.fill: parent
+            source: rootItem.thumbnail
+        }
+
+        ColumnLayout
+        {
+            anchors.fill: parent
+            anchors.margins: Constants.largeMargin
+            spacing: Constants.largeMargin
+
+            ImageFrame
+            {
+                Layout.fillWidth: true
+                Layout.alignment: Qt.AlignTop| Qt.AlignHCenter
+                Layout.topMargin: Constants.largeMargin
+                Layout.preferredHeight: width / 1.77777777778
+                Layout.maximumWidth: 800
+
+                source: rootItem.thumbnail
+            }
+
+            Text
+            {
+                id: titleText
+                text: rootItem.name
+                color: palette.text
+                font.bold: true
+                font.pixelSize: Constants.h3Font.pixelSize
+                elide: Text.ElideRight
+
+                Layout.fillWidth: true
+                Layout.alignment: Qt.AlignTop| Qt.AlignLeft
+            }
+
+            Text
+            {
+                id: descriptionText
+                text: rootItem.description
+                color: palette.text
+                font.pointSize: Constants.h4Font.pixelSize
+                wrapMode: Text.WrapAtWordBoundaryOrAnywhere
+
+                Layout.alignment: Qt.AlignTop| Qt.AlignLeft
+                Layout.fillWidth: true
+            }
+
+            Text
+            {
+                id: authorText
+                text: qsTr("By: ") + rootItem.author
+                color: palette.text
+                font.pointSize: Constants.h5Font.pixelSize
+                wrapMode: Text.WrapAtWordBoundaryOrAnywhere
+                horizontalAlignment: Qt.AlignRight
+
+                Layout.alignment: Qt.AlignTop | Qt.AlignRight
+                Layout.fillWidth: true
+            }
+
+            /** Spacer **/
+            Item
+            {
+                Layout.fillWidth: true
+                Layout.preferredHeight: 32
+            }
+
+            RowLayout
+            {
+                Layout.fillWidth: true
+
+                Item { Layout.fillWidth: true }
+
+                SquareButton
+                {
+                    Layout.preferredHeight: 36
+                    Layout.preferredWidth: 128
+                    text: qsTr("Download")
+                    icon.source: "qrc:/images/icons/icons8-download.svg"
+
+                    onTriggered: () => rootItem.download()
+                }
+            }
+
+            /** Spacer **/
+            Item { Layout.fillWidth: true; Layout.fillHeight: true }
+
+            RowLayout
+            {
+                Layout.fillWidth: true
+                Layout.alignment: Qt.AlignBottom
+
+                Text {
+                    text: qsTr("Shaders Provided Courtesy of ShaderToy, Komplex and Their Respective Authors")
+                    elide: Text.ElideLeft
+                    color: palette.text
+                    font.bold: true
+                    font.pixelSize: Constants.h6Font.pixelSize
+
+                    Layout.fillWidth: true
+                    Layout.alignment: Qt.AlignLeft
+                }
+
+                Image
+                {
+                    transform: Image.PreserveAspectFit
+                    source: "qrc:/images/icons/pexels-icon-filled-256.svg"
+
+                    Layout.alignment: Qt.AlignRight
+                    Layout.preferredHeight: 32
+                    Layout.preferredWidth: 32
+                }
+            }
+        }
+
+        Behavior on opacity
+        {
+            NumberAnimation
+            {
+                duration: 250
+            }
+        }
+
+        states:
+        [
+            State
+            {
+                name: "downloading"
+                when: downloadManager.state === DownloadManager.Downloading
+
+                PropertyChanges
+                {
+                    target: pageView
+                    opacity: 0
+                }
+
+                PropertyChanges
+                {
+                    target: downloadView
+                    opacity: 1
+                }
+
+                PropertyChanges
+                {
+                    target: completedView
+                    opacity: 0
+                }
+
+                PropertyChanges
+                {
+                    target: errorView
+                    opacity: 0
+                }
+            },
+            State
+            {
+                name: "compiling"
+                when: downloadManager.state === DownloadManager.Compiling
+
+                PropertyChanges
+                {
+                    target: pageView
+                    opacity: 0
+                }
+
+                PropertyChanges
+                {
+                    target: downloadView
+                    opacity: 1
+                }
+
+                PropertyChanges
+                {
+                    target: completedView
+                    opacity: 0
+                }
+
+                PropertyChanges
+                {
+                    target: errorView
+                    opacity: 0
+                }
+            },
+            State
+            {
+                name: "installing"
+                when: downloadManager.state === DownloadManager.Installing
+
+                PropertyChanges
+                {
+                    target: pageView
+                    opacity: 0
+                }
+
+                PropertyChanges
+                {
+                    target: downloadView
+                    opacity: 1
+                }
+
+                PropertyChanges
+                {
+                    target: completedView
+                    opacity: 0
+                }
+
+                PropertyChanges
+                {
+                    target: errorView
+                    opacity: 0
+                }
+            },
+            State
+            {
+                name: "complete"
+                when: downloadManager.state === DownloadManager.Complete
+
+                PropertyChanges
+                {
+                    target: pageView
+                    opacity: 0
+                }
+
+                PropertyChanges
+                {
+                    target: downloadView
+                    opacity: 0
+                }
+
+                PropertyChanges
+                {
+                    target: completedView
+                    opacity: 1
+                }
+
+                PropertyChanges
+                {
+                    target: errorView
+                    opacity: 0
+                }
+            },
+            State
+            {
+                name: "error"
+                when: downloadManager.state === DownloadManager.Error
+
+                PropertyChanges
+                {
+                    target: pageView
+                    opacity: 0
+                }
+
+                PropertyChanges
+                {
+                    target: downloadView
+                    opacity: 0
+                }
+
+                PropertyChanges
+                {
+                    target: completedView
+                    opacity: 0
+                }
+
+                PropertyChanges
+                {
+                    target: errorView
+                    opacity: 1
+                }
+            },
+            State
+            {
+                name: "idle"
+                when: downloadManager.state === DownloadManager.Idle
+
+                PropertyChanges
+                {
+                    target: pageView
+                    opacity: 1
+                }
+
+                PropertyChanges
+                {
+                    target: downloadView
+                    opacity: 0
+                }
+
+                PropertyChanges
+                {
+                    target: completedView
+                    opacity: 0
+                }
+
+                PropertyChanges
+                {
+                    target: errorView
+                    opacity: 0
+                }
+            }
+        ]
+    }
+
+    DownloadView
+    {
+        id: downloadView
+        anchors.fill: parent
+
+        manager: downloadManager
+        thumbnail: rootItem.thumbnail
+        opacity: 0
+        visible: opacity > 0.01
+
+        Behavior on opacity
+        {
+            NumberAnimation
+            {
+                duration: 250
+            }
+        }
+    }
+
+    CompletedView
+    {
+        id: completedView
+        anchors.fill: parent
+
+        opacity: 0
+        visible: opacity > 0.01
+        manager: downloadManager
+
+        Behavior on opacity
+        {
+            NumberAnimation
+            {
+                duration: 250
+            }
+        }
+    }
+
+    ErrorView
+    {
+        id: errorView
+        anchors.fill: parent
+
+        opacity: 0
+        visible: opacity > 0.01
+        manager: downloadManager
+
+        Behavior on opacity
+        {
+            NumberAnimation
+            {
+                duration: 250
+            }
+        }
+    }
+
+    function download()
+    {
+        downloadManager.downloadPack(uuid)
+    }
+
+    Component.onCompleted: () => downloadManager.reset()
+}

KomplexHubContent/views/VideoView.qml

@@ -0,0 +1,364 @@
+/*
+ *  Komplex Wallpaper Engine
+ *  Copyright (C) 2026 @DigitalArtifex
+ *  https://digitalartifex.dev - https://github.com/DigitalArtifex
+ *
+ *  This program is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program.  If not, see <https://www.gnu.org/licenses/>
+ */
+import QtCore
+import QtQuick
+import QtQuick.Controls
+import QtQuick.Layouts
+import QtQuick.Effects
+
+import KomplexHub
+import KomplexHub.Controls
+import KomplexHub.Kero
+import KomplexHub.Plugin
+
+Item
+{
+    property string uuid
+    property string author
+    property string authorUrl
+    property string thumbnail
+    property alias model: downloadSelector.model
+    property int modelIndex
+
+    property int imageHeight
+    property int imageWidth
+
+    visible: opacity > 0.01
+
+    Connections
+    {
+        target: model ? model : null
+
+        function onRowCountChanged()
+        {
+            downloadSelector.currentIndex = 0
+        }
+    }
+
+    DownloadManager
+    {
+        id: downloadManager
+    }
+
+    id: rootItem
+
+    Rectangle
+    {
+        id: pageView
+        anchors.fill: parent
+        color: palette.base
+
+        BackgroundImage
+        {
+            anchors.fill: parent
+            source: rootItem.thumbnail
+        }
+
+        ColumnLayout
+        {
+            anchors.fill: parent
+            anchors.margins: Constants.largeMargin
+            spacing: Constants.largeMargin
+
+            ImageFrame
+            {
+                Layout.fillWidth: true
+                Layout.alignment: Qt.AlignTop| Qt.AlignHCenter
+                Layout.topMargin: Constants.largeMargin
+                Layout.preferredHeight: width / 1.77777777778
+                Layout.maximumWidth: 800
+
+                source: rootItem.thumbnail
+            }
+
+            Text
+            {
+                id: titleText
+                text: rootItem.author
+                color: palette.text
+                font.bold: true
+                font.pixelSize: Constants.h3Font.pixelSize
+                elide: Text.ElideRight
+
+                Layout.fillWidth: true
+                Layout.alignment: Qt.AlignTop| Qt.AlignLeft
+            }
+
+            /** Spacer **/
+            Item
+            {
+                Layout.fillWidth: true
+                Layout.preferredHeight: 32
+            }
+
+            Text
+            {
+                text: qsTr("Available Downloads")
+                color: palette.text
+                font.bold: true
+                font.pixelSize: Constants.h3Font.pixelSize
+                elide: Text.ElideRight
+
+                Layout.fillWidth: true
+                Layout.alignment: Qt.AlignTop| Qt.AlignLeft
+            }
+
+            RowLayout
+            {
+                Layout.fillWidth: true
+
+                ComboBox
+                {
+                    id: downloadSelector
+                    textRole: "text"
+                    valueRole: "url"
+                    Layout.fillWidth: true
+                    Layout.preferredHeight: 36
+                }
+                SquareButton
+                {
+                    Layout.preferredHeight: 36
+                    Layout.preferredWidth: 128
+                    text: qsTr("Download")
+                    icon.source: "qrc:/images/icons/icons8-download.svg"
+
+                    onTriggered: () => rootItem.download()
+                }
+            }
+
+            /** Spacer **/
+            Item { Layout.fillWidth: true; Layout.fillHeight: true }
+
+            RowLayout
+            {
+                Layout.fillWidth: true
+                Layout.alignment: Qt.AlignBottom
+
+                Text {
+                    text: qsTr("Videos Provided Courtesy of Pexels and Their Respective Authors")
+                    elide: Text.ElideLeft
+                    color: palette.text
+                    font.bold: true
+                    font.pixelSize: Constants.h6Font.pixelSize
+
+                    Layout.fillWidth: true
+                    Layout.alignment: Qt.AlignLeft
+                }
+
+                Image
+                {
+                    transform: Image.PreserveAspectFit
+                    source: "qrc:/images/icons/pexels-icon-filled-256.svg"
+
+                    Layout.alignment: Qt.AlignRight
+                    Layout.preferredHeight: 32
+                    Layout.preferredWidth: 32
+                }
+            }
+        }
+
+        Behavior on opacity
+        {
+            NumberAnimation
+            {
+                duration: 250
+            }
+        }
+
+        states:
+        [
+            State
+            {
+                name: "downloading"
+                when: downloadManager.state === DownloadManager.Downloading
+
+                PropertyChanges
+                {
+                    target: pageView
+                    opacity: 0
+                }
+
+                PropertyChanges
+                {
+                    target: downloadView
+                    opacity: 1
+                }
+
+                PropertyChanges
+                {
+                    target: completedView
+                    opacity: 0
+                }
+
+                PropertyChanges
+                {
+                    target: errorView
+                    opacity: 0
+                }
+            },
+            State
+            {
+                name: "complete"
+                when: downloadManager.state === DownloadManager.Complete
+
+                PropertyChanges
+                {
+                    target: pageView
+                    opacity: 0
+                }
+
+                PropertyChanges
+                {
+                    target: downloadView
+                    opacity: 0
+                }
+
+                PropertyChanges
+                {
+                    target: completedView
+                    opacity: 1
+                }
+
+                PropertyChanges
+                {
+                    target: errorView
+                    opacity: 0
+                }
+            },
+            State
+            {
+                name: "error"
+                when: downloadManager.state === DownloadManager.Error
+
+                PropertyChanges
+                {
+                    target: pageView
+                    opacity: 0
+                }
+
+                PropertyChanges
+                {
+                    target: downloadView
+                    opacity: 0
+                }
+
+                PropertyChanges
+                {
+                    target: completedView
+                    opacity: 0
+                }
+
+                PropertyChanges
+                {
+                    target: errorView
+                    opacity: 1
+                }
+            },
+            State
+            {
+                name: "idle"
+                when: downloadManager.state === DownloadManager.Idle
+
+                PropertyChanges
+                {
+                    target: pageView
+                    opacity: 1
+                }
+
+                PropertyChanges
+                {
+                    target: downloadView
+                    opacity: 0
+                }
+
+                PropertyChanges
+                {
+                    target: completedView
+                    opacity: 0
+                }
+
+                PropertyChanges
+                {
+                    target: errorView
+                    opacity: 0
+                }
+            }
+        ]
+    }
+
+    DownloadView
+    {
+        id: downloadView
+        anchors.fill: parent
+
+        manager: downloadManager
+        thumbnail: rootItem.thumbnail
+        opacity: 0
+        visible: opacity > 0.01
+
+        Behavior on opacity
+        {
+            NumberAnimation
+            {
+                duration: 250
+            }
+        }
+    }
+
+    CompletedView
+    {
+        id: completedView
+        anchors.fill: parent
+
+        opacity: 0
+        visible: opacity > 0.01
+        manager: downloadManager
+
+        Behavior on opacity
+        {
+            NumberAnimation
+            {
+                duration: 250
+            }
+        }
+    }
+
+    ErrorView
+    {
+        id: errorView
+        anchors.fill: parent
+
+        opacity: 0
+        visible: opacity > 0.01
+        manager: downloadManager
+
+        Behavior on opacity
+        {
+            NumberAnimation
+            {
+                duration: 250
+            }
+        }
+    }
+
+    function download()
+    {
+        downloadManager.downloadImage(author, authorUrl, downloadSelector.currentValue)
+    }
+}

KomplexHubModule/CMakeLists.txt

@@ -13,10 +13,11 @@ qt6_add_qml_module(KomplexHubModule
     RESOURCE_PREFIX "/qt/qml"
     QML_FILES
         "Constants.qml"
-        "EventListModel.qml"
-        "EventListSimulator.qml"
-        "WallpaperModelData.qml"
+
+
+
 )
 
+set_target_properties(KomplexHubModule PROPERTIES VERSION "1.0")
 add_subdirectory("Controls")
 add_subdirectory("Kero")

KomplexHubModule/Constants.qml

@@ -1,8 +1,27 @@
+/*
+ *  Komplex Wallpaper Engine
+ *  Copyright (C) 2026 @DigitalArtifex
+ *  https://digitalartifex.dev - https://github.com/DigitalArtifex
+ *
+ *  This program is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program.  If not, see <https://www.gnu.org/licenses/>
+ */
 pragma Singleton
 import QtQuick
 import QtQuick.Studio.Application
 
-QtObject {
+QtObject
+{
     readonly property int width: 1920
     readonly property int height: 1080
 
@@ -62,8 +81,4 @@ QtObject {
     readonly property int slowAnimationDuration: 750
     readonly property int normalAnimationDuration: 250
     readonly property int fastAnimationDuration: 125
-
-    property StudioApplication application: StudioApplication {
-        fontPath: Qt.resolvedUrl("../KomplexHubContent/" + relativeFontDirectory)
-    }
 }

KomplexHubModule/Controls/BackgroundImage.qml

@@ -0,0 +1,51 @@
+/*
+ *  Komplex Wallpaper Engine
+ *  Copyright (C) 2026 @DigitalArtifex
+ *  https://digitalartifex.dev - https://github.com/DigitalArtifex
+ *
+ *  This program is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program.  If not, see <https://www.gnu.org/licenses/>
+ */
+import QtCore
+import QtQuick
+import QtQuick.Controls
+import QtQuick.Effects
+
+Item
+{
+    property alias source: image.source
+    property alias imageOpacity: effect.opacity
+    property alias blur: effect.blur
+    property alias saturation: effect.saturation
+
+    Image
+    {
+        anchors.fill: parent
+        id: image
+        source: thumbnail
+        fillMode: Image.PreserveAspectFit
+        visible: false
+    }
+
+    MultiEffect
+    {
+        id: effect
+        anchors.fill: image
+        source: image
+        blurEnabled: true
+        blurMax: 64
+        blur: 1.0
+        opacity: 0.25
+        saturation: -0.8
+    }
+}

KomplexHubModule/Controls/CMakeLists.txt

@@ -1,8 +1,8 @@
 ### This file is automatically generated by Qt Design Studio.
 ### Do not change
 
-qt_add_library(KomplexHubModule_Controls STATIC)
-qt6_add_qml_module(KomplexHubModule_Controls
+qt_add_library(KomplexHubControls STATIC)
+qt6_add_qml_module(KomplexHubControls
     URI "KomplexHub.Controls"
     VERSION 1.0
     RESOURCE_PREFIX "/qt/qml"
@@ -14,12 +14,12 @@ qt6_add_qml_module(KomplexHubModule_Controls
         "Throbber.qml"
         "SearchResultItem.qml"
         "SearchResultList.qml"
-        QML_FILES PaginationBox.qml
-        QML_FILES PaginatorGrid.qml
-        QML_FILES HorizontalPaginator.qml
-        QML_FILES ImageView.qml
-        QML_FILES
-        QML_FILES VideoView.qml
-        QML_FILES PackView.qml
+        "PaginationBox.qml"
+        "PaginatorGrid.qml"
+        "HorizontalPaginator.qml"
+        "VerticalSpacer.qml"
+        "ImageFrame.qml"
+        "BackgroundImage.qml"
 )
 
+#set_target_properties(KomplexHubControls PROPERTIES VERSION "1.0")

KomplexHubModule/Controls/HorizontalPaginator.qml

@@ -1,3 +1,22 @@
+/*
+ *  Komplex Wallpaper Engine
+ *  Copyright (C) 2026 @DigitalArtifex
+ *  https://digitalartifex.dev - https://github.com/DigitalArtifex
+ *
+ *  This program is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program.  If not, see <https://www.gnu.org/licenses/>
+ */
+import QtCore
 import QtQuick
 import QtQuick.Controls
 import QtQuick.Layouts
@@ -5,7 +24,7 @@ import QtQuick.Layouts
 import KomplexHub
 import KomplexHub.Controls
 import KomplexHub.Kero
-import KomplexHubPlugin
+import KomplexHub.Plugin
 
 Item
 {
@@ -28,6 +47,7 @@ Item
     signal viewMoreTriggered()
 
     id: rootItem
+    clip: true
 
     Item
     {
@@ -47,8 +67,6 @@ Item
                     height: 245
                     color: palette.accent
                     radius: 5
-                    // x: resultsView.currentItem.x
-                    // y: resultsView.currentItem.y
                     Behavior on x { SpringAnimation { spring: 3; damping: 0.2 } }
                     Behavior on y { SpringAnimation { spring: 3; damping: 0.2 } }
                 }
@@ -59,6 +77,7 @@ Item
                 id: resultsView
                 Layout.fillHeight: true
                 Layout.fillWidth: true
+                clip: true
 
                 spacing: Constants.mediumMargin
 
@@ -134,7 +153,7 @@ Item
             Item
             {
                 Layout.fillHeight: true
-                Layout.preferredWidth: 128
+                Layout.preferredWidth: 64
                 Rectangle
                 {
                     id: gradientMap

KomplexHubModule/Controls/ImageFrame.qml

@@ -0,0 +1,53 @@
+/*
+ *  Komplex Wallpaper Engine
+ *  Copyright (C) 2026 @DigitalArtifex
+ *  https://digitalartifex.dev - https://github.com/DigitalArtifex
+ *
+ *  This program is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program.  If not, see <https://www.gnu.org/licenses/>
+ */
+import QtCore
+import QtQuick
+import QtQuick.Controls
+import QtQuick.Layouts
+
+Item
+{
+    property alias source: viewImage.source
+    id: rootItem
+
+    Rectangle
+    {
+        anchors.fill: parent
+        Layout.alignment: Qt.AlignCenter
+        color: palette.base.darker()
+        border.color: palette.midlight
+
+        Throbber
+        {
+            anchors.fill: parent
+            id: loadingThrobber
+            visible: viewImage.status === Image.Loading
+        }
+
+        Image
+        {
+            id: viewImage
+            anchors.fill: parent
+            transform: Image.PreserveAspectCrop
+            source: rootItem.source
+            visible: !(status === Image.Loading)
+        }
+    }
+
+}

KomplexHubModule/Controls/ImageView.qml

@@ -1,195 +0,0 @@
-import QtQuick
-import QtQuick.Controls
-import QtQuick.Layouts
-import QtQuick.Effects
-
-import KomplexHub
-import KomplexHub.Controls
-import KomplexHub.Kero
-import KomplexHubPlugin
-
-Item
-{
-    property string uuid
-    property string author
-    property string authorUrl
-    property string description
-    property string thumbnail
-    property string portrait
-    property string landscape
-    property string original
-    property string fullScreen
-    property string portraitSize
-    property string landscapeSize
-    property string fullScreenSize
-    property string backgroundPortrait
-    property string backgroundLandscape
-
-    property int imageHeight
-    property int imageWidth
-
-    id: rootItem
-
-    Rectangle
-    {
-        anchors.fill: parent
-        color: palette.base
-
-        Image
-        {
-            id: backgroundImage
-            source: width > height ? backgroundLandscape : backgroundPortrait
-            transform: Image.PreserveAspectCrop
-            anchors.fill: parent
-            visible: false
-        }
-
-        MultiEffect
-        {
-            anchors.fill: backgroundImage
-            source: backgroundImage
-            blurEnabled: true
-            blurMax: 64
-            blur: 1.0
-            opacity: 0.25
-            saturation: -0.8
-        }
-
-        ColumnLayout
-        {
-            anchors.fill: parent
-            anchors.margins: Constants.largeMargin
-            spacing: Constants.largeMargin
-
-            RowLayout
-            {
-                Layout.fillWidth: true
-                Layout.alignment: Qt.AlignTop| Qt.AlignHCenter
-                Layout.topMargin: 32
-
-                Rectangle
-                {
-                    Layout.fillWidth: true
-                    Layout.preferredHeight: width / 1.77777777778
-                    Layout.maximumWidth: 800
-                    Layout.alignment: Qt.AlignHCenter
-                    color: palette.base.darker()
-
-                    Throbber
-                    {
-                        anchors.fill: parent
-                        id: loadingThrobber
-                        visible: viewImage.status === Image.Loading
-                    }
-
-                    Image
-                    {
-                        id: viewImage
-                        anchors.fill: parent
-                        transform: Image.PreserveAspectCrop
-                        source: rootItem.thumbnail
-                        visible: !(status === Image.Loading)
-                    }
-                }
-            }
-
-            Text
-            {
-                id: titleText
-                text: rootItem.author
-                color: palette.text
-                font.bold: true
-                font.pixelSize: Constants.h3Font.pixelSize
-                elide: Text.ElideRight
-
-                Layout.fillWidth: true
-                Layout.alignment: Qt.AlignTop| Qt.AlignLeft
-            }
-
-            Text
-            {
-                id: descriptionText
-                text: rootItem.description
-                color: palette.text
-                font.pointSize: Constants.h4Font.pixelSize
-                wrapMode: Text.WrapAtWordBoundaryOrAnywhere
-
-                Layout.alignment: Qt.AlignTop| Qt.AlignLeft
-                Layout.fillWidth: true
-            }
-
-            /** Spacer **/
-            Item
-            {
-                Layout.fillWidth: true
-                Layout.preferredHeight: 32
-            }
-
-            Text
-            {
-                text: qsTr("Available Downloads")
-                color: palette.text
-                font.bold: true
-                font.pixelSize: Constants.h3Font.pixelSize
-                elide: Text.ElideRight
-
-                Layout.fillWidth: true
-                Layout.alignment: Qt.AlignTop| Qt.AlignLeft
-            }
-
-            RowLayout
-            {
-                Layout.fillWidth: true
-
-                ComboBox
-                {
-                    id: downloadSelector
-                    model:[
-                        "Screen (" + fullScreenSize + ")",
-                        "Portrait (" + portraitSize + ")",
-                        "Landscape (" + landscapeSize + ")"
-                    ]
-                    Layout.fillWidth: true
-                    Layout.preferredHeight: 36
-                }
-                SquareButton
-                {
-                    Layout.preferredHeight: 36
-                    Layout.preferredWidth: 128
-                    text: qsTr("Download")
-                    icon.source: "qrc:/images/icons/icons8-download.svg"
-                }
-            }
-
-            /** Spacer **/
-            Item { Layout.fillWidth: true; Layout.fillHeight: true }
-
-            RowLayout
-            {
-                Layout.fillWidth: true
-                Layout.alignment: Qt.AlignBottom
-
-                Text {
-                    text: qsTr("Images Provided Courtesy of Pexels")
-                    elide: Text.ElideLeft
-                    color: palette.text
-                    font.bold: true
-                    font.pixelSize: Constants.h6Font.pixelSize
-
-                    Layout.fillWidth: true
-                    Layout.alignment: Qt.AlignLeft
-                }
-
-                Image
-                {
-                    transform: Image.PreserveAspectFit
-                    source: "qrc:/images/icons/pexels-icon-filled-256.svg"
-
-                    Layout.alignment: Qt.AlignRight
-                    Layout.preferredHeight: 32
-                    Layout.preferredWidth: 32
-                }
-            }
-        }
-    }
-}

KomplexHubModule/Controls/MenuButton.qml

@@ -1,3 +1,22 @@
+/*
+ *  Komplex Wallpaper Engine
+ *  Copyright (C) 2026 @DigitalArtifex
+ *  https://digitalartifex.dev - https://github.com/DigitalArtifex
+ *
+ *  This program is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program.  If not, see <https://www.gnu.org/licenses/>
+ */
+import QtCore
 import QtQuick
 import QtQuick.Controls
 import QtQuick.Layouts

KomplexHubModule/Controls/PackView.qml

@@ -1,177 +0,0 @@
-import QtQuick
-import QtQuick.Controls
-import QtQuick.Layouts
-import QtQuick.Effects
-
-import KomplexHub
-import KomplexHub.Controls
-import KomplexHub.Kero
-import KomplexHubPlugin
-
-Item
-{
-    property string uuid
-    property string author
-    property string authorId
-    property string description
-    property string thumbnail
-
-    property int imageHeight
-    property int imageWidth
-
-    id: rootItem
-
-    Rectangle
-    {
-        anchors.fill: parent
-        color: palette.base
-
-        Image
-        {
-            id: backgroundImage
-            source: thumbnail
-            transform: Image.PreserveAspectCrop
-            anchors.fill: parent
-            visible: false
-        }
-
-        MultiEffect
-        {
-            anchors.fill: backgroundImage
-            source: backgroundImage
-            blurEnabled: true
-            blurMax: 64
-            blur: 1.0
-            opacity: 0.25
-            saturation: -0.8
-        }
-
-        ColumnLayout
-        {
-            anchors.fill: parent
-            anchors.margins: Constants.largeMargin
-            spacing: Constants.largeMargin
-
-            RowLayout
-            {
-                Layout.fillWidth: true
-                Layout.alignment: Qt.AlignTop| Qt.AlignHCenter
-                Layout.topMargin: 32
-
-                Rectangle
-                {
-                    Layout.fillWidth: true
-                    Layout.preferredHeight: width / 1.77777777778
-                    Layout.maximumWidth: 800
-                    Layout.alignment: Qt.AlignHCenter
-                    color: palette.base.darker()
-
-                    Throbber
-                    {
-                        anchors.fill: parent
-                        id: loadingThrobber
-                        visible: viewImage.status === Image.Loading
-                    }
-
-                    Image
-                    {
-                        id: viewImage
-                        anchors.fill: parent
-                        transform: Image.PreserveAspectCrop
-                        source: rootItem.thumbnail
-                        visible: !(status === Image.Loading)
-                    }
-                }
-            }
-
-            Text
-            {
-                id: titleText
-                text: rootItem.author
-                color: palette.text
-                font.bold: true
-                font.pixelSize: Constants.h3Font.pixelSize
-                elide: Text.ElideRight
-
-                Layout.fillWidth: true
-                Layout.alignment: Qt.AlignTop| Qt.AlignLeft
-            }
-
-            Text
-            {
-                id: descriptionText
-                text: rootItem.description
-                color: palette.text
-                font.pointSize: Constants.h4Font.pixelSize
-                wrapMode: Text.WrapAtWordBoundaryOrAnywhere
-
-                Layout.alignment: Qt.AlignTop| Qt.AlignLeft
-                Layout.fillWidth: true
-            }
-
-            /** Spacer **/
-            Item
-            {
-                Layout.fillWidth: true
-                Layout.preferredHeight: 32
-            }
-
-            // Text
-            // {
-            //     text: qsTr("Available Downloads")
-            //     color: palette.text
-            //     font.bold: true
-            //     font.pixelSize: Constants.h3Font.pixelSize
-            //     elide: Text.ElideRight
-
-            //     Layout.fillWidth: true
-            //     Layout.alignment: Qt.AlignTop| Qt.AlignLeft
-            // }
-
-            RowLayout
-            {
-                Layout.fillWidth: true
-
-                Item { Layout.fillWidth: true }
-
-                SquareButton
-                {
-                    Layout.preferredHeight: 36
-                    Layout.preferredWidth: 128
-                    text: qsTr("Download")
-                    icon.source: "qrc:/images/icons/icons8-download.svg"
-                }
-            }
-
-            /** Spacer **/
-            Item { Layout.fillWidth: true; Layout.fillHeight: true }
-
-            RowLayout
-            {
-                Layout.fillWidth: true
-                Layout.alignment: Qt.AlignBottom
-
-                Text {
-                    text: qsTr("Shaders Provided Courtesy of ShaderToy and Their Respective Authors")
-                    elide: Text.ElideLeft
-                    color: palette.text
-                    font.bold: true
-                    font.pixelSize: Constants.h6Font.pixelSize
-
-                    Layout.fillWidth: true
-                    Layout.alignment: Qt.AlignLeft
-                }
-
-                Image
-                {
-                    transform: Image.PreserveAspectFit
-                    source: "qrc:/images/icons/pexels-icon-filled-256.svg"
-
-                    Layout.alignment: Qt.AlignRight
-                    Layout.preferredHeight: 32
-                    Layout.preferredWidth: 32
-                }
-            }
-        }
-    }
-}

KomplexHubModule/Controls/PaginationBox.qml

@@ -1,3 +1,22 @@
+/*
+ *  Komplex Wallpaper Engine
+ *  Copyright (C) 2026 @DigitalArtifex
+ *  https://digitalartifex.dev - https://github.com/DigitalArtifex
+ *
+ *  This program is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program.  If not, see <https://www.gnu.org/licenses/>
+ */
+import QtCore
 import QtQuick
 import QtQuick.Layouts
 import QtQuick.Controls

KomplexHubModule/Controls/PaginatorGrid.qml

@@ -1,3 +1,22 @@
+/*
+ *  Komplex Wallpaper Engine
+ *  Copyright (C) 2026 @DigitalArtifex
+ *  https://digitalartifex.dev - https://github.com/DigitalArtifex
+ *
+ *  This program is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program.  If not, see <https://www.gnu.org/licenses/>
+ */
+import QtCore
 import QtQuick
 import QtQuick.Controls
 import QtQuick.Layouts
@@ -5,7 +24,7 @@ import QtQuick.Layouts
 import KomplexHub
 import KomplexHub.Controls
 import KomplexHub.Kero
-import KomplexHubPlugin
+import KomplexHub.Plugin
 
 Item
 {

KomplexHubModule/Controls/SearchBar.qml

@@ -1,9 +1,22 @@
 /*
-This is a UI file (.ui.qml) that is intended to be edited in Qt Design Studio only.
-It is supposed to be strictly declarative and only uses a subset of QML. If you edit
-this file manually, you might introduce QML code that is not supported by Qt Design Studio.
-Check out https://doc.qt.io/qtcreator/creator-quick-ui-forms.html for details on .ui.qml files.
-*/
+ *  Komplex Wallpaper Engine
+ *  Copyright (C) 2026 @DigitalArtifex
+ *  https://digitalartifex.dev - https://github.com/DigitalArtifex
+ *
+ *  This program is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program.  If not, see <https://www.gnu.org/licenses/>
+ */
+import QtCore
 import QtQuick
 import QtQuick.Controls
 import QtQuick.Layouts

KomplexHubModule/Controls/SearchResultItem.qml

@@ -1,3 +1,22 @@
+/*
+ *  Komplex Wallpaper Engine
+ *  Copyright (C) 2026 @DigitalArtifex
+ *  https://digitalartifex.dev - https://github.com/DigitalArtifex
+ *
+ *  This program is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program.  If not, see <https://www.gnu.org/licenses/>
+ */
+import QtCore
 import QtQuick
 import QtQuick.Controls
 import QtQuick.Layouts
@@ -16,7 +35,7 @@ Item {
     signal triggered
     signal viewMoreTriggered
 
-    id: mainItem
+    id: rootItem
     width: 256
     height: 256
     clip: true
@@ -48,7 +67,7 @@ Item {
             onReleased: () => {
                 if(!states.selected)
                 {
-                    mainItem.triggered()
+                    rootItem.triggered()
                 }
             }
         }
@@ -57,47 +76,13 @@ Item {
         {
             anchors.fill: parent
 
-            Rectangle
+            ImageFrame
             {
                 Layout.preferredWidth: 250
                 Layout.preferredHeight: 141
                 Layout.alignment: Qt.AlignHCenter | Qt.AlignTop
                 Layout.topMargin: 3
-
-                border.color: palette.alternateBase.lighter(1.75)
-
-                color: palette.base.lighter(1.25)
-
-                Throbber
-                {
-                    anchors.fill: parent
-                    id: loadingThrobber
-                    visible: viewImage.status === Image.Loading
-                }
-
-                Image
-                {
-                    property int retries: 0
-                    id: viewImage
-                    anchors.fill: parent
-                    source: mainItem.thumbnail
-                    visible: !(status === Image.Loading)
-                    fillMode: Image.PreserveAspectCrop
-
-                    onStatusChanged: () =>
-                    {
-                        // if(status === Image.Error)
-                        // {
-                        //     if(retries <= 3)
-                        //     {
-                        //         ++retries
-                        //         let src = source
-                        //         source = ""
-                        //         source = src
-                        //     }
-                        // }
-                    }
-                }
+                source: rootItem.thumbnail
 
                 Image
                 {
@@ -108,18 +93,18 @@ Item {
 
                     width: 24
                     height: 24
-                    transform: Image.PreserveAspectFit
+                    fillMode: Image.PreserveAspectFit
                     opacity: 0.5
                     source: "qrc:/images/icons/pexels-icon-filled-256.svg"
 
-                    visible: mainItem.pexels
+                    visible: rootItem.pexels
                 }
             }
 
             Text
             {
                 color: palette.text
-                text: mainItem.title
+                text: rootItem.title
 
                 font.pixelSize: 16
                 font.bold: true
@@ -131,25 +116,13 @@ Item {
 
             Item { Layout.fillHeight: true }
 
-            Text
-            {
-                color: palette.text
-                font.pixelSize: 12
-                text: "By: " + mainItem.author
-                leftPadding: 12
-
-                Layout.alignment: Qt.AlignLeft | Qt.AlignBottom
-                Layout.preferredWidth: 250
-                visible: !mainItem.pexels
-            }
-
             Text
             {
                 id: descriptionText
                 clip: true
                 color: palette.text
                 font.pixelSize: 12
-                text: mainItem.description
+                text: rootItem.description
                 wrapMode: Text.WrapAtWordBoundaryOrAnywhere
                 textFormat: Text.PlainText
                 elide: Text.ElideRight
@@ -162,6 +135,19 @@ Item {
                 Layout.bottomMargin: 3
             }
 
+            Text
+            {
+                color: palette.text
+                font.pixelSize: 12
+                text: "By: " + rootItem.author
+                leftPadding: Constants.mediumMargin
+                rightPadding: Constants.mediumMargin
+                horizontalAlignment: Qt.AlignRight
+
+                Layout.alignment: Qt.AlignLeft | Qt.AlignBottom
+                Layout.fillWidth: true
+            }
+
             SquareButton
             {
                 id: viewMoreButton
@@ -176,7 +162,7 @@ Item {
                 opacity: 0
 
                 onTriggered: () => {
-                    mainItem.viewMoreTriggered()
+                    rootItem.viewMoreTriggered()
                 }
             }
 
@@ -189,7 +175,7 @@ Item {
         id: states
         property bool clicked: false
         property bool hovered: false
-        property alias selected: mainItem.selected
+        property alias selected: rootItem.selected
         property bool idle: true
 
         onIdleChanged: () =>

KomplexHubModule/Controls/SearchResultList.qml

@@ -1,3 +1,22 @@
+/*
+ *  Komplex Wallpaper Engine
+ *  Copyright (C) 2026 @DigitalArtifex
+ *  https://digitalartifex.dev - https://github.com/DigitalArtifex
+ *
+ *  This program is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program.  If not, see <https://www.gnu.org/licenses/>
+ */
+import QtCore
 import QtQuick
 import QtQuick.Controls
 import QtQuick.Layouts

KomplexHubModule/Controls/SquareButton.qml

@@ -1,3 +1,22 @@
+/*
+ *  Komplex Wallpaper Engine
+ *  Copyright (C) 2026 @DigitalArtifex
+ *  https://digitalartifex.dev - https://github.com/DigitalArtifex
+ *
+ *  This program is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program.  If not, see <https://www.gnu.org/licenses/>
+ */
+import QtCore
 import QtQuick
 import QtQuick.Controls
 import QtQuick.Layouts

KomplexHubModule/Controls/Throbber.qml

@@ -1,3 +1,22 @@
+/*
+ *  Komplex Wallpaper Engine
+ *  Copyright (C) 2026 @DigitalArtifex
+ *  https://digitalartifex.dev - https://github.com/DigitalArtifex
+ *
+ *  This program is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program.  If not, see <https://www.gnu.org/licenses/>
+ */
+import QtCore
 import QtQuick
 import QtQuick.Shapes
 import QtQuick.Effects

KomplexHubModule/Controls/VerticalSpacer.qml

@@ -0,0 +1,28 @@
+/*
+ *  Komplex Wallpaper Engine
+ *  Copyright (C) 2026 @DigitalArtifex
+ *  https://digitalartifex.dev - https://github.com/DigitalArtifex
+ *
+ *  This program is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program.  If not, see <https://www.gnu.org/licenses/>
+ */
+import QtCore
+import QtQuick
+import QtQuick.Layouts
+
+Rectangle
+{
+    Layout.fillHeight: true
+
+    color: "transparent"
+}

KomplexHubModule/Controls/VideoView.qml

@@ -1,191 +0,0 @@
-import QtQuick
-import QtQuick.Controls
-import QtQuick.Layouts
-import QtQuick.Effects
-
-import KomplexHub
-import KomplexHub.Controls
-import KomplexHub.Kero
-import KomplexHubPlugin
-
-Item
-{
-    property string uuid
-    property string author
-    property string authorUrl
-    property string thumbnail
-    property alias model: downloadSelector.model
-    property int modelIndex
-
-    property int imageHeight
-    property int imageWidth
-
-    visible: opacity > 0.01
-    onVisibleChanged: () =>
-    {
-        if(!visible)
-        {
-            model = null
-        }
-    }
-
-    Connections
-    {
-        target: model
-
-        function onRowCountChanged()
-        {
-            downloadSelector.currentIndex = 0
-        }
-    }
-
-    id: rootItem
-
-    Rectangle
-    {
-        anchors.fill: parent
-        color: palette.base
-
-        Image
-        {
-            id: backgroundImage
-            source: thumbnail
-            anchors.fill: parent
-            visible: false
-            fillMode: Image.PreserveAspectFit
-        }
-
-        MultiEffect
-        {
-            anchors.fill: backgroundImage
-            source: backgroundImage
-            blurEnabled: true
-            blurMax: 64
-            blur: 1.0
-            opacity: 0.25
-            saturation: -0.8
-        }
-
-        ColumnLayout
-        {
-            anchors.fill: parent
-            anchors.margins: Constants.largeMargin
-            spacing: Constants.largeMargin
-
-            RowLayout
-            {
-                Layout.fillWidth: true
-                Layout.alignment: Qt.AlignTop| Qt.AlignHCenter
-                Layout.topMargin: 32
-
-                Rectangle
-                {
-                    Layout.fillWidth: true
-                    Layout.preferredHeight: width / 1.77777777778
-                    Layout.maximumWidth: 800
-                    Layout.alignment: Qt.AlignHCenter
-                    color: palette.base.darker()
-
-                    Throbber
-                    {
-                        anchors.fill: parent
-                        id: loadingThrobber
-                        visible: viewImage.status === Image.Loading
-                    }
-
-                    Image
-                    {
-                        id: viewImage
-                        anchors.fill: parent
-                        source: rootItem.thumbnail
-                        visible: !(status === Image.Loading)
-                        fillMode: Image.PreserveAspectCrop
-                    }
-                }
-            }
-
-            Text
-            {
-                id: titleText
-                text: rootItem.author
-                color: palette.text
-                font.bold: true
-                font.pixelSize: Constants.h3Font.pixelSize
-                elide: Text.ElideRight
-
-                Layout.fillWidth: true
-                Layout.alignment: Qt.AlignTop| Qt.AlignLeft
-            }
-
-            /** Spacer **/
-            Item
-            {
-                Layout.fillWidth: true
-                Layout.preferredHeight: 32
-            }
-
-            Text
-            {
-                text: qsTr("Available Downloads")
-                color: palette.text
-                font.bold: true
-                font.pixelSize: Constants.h3Font.pixelSize
-                elide: Text.ElideRight
-
-                Layout.fillWidth: true
-                Layout.alignment: Qt.AlignTop| Qt.AlignLeft
-            }
-
-            RowLayout
-            {
-                Layout.fillWidth: true
-
-                ComboBox
-                {
-                    id: downloadSelector
-                    textRole: "text"
-                    valueRole: "url"
-                    Layout.fillWidth: true
-                    Layout.preferredHeight: 36
-                }
-                SquareButton
-                {
-                    Layout.preferredHeight: 36
-                    Layout.preferredWidth: 128
-                    text: qsTr("Download")
-                    icon.source: "qrc:/images/icons/icons8-download.svg"
-                }
-            }
-
-            /** Spacer **/
-            Item { Layout.fillWidth: true; Layout.fillHeight: true }
-
-            RowLayout
-            {
-                Layout.fillWidth: true
-                Layout.alignment: Qt.AlignBottom
-
-                Text {
-                    text: qsTr("Videos Provided Courtesy of Pexels and Their Respective Authors")
-                    elide: Text.ElideLeft
-                    color: palette.text
-                    font.bold: true
-                    font.pixelSize: Constants.h6Font.pixelSize
-
-                    Layout.fillWidth: true
-                    Layout.alignment: Qt.AlignLeft
-                }
-
-                Image
-                {
-                    transform: Image.PreserveAspectFit
-                    source: "qrc:/images/icons/pexels-icon-filled-256.svg"
-
-                    Layout.alignment: Qt.AlignRight
-                    Layout.preferredHeight: 32
-                    Layout.preferredWidth: 32
-                }
-            }
-        }
-    }
-}

KomplexHubModule/EventListModel.qml

@@ -1,12 +0,0 @@
-import QtQuick
-
-ListModel {
-    id: eventListModel
-
-    ListElement {
-        eventId: "enterPressed"
-        eventDescription: "Emitted when pressing the enter button"
-        shortcut: "Return"
-        parameters: "Enter"
-    }
-}

KomplexHubModule/EventListSimulator.qml

@@ -1,22 +0,0 @@
-import QtQuick
-import QtQuick.Studio.EventSimulator
-import QtQuick.Studio.EventSystem
-
-QtObject {
-    id: simulator
-    property bool active: true
-
-    property Timer __timer: Timer {
-        id: timer
-        interval: 100
-        onTriggered: {
-            EventSimulator.show()
-        }
-    }
-
-    Component.onCompleted: {
-        EventSystem.init(Qt.resolvedUrl("EventListModel.qml"))
-        if (simulator.active)
-            timer.start()
-    }
-}

KomplexHubModule/Kero/CMakeLists.txt

@@ -1,5 +1,5 @@
-qt_add_library(KomplexHubModule_Kero STATIC)
-qt6_add_qml_module(KomplexHubModule_Kero
+qt_add_library(KomplexHubKero STATIC)
+qt6_add_qml_module(KomplexHubKero
     URI "KomplexHub.Kero"
     VERSION 1.0
     RESOURCE_PREFIX "/qt/qml"
@@ -11,4 +11,7 @@ qt6_add_qml_module(KomplexHubModule_Kero
         "KeroLoadingAnimation.qml"
         "KeroNoResultsAvatar.qml"
         "KeroWarningAvatar.qml"
-)
+        "KeroHeader.qml"
+        "KeroSuccessAvatar.qml"
+)
+#set_target_properties(KomplexHubKero PROPERTIES VERSION "1.0")

KomplexHubModule/Kero/KeroBuildingAnimation.qml

@@ -1,12 +1,30 @@
+/*
+ *  Komplex Wallpaper Engine
+ *  Copyright (C) 2026 @DigitalArtifex
+ *  https://digitalartifex.dev - https://github.com/DigitalArtifex
+ *
+ *  This program is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program.  If not, see <https://www.gnu.org/licenses/>
+ */
 import QtQuick
 import QtQuick.Controls
 import QtQuick.Layouts
 import KomplexHub
 
 Item {
-    property string title: qsTr("Loading")
-    property string description: qsTr("Kero is busy looking for wallpapers..we promise")
-    property color color: palette.window
+    property string title: qsTr("Building")
+    property string description: qsTr("Kero is getting your wallpaper ready")
+    property color color: "transparent"
 
     id: keroLoadingOverlayRoot
 

KomplexHubModule/Kero/KeroChoiceAvatar.qml

@@ -1,3 +1,21 @@
+/*
+ *  Komplex Wallpaper Engine
+ *  Copyright (C) 2026 @DigitalArtifex
+ *  https://digitalartifex.dev - https://github.com/DigitalArtifex
+ *
+ *  This program is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program.  If not, see <https://www.gnu.org/licenses/>
+ */
 import QtQuick
 import QtQuick.Controls
 import QtQuick.Layouts

KomplexHubModule/Kero/KeroErrorAvatar.qml

@@ -1,3 +1,21 @@
+/*
+ *  Komplex Wallpaper Engine
+ *  Copyright (C) 2026 @DigitalArtifex
+ *  https://digitalartifex.dev - https://github.com/DigitalArtifex
+ *
+ *  This program is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program.  If not, see <https://www.gnu.org/licenses/>
+ */
 import QtQuick
 import QtQuick.Controls
 import QtQuick.Layouts

KomplexHubModule/Kero/KeroHeader.qml

@@ -0,0 +1,100 @@
+/*
+ *  Komplex Wallpaper Engine
+ *  Copyright (C) 2026 @DigitalArtifex
+ *  https://digitalartifex.dev - https://github.com/DigitalArtifex
+ *
+ *  This program is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program.  If not, see <https://www.gnu.org/licenses/>
+ */
+import QtQuick
+import QtQuick.Controls 2.0
+import QtQuick.Layouts
+import KomplexHub
+
+Item
+{
+    property string title: qsTr("Wallpaper Spotlight")
+    property string description: qsTr("Featured Images and Live Wallpaper Packs")
+    property color color: palette.alternateBase
+    property string image: "qrc:/images/kero/kero_spotlight.png"
+
+    id: rootItem
+
+    Rectangle
+    {
+        anchors.fill: parent
+        color: rootItem.color
+        border.color: palette.midlight
+
+        RowLayout
+        {
+            anchors.fill: parent
+
+            Item
+            {
+                Layout.fillHeight: true
+                Layout.fillWidth: true
+            }
+
+            Rectangle
+            {
+                Layout.fillHeight: true
+                Layout.preferredWidth: height
+                Layout.alignment: Qt.AlignLeft
+
+                color: "transparent"
+
+                Image
+                {
+                    anchors.fill: parent
+
+                    source: image
+                    antialiasing: true
+                    fillMode: Image.PreserveAspectFit
+                }
+            }
+
+            ColumnLayout
+            {
+                Layout.fillHeight: true
+                Layout.fillWidth: true
+                Layout.alignment: Qt.AlignLeft
+
+                Text
+                {
+                    color: palette.text
+                    text: rootItem.title
+                    font: Constants.h1Font
+
+                    Layout.alignment: Qt.AlignHCenter | Qt.AlignBottom
+                }
+
+                Text
+                {
+                    id: errorText
+                    text: rootItem.description
+                    color: palette.text.darker()
+
+                    Layout.alignment: Qt.AlignHCenter | Qt.AlignBottom
+                    Layout.bottomMargin: Constants.largeMargin
+                }
+            }
+
+            Item
+            {
+                Layout.fillHeight: true
+                Layout.fillWidth: true
+            }
+        }
+    }
+}

KomplexHubModule/Kero/KeroHelloAvatar.qml

@@ -1,3 +1,21 @@
+/*
+ *  Komplex Wallpaper Engine
+ *  Copyright (C) 2026 @DigitalArtifex
+ *  https://digitalartifex.dev - https://github.com/DigitalArtifex
+ *
+ *  This program is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program.  If not, see <https://www.gnu.org/licenses/>
+ */
 import QtQuick
 import QtQuick.Controls
 import QtQuick.Layouts

KomplexHubModule/Kero/KeroLoadingAnimation.qml

@@ -1,3 +1,21 @@
+/*
+ *  Komplex Wallpaper Engine
+ *  Copyright (C) 2026 @DigitalArtifex
+ *  https://digitalartifex.dev - https://github.com/DigitalArtifex
+ *
+ *  This program is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program.  If not, see <https://www.gnu.org/licenses/>
+ */
 import QtQuick
 import QtQuick.Controls
 import QtQuick.Layouts

KomplexHubModule/Kero/KeroNoResultsAvatar.qml

@@ -1,3 +1,21 @@
+/*
+ *  Komplex Wallpaper Engine
+ *  Copyright (C) 2026 @DigitalArtifex
+ *  https://digitalartifex.dev - https://github.com/DigitalArtifex
+ *
+ *  This program is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program.  If not, see <https://www.gnu.org/licenses/>
+ */
 import QtQuick
 import QtQuick.Controls
 import QtQuick.Layouts

KomplexHubModule/Kero/KeroSuccessAvatar.qml

@@ -0,0 +1,84 @@
+/*
+ *  Komplex Wallpaper Engine
+ *  Copyright (C) 2026 @DigitalArtifex
+ *  https://digitalartifex.dev - https://github.com/DigitalArtifex
+ *
+ *  This program is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program.  If not, see <https://www.gnu.org/licenses/>
+ */
+import QtQuick
+import QtQuick.Controls
+import QtQuick.Layouts
+
+import KomplexHub
+
+Item {
+    property string title: qsTr("Success!")
+    property string description: qsTr("Your new wallpaper is ready!")
+    property color color: "transparent"
+
+    id: keroHelloAvatarRoot
+
+    Rectangle {
+        id: keroHelloAvatarBackground
+        anchors.fill: parent
+        color: keroHelloAvatarRoot.color
+
+        ColumnLayout {
+            anchors.fill: parent
+
+            Rectangle {
+                Layout.fillHeight: true
+                Layout.fillWidth: true
+                Layout.minimumWidth: 64
+                Layout.minimumHeight: 64
+                Layout.maximumWidth: 512
+                Layout.maximumHeight: 512
+                Layout.alignment: Qt.AlignCenter
+
+                color: "transparent"
+
+                Image {
+                    anchors.fill: parent
+
+                    source: "qrc:/images/kero/kero_success.png"
+                    antialiasing: true
+                    fillMode: Image.PreserveAspectFit
+                }
+
+                ColumnLayout {
+                    anchors.bottom: parent.bottom
+                    anchors.left: parent.left
+                    anchors.right: parent.right
+
+                    Text {
+                        color: palette.text
+                        text: keroHelloAvatarRoot.title
+                        font: Constants.h1Font
+
+                        Layout.alignment: Qt.AlignHCenter | Qt.AlignBottom
+                    }
+
+                    Text {
+                        id: errorText
+                        text: keroHelloAvatarRoot.description
+                        color: palette.text.darker()
+
+                        Layout.alignment: Qt.AlignHCenter | Qt.AlignBottom
+                        Layout.bottomMargin: Constants.largeMargin
+                    }
+                }
+            }
+        }
+    }
+}

KomplexHubModule/Kero/KeroWarningAvatar.qml

@@ -1,3 +1,21 @@
+/*
+ *  Komplex Wallpaper Engine
+ *  Copyright (C) 2026 @DigitalArtifex
+ *  https://digitalartifex.dev - https://github.com/DigitalArtifex
+ *
+ *  This program is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program.  If not, see <https://www.gnu.org/licenses/>
+ */
 import QtQuick
 import QtQuick.Controls
 import QtQuick.Layouts
@@ -6,7 +24,7 @@ import KomplexHub
 Item {
     property string title: qsTr("Warning")
     property string description: qsTr("Kero noticed there might be an issue")
-    property color color: palette.window
+    property color color: "transparent"
 
     id: keroWarningAvatarRoot
 

KomplexHubModule/WallpaperModelData.qml

@@ -1,67 +0,0 @@
-import QtQuick
-import QtQuick.Controls
-
-ListModel {
-    ListElement {
-        author: "Wizmart"
-        name: "Some cool name 1"
-        description: "This is not a real wallpaper or person"
-        thumbnail: ""
-        uuid: "{aafd-311-afaa}"
-        url: ""
-    }
-
-    ListElement {
-        author: "Wizmart"
-        name: "Some cool name 2"
-        description: "This is not a real wallpaper or person"
-        thumbnail: ""
-        uuid: "{aafd-311-afaa}"
-        url: ""
-    }
-
-    ListElement {
-        author: "Wizmart"
-        name: "Some cool name 3"
-        description: "This is not a real wallpaper or person"
-        thumbnail: ""
-        uuid: "{aafd-311-afaa}"
-        url: ""
-    }
-
-    ListElement {
-        author: "Wizmart"
-        name: "Some cool name 4"
-        description: "This is not a real wallpaper or person"
-        thumbnail: ""
-        uuid: "{aafd-311-afaa}"
-        url: ""
-    }
-
-    ListElement {
-        author: "Wizmart"
-        name: "Some cool name 5"
-        description: "This is not a real wallpaper or person"
-        thumbnail: ""
-        uuid: "{aafd-311-afaa}"
-        url: ""
-    }
-
-    ListElement {
-        author: "Wizmart"
-        name: "Some cool name 6"
-        description: "This is not a real wallpaper or person"
-        thumbnail: ""
-        uuid: "{aafd-311-afaa}"
-        url: ""
-    }
-
-    ListElement {
-        author: "Wizmart"
-        name: "Some cool name 7"
-        description: "This is not a real wallpaper or person"
-        thumbnail: ""
-        uuid: "{aafd-311-afaa}"
-        url: ""
-    }
-}

KomplexHubPlugin/CMakeLists.txt

@@ -1,12 +1,38 @@
+find_package(
+  Qt6
+    REQUIRED COMPONENTS
+      Core
+      Gui
+      GuiPrivate
+      Widgets
+      Qml
+      Quick
+      QuickControls2
+      QuickTimeline
+      ShaderTools
+      ShaderToolsPrivate
+      Concurrent
+)
+
+find_package(
+  OpenGL REQUIRED COMPONENTS OpenGL
+)
+
+find_package(
+  Vulkan REQUIRED COMPONENTS glslang SPIRV-Tools
+)
+
 add_library(
     KomplexHubPlugin
     STATIC
 )
 
+set_target_properties(KomplexHubPlugin PROPERTIES VERSION "1.0")
+
 qt_add_qml_module(
     KomplexHubPlugin
     URI
-        KomplexHubPlugin
+        "KomplexHub.Plugin"
     VERSION
         1.0
     SOURCES
@@ -56,9 +82,13 @@ qt_add_qml_module(
       common/shaderpack.h
       packcompiler.h
       packcompiler.cpp
-      SOURCES common/userservices.h
-      SOURCES common/userservices.cpp
-      SOURCES common/qwallet.h common/qwallet.cpp
+      common/userservices.h
+      common/userservices.cpp
+      common/qwallet.h
+      common/qwallet.cpp
+      usermodel.h 
+      usermodel.cpp
+      SOURCES
 )
 
 target_compile_definitions(
@@ -70,8 +100,13 @@ target_compile_definitions(
 add_subdirectory(3rdparty/qtkeychain)
 
 target_link_libraries(KomplexHubPlugin PRIVATE
-    Qt${QT_VERSION_MAJOR}::Core
-    Qt${QT_VERSION_MAJOR}::Gui
+    Qt6::Core
+    Qt6::Concurrent
+    Qt6::Gui
+    Qt6::GuiPrivate
+    Qt6::ShaderTools
+    Qt6::ShaderToolsPrivate
+    Vulkan::Vulkan
     qt6keychain
 )
 

KomplexHubPlugin/common/coreservices.cpp

@@ -1,5 +1,6 @@
 #include "coreservices.h"
 #include "logging.h"
+#include "userservices.h"
 
 QNetworkAccessManager *CoreServices::s_networkAccessManager = nullptr;
 QMutex CoreServices::s_networkAccessMutex;
@@ -11,28 +12,31 @@ auto CoreServices::networkAccessManager() -> QWeakPointer<QNetworkAccessManager>
 
     if(!s_networkAccessPointer)
     {
-        s_networkAccessManager = new QNetworkAccessManager(QCoreApplication::instance());
-        s_networkAccessManager->setAutoDeleteReplies(true);
+        if(!s_networkAccessManager)
+        {
+            s_networkAccessManager = new QNetworkAccessManager(QCoreApplication::instance());
+            s_networkAccessManager->setAutoDeleteReplies(true);
 
-        QObject::connect(
-            s_networkAccessManager,
-            &QNetworkAccessManager::sslErrors,
-            s_networkAccessManager,
-            [] (QNetworkReply *reply, const QList<QSslError> &errors)
-            {
-                for(const auto &error : errors)
+            QObject::connect(
+                s_networkAccessManager,
+                &QNetworkAccessManager::sslErrors,
+                s_networkAccessManager,
+                [] (QNetworkReply *reply, const QList<QSslError> &errors)
                 {
-                    LOG_ERROR(
-                        "CoreServices::networkAccessManager",
-                        error.errorString().toStdString().c_str()
-                    );
-                }
+                    for(const auto &error : errors)
+                    {
+                        LOG_ERROR(
+                            "CoreServices::networkAccessManager",
+                            error.errorString().toStdString().c_str()
+                        );
+                    }
 
-#ifdef KOMPLEX_LOCAL_DEV
-                reply->ignoreSslErrors();
-#endif
-            }
-        );
+    #ifdef KOMPLEX_LOCAL_DEV
+                    reply->ignoreSslErrors();
+    #endif
+                }
+            );
+        }
 
         s_networkAccessPointer = QSharedPointer<QNetworkAccessManager>(
             s_networkAccessManager,
@@ -45,11 +49,7 @@ auto CoreServices::networkAccessManager() -> QWeakPointer<QNetworkAccessManager>
 
 auto CoreServices::sessionToken() -> QByteArray
 {
-    LOG_ERROR_X(true,
-        "CoreServices::sessionToken",
-        "User services not yet implemented",
-        {}
-    );
+    return UserServices::userCredentials().sessionToken;
 }
 
 auto CoreServices::screenSize() -> QSize

KomplexHubPlugin/common/exceptions.h

@@ -19,36 +19,197 @@
 #ifndef EXCEPTIONS_H
 #define EXCEPTIONS_H
 #include <QString>
-#include <exception>
+#include <string>
+#include <filesystem>
 #include "komplex_global.h"
 
-struct KOMPLEX_EXPORT Exception : std::exception
+struct KOMPLEX_EXPORT network_exception : std::ios_base::failure
 {
-    explicit Exception(const QString &message, quint16 errorCode = 0)
-        : std::exception(), message(message), errorCode(errorCode){}
+    network_exception(const std::string &message, const std::string &details, const std::error_code &code) :
+        details(details),
+        std::ios_base::failure(message, code) { }
 
-    const QString message;
-    const quint16 errorCode;
+    network_exception(const std::string &message, const std::error_code &code) :
+        std::ios_base::failure(message, code) { }
+
+    network_exception(const QString &message, const QString &details, const std::error_code &code) :
+        details(details.toStdString()),
+        std::ios_base::failure(message.toStdString(), code) { }
+
+    network_exception(const QString &message, const int code = errno) :
+        std::ios_base::failure
+        (
+            message.toStdString(),
+            std::error_code
+            (
+                code,
+                std::system_category()
+            )
+        ) { }
+
+    const std::string details;
 };
 
-struct KOMPLEX_EXPORT NetworkException : Exception
+struct KOMPLEX_EXPORT file_exception : std::filesystem::filesystem_error
 {
-    NetworkException(const QString &message, qsizetype errorCode = 0) : Exception(message, errorCode) {}
+    file_exception(const std::string &message, const std::string &details, const std::error_code &code) :
+        details(details),
+        std::filesystem::filesystem_error(message, code) { }
+
+    file_exception(const std::string &message, const std::error_code &code) :
+        std::filesystem::filesystem_error(message, code) { }
+
+    file_exception(const std::string &message, const int code = errno) :
+        std::filesystem::filesystem_error
+        (
+            message,
+            std::error_code
+            (
+                code,
+                std::system_category()
+            )
+        ) { }
+
+    file_exception(const std::string &message, const std::string &details, const int code = errno) :
+        details(details),
+        std::filesystem::filesystem_error
+        (
+            message,
+            std::error_code
+            (
+                code,
+                std::system_category()
+            )
+        ) { }
+
+    const std::string details;
 };
-struct KOMPLEX_EXPORT FileException : Exception
+
+struct KOMPLEX_EXPORT sql_exception : std::ios_base::failure
 {
-    FileException(const QString &message, qsizetype errorCode = 0) : Exception(message, errorCode) {}
+    sql_exception(const std::string &message, const std::string &details, const std::error_code &code) :
+        details(details),
+        std::ios_base::failure(message, code) { }
+
+    sql_exception(const std::string &message, const std::error_code &code) :
+        std::ios_base::failure(message, code) { }
+
+    sql_exception(const std::string &message, const int code = errno) :
+        std::ios_base::failure
+        (
+            message,
+            std::error_code
+            (
+                code,
+                std::system_category()
+            )
+        ) { }
+
+    const std::string details;
 };
-struct KOMPLEX_EXPORT SqlException : Exception
+
+struct KOMPLEX_EXPORT wallet_exception : std::ios_base::failure
 {
-    SqlException(const QString &message, qsizetype errorCode = 0) : Exception(message, errorCode) {}
+    wallet_exception(const std::string &message, const std::string &details, const std::error_code &code) :
+        details(details),
+        std::ios_base::failure(message, code) { }
+
+    wallet_exception(const std::string &message, const std::error_code &code) :
+        std::ios_base::failure(message, code) { }
+
+    wallet_exception(const std::string &message, const std::string &details, const int code = errno) :
+        details(details),
+        std::ios_base::failure
+        (
+            message,
+            std::error_code
+            (
+                code,
+                std::system_category()
+            )
+        ) { }
+
+    wallet_exception(const std::string &message, const int code = errno) :
+        std::ios_base::failure
+        (
+            message,
+            std::error_code
+            (
+                code,
+                std::system_category()
+            )
+        ) { }
+
+    const std::string details;
 };
-struct KOMPLEX_EXPORT WalletException : Exception
+
+struct KOMPLEX_EXPORT process_exception : std::runtime_error
 {
-    WalletException(const QString &message, qsizetype errorCode = 0) : Exception(message, errorCode) {}
+    process_exception(const std::string &message, const std::string &details, const std::error_code &code) :
+        details(details),
+        code(code),
+        std::runtime_error(message) { }
+
+    process_exception(const std::string &message, const std::error_code &code) :
+        code(code),
+        std::runtime_error(message) { }
+
+    process_exception(const std::string &message, const int code = errno) :
+        code
+        (
+            std::error_code
+            (
+                code,
+                std::system_category()
+            )
+        ),
+        std::runtime_error
+        (
+            message
+        ) { }
+
+    process_exception(const std::string &message, const std::string &details, const int code = errno) :
+        details(details),
+        code
+        (
+            std::error_code
+            (
+                code,
+                std::system_category()
+            )
+        ),
+        std::runtime_error (message) { }
+
+    const std::string details;
+    const std::error_code code;
 };
-struct KOMPLEX_EXPORT ShaderCompilerException : Exception
+
+namespace shader
 {
-    ShaderCompilerException(const QString &message, qsizetype errorCode = 0) : Exception(message, errorCode) {}
-};
+    struct KOMPLEX_EXPORT logic_error : std::logic_error
+    {
+        logic_error(const std::string &message, const std::string &details, const std::error_code &code) :
+            details(details),
+            code(code),
+            std::logic_error(message) { }
+
+        logic_error(const std::string &message, const std::error_code &code) :
+            code(code),
+            std::logic_error(message) { }
+
+        logic_error(const std::string &message, const std::string &details = {}, const int code = errno) :
+            code
+            (
+                std::error_code
+                (
+                    code,
+                    std::system_category()
+                )
+            ),
+            std::logic_error(message) { }
+
+        const std::string details;
+        const std::error_code code;
+    };
+}
 #endif // EXCEPTIONS_H

KomplexHubPlugin/common/komplex_global.h

@@ -69,14 +69,9 @@ inline const QString KOMPLEX_ENDPOINT_USER_AUTH               = QStringLiteral("
 
 inline const qsizetype nullsize                               = std::numeric_limits<qsizetype>::min();
 inline const std::chrono::milliseconds KOMPLEX_RATE_LIMIT(500);
-inline const QString KOMPLEX_KEYCHAIN_PASSWORD_KEY = QStringLiteral
+inline const QString KOMPLEX_KEYCHAIN_SERVICE_NAME = QStringLiteral
 (
-    "com.digitalartifex.komplex.keychain.password"
-);
-
-inline const QString KOMPLEX_KEYCHAIN_TOKEN_KEY = QStringLiteral
-(
-    "com.digitalartifex.komplex.keychain.token"
+    "com.digitalartifex.komplex"
 );
 
 #endif // KOMPLEX_GLOBAL_H

KomplexHubPlugin/common/qwallet.cpp

@@ -1,5 +1,6 @@
 #include "qwallet.h"
 #include "../3rdparty/qtkeychain/qtkeychain/keychain.h"
+#include "common/exceptions.h"
 
 auto QWallet::read(const QString &service, const QString &key) const -> QFuture<QByteArray>
 {
@@ -29,7 +30,11 @@ auto QWallet::read(const QString &service, const QString &key) const -> QFuture<
                     else
                     {
                         m_errorString = qPrintable(j->errorString());
-                        throw std::exception();
+                        throw wallet_exception
+                        (
+                            QStringLiteral("Wallet read error").toStdString(),
+                            errorString().toStdString()
+                        );
                     }
 
                     loop.quit();
@@ -65,11 +70,15 @@ auto QWallet::write(const QString &service, const QString &key, const QByteArray
                 this,
                 [this, key, &loop, &success](QKeychain::Job *job)
                 {
-                    auto j = static_cast<QKeychain::ReadPasswordJob*>(job);
+                    auto j = static_cast<QKeychain::WritePasswordJob*>(job);
                     if (j->error() != QKeychain::NoError)
                     {
                         setErrorString(qPrintable(j->errorString()));
-                        throw std::exception();
+                        throw wallet_exception
+                        (
+                            QStringLiteral("Wallet write error").toStdString(),
+                            errorString().toStdString()
+                        );
                     }
 
                     loop.quit();
@@ -102,7 +111,7 @@ auto QWallet::remove(const QString &service, const QString &key) -> QFuture<void
                 this,
                 [this, key, &loop, &value](QKeychain::Job *job)
                 {
-                    auto j = static_cast<QKeychain::ReadPasswordJob*>(job);
+                    auto j = static_cast<QKeychain::DeletePasswordJob*>(job);
                     if (j->error() != QKeychain::NoError)
                     {
                         m_errorString = qPrintable(j->errorString());
@@ -133,3 +142,8 @@ auto QWallet::errorString() const -> const QString &
 {
     return m_errorString;
 }
+
+auto QWallet::setErrorString(const QString &errorString) const -> void
+{
+    m_errorString = errorString;
+}

KomplexHubPlugin/common/qwallet.h

@@ -30,7 +30,7 @@
  * @brief The QWallet class
  * QWallet is a QFuture wrapper for QtKeychain to make interaction with the keychain easier
  */
-class KOMPLEX_EXPORT QWallet : QObject
+class KOMPLEX_EXPORT QWallet : public QObject
 {
     Q_OBJECT
 

KomplexHubPlugin/common/slidingcachecontroller.h

@@ -337,14 +337,17 @@ private:
             return false;
         }
 
-        qsizetype windowSize = this->windowSize();
+        qsizetype prefetchThreshold = SLIDING_CACHE_PREFETCH_THRESHOLD;
 
-        if(windowSize == 0)
+        if(prefetchThreshold >= windowSize())
         {
-            windowSize = SLIDING_CACHE_WINDOW_SIZE;
+            prefetchThreshold = std::floor
+            (
+                static_cast<qreal>(windowSize()) * 0.8
+            );
         }
 
-        while (index >= m_windowOffset + (SLIDING_CACHE_WINDOW_SIZE - SLIDING_CACHE_PREFETCH_THRESHOLD))
+        while (index >= m_windowOffset + (windowSize() - prefetchThreshold))
         {
             if(!slideForward())
             {
@@ -414,7 +417,7 @@ private:
             m_windowOffset = 0;
         }
 
-        QThread::sleep(KOMPLEX_RATE_LIMIT);
+        // QThread::sleep(KOMPLEX_RATE_LIMIT);
 
         FetchResult<T> result = m_fetch(
             m_windowOffset,
@@ -497,7 +500,7 @@ private:
             false
         );
 
-        QThread::sleep(KOMPLEX_RATE_LIMIT);
+        // QThread::sleep(KOMPLEX_RATE_LIMIT);
 
         m_windowOffset -= movementSize;
 

KomplexHubPlugin/common/userservices.cpp

@@ -1,5 +1,11 @@
 #include "userservices.h"
+#include "common/komplex_global.h"
 #include "coreservices.h"
+#include <QtConcurrent/qtconcurrentrun.h>
+#include <exception>
+#include <qcontainerfwd.h>
+#include <qstandardpaths.h>
+#include <qstringview.h>
 
 UserServices::UserServices(QObject *parent) : QObject(parent)
 {
@@ -8,6 +14,10 @@ UserServices::UserServices(QObject *parent) : QObject(parent)
 
 UserServices::~UserServices()
 {
+    if(m_wallet)
+    {
+        m_wallet->deleteLater();
+    }
 }
 
 auto UserServices::setUserCredentials(const UserCredentials &credentials) -> void
@@ -24,12 +34,135 @@ auto UserServices::errorString() const -> const QString &
 auto UserServices::setErrorString(const QString &errorString) -> void
 {
     if (m_errorString == errorString)
+    {
         return;
+    }
+
     m_errorString = errorString;
     emit errorStringChanged();
 }
 
-auto UserServices::instance() const -> QWeakPointer<UserServices>
+auto UserServices::savePassword(const QString &username, const QByteArray &password) -> void
+{
+    QFuture saveAttempt = m_wallet->write
+    (
+        KOMPLEX_KEYCHAIN_SERVICE_NAME,
+        username,
+        password
+    );
+}
+
+auto UserServices::readPassword(const QString &username) -> QFuture<QByteArray>
+{
+    return m_wallet->read(KOMPLEX_KEYCHAIN_SERVICE_NAME, username);
+}
+
+auto UserServices::readToken(const QString &username) -> QFuture<UserCredentials>
+{
+    return QtConcurrent::run
+    (
+        [this, username] () -> UserCredentials
+        {
+            UserCredentials credentials;
+
+            QFuture readAttempt = m_wallet->read
+            (
+                KOMPLEX_KEYCHAIN_SERVICE_NAME, 
+                username + QStringLiteral("_token")
+            );
+
+            QString _username = username;
+
+            readAttempt
+                .then
+                (
+                    [this, &credentials, _username] (const QByteArray &value) -> void
+                    {
+                        auto parts = value.split(PART_SEPARATOR);
+                        QDateTime expiry;
+
+                        if(parts.count() == 1)
+                        {
+                            setErrorString(QStringLiteral("Token malformed"));
+                            throw std::exception();
+                        }
+
+                        if(parts[0].length() != sizeof(qint64))
+                        {
+                            setErrorString(QStringLiteral("Token expiry malformed"));
+                            throw std::exception();
+                        }
+
+                        QByteArray numericData = parts[0];
+                        qint64 numericConversion = 0;
+
+                        for(int i = 0; i < sizeof(qint64); ++i)
+                        {
+                            numericConversion |= 
+                            (
+                                static_cast<qint64>
+                                (
+                                    (
+                                        static_cast<qint8>(numericData[i]) &
+                                        0xFF
+                                    )
+                                    << (i * sizeof(qint8))
+                                )
+                            );
+                        }
+
+                        expiry = QDateTime::fromMSecsSinceEpoch(numericConversion);
+
+                        if(parts[1].isEmpty() && parts.count() == 3)
+                        {
+                            parts[1] = parts[2];
+                        }
+
+                        credentials = UserCredentials
+                        {
+                            .username = _username.toUtf8(),
+                            .sessionToken = parts[1],
+                            .expiry = expiry
+                        };
+                    }
+                )
+                .onFailed
+                (
+                    [this] () -> void
+                    {
+                        setErrorString(m_wallet->errorString());
+                        throw std::exception();
+                    }
+                );
+
+            readAttempt.waitForFinished();
+
+            return credentials;
+        }
+    );
+}
+
+auto UserServices::saveToken(const QString &username, const QByteArray &token, const QDateTime &expiry) -> void
+{
+    QByteArray data;
+    qint64 numericData = expiry.toMSecsSinceEpoch();
+
+    for(int i = 0; i < sizeof(qint64); ++i)
+    {
+        data[i] = 0xFF & static_cast<qint8>(numericData >> (i * sizeof(qint8)));
+    }
+
+    data += PART_SEPARATOR + token;
+
+    QFuture saveAttempt = m_wallet->write
+    (
+        KOMPLEX_KEYCHAIN_SERVICE_NAME,
+        username + QString("_token"),
+        data
+    );
+}
+
+auto UserServices::instance() -> QWeakPointer<UserServices>
 {
     if(!s_pointer)
     {
@@ -53,16 +186,19 @@ auto UserServices::login(const QString &username, const QByteArray &password) ->
 {
     return QtConcurrent::run
     (
-        [this, username = std::move(username), password = std::move(password)] () -> UserCredentials
+        [this, username, password] () -> UserCredentials
         {
             QSharedPointer<QNetworkAccessManager> manager = CoreServices::networkAccessManager().toStrongRef();
 
             if(!manager)
             {
                 Q_EMIT loginFailed();
-                return {};
+                setErrorString(QStringLiteral("Network manager reference deleted"));
+                throw std::exception();
             }
 
+            saveDefaultUsername(username);
+
             QNetworkRequest request
             (
                 QUrl
@@ -111,14 +247,14 @@ auto UserServices::login(const QString &username, const QByteArray &password) ->
             if(parseError.error != QJsonParseError::NoError)
             {
                 setErrorString(parseError.errorString());
+                throw std::exception();
             }
 
-            QJsonObject rootObject;
+            QJsonObject rootObject = document.object();
+            QJsonObject dataObject = rootObject.value(QStringLiteral("data")).toObject();
 
             if(!rootObject.value("success").toBool())
             {
-                QJsonObject dataObject = rootObject.value(QStringLiteral("data")).toObject();
-
                 setErrorString
                 (
                     QStringLiteral("Login failure (%1): %2").arg
@@ -127,22 +263,100 @@ auto UserServices::login(const QString &username, const QByteArray &password) ->
                         dataObject.value(QStringLiteral("message")).toString()
                     )
                 );
+                throw std::exception();
+            }
+
+            QString expiryData = dataObject.value(QStringLiteral("expires")).toString();
+            bool converted = false;
+            qint64 secsSinceEpoch = expiryData.toLongLong(&converted);
+
+            if(!converted)
+            {
+                setErrorString(QStringLiteral("Malformed expiry data"));
+                throw std::exception();
             }
 
             UserCredentials credentials
             {
                 .username = username.toUtf8(),
-                .sessionToken = rootObject.value
+                .sessionToken = dataObject.value
                 (
                     QStringLiteral("jwt")
                 ).toString().toUtf8(),
-                .expiry = QDateTime::currentDateTime()
+                .expiry = QDateTime::fromSecsSinceEpoch(secsSinceEpoch)
             };
 
+            savePassword(username, password);
+            saveToken(username, credentials.sessionToken, credentials.expiry);
             setUserCredentials(credentials);
 
             Q_EMIT loginComplete();
             return credentials;
         }
     );
+}
+
+auto UserServices::saveDefaultUsername(const QString &username) -> void
+{
+    QDir configDirectory(QStandardPaths::writableLocation(QStandardPaths::AppConfigLocation));
+
+    if(!configDirectory.exists())
+    {
+        if(!configDirectory.mkpath(configDirectory.absolutePath()))
+        {
+            setErrorString(QStringLiteral("Could not make config directory"));
+            throw std::exception();
+        }
+    }
+
+    QFile usernameFile(configDirectory.absoluteFilePath(QStringLiteral("uname")));
+
+    if(!usernameFile.open(QFile::ReadWrite | QFile::Truncate))
+    {
+        setErrorString(QStringLiteral("Could not open uname file"));
+        throw std::exception();
+    }
+
+    QByteArray data = username.toUtf8().toBase64();
+
+    if(usernameFile.write(data) != data.length())
+    {
+        setErrorString(QStringLiteral("Could not write uname file"));
+    }
+
+    usernameFile.close();
+}
+
+auto UserServices::defaultUsername() -> QFuture<QString>
+{
+    return QtConcurrent::run
+    (
+        [this] () -> QString
+        {        
+            QDir configDirectory(QStandardPaths::writableLocation(QStandardPaths::AppConfigLocation));
+
+            if(!configDirectory.exists())
+            {
+                if(!configDirectory.mkpath(configDirectory.absolutePath()))
+                {
+                    setErrorString(QStringLiteral("Could not make config directory"));
+                    throw std::exception();
+                }
+            }
+
+            QFile usernameFile(configDirectory.absoluteFilePath(QStringLiteral("uname")));
+
+            if(!usernameFile.open(QFile::ReadOnly))
+            {
+                setErrorString(QStringLiteral("Could not open uname file"));
+                throw std::exception();
+            }
+
+            QByteArray data = QByteArray::fromBase64(usernameFile.readAll());
+
+            usernameFile.close();
+
+            return QString(data);
+        }
+    );
 }

KomplexHubPlugin/common/userservices.h

@@ -8,6 +8,10 @@
 #include <QJsonDocument>
 #include <QJsonArray>
 #include <QJsonObject>
+#include <QDir>
+#include <QFile>
+#include <QStandardPaths>
+
 #include "komplex_global.h"
 #include "qwallet.h"
 
@@ -32,23 +36,34 @@ struct UserCredentials
                !sessionToken.isEmpty() && sessionToken.isValidUtf8();
     }
 };
+Q_DECLARE_METATYPE(UserCredentials)
 
 class KOMPLEX_EXPORT UserServices : public QObject
 {
     Q_OBJECT
 
 public:
-    auto instance() const -> QWeakPointer<UserServices>;
+    static auto instance() -> QWeakPointer<UserServices>;
     static auto userCredentials() -> const UserCredentials &;
+
+    [[nodiscard]]
     auto login(const QString &username, const QByteArray &password) -> QFuture<UserCredentials>;
 
     auto errorString() const -> const QString &;
 
+    [[nodiscard]]
+    auto readPassword(const QString &username) -> QFuture<QByteArray>;
+
+    [[nodiscard]]
+    auto readToken(const QString &username) -> QFuture<UserCredentials>;
+
+    [[nodiscard]]
+    auto defaultUsername() -> QFuture<QString>;
+
 signals:
     auto loginComplete() -> void;
     auto loginFailed() -> void;
     auto userCredentialsChanged() -> void;
-
     auto errorStringChanged() -> void;
 
 private:
@@ -60,10 +75,17 @@ private:
 
     auto setUserCredentials(const UserCredentials &credentials) -> void;
     auto setErrorString(const QString &errorString) -> void;
+    auto savePassword(const QString &username, const QByteArray &password) -> void;
+    auto saveToken(const QString &username, const QByteArray &token, const QDateTime &expiry) -> void;
+    auto saveDefaultUsername(const QString &username) -> void;
 
     QWallet *m_wallet = nullptr;
     QString m_errorString;
     inline static UserCredentials s_userCredentials;
+
+    inline const static char PART_SEPARATOR = static_cast<char>('\x1f');
+
     Q_PROPERTY(UserCredentials userCredentials READ userCredentials NOTIFY userCredentialsChanged FINAL)
     Q_PROPERTY(QString errorString READ errorString WRITE setErrorString NOTIFY errorStringChanged FINAL)
-};
+};
+Q_DECLARE_METATYPE(UserServices)

KomplexHubPlugin/downloadmanager.h

@@ -68,13 +68,13 @@ public:
      * out of it
      * @param url
      */
-    auto downloadImage
+    Q_INVOKABLE auto downloadImage
     (
         const QString &author,
         const QString &authorId,
         const QString &description,
         const QUrl &url
-    ) noexcept(false) -> void;
+    ) -> void;
 
     /**
      * @brief downloadVideo
@@ -85,13 +85,12 @@ public:
      * @param description
      * @param url
      */
-    auto downloadVideo
+    Q_INVOKABLE auto downloadVideo
     (
         const QString &author,
         const QString &authorId,
-        const QString &description,
         const QUrl &url
-    ) noexcept(false) -> void;
+    ) -> void;
 
     /**
      * @brief downloadPack
@@ -100,13 +99,13 @@ public:
      * @param id
      * @return File info of the installed pack
      */
-    auto downloadPack(const QString &id) noexcept(false) -> void;
+    Q_INVOKABLE auto downloadPack(const QString &id) -> void;
 
     auto compilerOutput() const -> const QString & { return m_compilerOutput; }
     auto errorTitle() const -> const QString & { return m_errorTitle; }
     auto errorMessage() const -> const QString & { return m_errorMessage; }
     auto state() const -> State { return m_state; }
-    auto reset() -> void;
+    Q_INVOKABLE auto reset() -> void;
     auto downloadProgress() -> qreal { return m_downloadProgress; }
     auto compileProgress() -> qreal;
     auto compileSteps() -> qint64;
@@ -118,6 +117,9 @@ public:
     auto downloadedBytes() const -> qint64 { return m_downloadedBytes; }
     auto setDownloadedBytes(qint64 downloadedBytes) -> void;
 
+    auto lastInstalledFile() const -> const QString &;
+    auto setLastInstalledFile(const QString &lastInstalledFile) -> void;
+
 protected:
     auto setError(const QString &title, const QString &message) -> void;
     auto setCompilerOutput(const QString &compilerOutput) -> void;
@@ -136,11 +138,16 @@ signals:
     auto compileStepsChanged() -> void;
     auto compileStepsCompletedChanged() -> void;
 
+    auto lastInstalledFileChanged() -> void;
+
 private:
     auto compile(const QUrl &uri) noexcept(false) -> QUrl;
     auto install(const QUrl &uri) noexcept(false) -> QUrl;
-    auto download(const QNetworkRequest &request, const QString &id, RequestType type = Get) -> QFuture<QUrl>;
+    auto download(const QNetworkRequest &request, const QString &id, RequestType type = Get, const QString &filename = QString()) -> QFuture<QUrl>;
     auto readShaderToyEntry(const QUrl &uri) noexcept(false) -> ShaderToyEntry;
+    auto validateUri(const QUrl &uri) noexcept(false) -> void;
+
+    QString m_lastInstalledFile;
 
     QString m_compilerOutput;
     QString m_errorTitle;
@@ -153,9 +160,14 @@ private:
     State m_state;
 
     QMutex m_downloadMutex;
+    QMutex m_fileMutex;
 
     PackCompiler *m_compiler = nullptr;
 
+    QProcess m_moveProcess;
+
+    QFuture<QUrl> m_downloadFuture;
+
     Q_PROPERTY(QString compilerOutput READ compilerOutput WRITE setCompilerOutput NOTIFY compilerOutputChanged FINAL)
     Q_PROPERTY(QString errorTitle READ errorTitle NOTIFY errorChanged FINAL)
     Q_PROPERTY(QString errorMessage READ errorMessage NOTIFY errorChanged FINAL)
@@ -166,6 +178,7 @@ private:
     Q_PROPERTY(qint64 downloadedBytes READ downloadedBytes WRITE setDownloadedBytes NOTIFY downloadedBytesChanged FINAL)
     Q_PROPERTY(qint64 compileSteps READ compileSteps NOTIFY compileStepsChanged FINAL)
     Q_PROPERTY(qint64 compileStepsCompleted READ compileStepsCompleted NOTIFY compileStepsCompletedChanged FINAL)
+    Q_PROPERTY(QString lastInstalledFile READ lastInstalledFile WRITE setLastInstalledFile NOTIFY lastInstalledFileChanged FINAL)
 };
 Q_DECLARE_METATYPE(DownloadManager)
 

KomplexHubPlugin/featuredimagesmodel.cpp

@@ -5,49 +5,56 @@ FeaturedImagesModel::FeaturedImagesModel(QObject *parent) : QAbstractListModel{p
     m_paginator = new FeaturedImagesPaginator(this);
     PaginationNotifier *notifier = static_cast<PaginationNotifier*>(m_paginator);
 
-    QObject::connect(
+    QObject::connect
+    (
         notifier,
         &PaginationNotifier::resultsPerPageChanged,
         this,
         &FeaturedImagesModel::resultsPerPageChanged
     );
 
-    QObject::connect(
+    QObject::connect
+    (
         notifier,
         &PaginationNotifier::totalResultsChanged,
         this,
         &FeaturedImagesModel::totalResultsChanged
     );
 
-    QObject::connect(
+    QObject::connect
+    (
         notifier,
         &PaginationNotifier::totalPagesChanged,
         this,
         &FeaturedImagesModel::totalPagesChanged
     );
 
-    QObject::connect(
+    QObject::connect
+    (
         notifier,
         &PaginationNotifier::pageChanged,
         this,
         &FeaturedImagesModel::pageChanged
     );
 
-    QObject::connect(
+    QObject::connect
+    (
         notifier,
         &PaginationNotifier::pageChanged,
         this,
         &FeaturedImagesModel::resetDataModel
     );
 
-    QObject::connect(
+    QObject::connect
+    (
         notifier,
         &PaginationNotifier::fetchComplete,
         this,
         &FeaturedImagesModel::resetState
     );
 
-    QObject::connect(
+    QObject::connect
+    (
         notifier,
         &PaginationNotifier::fetching,
         this,
@@ -172,13 +179,19 @@ auto FeaturedImagesModel::state() const -> FeaturedImagesModel::State
 
 auto FeaturedImagesModel::setState(State state) -> void
 {
-    if (m_state == state)
-    {
-        return;
-    }
+    QFuture<void> aether = QtConcurrent::run
+    (
+        [this, state]
+        {
+            if (m_state == state)
+            {
+                return;
+            }
 
-    m_state = state;
-    emit stateChanged();
+            m_state = state;
+            emit stateChanged();
+        }
+    );
 }
 
 auto FeaturedImagesModel::resetState() -> void
@@ -343,3 +356,23 @@ auto FeaturedImagesModel::totalPages() const -> qsizetype
 
     return 0;
 }
+
+auto FeaturedImagesModel::hasNextPage() const -> bool
+{
+    if(m_paginator == nullptr)
+    {
+        return false;
+    }
+
+    return m_paginator->page() < m_paginator->totalPages();
+}
+
+auto FeaturedImagesModel::hasPreviousPage() const -> bool
+{
+    if(m_paginator == nullptr)
+    {
+        return false;
+    }
+
+    return m_paginator->page() > 0;
+}

KomplexHubPlugin/featuredimagesmodel.h

@@ -213,6 +213,20 @@ public:
      */
     Q_INVOKABLE auto previousPage() -> void;
 
+    /**
+     * @brief hasNextPage
+     * Calculates if there are more pages based on the current page calculation
+     * @return
+     */
+    auto hasNextPage() const -> bool;
+
+    /**
+     * @brief hasPreviousPage
+     * If page is greater than 1, returns true
+     * @return
+     */
+    auto hasPreviousPage() const -> bool;
+
 protected:
     /**
      * @brief setErrorString
@@ -343,6 +357,8 @@ private:
     Q_PROPERTY(qsizetype resultsPerPage READ resultsPerPage WRITE setResultsPerPage NOTIFY resultsPerPageChanged FINAL)
     Q_PROPERTY(qsizetype totalResults READ totalResults NOTIFY totalResultsChanged FINAL)
     Q_PROPERTY(qsizetype totalPages READ totalPages NOTIFY totalPagesChanged FINAL)
+    Q_PROPERTY(bool hasNextPage READ hasNextPage NOTIFY pageChanged FINAL)
+    Q_PROPERTY(bool hasPreviousPage READ hasPreviousPage NOTIFY pageChanged FINAL)
     Q_PROPERTY(qsizetype page READ page NOTIFY pageChanged FINAL)
 };
 Q_DECLARE_METATYPE(FeaturedImagesModel)

KomplexHubPlugin/featuredpacksmodel.cpp

@@ -311,6 +311,26 @@ auto FeaturedPacksModel::previousPage() -> void
     }
 }
 
+auto FeaturedPacksModel::hasNextPage() const -> bool
+{
+    if(m_paginator == nullptr)
+    {
+        return false;
+    }
+
+    return m_paginator->page() < m_paginator->totalPages();
+}
+
+auto FeaturedPacksModel::hasPreviousPage() const -> bool
+{
+    if(m_paginator == nullptr)
+    {
+        return false;
+    }
+
+    return m_paginator->page() > 0;
+}
+
 qsizetype FeaturedPacksModel::page() const
 {
     if(m_paginator != nullptr)

KomplexHubPlugin/featuredpacksmodel.h

@@ -208,6 +208,20 @@ public:
      */
     Q_INVOKABLE auto previousPage() -> void;
 
+    /**
+     * @brief hasNextPage
+     * Calculates if there are more pages based on the current page calculation
+     * @return
+     */
+    auto hasNextPage() const -> bool;
+
+    /**
+     * @brief hasPreviousPage
+     * If page is greater than 1, returns true
+     * @return
+     */
+    auto hasPreviousPage() const -> bool;
+
 protected:
     /**
      * @brief setErrorString
@@ -310,6 +324,8 @@ private:
     Q_PROPERTY(qsizetype resultsPerPage READ resultsPerPage WRITE setResultsPerPage NOTIFY resultsPerPageChanged FINAL)
     Q_PROPERTY(qsizetype totalResults READ totalResults NOTIFY totalResultsChanged FINAL)
     Q_PROPERTY(qsizetype totalPages READ totalPages NOTIFY totalPagesChanged FINAL)
+    Q_PROPERTY(bool hasNextPage READ hasNextPage NOTIFY pageChanged FINAL)
+    Q_PROPERTY(bool hasPreviousPage READ hasPreviousPage NOTIFY pageChanged FINAL)
     Q_PROPERTY(qsizetype page READ page NOTIFY pageChanged FINAL)
 };
 Q_DECLARE_METATYPE(FeaturedPacksModel)

KomplexHubPlugin/featuredvideosmodel.cpp

@@ -160,13 +160,19 @@ auto FeaturedVideosModel::state() const -> FeaturedVideosModel::State
 
 auto FeaturedVideosModel::setState(State state) -> void
 {
-    if (m_state == state)
-    {
-        return;
-    }
+    QFuture<void> aether = QtConcurrent::run
+    (
+        [this, state]
+        {
+            if (m_state == state)
+            {
+                return;
+            }
 
-    m_state = state;
-    emit stateChanged();
+            m_state = state;
+            emit stateChanged();
+        }
+    );
 }
 
 auto FeaturedVideosModel::resetState() -> void
@@ -365,3 +371,23 @@ auto FeaturedVideosModel::totalPages() const -> qsizetype
 
     return 0;
 }
+
+auto FeaturedVideosModel::hasNextPage() const -> bool
+{
+    if(m_paginator == nullptr)
+    {
+        return false;
+    }
+
+    return m_paginator->page() < m_paginator->totalPages();
+}
+
+auto FeaturedVideosModel::hasPreviousPage() const -> bool
+{
+    if(m_paginator == nullptr)
+    {
+        return false;
+    }
+
+    return m_paginator->page() > 0;
+}

KomplexHubPlugin/featuredvideosmodel.h

@@ -231,6 +231,20 @@ public:
      */
     auto setWindowSize(qsizetype size) -> void;
 
+    /**
+     * @brief hasNextPage
+     * Calculates if there are more pages based on the current page calculation
+     * @return
+     */
+    auto hasNextPage() const -> bool;
+
+    /**
+     * @brief hasPreviousPage
+     * If page is greater than 1, returns true
+     * @return
+     */
+    auto hasPreviousPage() const -> bool;
+
 protected:
     /**
      * @brief setErrorString
@@ -327,6 +341,8 @@ private:
     Q_PROPERTY(qsizetype totalResults READ totalResults NOTIFY totalResultsChanged FINAL)
     Q_PROPERTY(qsizetype totalPages READ totalPages NOTIFY totalPagesChanged FINAL)
     Q_PROPERTY(qsizetype page READ page NOTIFY pageChanged FINAL)
+    Q_PROPERTY(bool hasNextPage READ hasNextPage NOTIFY pageChanged FINAL)
+    Q_PROPERTY(bool hasPreviousPage READ hasPreviousPage NOTIFY pageChanged FINAL)
     Q_PROPERTY(VideoItemModel *itemModel READ itemModel CONSTANT FINAL)
     Q_PROPERTY(qsizetype windowSize READ windowSize WRITE setWindowSize NOTIFY windowSizeChanged FINAL)
 };

KomplexHubPlugin/installedpackmanager.cpp

@@ -249,7 +249,7 @@ auto InstalledPackManager::setState(State state) -> void
 
 auto InstalledPackManager::resetState() -> void
 {
-    setState(Idle); // TODO: Adapt to use your actual default value
+    setState(Idle);
 }
 
 auto InstalledPackManager::roleNames() const -> QHash<int, QByteArray>

KomplexHubPlugin/newestpacksmodel.cpp

@@ -159,13 +159,19 @@ auto NewestPacksModel::state() const -> NewestPacksModel::State
 
 auto NewestPacksModel::setState(State state) -> void
 {
-    if (m_state == state)
-    {
-        return;
-    }
+    QFuture<void> aether = QtConcurrent::run
+    (
+        [this, state]
+        {
+            if (m_state == state)
+            {
+                return;
+            }
 
-    m_state = state;
-    emit stateChanged();
+            m_state = state;
+            emit stateChanged();
+        }
+    );
 }
 
 auto NewestPacksModel::resetState() -> void
@@ -224,7 +230,7 @@ auto NewestPacksModel::setResultsPerPage(qsizetype resultsPerPage) -> void
 {
     if(m_paginator != nullptr)
     {
-        QFuture<void> future = QtConcurrent::run
+        QFuture<void> aether = QtConcurrent::run
         (
             [this, resultsPerPage]
             {
@@ -277,7 +283,7 @@ auto NewestPacksModel::nextPage() const -> void
 {
     if(m_paginator != nullptr)
     {
-        QFuture<void> future = QtConcurrent::run
+        QFuture<void> aether = QtConcurrent::run
         (
             [this]
             {
@@ -291,7 +297,7 @@ auto NewestPacksModel::previousPage() const -> void
 {
     if(m_paginator != nullptr)
     {
-        QFuture<void> future = QtConcurrent::run
+        QFuture<void> aether = QtConcurrent::run
         (
             [this]
             {
@@ -320,3 +326,24 @@ auto NewestPacksModel::totalPages() const -> qsizetype
 
     return 0;
 }
+
+auto NewestPacksModel::hasNextPage() const -> bool
+{
+    if(m_paginator == nullptr)
+    {
+        return false;
+    }
+
+    return m_paginator->page() < m_paginator->totalPages();
+
+}
+
+auto NewestPacksModel::hasPreviousPage() const -> bool
+{
+    if(m_paginator == nullptr)
+    {
+        return false;
+    }
+
+    return m_paginator->page() > 0;
+}

KomplexHubPlugin/newestpacksmodel.h

@@ -215,6 +215,20 @@ public:
      */
     Q_INVOKABLE auto previousPage() const -> void;
 
+    /**
+     * @brief hasNextPage
+     * Calculates if there are more pages based on the current page calculation
+     * @return
+     */
+    auto hasNextPage() const -> bool;
+
+    /**
+     * @brief hasPreviousPage
+     * If page is greater than 1, returns true
+     * @return
+     */
+    auto hasPreviousPage() const -> bool;
+
 protected:
     /**
      * @brief setErrorString
@@ -321,6 +335,8 @@ private:
     Q_PROPERTY(qsizetype totalResults READ totalResults NOTIFY totalResultsChanged FINAL)
     Q_PROPERTY(qsizetype totalPages READ totalPages NOTIFY totalPagesChanged FINAL)
     Q_PROPERTY(qsizetype page READ page NOTIFY pageChanged FINAL)
+    Q_PROPERTY(bool hasNextPage READ hasNextPage NOTIFY pageChanged FINAL)
+    Q_PROPERTY(bool hasPreviousPage READ hasPreviousPage NOTIFY pageChanged FINAL)
 };
 Q_DECLARE_METATYPE(NewestPacksModel)
 

KomplexHubPlugin/packcompiler.h

@@ -36,6 +36,8 @@
 #include <qobject.h>
 #include <qtmetamacros.h>
 #include <QPainter>
+#include <QtShaderTools>
+#include <QtShaderTools/rhi/qshaderbaker.h>
 #include <QtConcurrent/qtconcurrentrun.h>
 #include <qcontainerfwd.h>
 #include <qmargins.h>
@@ -43,23 +45,47 @@
 #include <qtmetamacros.h>
 #include <qurl.h>
 #include "common/komplex_global.h"
+
+#if __has_include("vulkan/vulkan_core.h")
+#define HAS_VULKAN
+#include <vulkan/vulkan_core.h>
+#endif
+
+#if __has_include("GL/gl.h")
+#define HAS_OPENGL
+#include <GL/gl.h>
+#endif
+
+struct KOMPLEX_EXPORT BuildContext
+{
+    QMap<QByteArray, QByteArray> commonData;
+};
+
 /**
  * @brief The PackCompiler class
  * [1] Extract Pack (GZip)
  * [2] Verify directory is a pack and has shaders
- * [3] Load shader code
- * [4] Append Common and Global files, if they exist
- * [5] Add uniform and replace variable use
- * [6] Run C Preprocessor (cpp -P) to process macros
- * [7] Append version macro
- * [8] Compile with Qt Shader Baker
+ * [3] Load Common shader code
+ * [4] Walk the shader directory
+ * [5] Load shader code
+ * [6] Append type specific common code and global code
+ * [7] Replace uniform variable use
+ * [8] Add uniform header
+ * [9] Add uniform footer
+ * [10] Run preprocessor to process macros
+ * [11] Append version macro
+ * [12] Compile with QShaderBaker
+ * [13] Save
  */
-class KOMPLEX_EXPORT PackCompiler : public QObject
+class PackCompiler : public QObject
 {
     Q_OBJECT
-    QML_ELEMENT
 public:
 
+    /**
+     * @brief The State enum
+     * Enum of the possible states of the compiler
+     */
     enum State
     {
         Idle,
@@ -70,112 +96,418 @@ public:
     Q_ENUM(State)
 
     explicit PackCompiler(QObject *parent = nullptr);
-    ~PackCompiler() override;
 
-    auto compilerOutput() const -> const QString & { return m_compilerOutput; }
+    /**
+     * @brief progress
+     * Current compiler progress
+     * @return
+     */
     auto progress() -> qreal { return m_progress; }
+
+    /**
+     * @brief currentStep
+     * Current compiler step
+     * @return
+     */
     auto currentStep() -> qint64 { return m_currentStep; }
+
+    /**
+     * @brief totalSteps
+     * Total steps in the current compile
+     * @return
+     */
     auto totalSteps() -> qint64 { return m_totalSteps; }
-    auto errorTitle() const -> const QString & { return m_errorTitle; }
-    auto errorMessage() const -> const QString & { return m_errorMessage; }
-    auto reset() -> void;
-
-    auto process(const QUrl &uri) -> QFuture<QUrl>;
 
+    /**
+     * @brief status
+     * Current status message
+     * @return
+     */
     auto status() const -> const QString & { return m_status; }
+
+    /**
+     * @brief state
+     * Current compiler state
+     * @return
+     */
     auto state() const -> State { return m_state; }
 
-protected:
     /**
-     * @brief prepareShaders
-     * Scans the pack's shader directory and sends each file to
-     * prepareFile()
-     * @param uri
-     * Directory to prepare
+     * @brief reset
+     * Resets the compiler state
      */
-    auto prepareShaders(const QUrl &uri) noexcept(false) -> void;
+    auto reset() -> void;
 
     /**
-     * @brief prepareFile
-     * Prepares the individual file by appending the header, footer,
-     * common files and replacing standard variable names
+     * @brief build
+     * Builds a Komplex pack from a tar.gz file
      * @param uri
+     * Uri of the tar.gz
+     * @return
+     * Uri of the built pack
      */
-    auto prepareFile(const QUrl &uri) noexcept(false) -> void;
-
-    /**
-     * @brief validateDirectory
-     *
-     * @param uri
-     * @return true
-     * @return false
-     */
-    auto validateDirectory(const QUrl &uri) -> bool;
-
-    auto extract(const QUrl &sourceUri, const QUrl &destinationUri) noexcept(false) -> void;
-    auto copyFile(const QUrl &sourceUri, const QUrl &destinationUri) noexcept(false) -> void;
-    auto compile(const QUrl &uri) noexcept(false) -> void;
-    auto preprocess(const QUrl &uri) noexcept(false) -> void;
-    auto appendVersion(const QUrl &uri) noexcept(false) -> void;
-    auto compileShader(const QUrl &uri) noexcept(false) -> void;
-    auto loadCommonFragmentData(const QUrl &uri) -> QByteArray;
-    auto loadCommonVertexData(const QUrl &uri) -> QByteArray;
-    auto loadGlobalData(const QUrl &uri) -> QByteArray;
-
-    auto setError(const QString &title, const QString &message, const QUrl &uri = {}) -> void;
-    auto setCompilerOutput(const QString &compilerOutput) -> void;
-    auto setState(State state) -> void;
-    auto setProgress(qreal progress) -> void;
-    auto setTotalSteps(qint64 steps) -> void;
-    auto setCurrentStep(qint64 step) -> void;
-
-    auto setStatus(const QString &status) -> void;
-
-    auto incrementCompileStep() -> void;
-
-    auto removeDirectory(const QUrl &uri) -> bool;
+    auto build(const QUrl &uri) -> QUrl;
 
 signals:
     auto compilerOutputChanged() -> void;
-    auto errorOcurred() -> void;
-    auto errorTitleChanged() -> void;
-    auto errorMessageChanged() -> void;
     auto stateChanged() -> void;
     auto progressChanged() -> void;
     auto currentStepChanged() -> void;
     auto totalStepsChanged() -> void;
-
     auto compileComplete(const QUrl &uri) -> void;
-
     auto statusChanged() -> void;
     auto packReady(const QString &) -> void;
     auto errorStepChanged() -> void;
     auto errorRatingChanged() -> void;
 
 private:
+    //[1]
+    /**
+     * @brief extract
+     * Extracts the packfile and deletes the source
+     * @param uri of the tar.gz pack
+     * @return uri of the extracted directory
+     */
+    auto extract(const QUrl &uri) noexcept(false) -> const QUrl;
+
+    //[2]
+    /**
+     * @brief validatePack
+     * Validates that the directory is a valid pack and has shaders to compile
+     * @param uri of the directory provided by extract
+     */
+    auto validatePack(const QUrl &uri) const noexcept(false) -> void;
+
+    //[3]
+    /**
+     * @brief loadCommonData
+     * Loads the common and global shader code from the shader directory of the uri
+     * @param uri
+     */
+    auto loadCommonData(const QUrl &uri) -> QMap<QByteArray,QByteArray>;
+
+    //[4-5]
+    /**
+     * @brief processShaders
+     * Walks the shader directory, loads the code and calls 6-13 for each
+     * @param uri
+     * @param context
+     */
+    auto processShaders(const QUrl &uri, BuildContext *context) -> void;
+
+    //[6]
+    /**
+     * @brief appendCommonData
+     * Appends the type specific common code to the shader data
+     * @param data
+     * Pointer to shader data
+     * @param suffix
+     * Shader file suffix
+     * @param context
+     * Pointer to build context object
+     */
+    auto appendCommonData(QByteArray *data, const QByteArray &suffix, BuildContext *context) noexcept(true) -> void;
+
+    //[7]
+    /**
+     * @brief replaceUniformVariables
+     * Replaces standard variables such as iFrame with their uniform buffer name
+     * @param data
+     * Pointer to the shader data
+     */
+    auto replaceUniformVariables(QByteArray *data) noexcept(true) -> void;
+
+    //[8]
+    /**
+     * @brief appendUniformHeader
+     * Adds header and uniform buffer to the shader data
+     * @param data
+     * Pointer to the shader data
+     */
+    auto appendUniformHeader(QByteArray *data) noexcept(true) -> void;
+
+    //[9]
+    /**
+     * @brief appendUniformFooter
+     * Adds the uniform footer to the shader data
+     * @param data
+     * Pointer to the shader data
+     */
+    auto appendUniformFooter(QByteArray *data) noexcept(true) -> void;
+
+    //[10]
+    /**
+     * @brief preprocess
+     * I have had issues with defines in code so passing it to a c/c++
+     * preprocessor is required. I am now using clang for this as clang
+     * is more modern and can use stdin
+     * @param data
+     */
+    auto preprocess(QByteArray *data) noexcept(false) -> void;
+
+    //[11]
+    /**
+     * @brief appendVersion
+     * The version header confuses the preprocessor, so add it at the end
+     * @param data
+     */
+    auto appendVersion(QByteArray *data) noexcept(true) -> void;
+
+    //[12]
+    /**
+     * @brief compile
+     * Compiles the shader data in memory and returns the shader object.
+     * @param data
+     * Shader data
+     * @param filename
+     * Filename of the shader
+     * @param stage
+     * Type of shader, based on suffix of original file
+     * @return
+     * Compiled shader object
+     */
+    auto compile(const QByteArray &data, const QString &filename, const QShader::Stage stage) noexcept(false) -> QShader;
+
+    //[13]
+    /**
+     * @brief save
+     * Saves a serialized version of the shader to the specified uri
+     * @param uri
+     * Uri of the file to create
+     * @param shader
+     * The compiled shader
+     */
+    auto save(const QUrl &uri, const QShader &shader) noexcept(false) -> void;
+
+//@BEGIN helpers
+    /**
+     * @brief validateUri
+     * Validates that the uri is a local file or direcotry
+     * @param uri
+     */
+    auto validateUri(const QUrl &uri) const noexcept(false) -> void;
+
+    /**
+     * @brief run
+     * Runs the supplied command with the given arguments as a QProcess. If
+     * data is supplied, it is written to the standard input channel after the
+     * process has started
+     * @param command
+     * System command or program to run
+     * @param arguments
+     * QStringList of the given arguments. Minimal wildcard expansion available.
+     * @param data
+     * Optional data to write
+     * @return
+     * Standard non-error output
+     */
+    auto run(const QString &command, const QStringList &arguments, const QByteArray &data = {}) noexcept(false) -> QByteArray;
+
+    /**
+     * @brief readFile
+     * Reads the file at the given uri and returns its data
+     * @param uri
+     * Uri of the file
+     * @return
+     * File contents
+     */
+    auto readFile(const QUrl &uri) noexcept(false) -> QByteArray;
+
+    /**
+     * @brief writeFile
+     * Writes the supplied data to the given uri
+     * @param uri
+     * Uri of the file
+     * @param data
+     * Data to write
+     */
+    auto writeFile(const QUrl &uri, const QByteArray &data) noexcept(false) -> void;
+
+    /**
+     * @brief copyFile
+     * Copys file to new uri
+     * @param sourceUri
+     * File to copy
+     * @param destinationUri
+     * New file location/name
+     */
+    auto copyFile(const QUrl &sourceUri, const QUrl &destinationUri) noexcept(false) -> void;
+
+    /**
+     * @brief createDirectory
+     * QDir::mkpath was failing, so this helper function calls mkdir -p
+     * @param uri
+     * Directory path to create
+     */
+    auto createDirectory(const QUrl &uri) noexcept(false) -> void;
+
+    /**
+     * @brief removeDirectory
+     * Calls rm -rf, but should be replaced with an agnostic solution
+     * @param uri
+     * Directory to remove
+     */
+    auto removeDirectory(const QUrl &uri) noexcept(false) -> void;
+
+    /**
+     * @brief getStageFromSuffix
+     * Supplies the stage/type of shader based on the shaders file extension
+     * @param suffix
+     * @return
+     */
+    auto getStageFromSuffix(const QString &suffix) const -> QShader::Stage;
+
+    /**
+     * @brief setState
+     * Sets the current state of the compiler
+     * @param state
+     */
+    auto setState(State state) -> void;
+
+    /**
+     * @brief setProgress
+     * Sets the current progress of the compiler
+     * @param progress
+     */
+    auto setProgress(qreal progress) -> void;
+
+    /**
+     * @brief setTotalSteps
+     * Sets the total steps pack will take to build
+     * @param steps
+     */
+    auto setTotalSteps(qint64 steps) -> void;
+
+    /**
+     * @brief setCurrentStep
+     * Sets the current step
+     * @param step
+     */
+    auto setCurrentStep(qint64 step) -> void;
+
+    /**
+     * @brief setStatus
+     * Sets the current status message
+     * @param status
+     */
+    auto setStatus(const QString &status) -> void;
+
+    /**
+     * @brief incrementCompileStep
+     * Increments the current step and updates progress
+     */
+    auto incrementCompileStep() -> void;
+
+//@END helpers
+
+#ifdef HAS_VULKAN
+    /**
+     * @brief vulkanVersion
+     * Returns the current version reported by the vulkan api
+     * @return
+     */
+    auto vulkanVersion() const -> qint32;
+#endif
+
+#ifdef HAS_OPENGL
+    /**
+     * @brief openGlVersion
+     * Returns the current version reported by the opengl api
+     * @return
+     */
+    auto openGlVersion() const -> qint32;
+#endif
+
+    //members
+    /**
+     * @brief m_updateVariables
+     * Standard variables expected by most online shaders, mainly
+     * shadertoy and similar.
+     */
     static inline const QStringList m_updateVariables
-        {
-            QStringLiteral("iTime"),
-            QStringLiteral("iTimeDelta"),
-            QStringLiteral("iFrameRate"),
-            QStringLiteral("iSampleRate"),
-            QStringLiteral("iFrame"),
-            QStringLiteral("iDate"),
-            QStringLiteral("iMouse"),
-            QStringLiteral("iResolution"),
-            QStringLiteral("iColorTheme"),
-            QStringLiteral("iChannelTime"),
-            QStringLiteral("iChannelResolution")
-        };
+    {
+        QStringLiteral("iTime"),
+        QStringLiteral("iTimeDelta"),
+        QStringLiteral("iFrameRate"),
+        QStringLiteral("iSampleRate"),
+        QStringLiteral("iFrame"),
+        QStringLiteral("iDate"),
+        QStringLiteral("iMouse"),
+        QStringLiteral("iResolution"),
+        QStringLiteral("iColorTheme"),
+        QStringLiteral("iChannelTime"),
+        QStringLiteral("iChannelResolution")
+    };
 
+    /**
+     * @brief m_variableExpressions
+     * Regular expressions of standardized variables. Built at runtime
+     */
+    static inline QList<QRegularExpression> m_variableExpressions;
+
+    /**
+     * @brief m_shaderNameFilters
+     * Name filters for supported shader types
+     */
+    static inline const QStringList m_shaderNameFilters
+    {
+        QStringLiteral("*.frag"),
+        QStringLiteral("*.vert"),
+        QStringLiteral("*.tese"),
+        QStringLiteral("*.tesc"),
+        QStringLiteral("*.geom"),
+        QStringLiteral("*.comp"),
+        QStringLiteral("*.glsl")
+    };
+
+    /**
+     * @brief m_shaderStages
+     * Map of supported file suffix to their QShader::Stage
+     */
+    static inline const QMap<QString, QShader::Stage> m_shaderStages
+    {
+        {
+            QStringLiteral("frag"),
+            QShader::FragmentStage
+        },
+        {
+            QStringLiteral("vert"),
+            QShader::VertexStage
+        },
+        {
+            QStringLiteral("tese"),
+            QShader::TessellationEvaluationStage
+        },
+        {
+            QStringLiteral("tesc"),
+            QShader::TessellationControlStage
+        },
+        {
+            QStringLiteral("geom"),
+            QShader::GeometryStage
+        },
+        {
+            QStringLiteral("comp"),
+            QShader::ComputeStage
+        }
+    };
+
+    /**
+     * @brief m_version
+     * Version to be appended to the shader before build
+     */
     static inline const QByteArray m_version
-        {
-            R"(#version 450)"
-        };
+    {
+        R"(#version 450)"
+    };
 
-    static inline const QString m_header
-        {
-            R"(layout(location = 0) in vec2 qt_TexCoord0;
+    /**
+     * @brief m_header
+     * Header to be appended to the shader before build
+     */
+    static inline const QByteArray m_header
+    {
+        R"(layout(location = 0) in vec2 qt_TexCoord0;
 layout(location = 0) out vec4 fragColor;
 
 layout(std140, binding = 0) uniform buf {
@@ -200,61 +532,28 @@ layout(binding = 3) uniform sampler2D iChannel2;
 layout(binding = 4) uniform sampler2D iChannel3;
 
 vec2 fragCoord = vec2(qt_TexCoord0.x, 1.0 - qt_TexCoord0.y) * ubuf.iResolution.xy;)"
-        };
+    };
 
-    static inline const QString m_footer
-        {
-            R"(void main() {
+    /**
+     * @brief m_footer
+     * Footer to be appended to the shader before build
+     */
+    static inline const QByteArray m_footer
+    {
+        R"(
+void main() {
     vec4 color = vec4(0.0);
     mainImage(color, fragCoord);
     fragColor = color;
 })"
-        };
-
-    QString m_compilerOutput;
-    QString m_errorMessage;
-    QString m_errorTitle;
-    QString m_status;
+    };
 
     State m_state;
-
     qreal m_currentStep = 0;
     qreal m_progress = 0;
     qreal m_totalSteps = 0;
+    QString m_status;
 
-    QMutex m_downloadMutex;
-
-    static inline QList<QRegularExpression> m_variableExpressions;
-
-    static inline const QRegularExpression m_commonFragmentExpression = QRegularExpression
-    (
-        QString("^common\\.frag$"),
-        QRegularExpression::CaseInsensitiveOption
-    );
-
-    static inline const QRegularExpression m_commonVertexExpression = QRegularExpression
-    (
-        QString("^common\\.vert$"),
-        QRegularExpression::CaseInsensitiveOption
-    );
-
-    static inline const QRegularExpression m_fragmentExpression = QRegularExpression
-    (
-        QString("^.{1,}\\.frag$"),
-        QRegularExpression::CaseInsensitiveOption |
-            QRegularExpression::DotMatchesEverythingOption
-    );
-
-    static inline const QRegularExpression m_vertexExpression = QRegularExpression
-    (
-        QString("^.{1,}\\.vert$"),
-        QRegularExpression::CaseInsensitiveOption |
-            QRegularExpression::DotMatchesEverythingOption
-    );
-
-    Q_PROPERTY(QString compilerOutput READ compilerOutput WRITE setCompilerOutput NOTIFY compilerOutputChanged FINAL)
-    Q_PROPERTY(QString errorTitle READ errorTitle NOTIFY errorTitleChanged FINAL)
-    Q_PROPERTY(QString errorMessage READ errorMessage NOTIFY errorMessageChanged FINAL)
     Q_PROPERTY(qreal progress READ progress NOTIFY progressChanged FINAL)
     Q_PROPERTY(qint64 totalSteps READ totalSteps NOTIFY totalStepsChanged FINAL)
     Q_PROPERTY(qint64 currentStep READ currentStep NOTIFY currentStepChanged FINAL)

KomplexHubPlugin/paginators/featuredimagespaginator.h

@@ -36,11 +36,8 @@ class KOMPLEX_EXPORT FeaturedImagesPaginator : public ImagePaginator
 public:
     explicit FeaturedImagesPaginator(QObject *parent = nullptr) : ImagePaginator(parent)
     {
-        setUri(
-            QString::fromUtf8(KOMPLEX_ENDPOINT_IMAGES_FEATURED)
-        );
-
-        controller()->setWindowSize(20);
+        setUri(KOMPLEX_ENDPOINT_IMAGES_FEATURED);
+        controller()->setWindowSize(32);
     }
 };
 

KomplexHubPlugin/paginators/featuredpackspaginator.h

@@ -36,10 +36,7 @@ class KOMPLEX_EXPORT FeaturedPacksPaginator : public WallpaperPaginator
 public:
     explicit FeaturedPacksPaginator(QObject *parent = nullptr) : WallpaperPaginator(parent)
     {
-        setUri(
-            QString::fromUtf8(KOMPLEX_ENDPOINT_PACKS_FEATURED)
-        );
-
+        setUri(KOMPLEX_ENDPOINT_PACKS_FEATURED);
         controller()->setWindowSize(32);
     }
 };

KomplexHubPlugin/paginators/featuredvideospaginator.h

@@ -36,11 +36,8 @@ class KOMPLEX_EXPORT FeaturedVideosPaginator : public VideoPaginator
 public:
     explicit FeaturedVideosPaginator(QObject *parent = nullptr) : VideoPaginator(parent)
     {
-        setUri(
-            QString::fromUtf8(KOMPLEX_ENDPOINT_VIDEOS_FEATURED)
-        );
-
-        controller()->setWindowSize(20);
+        setUri(KOMPLEX_ENDPOINT_VIDEOS_FEATURED);
+        controller()->setWindowSize(32);
     }
 };
 

KomplexHubPlugin/paginators/imagesearchpaginator.h

@@ -38,10 +38,7 @@ class KOMPLEX_EXPORT ImageSearchPaginator : public ImagePaginator
 public:
     explicit ImageSearchPaginator(QObject *parent = nullptr) : ImagePaginator(parent)
     {
-        setUri(
-            QString::fromUtf8(KOMPLEX_ENDPOINT_IMAGES_SEARCH)
-        );
-
+        setUri(KOMPLEX_ENDPOINT_IMAGES_SEARCH);
         setQueryable(true);
     }
 };

KomplexHubPlugin/paginators/newestpackspaginator.h

@@ -36,10 +36,7 @@ class KOMPLEX_EXPORT NewestPacksPaginator : public WallpaperPaginator
 public:
     explicit NewestPacksPaginator(QObject *parent = nullptr) : WallpaperPaginator(parent)
     {
-        setUri(
-            QString::fromUtf8(KOMPLEX_ENDPOINT_PACKS_NEWEST)
-        );
-
+        setUri(KOMPLEX_ENDPOINT_PACKS_NEWEST);
         controller()->setWindowSize(20);
     }
 };

KomplexHubPlugin/paginators/packsearchpaginator.h

@@ -36,10 +36,7 @@ class KOMPLEX_EXPORT PackSearchPaginator : public WallpaperPaginator
 public:
     explicit PackSearchPaginator(QObject *parent = nullptr) : WallpaperPaginator(parent)
     {
-        setUri(
-            QString::fromUtf8(KOMPLEX_ENDPOINT_PACKS_SEARCH)
-        );
-
+        setUri(KOMPLEX_ENDPOINT_PACKS_SEARCH);
         setQueryable(true);
     }
 };

KomplexHubPlugin/paginators/paginator.h

@@ -303,13 +303,13 @@ public:
         return m_cacheController.windowSize();
     }
 
-protected:
-
     auto queryable() const -> bool
     {
         return m_queryable;
     }
 
+protected:
+
     auto setQueryable(bool queryable) -> void
     {
         m_queryable = queryable;

KomplexHubPlugin/paginators/videopaginator.h

@@ -245,6 +245,8 @@ protected:
             loop.exec();
         }
 
+        manager.clear();
+
         LOG_ERROR_X(reply->error() != QNetworkReply::NoError,
             "NewestPacksPaginator::getNetworkReply",
             reply->errorString().toStdString().c_str(),

KomplexHubPlugin/paginators/videosearchpaginator.h

@@ -36,10 +36,7 @@ class KOMPLEX_EXPORT VideoSearchPaginator : public VideoPaginator
 public:
     explicit VideoSearchPaginator(QObject *parent = nullptr) : VideoPaginator(parent)
     {
-        setUri(
-            QString::fromUtf8(KOMPLEX_ENDPOINT_VIDEOS_SEARCH)
-        );
-
+        setUri(KOMPLEX_ENDPOINT_VIDEOS_SEARCH);
         setQueryable(true);
     }
 };

KomplexHubPlugin/paginators/wallpaperpaginator.h

@@ -248,6 +248,8 @@ protected:
             loop.exec();
         }
 
+        manager.clear();
+
         LOG_ERROR_X(reply->error() != QNetworkReply::NoError,
             "NewestPacksPaginator::getNetworkReply",
             reply->errorString().toStdString().c_str(),

KomplexHubPlugin/usermodel.cpp

@@ -0,0 +1,288 @@
+#include "usermodel.h"
+#include "common/userservices.h"
+#include <QtConcurrent/qtconcurrentrun.h>
+#include <qdatetime.h>
+#include <qfuture.h>
+#include <qobjectdefs.h>
+#include <qstringview.h>
+
+UserModel::UserModel(QObject *parent)
+    : QObject{parent}
+{
+    m_stateResetTimer = new QTimer(this);
+    m_stateResetTimer->setInterval(1000);
+    m_stateResetTimer->setSingleShot(true);
+
+    QObject::connect
+    (
+        m_stateResetTimer,
+        &QTimer::timeout,
+        this,
+        &UserModel::resetState
+    );
+
+    setState(Busy);
+
+    QSharedPointer<UserServices> service = UserServices::instance();
+
+    if(service == nullptr)
+    {
+        setErrorString(QStringLiteral("UserServices object deleted"));
+        setState(LoginFailure);
+        return;
+    }
+
+    QFuture<QString> usernameFuture = service->defaultUsername();
+
+    usernameFuture
+        .then
+        (
+            [this] (const QString username)
+            {
+                login(username);
+            }
+        )
+        .onCanceled
+        (
+            [this] () -> void
+            {
+                reset();
+            }
+        )
+        .onFailed
+        (
+            [this] () -> void
+            {
+                reset();
+            }
+        );
+
+    service.clear();
+}
+
+UserModel::~UserModel()
+{
+    if(m_stateResetTimer != nullptr)
+    {
+        m_stateResetTimer->deleteLater();
+    }
+}
+
+auto UserModel::login() -> void
+{
+    QFuture aether = QtConcurrent::run
+    (
+        [this] () -> void
+        {
+            QMutexLocker locker(&m_loginMutex);
+            setState(LoggingIn);
+
+            QSharedPointer<UserServices> service = UserServices::instance();
+
+            if(service == nullptr)
+            {
+                setErrorString(QStringLiteral("UserServices object deleted"));
+                setState(LoginFailure);
+                return;
+            }
+
+            m_loginAttempt = service->login(username(), password().toUtf8());
+
+            m_loginAttempt
+                .then
+                (
+                    [this] (UserCredentials credentials) -> void
+                    {
+                        setState(LoggedIn);
+                    }
+                )
+                .onCanceled
+                (
+                    [this] () -> void
+                    {
+                        setState(LoginFailure);
+                    }
+                )
+                .onFailed
+                (
+                    [this] () -> void
+                    {
+                        setState(LoginCancelled);
+                    }
+                );
+        }
+    );
+}
+
+auto UserModel::login(const QString username) -> void
+{
+    if(username == m_username)
+    {
+        return;
+    }
+
+    m_username = username;
+    Q_EMIT usernameChanged();
+
+    QSharedPointer<UserServices> service = UserServices::instance();
+
+    if(service == nullptr)
+    {
+        setErrorString(QStringLiteral("UserServices object deleted"));
+        setState(LoggedOut);
+        return;
+    }
+
+    QFuture<UserCredentials> tokenRead = service->readToken(username);
+
+    tokenRead
+        .then
+        (
+            [this] (const UserCredentials credentials) -> void
+            {
+                if(QDateTime::currentDateTime() <= credentials.expiry)
+                {
+                    setState(LoggedIn);
+                    return;
+                }
+
+                QSharedPointer<UserServices> service = UserServices::instance();
+
+                if(service == nullptr)
+                {
+                    setErrorString(QStringLiteral("UserServices object deleted"));
+                    setState(LoggedOut);
+                    return;
+                }
+
+                QFuture<QByteArray> passwordRead = service->readPassword(credentials.username);
+
+                passwordRead
+                    .then
+                    (
+                        [this] (const QByteArray password)
+                        {
+                            if(password.isEmpty())
+                            {
+                                setState(LoggedOut);
+                                return;
+                            }
+
+                            setPassword(password);
+                        }
+                    );
+
+                service.clear();
+            }
+        );
+
+    service.clear();
+}
+
+auto UserModel::cancelLogin() -> void
+{
+    QFuture aether = QtConcurrent::run
+    (
+        [this] () -> void
+        {
+            QMutexLocker locker(&m_loginMutex);
+
+            if(m_loginAttempt.isRunning())
+            {
+                m_loginAttempt.cancel();
+            }
+        }
+    );
+}
+
+auto UserModel::reset() -> void
+{
+    resetState();
+    setUsername({});
+    setPassword({});
+}
+
+auto UserModel::setUsername(const QString &username) -> void
+{
+    if(username == m_username)
+    {
+        return;
+    }
+
+    m_username = username;
+    Q_EMIT usernameChanged();
+
+    if(!password().isEmpty())
+    {
+        return;
+    }
+
+    setState(Busy);
+
+    QSharedPointer<UserServices> service = UserServices::instance();
+
+    if(service == nullptr)
+    {
+        return;
+    }
+
+    QFuture<QByteArray> passwordRead = service->readPassword(username);
+    passwordRead
+        .then
+        (
+            [this] (const QByteArray password) -> void
+            {
+                setPassword(password);
+            }
+        );
+}
+
+auto UserModel::setPassword(const QString &password) -> void
+{
+    if(password == m_password)
+    {
+        return;
+    }
+
+    m_password = password;
+    Q_EMIT passwordChanged();
+}
+
+auto UserModel::resetState() -> void
+{
+    setState(Idle);
+}
+
+auto UserModel::setState(State state) -> void
+{
+    if(state == m_state)
+    {
+        return;
+    }
+
+    switch(state)
+    {
+    case LoginFailure:
+    case LoggedOut:
+    case LoginCancelled:
+        m_stateResetTimer->start();
+        break;
+
+    default:
+        break;
+    }
+
+    m_state = state;
+    Q_EMIT stateChanged();
+}
+
+auto UserModel::setErrorString(const QString &string) -> void
+{
+    if(string == m_errorString)
+    {
+        return;
+    }
+
+    m_errorString = string;
+    Q_EMIT errorStringChanged();
+}

KomplexHubPlugin/usermodel.h

@@ -0,0 +1,76 @@
+#ifndef USERMODEL_H
+#define USERMODEL_H
+
+#include <QObject>
+#include <QTimer>
+#include <QMutex>
+#include <QMutexLocker>
+#include <qqmlintegration.h>
+#include "common/userservices.h"
+
+class UserModel : public QObject
+{
+    Q_OBJECT
+    QML_ELEMENT
+
+public:
+
+    enum State
+    {
+        Idle,
+        LoggingIn,
+        LoggedIn,
+        LoginFailure,
+        LoginCancelled,
+        LoggedOut,
+        Busy
+    };
+    Q_ENUM(State)
+
+    explicit UserModel(QObject *parent = nullptr);
+    ~UserModel();
+
+    Q_INVOKABLE auto login() -> void;
+    Q_INVOKABLE auto login(const QString username) -> void;
+    Q_INVOKABLE auto cancelLogin() -> void;
+    Q_INVOKABLE auto reset() -> void;
+
+    auto username() const -> const QString & { return m_username; }
+    auto setUsername(const QString &username) -> void;
+
+    auto password() const -> const QString & { return m_password; }
+    auto setPassword(const QString &password) -> void;
+
+    auto state() const -> State { return m_state; }
+    auto errorString() const -> QString { return m_errorString; }
+
+signals:
+    auto loginSuccessful() -> void;
+    auto loginFailed() -> void;
+    auto stateChanged() -> void;
+    auto usernameChanged() -> void;
+    auto passwordChanged() -> void;
+    auto errorStringChanged() -> void;
+
+protected slots:
+    auto resetState() -> void;
+
+private:
+    auto setState(State state) -> void;
+    auto setErrorString(const QString &string) -> void;
+
+    State m_state = Idle;
+    QString m_errorString;
+    QString m_username;
+    QString m_password;
+    QTimer *m_stateResetTimer = nullptr;
+    QMutex m_loginMutex;
+    QFuture<UserCredentials> m_loginAttempt;
+
+    Q_PROPERTY(State state READ state NOTIFY stateChanged FINAL)
+    Q_PROPERTY(QString username READ username WRITE setUsername NOTIFY usernameChanged FINAL)
+    Q_PROPERTY(QString password READ password WRITE setPassword NOTIFY passwordChanged FINAL)
+    Q_PROPERTY(QString errorString READ errorString WRITE setErrorString NOTIFY errorStringChanged FINAL)
+};
+
+#endif // USERMODEL_H

README.md

@@ -34,7 +34,10 @@
     </tr>
 </table>
 
-Most of the development of Komplex and it's associated apps will now happen here, instead of Github.
+<small>Note: Application style is based on your system theme. It will look different than it does in the screenshots. I am using a modified KVantum Glass, Blur and Neon Sunset Wallpaper Pack.</small>
+
+## Development
+Most of the development of Komplex and applications under its project umbrella will now happen on https://git.digitalartifex.dev instead of Github.
 
 ## Installation
 
@@ -51,10 +54,11 @@ Most of the development of Komplex and it's associated apps will now happen here
   - Qt6 Shader Tools
 - CMake
 - clang
+- C Pre Processor (cpp)
 
 #### Build
 ```console
-$ git clone gitea@git.digitalartifex.dev:digitalartifex/komplex-hub.git
+$ git clone --recursive gitea@git.digitalartifex.dev:digitalartifex/komplex-hub.git
 $ mkdir build
 $ cmake -S ./ -B ./build/
 $ cmake --build ./build
@@ -74,4 +78,110 @@ Content purchases will be processed through the website using Paypal as will art
 
 ## Status
 
-This app is currently under development and is pre-alpha. The API is now being hosted on https://komplex.dev. However, there is no download functionality as of yet. BETA should be here within a few weeks.
+### Legend
+
+| Status |  Icon  | Description  |
+|-------|:-------:|--------|
+| Not started | ❌ | Either no work has been done yet or so little work that it is unusable in its current state.
+| In Progress | ✔ | *Some* work has been completed, but is not yet functional and/or feature complete
+| Complete | ✅ | Planned features completed
+
+### API Status
+
+| Feature |  Status  |
+|-------|:-------:|
+| Packs | ✔ | |
+| - Download Packs | ✅ | |
+| - Newest Packs | ✅ | |
+| - Featured Packs | ✔ | |
+| - Search Packs | ✅ | |
+| - Submit Packs | ✔ | |
+| - Thumbnails | ✅ | |
+|  |    |  |
+| Cubemaps | ✔ | |
+| - Download Cubemaps | ✅ | |
+| - Newest Cubemaps | ✅ | |
+| - Featured Cubemaps | ✔ | |
+| - Search Cubemaps | ✅ | |
+| - Submit Cubemaps | ✔ | - |
+|  |    |  |
+| Filter Shaders | ✔ | |
+| - Download Filter Shaders | ✅ | |
+| - Newest Filter Shaders | ✅ | |
+| - Featured Filter Shaders | ✔ | |
+| - Search Filter Shaders | ✅ | |
+| - Submit Filter Shaders | ✔ | - |
+|  |    |  |
+| Images | ✅ | |
+| - Featured Images | ✅ | |
+| - Search Images | ✅ | |
+|  |    |  |
+| Videos | ✅ | |
+| - Popular Videos | ✅ | |
+| - Search Videos | ✅ | |
+|  |    |  |
+| Accounts | ✔ | |
+| - User Accounts | ✔ | |
+| - User Authentication | ✔ | |
+| - User Editing | ❌ | |
+| - User Configuration | ❌ | |
+| - User Media | ❌ | |
+| - Author Profiles | ❌ | |
+
+### Media Hub Status
+
+| Feature |  Status  |
+|-------|:-------:|
+| Spotlight/Homepage | ✔ | |
+| - Newest Packs | ✅ | |
+| - Featured Packs | ✔ | |
+| - Featured Images | ✅ | |
+| - Popular Videos | ✅ | |
+| - View More | ✅ | |
+|  |    |  |
+| Media Search | ✅ | |
+| - Packs | ✅ | |
+| - Videos | ✅ | |
+| - Images | ✅ | |
+|  |    |  |
+| Media Downloader | ✅ | |
+| - Packs | ✅ | |
+| - Videos | ✅ | |
+| - Images | ✅ | |
+|  |    |  |
+| Detailed Views | ✅ | |
+| - Packs | ✅ | |
+| - Videos | ✅ | |
+| - Images | ✅ | |
+|  |    |  |
+| App Management | ✔ | |
+| Installed Media Manager | ✔ | |
+| Settings Manager | ✅ | |
+|  |    |  |
+| Account Management | ❌ | |
+| User Accounts | ❌ | |
+| - User Login | ❌ | |
+| - User Profile | ❌ | |
+| - Author Profile | ❌ | |
+| About Page | ✅ | |
+
+### Pack Designer
+
+| Feature |  Status  |
+|-------|:-------:|
+| All Design & Features | ❌ | |
+
+### Site
+
+| Feature |  Status  |
+|-------|:-------:|
+| Site Base | ✔ | |
+| Accounts | ✔ | |
+| Gallery | ❌ | |
+| Payment Gateway | ❌ | |
+| - Artist Payout | ❌ | |
+| - User Media Purchase | ❌ | |
+
+This app is currently under development and is currently BETA1 and the new API is live. Please do expect bugs in pack compiling at this stage.
+
+"Featured" Live wallpapers is currently a duplicated of "Newest". The featured endpoint will take manual curation, so this will take some time.

qds.cmake

@@ -11,8 +11,8 @@ target_link_libraries(${CMAKE_PROJECT_NAME} PRIVATE
     KomplexHubModuleplugin
     KomplexHubContentplugin
     KomplexHubPluginplugin
-    KomplexHubModule_Controlsplugin
-    KomplexHubModule_Keroplugin
+    KomplexHubControlsplugin
+    KomplexHubKeroplugin
     Qt6::Quick
     Qt6::Core
     Qt6::Gui