Modern, Flexible and Powerful Desktop Widget Manager
Kurug is an open-source, modern widget management platform designed to make your desktop entirely personal. Whether it's weather, a stock ticker, or just a stylish clock; Kurug allows you to place any content prepared with web technologies (HTML, JS, CSS) directly on your desktop as a persistent and interactive "widget".
- 🚀 Multi-Source Support:
- Git Repositories: Paste GitHub, GitLab, or Bitbucket links; Kurug automatically clones and runs them.
- Direct URLs: Instantly turn any website or web application into a widget.
- Local Folders: Directly link local projects you've developed on your computer.
- 🛡️ Isolated Execution: Each widget runs as an independent process from the main application. If one widget crashes, others or the main app remain unaffected.
- 🎨 Modern Design: The interface, prepared with glassmorphism aesthetics, fits perfectly into your system with both Dark and Light theme options.
- 🛠️ Easy Management: Manage all your widgets from a single panel. Toggle them all on/off with one click or customize their settings (size, position, opacity).
- 📦 Native Performance: Provides low resource consumption and high performance through native file access, bypassing heavy packaging methods.
- Add Widget: Click the "Add Widget" button on the home screen.
- Define Source:
- You can enter a Git link (Kurug downloads it for you).
- You can select a folder.
- Or just enter a URL.
- Activation: Turn on the switch next to the widget added to the list. Your widget will appear on your desktop in seconds!
- Personalization: Click the "Settings" icon to adjust the size and position of the widget on the screen as you wish.
Kurug is built with the most modern web technologies:
- Frontend: React 19 + TypeScript + Vite (Ultra-fast development and build process).
- Styling: Tailwind CSS (Modern and flexible design system).
- Runtime: Electron (Native desktop integration).
- Engine:
@osmn-byhn/widget-core(Custom engine for widget isolation and system integration). - Database: LowDB (Fast and reliable local data storage).
To run the project locally:
# Install dependencies
npm install
# Start in development mode
npm run electron:devKurug has optimized packaging scripts for different operating systems:
# For Windows (.exe)
npm run package:win
# For Debian/Ubuntu (.deb)
npm run package:deb
# For Fedora/RedHat (.rpm)
npm run package:rpm
# For AppImage (.AppImage)
npm run package:appimage
# For macOS (.dmg)
npm run package:macThis project is licensed under the MIT License - see the LICENSE file for details.
Crafted with ❤️ by Osman Beyhan