# States

### <mark style="color:purple;">List Of Files In Current Directory</mark>

Exposes a list of objects containing details on the files/folders in the current directory.

**Files Object**

<mark style="color:$info;">**File Name**</mark>\
The name of the file or directory

<mark style="color:$info;">**Is Directory**</mark>\
yes/no value indicating whether the entry is a directory.

<mark style="color:$info;">**Is File**</mark>\
yes/no value indicating whether the entry is a file.

<mark style="color:$info;">**File Extension**</mark>\
The file's extension if available (ex. ".png")

<mark style="color:$info;">**Directory**</mark>\
The parent directory. This will be the current directory.

<mark style="color:$info;">**Path**</mark>\
The direct path of the file. Equal to the directory + the file name (ex. "**C:/Users**" + "**/example.png**")

***

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

The path of the current directory. (ex. "**C:/Users/example-folder**")

***

### <mark style="color:purple;">Current Directory Path Segments</mark>

The current directory as a list of segments (ex . "**C:**", "**Users**", "**example-folder**")

***

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

A list of drives on the current device.&#x20;

Note, drive data is displayed differently depending on the operating system:

* **Windows** shows logical drives with letters (e.g., `C:`, `D:`).
* **macOS / Linux** show mounted filesystems using paths (e.g., `/`, `/Volumes/Drive`, `/mnt/data`).

**System Drives Object**

<mark style="color:$info;">**Available**</mark>\
Amount of storage available in bytes.

<mark style="color:$info;">**Size**</mark>\
The amount of storage the device can hold in bytes.

<mark style="color:$info;">**Capacity**</mark>\
The amount of storage used as a %

<mark style="color:$info;">**Filesystem**</mark>\
The type of drive.

<mark style="color:$info;">**Mounted**</mark>\
The mount point of the drive (Ex. "C:")

<mark style="color:$info;">**Used**</mark>\
The amount of storage used in Bytes.

***

### <mark style="color:purple;">Desktop Folder Directory</mark>

The path to the desktop folder on the user's device. This directory is whitelisted by default.

***

### <mark style="color:purple;">Documents Folder Directory</mark>

The path to the documents folder on the user's device. This directory is whitelisted by default.

***

### <mark style="color:purple;">Downloads Folder Directory</mark>

The path to the downloads folder on the user's device. This directory is whitelisted by default.

***

### <mark style="color:purple;">Music Folder Directory</mark>

The path to the music folder on the user's device. This directory is whitelisted by default.

***

### <mark style="color:purple;">Pictures Folder Directory</mark>

The path to the pictures folder on the user's device. This directory is whitelisted by default.

***

### <mark style="color:purple;">Videos Folder Directory</mark>

The path to the videos folder on the user's device. This directory is whitelisted by default.

***

### <mark style="color:purple;">AppData Folder Directory</mark>

The path to the AppData folder on the user's device. This directory is whitelisted by default.

***

### <mark style="color:purple;">Temp Folder Directory</mark>

The path to the temp folder on the user's device. This directory is whitelisted by default.

***

### <mark style="color:purple;">Executable Folder Directory</mark>

The path to the application's install location. This directory is whitelisted by default.

***

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

The base64 encoded thumbnail image, generated with the "File System - Generate Thumbnail" action.

***

### <mark style="color:purple;">Paths Of Dropped File(s)</mark>

The paths of the files that were dropped onto the application.

***

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

Evaluates to yes when files are currently being dragged over the application.

***

### <mark style="color:purple;">File System Separator</mark>

Which path separator the current devices uses ( "\\" on Windows, "/" on macOS/Linux)

***

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

If any error event is triggered, the error message will populate in this state.

***

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

A list of objects containing details about active downloads.

**Downloaded Files Object**

<mark style="color:$info;">**id**</mark>\
The ID of the download.

<mark style="color:$info;">**savePath**</mark>\
Where the file is being written to.

<mark style="color:$info;">**fileName**</mark>\
The name of the file being saved.

<mark style="color:$info;">**mimeType**</mark>\
The extension type of the file being downloaded (Ex. "application/octet")

<mark style="color:$info;">**percentCompleted**</mark>\
The download completion status as a number out of 100.

<mark style="color:$info;">**transferredBytes**</mark>\
The amount that has been downloaded in bytes.

<mark style="color:$info;">**transferredHuman**</mark>\
The amount that has been downloaded in human readable format (ex. "5mb")

<mark style="color:$info;">**totalBytes**</mark>\
The total amount that will be downloaded in bytes.

<mark style="color:$info;">**totalHuman**</mark>\
The amount that will be downloaded in human readable format (ex. "5mb")

<mark style="color:$info;">**speed**</mark>\
The current download speed per second in bytes.

<mark style="color:$info;">**state**</mark>\
The state of the download. Possible value are `progressing`, `completed`, `cancelled`, `interrupted`

<mark style="color:$info;">**isPaused**</mark>\
If the current download is paused currently.

<mark style="color:$info;">**canResume**</mark>\
If the current download is paused and can be safely resumed.

<mark style="color:$info;">**isComplete**</mark>\
If the current download is complete.

<mark style="color:$info;">**error**</mark>\
The error that occured while downloading, if any.

***

### <mark style="color:purple;">Most Recent Downloading ID</mark>

The ID of the most recently started download ID.

***

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

The output of the "File System - Get File Details" action.

**File Details Object**

<mark style="color:$info;">**size**</mark>\
The size of the file in bytes.

<mark style="color:$info;">**sizeHuman**</mark>\
The file size in human readable format (ex. "5mb")

<mark style="color:$info;">**path**</mark>\
The path to the file/directory.

<mark style="color:$info;">**extension**</mark>\
The extension of the file (ex. ".png")

<mark style="color:$info;">**parentDirectory**</mark>\
The directory that the file/directory exists in.

<mark style="color:$info;">**fileName**</mark>\
The name of the file.

<mark style="color:$info;">**isFile**</mark>\
If the current details object is a file.

<mark style="color:$info;">**isDirectory**</mark>\
If the current details object is a directory.

<mark style="color:$info;">**createdAt**</mark>\
When the file/directory was created.

<mark style="color:$info;">**modifiedAt**</mark>\
When the file/directory was last modified.

<mark style="color:$info;">**accessedAt**</mark>\
When the file/directory was last accessed.

***


---

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