General

On this page
Edit

File: Append Text #

Appends text to a file of your choice. Creates the file if it doesn’t exist yet.

Box Name Type Description
File Name String Name of the file. Accepts both relative and absolute path.
Text String Text to append to the file.

Edit

File: Copy File #

Copies a specified file to a new destination.
Will not replace the file if one with the same name is already present.

Box Name Type Description
File Path to Copy From String The file you wish to copy. Accepts both relative and absolute path.
File Path to Copy to String Where to copy the file. Accepts both relative and absolute path.

Edit

File: Read Line #

Reads a single line of file of your choice and saves it into a variable.

Box Name Type Description
File Name String Name of the file. Accepts both relative and absolute path.
Line Line which should be read.
Save Variable As String Variable name the string is saved as.

Edit

File: Random Line #

Reads a random line from a file of your choice and saves it into a variable.

Box Name Type Description
File Name String Name of the file. Accepts both relative and absolute path.
Save Variable As String Variable to save the random line as.
Save Variable As (Position) String Variable to save the position of the random line to.

Edit

File: Read All #

Reads every line from a file and saves them into a variable either as a string, or an array.

Box Name Type Description
File Name String Name of the file. Accepts both relative and absolute path.
Type String Array: Creates an array where it enters each line separately. String: Full text will be added as a string.
Save Variable As String Variable name the response will be saved to.

Edit

File: File Exists #

Checks if a file already exists in a specified path. SAMMI will return true if the file exists, and false if it doesn’t.

Box Name Type Description
File Path String The file to check. Accepts both relative and absolute path.
Save Variable As String The variable name to save the return value as

Edit

File: Folder Exists #

Checks if a folder already exists in a specified path. SAMMI will return true if the folder exists, and false if it doesn’t.

Box Name Type Description
File Path String The folder to check. Accepts both relative and absolute paths.
Save Variable As String The variable name to save the return value as

Edit

File: Create Folder #

Creates a folder at the specified path.

Box Name Type Description
Folder Path String Folder path to create. Accepts both relative and absolute paths.

Examples:

Folder Path Result
exports Creates an exports folder inside SAMMI’s working directory.
exports/screenshots Creates a nested screenshots folder inside exports.
C:/SAMMI/Backups Creates or reuses the absolute folder path C:/SAMMI/Backups.

Edit

File: Folder Get Files #

Gets file paths from a folder and saves them as an array.

Box Name Type Description
Folder Path Folder Select Folder to get files from.
File Extensions String Optional comma-separated list of file extensions to include, for example txt,png,jpg. Leave empty to include all files.
Save Variable As String Variable name to save the resulting array.
Include Subfolders Checkbox If checked, SAMMI also get files from subfolders.

Examples:

Folder Path File Extensions Include Subfolders Save Variable As Saved Value Example
C:/SAMMI/quotes txt false files [C:/SAMMI/quotes/one.txt, C:/SAMMI/quotes/two.txt]
C:/SAMMI/media png,jpg true images [C:/SAMMI/media/a.png, C:/SAMMI/media/sub/b.jpg]
exports   false allFiles All files directly inside the exports folder.

File extension examples:

File Extensions Description
txt Only .txt files.
.txt, .png, .jpg Only .txt, .png, and .jpg files.
  All files.

The returned array contains full file paths. You can use Array Get Value, Array Random, or Repeat to work with the files afterwards.

Edit

File: Get Information #

Gets information about a file and saves the selected value to a variable.

Box Name Type Description
File Path File Select File to get information from.
Type Dropdown Information to retrieve from the file.
Save Variable As String Variable name to save the result.

Example using C:/SAMMI/files/example.txt:

Type Save Variable As Saved Value Example
File Name fileName example
File Extension fileExt .txt
Folder Path folderPath C:/SAMMI/files/
File Size fileSize 1428
Created Date createdDate 2026-05-08 13:42:10
Modified Date modifiedDate 2026-05-08 14:05:31
Duration fileDuration Duration returned by the SAMMI_V2.dll helper, if the file type supports it.

Returned date and duration formats may depend on the system and the SAMMI_V2.dll helper used by the command.

Edit

Open Folder #

Opens a folder in the operating system’s file explorer.

Box Name Type Description
Folder Path Folder Select Folder to open. Can be an absolute path or a relative path inside the SAMMI folder.

Examples:

Folder Path Result
C:/SAMMI/exports Opens the exports folder in Windows Explorer
exports Opens the exports folder relative to the SAMMI folder

Notes:

  • On Windows, SAMMI will open the folder using Explorer. On other platforms behavior may vary or be unsupported.

Edit

File: Delete File #

Deletes a file from a specified file path. The file path must begin with a lowercase drive letter, for example, c:\ instead of C:\.

Box Name Type Description
File Path String File you wish to delete. Accepts both relative and absolute path.

Edit

File: Get SHA1 Hash #

Returns the SHA1 hash of a file.
SHA1 hash is like a file’s digital signature. You can verify a file’s integrity by checking its hash value. If even one byte in the file changes (i.e. the file is modified in any way), its hash value will be different.
Very useful command to periodically detect any file changes.

Box Name Type Description
Variable String Variable to save the SHA1 string in.
File Path string File name you wish to get SHA1 hash of. Accepts both relative and absolute path.