# States

### <mark style="color:purple;">System - Platform Name</mark>

Possible values are `darwin`, `win32`, `linux`

***

### <mark style="color:purple;">isMacOS</mark>

Whether the current platform is macOS.

***

### <mark style="color:purple;">isWindows</mark>

Whether the current platform is Windows.

***

### <mark style="color:purple;">isLinux</mark>

Whether the current platform is Windows.

***

### <mark style="color:purple;">System - Accent Color</mark>

The device theme accent color (Hex code)

***

### <mark style="color:purple;">Displays</mark>

Details about the currently connected displays.<br>

#### **Display Object**

Represents information about a connected display or monitor.

<mark style="color:$info;">**id**</mark>\
A unique identifier for the display.

<mark style="color:$info;">**label**</mark>\
The system-provided name of the display.

<mark style="color:$info;">**detected**</mark>\
Indicates whether the display is currently detected by the system.

<mark style="color:$info;">**isPrimaryDisplay**</mark>\
Indicates whether this is the primary display.

<mark style="color:$info;">**internal**</mark>\
True if the display is built into the device (such as a laptop screen).

<mark style="color:$info;">**bounds**</mark>\
An object representing the display’s position and full resolution in virtual screen space.

<mark style="color:$info;">**bounds.x**</mark>\
Horizontal position of the display.

<mark style="color:$info;">**bounds.y**</mark>\
Vertical position of the display.

<mark style="color:$info;">**bounds.width**</mark>\
Full width of the display in pixels.

<mark style="color:$info;">**bounds.height**</mark>\
Full height of the display in pixels.

<mark style="color:$info;">**size**</mark>\
The width and height of the display in pixels.

<mark style="color:$info;">**nativeOrigin**</mark>\
The display’s native top-left origin in virtual screen space.

<mark style="color:$info;">**rotation**</mark>\
The display rotation in degrees (0, 90, 180, 270).

<mark style="color:$info;">**scaleFactor**</mark>\
The device pixel ratio scaling factor.

<mark style="color:$info;">**workArea**</mark>\
The usable area of the display excluding taskbars, docks, or system UI.

<mark style="color:$info;">**workAreaSize**</mark>\
The usable width and height of the display.

<mark style="color:$info;">**colorDepth**</mark>\
Total number of bits used to represent color.

<mark style="color:$info;">**depthPerComponent**</mark>\
Bits per color channel.

<mark style="color:$info;">**colorSpace**</mark>\
The display’s color space.

<mark style="color:$info;">**monochrome**</mark>\
Indicates whether the display is monochrome.

<mark style="color:$info;">**maximumCursorSize**</mark>\
The maximum supported cursor size for the display.

<mark style="color:$info;">**displayFrequency**</mark>\
The refresh rate of the display (in Hz).

<mark style="color:$info;">**accelerometerSupport**</mark>\
Indicates whether the display supports accelerometer-based orientation changes.

<mark style="color:$info;">**touchSupport**</mark>\
Indicates the level of touch support available on the display.

***

### <mark style="color:purple;">System - Idle Time</mark>

Returns the amount of time the system has been idle in seconds.

{% hint style="info" %}
The system is considered idle when there are no keyboard or mouse inputs. The counter will start shortly after the last input, and will restart when the next input is detected.
{% endhint %}

***

### <mark style="color:purple;">System - Free Memory (KB)</mark>

The amount of memory not in use in KB.

***

### <mark style="color:purple;">System - Free Memory (Readable)</mark>

The amount of memory not in use in human readable format (ex. "5mb")

***

### <mark style="color:purple;">System - Total Memory (KB)</mark>

The total amount of memory installed in KB.

***

### <mark style="color:purple;">System - Total Memory (Readable)</mark>

The total amount of memory installed in human readable format (ex. "5mb")

***

### <mark style="color:purple;">System - CPU Usage</mark>

The current amount of CPU being utilized, out of 100

***

### <mark style="color:purple;">System - System Details</mark>

An object containing hardware information for all aspects of the device. Use the "System - Load Static Data" action to retrieve the details.

#### System Information Object

Represents a comprehensive snapshot of the device’s hardware, operating system, and installed software environment.

<mark style="color:$info;">**version**</mark>\
The version of the system information library or schema used to generate this data.

<mark style="color:$info;">**system**</mark>\
General system-level details such as manufacturer, model, serial numbers, UUID, SKU, and whether the machine is virtualized.

<mark style="color:$info;">**bios**</mark>\
Information about the system BIOS or firmware, including vendor, version, release date, and serial identifiers.

<mark style="color:$info;">**baseboard**</mark>\
Details about the motherboard, including manufacturer, model, serial number, memory capacity limits, and memory slot count.

<mark style="color:$info;">**chassis**</mark>\
Information about the physical enclosure of the device, including manufacturer, model, type (e.g., laptop, desktop, server), and serial data.

<mark style="color:$info;">**os**</mark>\
Operating system information such as platform, distribution, version, kernel, architecture, hostname, build details, UEFI status, virtualization state, and remote session indicators.

<mark style="color:$info;">**uuid**</mark>\
Unique identifiers associated with the operating system, hardware, and network interfaces.

<mark style="color:$info;">**versions**</mark>\
Detected versions of installed runtimes, shells, servers, and development tools such as Node.js, Docker, Git, Python, databases, and other system software.

<mark style="color:$info;">**cpu**</mark>\
Processor information including manufacturer, model, clock speeds, core counts (physical and logical), cache sizes, virtualization support, and other hardware characteristics.

<mark style="color:$info;">**graphics**</mark>\
Graphics hardware and display information, including GPU controllers and connected displays with their resolution and refresh rate details.

<mark style="color:$info;">**net**</mark>\
Network interface information, including IP addresses, MAC addresses, interface types, connection state, speed, and DHCP status.

<mark style="color:$info;">**memLayout**</mark>\
Physical memory module details, including size, type, clock speed, manufacturer, and voltage specifications for each installed RAM stick.

<mark style="color:$info;">**diskLayout**</mark>\
Information about connected storage devices, including device type, size, firmware details, interface type, SMART status, and temperature.

<mark style="color:$info;">**audio**</mark>\
Detected audio devices, including input and output devices, driver details, and default device status.

<mark style="color:$info;">**usb**</mark>\
Connected USB devices, including vendor, device type, power requirements, and serial numbers.

<mark style="color:$info;">**printer**</mark>\
Configured printers on the system, including model, connection URI, status, and whether they are local, shared, or set as default.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://deskifier.gitbook.io/deskifier/deskifier-bubble.io-docs/system-element/states.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.