General

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

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

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

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

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

Reads a JSON file and saves the parsed result directly into a SAMMI variable.

The file must contain valid JSON. If the JSON root is an object, SAMMI saves an object. If the JSON root is an array, SAMMI saves an array.

Example file:

{
  "user": "Chrizzz",
  "points": 150,
  "roles": ["mod", "vip"]
}

If saved as jsonData, you can read values such as /$jsonData.user$/ or /$jsonData.roles[0]$/.

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

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

Creates a folder at the specified path.

Examples:

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

Examples:

File extension examples:

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

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

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

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

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

Examples:

Notes:

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

Compresses a folder (including its subfolders) into a single .zip archive.

Examples:

Notes:

• Relative paths are resolved inside the SAMMI installation folder. All paths are converted to lowercase and backslashes (\) are converted to forward slashes (/).
• If either box is left empty, the command does nothing.
• If the folder cannot be zipped (for example, the source folder does not exist or the target location is not writable), SAMMI shows an alert and the archive is not created.

Extracts the contents of a .zip archive into a target folder.

Examples:

Notes:

• Relative paths are resolved inside the SAMMI installation folder. All paths are converted to lowercase and backslashes (\) are converted to forward slashes (/).
• If either box is left empty, the command does nothing.
• If the archive cannot be extracted (for example, the file does not exist or is not a valid ZIP archive), SAMMI shows an alert and nothing is extracted.

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

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.