States
List Of Files In Current Directory
Exposes a list of objects containing details on the files/folders in the current directory.
Files Object
File Name
The name of the file or directory
Is Directory
yes/no value indicating whether the entry is a directory.
Is File
yes/no value indicating whether the entry is a file.
File Extension
The file's extension if available (ex. ".png")
Directory
The parent directory. This will be the current directory.
Path
The direct path of the file. Equal to the directory + the file name (ex. "C:/Users" + "/example.png")
Current Directory
The path of the current directory. (ex. "C:/Users/example-folder")
Current Directory Path Segments
The current directory as a list of segments (ex . "C:", "Users", "example-folder")
System Drives
A list of drives on the current device.
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
Available
Amount of storage available in bytes.
Size
The amount of storage the device can hold in bytes.
Capacity
The amount of storage used as a %
Filesystem
The type of drive.
Mounted
The mount point of the drive (Ex. "C:")
Used
The amount of storage used in Bytes.
Desktop Folder Directory
The path to the desktop folder on the user's device. This directory is whitelisted by default.
Documents Folder Directory
The path to the documents folder on the user's device. This directory is whitelisted by default.
Downloads Folder Directory
The path to the downloads folder on the user's device. This directory is whitelisted by default.
Music Folder Directory
The path to the music folder on the user's device. This directory is whitelisted by default.
Pictures Folder Directory
The path to the pictures folder on the user's device. This directory is whitelisted by default.
Videos Folder Directory
The path to the videos folder on the user's device. This directory is whitelisted by default.
AppData Folder Directory
The path to the AppData folder on the user's device. This directory is whitelisted by default.
Temp Folder Directory
The path to the temp folder on the user's device. This directory is whitelisted by default.
Executable Folder Directory
The path to the application's install location. This directory is whitelisted by default.
Thumbnail
The base64 encoded thumbnail image, generated with the "File System - Generate Thumbnail" action.
Paths Of Dropped File(s)
The paths of the files that were dropped onto the application.
Drag Over
Evaluates to yes when files are currently being dragged over the application.
File System Separator
Which path separator the current devices uses ( "\" on Windows, "/" on macOS/Linux)
Error
If any error event is triggered, the error message will populate in this state.
Downloading Files
A list of objects containing details about active downloads.
Downloaded Files Object
id
The ID of the download.
savePath
Where the file is being written to.
fileName
The name of the file being saved.
mimeType
The extension type of the file being downloaded (Ex. "application/octet")
percentCompleted
The download completion status as a number out of 100.
transferredBytes
The amount that has been downloaded in bytes.
transferredHuman
The amount that has been downloaded in human readable format (ex. "5mb")
totalBytes
The total amount that will be downloaded in bytes.
totalHuman
The amount that will be downloaded in human readable format (ex. "5mb")
speed
The current download speed per second in bytes.
state
The state of the download. Possible value are progressing, completed, cancelled, interrupted
isPaused
If the current download is paused currently.
canResume
If the current download is paused and can be safely resumed.
isComplete
If the current download is complete.
error
The error that occured while downloading, if any.
Most Recent Downloading ID
The ID of the most recently started download ID.
File Details
The output of the "File System - Get File Details" action.
File Details Object
size
The size of the file in bytes.
sizeHuman
The file size in human readable format (ex. "5mb")
path
The path to the file/directory.
extension
The extension of the file (ex. ".png")
parentDirectory
The directory that the file/directory exists in.
fileName
The name of the file.
isFile
If the current details object is a file.
isDirectory
If the current details object is a directory.
createdAt
When the file/directory was created.
modifiedAt
When the file/directory was last modified.
accessedAt
When the file/directory was last accessed.