Add KDE Plasma Qt/QML native client (PHASE 10)

README.md

@@ -676,13 +676,37 @@ including integration with GitHub Copilot, Claude, and ChatGPT.
 
 ---
 
+## Clients
+
+### KDE Plasma Native Client (Recommended)
+
+RootStream now features a **native KDE Plasma Qt/QML client** for the best Linux desktop experience:
+
+```bash
+cd clients/kde-plasma-client
+mkdir build && cd build
+cmake -DCMAKE_BUILD_TYPE=Release ..
+make -j$(nproc)
+sudo make install
+```
+
+**Features:**
+- Native Qt 6 / QML interface
+- KDE Plasma integration
+- Hardware-accelerated decoding (VA-API)
+- PulseAudio/PipeWire audio support
+- AI logging mode for debugging
+- Comprehensive settings management
+
+See **[clients/kde-plasma-client/README.md](clients/kde-plasma-client/README.md)** for complete documentation.
+
 ## Contributing
 
 We welcome contributions! Areas needing help:
 
-1. **Client implementation** - Decoder + display
+1. **KDE client enhancement** - Video rendering, audio playback, input injection
 2. **NVENC support** - Direct API (not VA-API wrapper)
-3. **Audio streaming** - ALSA + Opus
+3. **Audio streaming** - Complete Opus implementation
 4. **H.265/HEVC** - Better compression
 5. **Cross-platform** - Windows/Mac clients
 6. **Mobile apps** - Android/iOS clients

clients/kde-plasma-client/CMakeLists.txt

@@ -0,0 +1,148 @@
+# RootStream KDE Plasma Client
+cmake_minimum_required(VERSION 3.16)
+project(rootstream-kde-client VERSION 1.0.0 LANGUAGES CXX C)
+
+set(CMAKE_CXX_STANDARD 17)
+set(CMAKE_CXX_STANDARD_REQUIRED ON)
+set(CMAKE_AUTOMOC ON)
+set(CMAKE_AUTORCC ON)
+set(CMAKE_AUTOUIC ON)
+
+# Build type
+if(NOT CMAKE_BUILD_TYPE)
+    set(CMAKE_BUILD_TYPE Release)
+endif()
+
+# Options
+option(ENABLE_AI_LOGGING "Enable AI logging support" ON)
+
+# Find Qt6
+find_package(Qt6 REQUIRED COMPONENTS Core Gui Qml Quick Widgets OpenGL)
+
+# Find KDE Frameworks  
+find_package(ECM QUIET NO_MODULE)
+if(ECM_FOUND)
+    set(CMAKE_MODULE_PATH ${ECM_MODULE_PATH})
+    find_package(KF6 COMPONENTS Config CoreAddons)
+endif()
+
+# Find other dependencies
+find_package(PkgConfig REQUIRED)
+pkg_check_modules(OPUS REQUIRED opus)
+pkg_check_modules(VAAPI libva libva-drm)
+pkg_check_modules(PULSEAUDIO libpulse-simple libpulse)
+pkg_check_modules(PIPEWIRE libpipewire-0.3)
+
+# Include RootStream library
+include_directories(${CMAKE_SOURCE_DIR}/../../include)
+
+# Sources
+set(SOURCES
+    src/main.cpp
+    src/rootstreamclient.cpp
+    src/peermanager.cpp
+    src/videorenderer.cpp
+    src/audioplayer.cpp
+    src/inputmanager.cpp
+    src/settingsmanager.cpp
+    src/logmanager.cpp
+    src/connectiondialog.cpp
+    src/mainwindow.cpp
+)
+
+# Headers (for MOC)
+set(HEADERS
+    src/rootstreamclient.h
+    src/peermanager.h
+    src/videorenderer.h
+    src/audioplayer.h
+    src/inputmanager.h
+    src/settingsmanager.h
+    src/logmanager.h
+    src/connectiondialog.h
+    src/mainwindow.h
+)
+
+# QML resources
+qt6_add_resources(QML_RESOURCES qml/qml.qrc)
+
+# Executable
+add_executable(rootstream-kde-client
+    ${SOURCES}
+    ${QML_RESOURCES}
+)
+
+target_link_libraries(rootstream-kde-client PRIVATE
+    Qt6::Core
+    Qt6::Gui
+    Qt6::Qml
+    Qt6::Quick
+    Qt6::Widgets
+    Qt6::OpenGL
+    ${OPUS_LIBRARIES}
+)
+
+# Link KDE Frameworks if available
+if(KF6_FOUND)
+    target_link_libraries(rootstream-kde-client PRIVATE
+        KF6::ConfigCore
+        KF6::CoreAddons
+    )
+endif()
+
+# Link PulseAudio if available
+if(PULSEAUDIO_FOUND)
+    target_link_libraries(rootstream-kde-client PRIVATE ${PULSEAUDIO_LIBRARIES})
+    target_include_directories(rootstream-kde-client PRIVATE ${PULSEAUDIO_INCLUDE_DIRS})
+    target_compile_definitions(rootstream-kde-client PRIVATE HAVE_PULSEAUDIO)
+endif()
+
+# Link PipeWire if available
+if(PIPEWIRE_FOUND)
+    target_link_libraries(rootstream-kde-client PRIVATE ${PIPEWIRE_LIBRARIES})
+    target_include_directories(rootstream-kde-client PRIVATE ${PIPEWIRE_INCLUDE_DIRS})
+    target_compile_definitions(rootstream-kde-client PRIVATE HAVE_PIPEWIRE)
+endif()
+
+# Link VA-API if available
+if(VAAPI_FOUND)
+    target_link_libraries(rootstream-kde-client PRIVATE ${VAAPI_LIBRARIES})
+    target_include_directories(rootstream-kde-client PRIVATE ${VAAPI_INCLUDE_DIRS})
+    target_compile_definitions(rootstream-kde-client PRIVATE HAVE_VAAPI)
+endif()
+
+# Link RootStream library (assume it's built separately)
+target_link_libraries(rootstream-kde-client PRIVATE
+    ${CMAKE_SOURCE_DIR}/../../build/librootstream.a
+    sodium
+    m
+    pthread
+)
+
+# AI Logging support
+if(ENABLE_AI_LOGGING)
+    target_compile_definitions(rootstream-kde-client PRIVATE ENABLE_AI_LOGGING)
+endif()
+
+# Installation
+install(TARGETS rootstream-kde-client RUNTIME DESTINATION bin)
+install(FILES ${CMAKE_CURRENT_SOURCE_DIR}/packaging/rootstream-kde-client.desktop
+        DESTINATION share/applications)
+install(FILES ${CMAKE_CURRENT_SOURCE_DIR}/packaging/icon.svg
+        DESTINATION share/icons/hicolor/scalable/apps
+        RENAME rootstream-kde-client.svg)
+
+# Tests
+enable_testing()
+add_subdirectory(tests)
+
+# Summary
+message(STATUS "")
+message(STATUS "RootStream KDE Plasma Client Configuration:")
+message(STATUS "  Qt Version:     ${Qt6_VERSION}")
+message(STATUS "  KDE Frameworks: ${KF6_FOUND}")
+message(STATUS "  VA-API:         ${VAAPI_FOUND}")
+message(STATUS "  PulseAudio:     ${PULSEAUDIO_FOUND}")
+message(STATUS "  PipeWire:       ${PIPEWIRE_FOUND}")
+message(STATUS "  AI Logging:     ${ENABLE_AI_LOGGING}")
+message(STATUS "")