mirror of
https://github.com/AvengeMedia/DankMaterialShell.git
synced 2026-10-15 15:54:00 -04:00
bbedward
ccbf1d38ad
deprecation notice to plugin compatibility shims - When qml-common became a thing, we left qs.Widgets shims in place for plugin compatibility - It's annoying to need to maintain them when qml-common has any change, add a warning so we can safely deprecate them in the future - One shot rename the common stuff to D to make it shorter and nicer to write
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
- 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
Example Code Highlights
This plugin demonstrates:
- Using
PluginComponentfor bar integration SelectionSetting,SliderSettingfor configuration- Plugin-local translations (
translations/+I18n.trFor) - 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!