wpe-manager 0.5.0__tar.gz

wpe_manager-0.5.0/LICENSE

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

wpe_manager-0.5.0/PKG-INFO

@@ -0,0 +1,170 @@
+Metadata-Version: 2.4
+Name: wpe-manager
+Version: 0.5.0
+Summary: A fast, native GUI over linux-wallpaperengine with per-screen assignment and playlist rotation
+Author-email: Dragonir <dragonir44@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/Dragonir44/wpe-manager
+Project-URL: Repository, https://github.com/Dragonir44/wpe-manager
+Project-URL: Issues, https://github.com/Dragonir44/wpe-manager/issues
+Keywords: wallpaper,wallpaper-engine,linux-wallpaperengine,kde,wayland
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: X11 Applications :: Qt
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Desktop Environment
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: PySide6>=6.5
+Dynamic: license-file
+
+# Wallpaper Engine Manager
+
+Une petite GUI native (PySide6/Qt) au-dessus de
+[`linux-wallpaperengine`](https://github.com/Almamu/linux-wallpaperengine).
+Elle fait ce que les frontends existants faisaient mal : gérer correctement une
+bibliothèque Steam sur un autre disque, transmettre le bon `--assets-dir`, et
+proposer des **playlists tournantes par écran** — le tout en restant fluide.
+
+Testé sur KDE Plasma 6 / Wayland (CachyOS), mais ne dépend d'aucune API KDE.
+
+## Fonctionnalités
+
+- **Détection auto** de la bibliothèque (`workshop/content/431960`) même sur un
+  autre disque — lit `libraryfolders.vdf` et résout les symlinks pour retrouver
+  le dossier des assets.
+- **Grille de vignettes**, chargées en tâche de fond (fluide même à 500+ fonds).
+- **Recherche** par titre.
+- **Filtres combinés** : genre, type, évaluation d'âge (tout en local depuis
+  `project.json`), **résolution**, et un filtre **« Compatible écran »** qui ne
+  montre que les fonds au bon ratio pour l'écran sélectionné (idéal multi-écran /
+  ultrawide). Tri par titre ou par taille.
+- **Résolution via Steam** : la résolution est un tag Workshop absent des fichiers
+  locaux ; l'app la récupère depuis l'API publique Steam (**sans clé**), la met en
+  cache (`metadata.json`) — instantané et hors-ligne ensuite. Bouton « Sync Steam »
+  et sync auto au premier lancement.
+- **Un process par écran** : changer un écran ne redémarre pas les autres.
+- **Assignation par écran** : un **fond fixe** ou une **playlist tournante**.
+- **Playlists** créées par **cases à cocher** dans la grille, avec **intervalle**
+  et **ordre** (séquentiel / aléatoire).
+- **Import depuis Wallpaper Engine** : récupère les playlists du `config.json`
+  de WPE (extrait les IDs, ignore les chemins/moniteurs Windows non portables).
+- **Propriétés par fond** : bouton *Propriétés…* pour personnaliser un fond
+  (couleurs, curseurs, cases à cocher, listes de choix). Les réglages sont
+  enregistrés par fond et réappliqués à chaque lancement via `--set-property` ;
+  si le fond est affiché, il se recharge aussitôt.
+- **Transition sans coupure** : le nouveau fond est affiché *par-dessus* l'ancien
+  avant que celui-ci soit tué (pas de fondu alpha — le backend ne le permet pas —
+  mais plus de flash du fond de bureau entre deux).
+- **Barre système (systray)** : fermer la fenêtre la réduit dans le tray ; la
+  **rotation continue** en arrière-plan. Le menu de l'icône permet de changer la
+  playlist de chaque écran, de vider un écran, de tout arrêter, et de rouvrir.
+- **Démarrage avec la session** : une case (ou l'entrée du menu tray) installe
+  un lanceur autostart qui relance l'app dans le tray et **restaure les fonds
+  (rotation comprise)** à l'ouverture de session.
+- **Options** : muet, FPS, durée de transition (ms).
+
+## Prérequis
+
+- [`linux-wallpaperengine`](https://github.com/Almamu/linux-wallpaperengine)
+  installé et dans le `PATH`.
+- Wallpaper Engine (l'app Steam, app id `431960`) installé, pour disposer des
+  **assets** et des wallpapers du workshop.
+- Python ≥ 3.10 et PySide6 (installé automatiquement via pip).
+
+## Installation
+
+### Toute distribution (PyPI)
+
+```bash
+pipx install wpe-manager     # recommandé (environnement isolé)
+# ou
+pip install --user wpe-manager
+```
+
+### Arch / CachyOS / dérivés (AUR)
+
+```bash
+paru -S wpe-manager          # ou : yay -S wpe-manager
+```
+
+Le paquet AUR tire le backend `linux-wallpaperengine-git` automatiquement.
+
+### Depuis les sources
+
+```bash
+pipx install .               # ou : pip install --user .
+# ou sans installer :
+python -m wpe_manager
+```
+
+Puis lance la commande :
+
+```bash
+wpe-manager
+```
+
+## Utilisation
+
+1. Choisis un **écran** dans le menu en haut.
+2. Clique un fond (ou double-clic) → **Fond sélectionné → écran** pour un fond fixe.
+3. Pour une rotation : coche des fonds → **Nouvelle (depuis cochés)**, nomme la
+   playlist, règle **intervalle** + **ordre**, puis **Playlist → écran**.
+4. **Vider l'écran** / **Tout arrêter** au besoin.
+
+Si la bibliothèque n'est pas trouvée automatiquement, bouton **Chemins…** pour la
+pointer à la main.
+
+> Fermer la fenêtre la **réduit dans la barre système** : la rotation continue.
+> Clic sur l'icône pour rouvrir, clic droit → **Quitter** pour fermer réellement.
+
+## Fichiers de config
+
+- `~/.config/wpe-manager/config.json` — chemins, muet, FPS, transition.
+- `~/.config/wpe-manager/state.json` — assignations par écran (fond / playlist).
+- `~/.config/wpe-manager/playlists.json` — playlists.
+- `~/.config/wpe-manager/engine.json` — process backend en cours (par écran).
+- `~/.config/wpe-manager/metadata.json` — cache des résolutions (Steam Workshop).
+- `~/.config/wpe-manager/properties.json` — propriétés personnalisées par fond.
+
+## Autostart (restaurer les fonds à l'ouverture de session)
+
+Le plus simple : coche **Démarrer avec la session** (barre du haut ou menu du
+tray). L'app écrit `~/.config/autostart/wpe-manager.desktop` pour toi.
+
+Sous le capot, l'entrée lance `wpe-manager --daemon` (alias historique :
+`--autostart`) : l'app démarre **cachée dans la barre système**, restaure les
+fonds sauvegardés et **reprend la rotation**.
+
+## Entrée dans le menu des applications
+
+Coche **Menu applications** (barre du haut ou menu du tray) pour ajouter un
+lanceur dans le menu de ton bureau (`~/.local/share/applications/`) et ouvrir
+l'app comme n'importe quel programme. Fonctionne aussi bien depuis une
+installation pip/pipx que depuis les sources.
+
+## Compatibilité & limites connues
+
+Cette app n'est qu'un frontend ; ce qui fonctionne dépend surtout du backend.
+
+- **Backend requis** : `linux-wallpaperengine` doit être installé et dans le
+  `PATH`. Il est packagé sur l'AUR ; sur Debian/Fedora/etc. il faut le
+  **compiler depuis les sources**.
+- **Bureau** : testé sur **KDE Plasma / Wayland**. Fonctionne sur les
+  compositeurs qui supportent `wlr-layer-shell` (KWin, wlroots) et sous X11.
+  **GNOME Wayland (Mutter) n'implémente pas layer-shell** → le backend ne peut
+  pas y dessiner le fond ; c'est une limite du compositeur, pas de cette app.
+- **Wayland** : le fond est dessiné **par-dessus** le bureau → pas d'icônes ni
+  de clic droit sur le bureau tant qu'un fond animé est actif (limite du
+  backend).
+
+## Remerciements
+
+Ce projet n'est qu'un frontend ; tout le rendu est assuré par
+[Almamu/linux-wallpaperengine](https://github.com/Almamu/linux-wallpaperengine).

wpe_manager-0.5.0/README.md

@@ -0,0 +1,144 @@
+# Wallpaper Engine Manager
+
+Une petite GUI native (PySide6/Qt) au-dessus de
+[`linux-wallpaperengine`](https://github.com/Almamu/linux-wallpaperengine).
+Elle fait ce que les frontends existants faisaient mal : gérer correctement une
+bibliothèque Steam sur un autre disque, transmettre le bon `--assets-dir`, et
+proposer des **playlists tournantes par écran** — le tout en restant fluide.
+
+Testé sur KDE Plasma 6 / Wayland (CachyOS), mais ne dépend d'aucune API KDE.
+
+## Fonctionnalités
+
+- **Détection auto** de la bibliothèque (`workshop/content/431960`) même sur un
+  autre disque — lit `libraryfolders.vdf` et résout les symlinks pour retrouver
+  le dossier des assets.
+- **Grille de vignettes**, chargées en tâche de fond (fluide même à 500+ fonds).
+- **Recherche** par titre.
+- **Filtres combinés** : genre, type, évaluation d'âge (tout en local depuis
+  `project.json`), **résolution**, et un filtre **« Compatible écran »** qui ne
+  montre que les fonds au bon ratio pour l'écran sélectionné (idéal multi-écran /
+  ultrawide). Tri par titre ou par taille.
+- **Résolution via Steam** : la résolution est un tag Workshop absent des fichiers
+  locaux ; l'app la récupère depuis l'API publique Steam (**sans clé**), la met en
+  cache (`metadata.json`) — instantané et hors-ligne ensuite. Bouton « Sync Steam »
+  et sync auto au premier lancement.
+- **Un process par écran** : changer un écran ne redémarre pas les autres.
+- **Assignation par écran** : un **fond fixe** ou une **playlist tournante**.
+- **Playlists** créées par **cases à cocher** dans la grille, avec **intervalle**
+  et **ordre** (séquentiel / aléatoire).
+- **Import depuis Wallpaper Engine** : récupère les playlists du `config.json`
+  de WPE (extrait les IDs, ignore les chemins/moniteurs Windows non portables).
+- **Propriétés par fond** : bouton *Propriétés…* pour personnaliser un fond
+  (couleurs, curseurs, cases à cocher, listes de choix). Les réglages sont
+  enregistrés par fond et réappliqués à chaque lancement via `--set-property` ;
+  si le fond est affiché, il se recharge aussitôt.
+- **Transition sans coupure** : le nouveau fond est affiché *par-dessus* l'ancien
+  avant que celui-ci soit tué (pas de fondu alpha — le backend ne le permet pas —
+  mais plus de flash du fond de bureau entre deux).
+- **Barre système (systray)** : fermer la fenêtre la réduit dans le tray ; la
+  **rotation continue** en arrière-plan. Le menu de l'icône permet de changer la
+  playlist de chaque écran, de vider un écran, de tout arrêter, et de rouvrir.
+- **Démarrage avec la session** : une case (ou l'entrée du menu tray) installe
+  un lanceur autostart qui relance l'app dans le tray et **restaure les fonds
+  (rotation comprise)** à l'ouverture de session.
+- **Options** : muet, FPS, durée de transition (ms).
+
+## Prérequis
+
+- [`linux-wallpaperengine`](https://github.com/Almamu/linux-wallpaperengine)
+  installé et dans le `PATH`.
+- Wallpaper Engine (l'app Steam, app id `431960`) installé, pour disposer des
+  **assets** et des wallpapers du workshop.
+- Python ≥ 3.10 et PySide6 (installé automatiquement via pip).
+
+## Installation
+
+### Toute distribution (PyPI)
+
+```bash
+pipx install wpe-manager     # recommandé (environnement isolé)
+# ou
+pip install --user wpe-manager
+```
+
+### Arch / CachyOS / dérivés (AUR)
+
+```bash
+paru -S wpe-manager          # ou : yay -S wpe-manager
+```
+
+Le paquet AUR tire le backend `linux-wallpaperengine-git` automatiquement.
+
+### Depuis les sources
+
+```bash
+pipx install .               # ou : pip install --user .
+# ou sans installer :
+python -m wpe_manager
+```
+
+Puis lance la commande :
+
+```bash
+wpe-manager
+```
+
+## Utilisation
+
+1. Choisis un **écran** dans le menu en haut.
+2. Clique un fond (ou double-clic) → **Fond sélectionné → écran** pour un fond fixe.
+3. Pour une rotation : coche des fonds → **Nouvelle (depuis cochés)**, nomme la
+   playlist, règle **intervalle** + **ordre**, puis **Playlist → écran**.
+4. **Vider l'écran** / **Tout arrêter** au besoin.
+
+Si la bibliothèque n'est pas trouvée automatiquement, bouton **Chemins…** pour la
+pointer à la main.
+
+> Fermer la fenêtre la **réduit dans la barre système** : la rotation continue.
+> Clic sur l'icône pour rouvrir, clic droit → **Quitter** pour fermer réellement.
+
+## Fichiers de config
+
+- `~/.config/wpe-manager/config.json` — chemins, muet, FPS, transition.
+- `~/.config/wpe-manager/state.json` — assignations par écran (fond / playlist).
+- `~/.config/wpe-manager/playlists.json` — playlists.
+- `~/.config/wpe-manager/engine.json` — process backend en cours (par écran).
+- `~/.config/wpe-manager/metadata.json` — cache des résolutions (Steam Workshop).
+- `~/.config/wpe-manager/properties.json` — propriétés personnalisées par fond.
+
+## Autostart (restaurer les fonds à l'ouverture de session)
+
+Le plus simple : coche **Démarrer avec la session** (barre du haut ou menu du
+tray). L'app écrit `~/.config/autostart/wpe-manager.desktop` pour toi.
+
+Sous le capot, l'entrée lance `wpe-manager --daemon` (alias historique :
+`--autostart`) : l'app démarre **cachée dans la barre système**, restaure les
+fonds sauvegardés et **reprend la rotation**.
+
+## Entrée dans le menu des applications
+
+Coche **Menu applications** (barre du haut ou menu du tray) pour ajouter un
+lanceur dans le menu de ton bureau (`~/.local/share/applications/`) et ouvrir
+l'app comme n'importe quel programme. Fonctionne aussi bien depuis une
+installation pip/pipx que depuis les sources.
+
+## Compatibilité & limites connues
+
+Cette app n'est qu'un frontend ; ce qui fonctionne dépend surtout du backend.
+
+- **Backend requis** : `linux-wallpaperengine` doit être installé et dans le
+  `PATH`. Il est packagé sur l'AUR ; sur Debian/Fedora/etc. il faut le
+  **compiler depuis les sources**.
+- **Bureau** : testé sur **KDE Plasma / Wayland**. Fonctionne sur les
+  compositeurs qui supportent `wlr-layer-shell` (KWin, wlroots) et sous X11.
+  **GNOME Wayland (Mutter) n'implémente pas layer-shell** → le backend ne peut
+  pas y dessiner le fond ; c'est une limite du compositeur, pas de cette app.
+- **Wayland** : le fond est dessiné **par-dessus** le bureau → pas d'icônes ni
+  de clic droit sur le bureau tant qu'un fond animé est actif (limite du
+  backend).
+
+## Remerciements
+
+Ce projet n'est qu'un frontend ; tout le rendu est assuré par
+[Almamu/linux-wallpaperengine](https://github.com/Almamu/linux-wallpaperengine).

wpe_manager-0.5.0/pyproject.toml

@@ -0,0 +1,41 @@
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "wpe-manager"
+dynamic = ["version"]
+description = "A fast, native GUI over linux-wallpaperengine with per-screen assignment and playlist rotation"
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Dragonir", email = "dragonir44@gmail.com" }]
+dependencies = ["PySide6>=6.5"]
+keywords = ["wallpaper", "wallpaper-engine", "linux-wallpaperengine", "kde", "wayland"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: X11 Applications :: Qt",
+    "Intended Audience :: End Users/Desktop",
+    "Operating System :: POSIX :: Linux",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Desktop Environment",
+]
+
+[project.urls]
+Homepage = "https://github.com/Dragonir44/wpe-manager"
+Repository = "https://github.com/Dragonir44/wpe-manager"
+Issues = "https://github.com/Dragonir44/wpe-manager/issues"
+
+[project.gui-scripts]
+wpe-manager = "wpe_manager.__main__:main"
+
+[tool.setuptools]
+packages = ["wpe_manager"]
+
+[tool.setuptools.dynamic]
+version = { attr = "wpe_manager.__version__" }

wpe_manager-0.5.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

wpe_manager-0.5.0/wpe_manager/__init__.py

@@ -0,0 +1,2 @@
+"""Wallpaper Engine Manager — a thin, fast GUI over linux-wallpaperengine."""
+__version__ = "0.5.0"

wpe_manager-0.5.0/wpe_manager/__main__.py

@@ -0,0 +1,98 @@
+"""Entry point.
+
+    python -m wpe_manager              launch the GUI (with a system-tray icon)
+    python -m wpe_manager --daemon     start hidden in the tray and re-apply the
+                                       saved wallpapers, so playlist rotation
+                                       resumes at session login. Suitable for an
+                                       autostart entry (see config.install_autostart).
+
+    --autostart is kept as an alias of --daemon for older autostart entries.
+
+Only ONE instance runs at a time. A second launch just tells the running one to
+show its window (and exits), so the daemon started at login and a later manual
+launch never fight over the config files.
+"""
+from __future__ import annotations
+
+import os
+import sys
+
+from . import config
+
+_SERVER_NAME = f"wpe-manager-{os.getuid()}"
+
+
+def _signal_existing(daemon: bool) -> bool:
+    """If another instance is listening, ask it to show its window and return
+    True (we should exit). Return False if we're the first instance."""
+    from PySide6.QtNetwork import QLocalSocket
+
+    sock = QLocalSocket()
+    sock.connectToServer(_SERVER_NAME)
+    if not sock.waitForConnected(300):
+        return False
+    # A daemon relaunch shouldn't pop the window open; a plain launch should.
+    sock.write(b"noop" if daemon else b"show")
+    sock.flush()
+    sock.waitForBytesWritten(500)
+    sock.disconnectFromServer()
+    return True
+
+
+def main() -> int:
+    daemon = "--daemon" in sys.argv or "--autostart" in sys.argv
+
+    from PySide6.QtNetwork import QLocalServer
+    from PySide6.QtWidgets import QApplication
+
+    from .gui import MainWindow, app_icon
+
+    app = QApplication(sys.argv)
+    app.setApplicationName("Wallpaper Engine Manager")
+    app.setWindowIcon(app_icon())
+    # The tray keeps the app alive when the window is hidden/closed.
+    app.setQuitOnLastWindowClosed(False)
+
+    # Single-instance guard: hand off to a running instance if there is one.
+    if _signal_existing(daemon):
+        return 0
+
+    cfg = config.load_config()
+    win = MainWindow(cfg)
+
+    # We're the primary instance: listen so later launches can reach us.
+    QLocalServer.removeServer(_SERVER_NAME)  # clear a stale socket if any
+    server = QLocalServer(app)
+    server.listen(_SERVER_NAME)
+
+    def _on_new_connection() -> None:
+        conn = server.nextPendingConnection()
+        if conn is None:
+            return
+        if conn.waitForReadyRead(300):
+            msg = bytes(conn.readAll().data())
+            if msg.startswith(b"show"):
+                win.showNormal()
+                win.raise_()
+                win.activateWindow()
+        conn.disconnectFromServer()
+
+    server.newConnection.connect(_on_new_connection)
+
+    if daemon:
+        # Resume the saved assignments (launches wallpapers, arms rotation
+        # timers) and stay hidden in the tray.
+        if cfg.is_usable():
+            win.controller.apply()
+        # If there's no tray to live in, fall back to showing the window so the
+        # app isn't invisible and unreachable.
+        if win._tray is None:
+            win.show()
+    else:
+        win.show()
+
+    return app.exec()
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())