1
0
mirror of https://github.com/AvengeMedia/DankMaterialShell.git synced 2026-01-24 13:32:50 -05:00
Files
DankMaterialShell/quickshell/PLUGINS/LauncherImageExample/README.md
bbedward 1d5d876e16 launcher: Dank Launcher V2 (beta)
- Aggregate plugins/extensions in new "all" tab
- Quick tab actions
- New tile mode for results
- Plugins can enforce/require view mode, or set preferred default
- Danksearch under "files" category
2026-01-20 17:59:13 -05:00

44 lines
1.1 KiB
Markdown

# 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.