I'm sorry, im new to making websites so some things may look off!

test... :3c

Folder Reader

Read Files and Folders from a directory with filters using SAMMI

Current Version: 3.0.1

Payment is done through itch.io ! It is highly recommended to make an account to save your purchases!


❓ What is this?

Check out the video!

This extension allows SAMMI to easily retrieve files, and folders with optional filtering; from a specified directory! Gone are the days of renaming files, finicky command line, and arbitrary wait times!

✨ Features

  • A Single Command: Folder Reader: Read
  • File Extension Filtering
  • Saves files/folders into a specified array, for easy use!
  • Leverages SAMMI's NEW Local API Server to cut out arbitrary wait times
  • Sort options for date, newest, oldest, and more

🌟 How do I get started?

Download the extension, then, head over to the Setup Tab!

💚 Support

If you want me to continue making awesome SAMMI extensions for everyone, please consider donating to my Ko-Fi! Supporting me allows me to get more equipment to make extensions with, gives me some food on the table, and lets me know that my extensions are appreciated!

Made with Love, Landie

Example Usage 📝


An example of Folder Reader: Read usage


Folder Reader: Read output

How do i get started?

Visit the Setup tab for an in-depth, easy to follow quick start guide!

right side

Getting Started


  1. Download the .sef file
  2. Install the .sef file via the left hand side menu of the core, clicking the bridge button, then clicking "Install an Extension".

General Extension Command Usage

local variable persist visual

When you use these commands, any command that stores data in a variable must be a persistent button. You can check and change your button's persistence by checking that button's settings. This is a limitation of SAMMI, so this must be done for your variable saving commands to work.

A slightly purple colored command implies that the command is not instant. This means that you have to provide a delay, or, what is recommended, a Wait Until Variable Exists command block right after, which halts everything until that command returns the data that is required for the rest of the button to work. Since buttons are persistent, you must have a Delete Variable command in the top of your button to ensure that it is properly waiting for new data to exist.

purple command proper usage

  1. Delete Variable: ensures that the Wait Until Variable Exists command waits for a brand new variable to exist
  2. Purple Extension Command: indicates that the command doesn't return the information instantly. must be paired with delay.
  3. Wait Until Variable Exists: A delay, halting the rest of the button, until the data exists within LB or the timeout is reached.

Then do whatever you want with that sweet, sweet data!


I value updates a lot, so i can ensure everyone has the top quality product! When the bridge connects, there is an automatic update check. If there is a new update available, an alert message will be displayed in your core to check your bridge for an update button which checks, and provides a link to the releases section of this extension.

If you have a lot of alert messages pop up on bridge connect, you might miss it. I recommend clicking the "Check for updates" button in this extension's tab in the bridge every so often, or if you encounter an issue out of the blue.

⚠ Updating Procedure

To update this extension, please follow the steps below!

  1. Install the .sef file via the left hand side menu of the core, clicking the bridge button, then clicking "Install an Extension".
  2. Allow it to replace the deck it prompts
  3. 👍 (ur good)


Visit the docs for usage!

Visit the new Documentation page here!

No tutorials yet!

No troubleshooting yet!


removed API Server check since it's not needed as of 3.0.0


Huge overhaul to support the new Command Line introduced in 2023.2.0, abandoning the need for the API server checks

  • Removed API Box, not needed anymore
  • Removed many internal checks no longer needed
  • uses a more efficient algorithm to fetch files, boosting speed by a bit


  • New Dropdown: Sort
  • Sort Options: _ Date (Newest) _ Date (Oldest) _ Size (Smallest) _ Size (Largest)


  • Fixed a typo hehe Save ~Stringified~ Array Variable


Update requires SAMMI's local API to be turned on before usage!

This is a button-breaking update! Versions below this one will have to makes some adjustments!
  • New Box: Local API Password
  • Incredibly reduced fetch time using SAMMI's Local API and cURL
  • Added version number as variable
  • Sends Array instead of Stringified Array
  • Added checks to ensure Local API is enabled before usage