plasma-taskmanager-zoom/README.md

Icon Task Manager with Zoom

An enhanced KDE Plasma widget based on the original org.kde.plasma.taskmanager, featuring macOS dock-like zoom effects and custom launch animations.

✨ Features

🔍 macOS Dock-like Zoom Effects

• Smooth zoom animations when hovering over task icons
• Configurable zoom intensity (10-100%)
• Multiple anchor points (Center, Bottom, Top, Corners)
• Adjustable timing (hover delay, reset delay, duration)
• 7 easing curves (Linear, OutQuad, OutCubic, OutQuart, OutBack, OutElastic, OutBounce)
• Performance optimized with 4ms ultra-responsive updates
• Smart state management for rapid mouse movements

🎭 Custom Launch Animations

• 7 animation types to choose from:

  1. Classic Busy Indicator (default) - Traditional spinning indicator overlay
  2. Pulsing Icon - Smooth scaling pulse effect
  3. Bouncing Icon - Realistic physics-based bouncing with multiple bounces
  4. Rotating Icon - Continuous rotation animation
  5. Scaling Icon - Complex bounce-scale with elastic settle
  6. Fading Icon - Dramatic fade in/out effect
  7. Glow Effect - Circular glow rings around the icon

• Configurable parameters:

  • Animation duration (500-3000ms)
  • Animation intensity (10-100%)
  • Automatic zoom override during startup

🚀 Performance Enhancements

• Ultra-responsive 4ms update cycles for rapid mouse movements
• Optimized caching systems for expensive layout calculations
• Binding loop fixes and memory optimizations
• Zero performance impact when using default settings

🎯 Activity & Desktop Integration

• Virtual desktop aware zoom effects
• Activity-specific task filtering
• Multi-screen support with proper scaling
• Theme integration for consistent appearance

📦 Installation

Method 1: From KDE Store (Recommended)

1. Open System Settings → Workspace → Plasma Style
2. Click Get New Plasma Widgets
3. Search for "Icon Task Manager with Zoom"
4. Click Install

Method 2: Manual Installation

1. Download the latest .plasmoid file from releases
2. Right-click on your panel → Add Widgets
3. Click Get New Widgets → Install Widget From Local File
4. Select the downloaded .plasmoid file

Method 3: From Source

git clone https://github.com/kde-plasma-taskmanager-zoom
cd kde-plasma-taskmanager-zoom
kpackagetool6 --install . --type Plasma/Applet

⚙️ Configuration

Right-click the widget → Configure Icon Task Manager with Zoom

Zoom Effects Tab

• Magnify Factor: Control zoom intensity (0.1-1.0)
• Duration: Animation speed (50-500ms)
• Easing: Choose from 7 animation curves
• Hover Delay: Delay before zoom starts (0-300ms)
• Reset Delay: Delay before zoom resets (0-300ms)
• Anchor Point: Where zoom originates from

Launch Animations Tab

• Animation Type: Choose from 7 different animations
• Duration: How long each animation cycle lasts (500-3000ms)
• Intensity: Scale factor for animation effects (0.1-1.0)

🏗️ Building a Package

To create a .plasmoid package for distribution:

# Create the package
zip -r org.kde.plasma.icontasks.zoom.plasmoid . -x "*.git*" "*.md" "screenshots/*"

# Or use the KDE packaging tool
kpackagetool6 --type Plasma/Applet --generate-index .

🤝 Contributing

This project is based on the original KDE Plasma Task Manager. Contributions are welcome!

Guidelines

• Follow KDE coding standards
• Test on multiple Plasma versions
• Include screenshots for UI changes
• Update documentation as needed

📄 License

This project is licensed under GPL-2.0+, maintaining compatibility with the original KDE Plasma Task Manager.

🙏 Credits

• Original Task Manager: KDE Plasma Team, primarily Eike Hein
• Zoom & Animation Enhancements: Community contributions
• Performance Optimizations: Various contributors

Based On

• org.kde.plasma.taskmanager - The original KDE Plasma task manager
• org.kde.plasma.icontasks - Icon-only variant

🐛 Bug Reports

Found a bug? Please report it on our GitHub Issues page.

📸 Screenshots

macOS dock-like zoom effect in action

Custom launch animations showcase

Easy-to-use configuration interface

---

Enjoy your enhanced Plasma desktop experience! 🚀