summaryrefslogtreecommitdiff
path: root/raveos-hyprland-theme/theme-data/dms/PLUGINS/LauncherImageExample/README.md
diff options
context:
space:
mode:
authorNippy <nippy@rp1.hu>2026-05-08 19:50:49 +0200
committerNippy <nippy@rp1.hu>2026-05-08 19:50:49 +0200
commit3462bcc46ecf74f576ea4397f16492c16bd75b10 (patch)
treec5ab7aef4498647e057bda8d49c11e5f9dda74c9 /raveos-hyprland-theme/theme-data/dms/PLUGINS/LauncherImageExample/README.md
parent56616f693b4f263cbf0d47da43b67424efa6022d (diff)
downloadRaveOS-PKGBUILD-3462bcc46ecf74f576ea4397f16492c16bd75b10.tar.gz
RaveOS-PKGBUILD-3462bcc46ecf74f576ea4397f16492c16bd75b10.zip
raveos update
Diffstat (limited to 'raveos-hyprland-theme/theme-data/dms/PLUGINS/LauncherImageExample/README.md')
-rw-r--r--raveos-hyprland-theme/theme-data/dms/PLUGINS/LauncherImageExample/README.md43
1 files changed, 43 insertions, 0 deletions
diff --git a/raveos-hyprland-theme/theme-data/dms/PLUGINS/LauncherImageExample/README.md b/raveos-hyprland-theme/theme-data/dms/PLUGINS/LauncherImageExample/README.md
new file mode 100644
index 0000000..13b608d
--- /dev/null
+++ b/raveos-hyprland-theme/theme-data/dms/PLUGINS/LauncherImageExample/README.md
@@ -0,0 +1,43 @@
+# LauncherImageExample
+
+Example launcher plugin demonstrating tile mode with URL-based images.
+
+## Features
+
+- **Tile Mode**: Uses `viewMode: "tile"` in plugin.json to display results as image tiles
+- **Enforced View Mode**: Uses `viewModeEnforced: true` to lock the view to tile mode (users cannot change it)
+- **URL Images**: Demonstrates using `imageUrl` property for remote images
+
+## Usage
+
+1. Open the launcher (DankLauncherV2)
+2. Type `img` to activate the plugin
+3. Browse DankMaterialShell screenshots in tile view
+
+## Plugin Configuration
+
+```json
+{
+ "viewMode": "tile",
+ "viewModeEnforced": true
+}
+```
+
+- `viewMode`: Sets the default view mode ("list", "grid", or "tile")
+- `viewModeEnforced`: When true, users cannot switch view modes for this plugin
+
+## Item Data Structure
+
+To display images in tile mode, set `imageUrl` directly on the item:
+
+```javascript
+{
+ name: "Image Title",
+ icon: "material:image",
+ comment: "Image description",
+ categories: ["Category"],
+ imageUrl: "https://example.com/image.png"
+}
+```
+
+The `imageUrl` property supports remote URLs or local files, use `file://` prefix for local files.