{"id":47936815,"url":"https://github.com/osmn-byhn/kurug","last_synced_at":"2026-04-04T07:44:53.415Z","repository":{"id":347867442,"uuid":"1193198714","full_name":"osmn-byhn/kurug","owner":"osmn-byhn","description":"Kurug is an open-source, modern widget management platform designed to make your desktop entirely personal","archived":false,"fork":false,"pushed_at":"2026-03-29T22:34:27.000Z","size":432,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-04T07:44:51.887Z","etag":null,"topics":["app","electron","linux","mac","project-completed","web","web-widget","widget","widget-manager"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/osmn-byhn.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-27T01:15:22.000Z","updated_at":"2026-03-31T03:05:03.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/osmn-byhn/kurug","commit_stats":null,"previous_names":["osmn-byhn/kurug"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/osmn-byhn/kurug","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/osmn-byhn%2Fkurug","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/osmn-byhn%2Fkurug/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/osmn-byhn%2Fkurug/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/osmn-byhn%2Fkurug/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/osmn-byhn","download_url":"https://codeload.github.com/osmn-byhn/kurug/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/osmn-byhn%2Fkurug/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31392186,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-04T04:26:24.776Z","status":"ssl_error","status_checked_at":"2026-04-04T04:23:34.147Z","response_time":60,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["app","electron","linux","mac","project-completed","web","web-widget","widget","widget-manager"],"created_at":"2026-04-04T07:44:52.837Z","updated_at":"2026-04-04T07:44:53.400Z","avatar_url":"https://github.com/osmn-byhn.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"./public/logo.png\" width=\"128\" alt=\"Kurug Logo\" /\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eKurug\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eModern, Flexible and Powerful Desktop Widget Manager\u003c/strong\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Version-1.0.0-blue?style=for-the-badge\" alt=\"Version\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Platform-Linux%20%7C%20Windows%20%7C%20Mac-blueviolet?style=for-the-badge\" alt=\"Platform\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Stack-React%20%7C%20Electron%20%7C%20Vite-61dafb?style=for-the-badge\" alt=\"Stack\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/License-MIT-green?style=for-the-badge\" alt=\"License\" /\u003e\n\u003c/p\u003e\n\n## 🌟 What is Kurug?\n\n**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\".\n\n## ✨ Key Features\n\n* **🚀 Multi-Source Support:**\n  * **Git Repositories:** Paste GitHub, GitLab, or Bitbucket links; Kurug automatically clones and runs them.\n  * **Direct URLs:** Instantly turn any website or web application into a widget.\n  * **Local Folders:** Directly link local projects you've developed on your computer.\n* **🛡️ Isolated Execution:** Each widget runs as an independent process from the main application. If one widget crashes, others or the main app remain unaffected.\n* **🎨 Modern Design:** The interface, prepared with glassmorphism aesthetics, fits perfectly into your system with both Dark and Light theme options.\n* **🛠️ 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).\n* **📦 Native Performance:** Provides low resource consumption and high performance through native file access, bypassing heavy packaging methods.\n\n## 🛠️ How to Use?\n\n1. **Add Widget:** Click the **\"Add Widget\"** button on the home screen.\n2. **Define Source:**\n    * You can enter a Git link (Kurug downloads it for you).\n    * You can select a folder.\n    * Or just enter a URL.\n3. **Activation:** Turn on the switch next to the widget added to the list. Your widget will appear on your desktop in seconds!\n4. **Personalization:** Click the \"Settings\" icon to adjust the size and position of the widget on the screen as you wish.\n\n## 🏗️ Technical Architecture\n\nKurug is built with the most modern web technologies:\n\n* **Frontend:** React 19 + TypeScript + Vite (Ultra-fast development and build process).\n* **Styling:** Tailwind CSS (Modern and flexible design system).\n* **Runtime:** Electron (Native desktop integration).\n* **Engine:** `@osmn-byhn/widget-core` (Custom engine for widget isolation and system integration).\n* **Database:** LowDB (Fast and reliable local data storage).\n\n## 🚀 Development and Installation\n\nTo run the project locally:\n\n```bash\n# Install dependencies\nnpm install\n\n# Start in development mode\nnpm run electron:dev\n```\n\n### Packaging (Build)\n\nKurug has optimized packaging scripts for different operating systems:\n\n```bash\n# For Windows (.exe)\nnpm run package:win\n\n# For Debian/Ubuntu (.deb)\nnpm run package:deb\n\n# For Fedora/RedHat (.rpm)\nnpm run package:rpm\n\n# For AppImage (.AppImage)\nnpm run package:appimage\n\n# For macOS (.dmg)\nnpm run package:mac\n```\n\n## 📄 License\n\nThis project is licensed under the **MIT** License - see the [LICENSE](LICENSE) file for details.\n\n---\n\u003cp align=\"center\"\u003e\n  Crafted with ❤️ by \u003ca href=\"https://github.com/osmn-byhn\"\u003eOsman Beyhan\u003c/a\u003e\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fosmn-byhn%2Fkurug","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fosmn-byhn%2Fkurug","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fosmn-byhn%2Fkurug/lists"}