# Desktop **URL:** \ **Category:** API Reference\ **Created:** [October 21, 2026, 4:03pm UTC](https://hotbunny.dev/t/desktop/68 "2026-10-21T16:03:11Z")\ **Posts on this page:** 1\ **Page:** 1

**Author:** ![SteelWaffe7](https://hotbunny.dev/user_avatar/hotbunny.dev/steelwaffe7/32/11_2.png) [@SteelWaffe7](https://hotbunny.dev/u/SteelWaffe7)\ **Post date:** [October 21, 2026, 4:03pm UTC](https://hotbunny.dev/t/desktop/68/1 "2026-10-21T16:03:11Z")

The `Desktop` API allows mods to add custom widgets to the game desktop. Widgets are rendered inside sandboxed iframes with full SDK access via `window.HackhubSDK`. ## Import ```ts import { Desktop } from "@hotbunny/hackhub-content-sdk"; ``` ## Functions ### `Desktop.addWidget(widget: DesktopWidget)` Adds a custom widget to the desktop. The widget’s HTML file is loaded from the mod’s file system and rendered in a sandboxed iframe. ```ts Desktop.addWidget({ id: "clock-widget", src: "widgets/clock.html", width: 200, height: 100, position: { x: 50, y: 50 }, transparent: true, }); ``` ### `Desktop.removeWidget(id: string)` Removes a previously added widget by its ID. ```ts Desktop.removeWidget("clock-widget"); ``` ### `Desktop.getWidgets(): DesktopWidget[]` Returns all mod-added desktop widgets. ```ts const widgets = Desktop.getWidgets(); console.log(`${widgets.length} widgets on desktop`); ``` ### `Desktop.isAppInstalled(app: string): boolean` Whether an app is installed on this save, by the name the desktop knows it (e.g. `"Kisscord"`). Most apps are unlocked as the player progresses, so ask before sending something to one. ### `Desktop.getInstalledApps(): string[]` Every app installed on this save, by name. ### `Desktop.setAppBadge(app: string, count: number)` Shows a count on one of your own apps: on its taskbar, dock or panel button and on its desktop shortcuts, on every OS. Use it for what waits for the player in the app (unread messages, jobs to collect). - `app` is your app’s `AppName`. Only your own mod’s apps can be badged. - `count` is rounded down to a whole number. `0` hides the badge; above 99 it reads “99+”. - The count stays until you set it again or the mod is turned off. It is not saved: set it again when your mod loads. ```ts Desktop.setAppBadge("Inbox", unread.length); ``` From the app’s own HTML: ```html ``` ## DesktopWidget Interface | Property | Type | Required | Description | | --- | --- | --- | --- | | `id` | `string` | Yes | Unique identifier for the widget | | `src` | `string` | Yes | Path to HTML file relative to mod root | | `width` | `number` | Yes | Widget width in pixels | | `height` | `number` | Yes | Widget height in pixels | | `position` | `{ x: number; y: number }` | No | Pixels from the desktop’s top-left corner. Unset: the widget joins the OS’s widget column (top right on RabbitOS) under the Objectives widget, no wider than the column | | `transparent` | `boolean` | No | Transparent background (default: true) | ## Widget HTML File Widget HTML files are loaded from your mod’s directory. Inside the widget, you have access to the full SDK through `window.HackhubSDK`. ### File Structure ```auto my-mod/ ├── manifest.json ├── index.ts └── widgets/ └── clock.html ``` ### Example: `widgets/clock.html` ```html

--:--:--

``` ### Accessing the SDK Inside widget HTML files, the full HackhubSDK is available on `window.HackhubSDK`: ```html ``` ## Example: System Monitor Widget **`index.ts`** (mod entry): ```ts import { Desktop } from "@hotbunny/hackhub-content-sdk"; Desktop.addWidget({ id: "sys-monitor", src: "widgets/monitor.html", width: 220, height: 120, position: { x: 20, y: 400 }, transparent: true, }); ``` **`widgets/monitor.html`** : ```html

CPU: 0%

MEM: 0 MB

Mod:

```