# States

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

Returns the details about the currently focused application.

#### **External Application Object**

Represents a running external application or window detected on the system.

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

<mark style="color:$info;">**title**</mark>\
The current window title of the application.

<mark style="color:$info;">**processId**</mark>\
The operating system process ID (PID) associated with the application.

<mark style="color:$info;">**path**</mark>\
The full file path to the application’s executable.

<mark style="color:$info;">**bounds**</mark>\
An object representing the position and size of the application window on screen, including its x and y coordinates and its width and height in pixels.

<mark style="color:$info;">**isVisible**</mark>\
Indicates whether the application window is currently visible on screen.

<mark style="color:$info;">**isWindow**</mark>\
Indicates whether the detected process has a standard window associated with it.

<mark style="color:$info;">**icon**</mark>\
A base64-encoded string or file reference representing the application’s icon.

<mark style="color:$info;">**opacity**</mark>\
The current opacity level of the window, where 1 is fully visible and 0 is fully transparent.

***

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

Returns a list of External Application Objects.&#x20;

***

### <mark style="color:purple;">Overlayed Window IDs</mark>

A list of all Window IDs that are currently acting as application overlays.


---

# 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/applications-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.