# felixhageloh/uebersicht **Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/felixhageloh-uebersicht).** 4,886 stars · 175 forks · Objective-C · gpl-3.0 ## Links - GitHub: https://github.com/felixhageloh/uebersicht - awesome-repositories: https://awesome-repositories.com/repository/felixhageloh-uebersicht.md ## Description Übersicht is a desktop widget engine for macOS that renders JavaScript-based widgets as live content directly on the desktop background. Widgets are authored using JSX syntax with inline CSS styling, enabling a React-like component model and automatic code reload without manual refreshing. The engine provides built-in bridges for executing arbitrary shell commands asynchronously, accessing device geographic location with street-level detail, and routing outbound HTTP requests through a local proxy to bypass cross-origin restrictions when fetching external data. Distinctively, widgets can be automated via AppleScript commands for refresh, hide, and list operations, and each widget runs in its own WebKit view served by a lightweight Node.js HTTP server within the application. A file-based discovery system automatically loads all widgets placed in a designated directory. The shell command API returns stdout and stderr as promises, and the proxy-based API routing allows widgets to access external services without CORS errors. Beyond these core capabilities, Übersicht supports live data display from APIs, shell commands, and device sensors, enabling system monitoring widgets that show real-time metrics such as CPU, memory, and network usage. Widget definition includes access to a server-side module system, and the geolocation bridge returns detailed address data including street, city, state, and country. The documentation covers widget creation, API usage, and AppleScript automation commands for advanced control. ## Tags ### Part of an Awesome List - [Customizable Desktop Widgets](https://awesome-repositories.com/f/awesome-lists/devtools/customizable-desktop-widgets.md) — Provides a framework for building interactive macOS desktop widgets using JavaScript and JSX. - [Desktop Location Widgets](https://awesome-repositories.com/f/awesome-lists/data/geographic-and-location/desktop-location-widgets.md) — Retrieves the device's current or watched geographic position, including street-level address data, from within a widget. ([source](https://github.com/felixhageloh/uebersicht/blob/master/README.md)) - [Device Location Retrievers](https://awesome-repositories.com/f/awesome-lists/data/geographic-and-location/device-location-retrievers.md) — Ships a geolocation bridge that returns street-level address data from within desktop widgets. ([source](https://github.com/felixhageloh/uebersicht/blob/master/ClassicWidgets.md)) - [Developer Utilities](https://awesome-repositories.com/f/awesome-lists/devtools/developer-utilities.md) — Displays system command output as desktop widgets. ### Development Tools & Productivity - [Widget Directory Scanners](https://awesome-repositories.com/f/development-tools-productivity/command-hierarchies/file-based-discovery/widget-directory-scanners.md) — Automatically discovers and loads all widget files placed in a designated directory without manual configuration. - [Shell Command Widgets](https://awesome-repositories.com/f/development-tools-productivity/desktop-shells/shell-command-widgets.md) — Enables widgets to execute shell commands and display real-time system information on the desktop. - [Shell Command Execution](https://awesome-repositories.com/f/development-tools-productivity/shell-command-execution.md) — Executes arbitrary shell commands asynchronously from widgets and returns output as promises. ([source](https://github.com/felixhageloh/uebersicht#readme)) - [Widget Shell Command APIs](https://awesome-repositories.com/f/development-tools-productivity/shell-command-execution/widget-shell-command-apis.md) — Provides an API for executing shell commands from within widgets and processing their output asynchronously. ### Graphics & Multimedia - [System-Webview-Based Renderers](https://awesome-repositories.com/f/graphics-multimedia/graphics-engines-rendering/rendering/systems/dom-web-rendering-strategies/system-webview-based-renderers.md) — Renders widget UIs inside an embedded WebKit view that displays HTML and JavaScript on the macOS desktop background. ### Networking & Communication - [API Request Proxying](https://awesome-repositories.com/f/networking-communication/api-request-proxying.md) — Routes HTTP requests to external servers through a built-in proxy to bypass cross-origin restrictions. ([source](https://github.com/felixhageloh/uebersicht/blob/master/README.md)) - [CORS Proxies](https://awesome-repositories.com/f/networking-communication/cors-proxies.md) — Routes widget HTTP requests through a built-in proxy to bypass cross-origin restrictions. - [Widget](https://awesome-repositories.com/f/networking-communication/http-proxies/widget.md) — Ships a built-in HTTP proxy that routes widget requests to bypass cross-origin restrictions. - [Local HTTP Servers](https://awesome-repositories.com/f/networking-communication/local-http-servers.md) — Embeds a lightweight Node.js HTTP server to serve widget files and route API calls within the application. ### Operating Systems & Systems Programming - [AppleScript Integrations](https://awesome-repositories.com/f/operating-systems-systems-programming/desktop-environment-frameworks/desktop-environment-components/desktop-applications/desktop-application-automation/applescript-integrations.md) — Ships a built-in AppleScript interface for controlling widget refresh, hide, and list operations from external scripts. ### Programming Languages & Runtimes - [CSS-in-JSX Integration](https://awesome-repositories.com/f/programming-languages-runtimes/language-features-paradigms/language-features/language-extensions/jsx-syntax/css-in-jsx-integration.md) — Widgets are authored using JSX syntax with inline CSS styling, enabling a React-like component model with live reload. ### System Administration & Monitoring - [Resource Monitoring Widgets](https://awesome-repositories.com/f/system-administration-monitoring/resource-monitoring-widgets.md) — Displays real-time system metrics such as CPU, memory, and network usage directly on the desktop. ### User Interface & Experience - [Live Data Widgets](https://awesome-repositories.com/f/user-interface-experience/presentation-frameworks/lifecycle-state-management/live-display-management/live-data-plots/live-data-widgets.md) — Fetches and updates live data from external APIs, shell commands, and device location inside desktop widgets. - [CSS-in-JS Implementations](https://awesome-repositories.com/f/user-interface-experience/styling-theming-systems/content-styling/component-styling-tools/component-styling/css-in-js-implementations.md) — Provides a CSS-in-JS library for styling desktop widgets with inline styles and animations. ([source](https://github.com/felixhageloh/uebersicht/blob/master/README.md)) - [Widget Engines](https://awesome-repositories.com/f/user-interface-experience/widget-engines.md) — Provides a desktop widget engine for macOS that renders JavaScript-based widgets with live updates. - [JSX](https://awesome-repositories.com/f/user-interface-experience/widget-frameworks/jsx.md) — Provides a JSX-based framework for building interactive desktop widgets with automatic code reload. - [Geolocation Bridges](https://awesome-repositories.com/f/user-interface-experience/javascript-execution-bridges/geolocation-bridges.md) — Provides a JavaScript bridge to retrieve the device's geographic position with street-level address details from within widgets. ### Web Development - [API Proxy Routings](https://awesome-repositories.com/f/web-development/traffic-routing/frontend-version-routing/api-proxy-routings.md) — Routes outbound HTTP requests through a local proxy to bypass cross-origin restrictions when fetching external data. ### Data & Databases - [Desktop Geolocation APIs](https://awesome-repositories.com/f/data-databases/geographic-data-apis/desktop-geolocation-apis.md) — Retrieves the device's geographic position and returns its detailed address including street, city, state, and country from within a widget. ([source](https://github.com/felixhageloh/uebersicht#readme))