mirror of
https://github.com/AvengeMedia/DankMaterialShell.git
synced 2025-12-05 21:15:38 -05:00
1.7 KiB
1.7 KiB
Emoji Cycler Plugin
An example dms plugin that displays cycling emojis in your bar with an emoji picker popout.
Features
- Cycling Emojis: Automatically rotates through your selected emoji set in the bar
- Emoji Picker: Click the widget to open a grid of 120+ emojis
- Copy to Clipboard: Click any emoji in the picker to copy it to clipboard (uses
wl-copy) - Customizable: Choose emoji sets, cycle speed, and max emojis shown
Installation
- Copy this directory to
~/.config/DankMaterialShell/plugins/ExampleEmojiPlugin - Open DMS Settings → Plugins
- Click "Scan for Plugins"
- Enable "Emoji Cycler"
- Add
exampleEmojiPluginto your DankBar widget list
Settings
Emoji Set
Choose from different emoji collections:
- Happy & Sad: Mix of emotional faces
- Hearts: Various colored hearts
- Hand Gestures: Thumbs up, peace signs, etc.
- All Mixed: A bit of everything
Cycle Speed
Control how fast emojis rotate (500ms - 10000ms)
Max Bar Emojis
How many emojis to display at once (1-8)
Usage
In the bar: Watch emojis cycle through automatically Click the widget: Opens emoji picker with 120+ emojis Click any emoji: Copies it to clipboard and shows toast
Requirements
wl-copy(for clipboard support on Wayland)
Example Code Highlights
This plugin demonstrates:
- Using
PluginComponentfor bar integration SelectionSetting,SliderSettingfor configuration- Timer-based animation
- Popout content with grid layout
- External command execution (
Quickshell.execDetached) - Toast notifications (
ToastService.show) - Dynamic settings loading/saving
Perfect template for creating your own DMS plugins!