A visual tool to explore files

gui_fm is a really simple file manager for Pico-8.

Use it to explore all folders and files saved on your Pico.
You can enter folders and load saved carts directly from it.
You can even use it to create new folders. Kinda...

To use

load #gui_fm
save **filename**
run

Won't work if run directly from the BBS, as sandboxed carts don't have access to the file system.

Choose your input method

Use both controller inputs 🎮 or mouse 🖱.
You can switch input method in the pause menu.

Launch saved carts with a single click...

...and go back to the file manager using the pause menu.

Create new folders

gui_fm streamlines the mkdir command.
Select the option to create a new folder and give it a name.
The console command for creating the folder will be copied to the clipboard.

Create new text files

You can use gui_fm to create new text file as .p8l (.txt won't show up in the file manager).
It's not particularly useful, since they are empty, but you can do it.

Limitations

While it is possible to create new folders and text files, I still don't have a solution for renaming and deleting folders and files.
I'll keep exploring new ideas on how to reach these goals, like the suggestion from @ChazBCook.
If you have any idea on how to make it possible, share it in the comments.

CHANGELOG

1.0:

• Initial release

1.1:

• Added scrolling
• Added mouse controls
• Added menu items:
  Open folder in host os,
  Go back to root folder,
  Change input method
• Added breadcrumb to launched cartridges. Go back to gui_fm using the pause menu
• Added warning page if runned in sandbox mode

1.2:

• Added functionality to create new folders

1.3:

• Added functionality to create new text files (.p8l)

I see. I think I forgot to check if the root folder doesn't have any elements in it. (⁠≧⁠▽⁠≦⁠)
I'll check and push a fix soon.

when is the fix?

Couple hours more or less

@IL Matthew
Nice work so far!

@allmightythunder

I got this runtime error when I loaded it off the bbs with #gui_fm (It likely stems from ls in tab 2 line 5 returning nil), but it worked when I saved it as a local copy and ran that instead.

Ooh I see. It's because carts downloaded from the BBS run in sandbox mode.
https://www.lexaloffle.com/dl/docs/pico-8_manual.html#LS
You need to save to disk to use it.
I'll update the thread.
Thank you both @allmightythunder @Verb

Updated to version 1.1!

load #gui_fm-4

See changelog for details.

With
printh( str, [filename,] [overwrite,] [save_to_desktop] )
you can create a txt file. You could use the file name as save data. Limited to file name length and how many different txt files you want to create. Great job on the cart, you got my mind going with this cart.

Thanks @ChazBCook !
I can absolutely add to ability to create empty text files like this. I've noticed that if you don't specify ".txt" in the file name, it saves it as a .p8l file and that will also show up in the pico8 file system.
As for creating folder I might have found a way, although it's a bit cumbersome.

Updated to version 1.2!

load #gui_fm-5

You can now (kinda) create new folders.

Updated to version 1.3!

You can now create text files, although you can't edit them...

As a feature, is it possible for the cart to detect if it's in sandbox/bbs mode or not? Maybe an error handler?

@hseiken
There should be a warning page if the cart is executed directly from bbs (in which case ls() will return nil) instructing the user to save the cart first. Let me know if it is working correctly.

As for editing text files, I haven't started working on it yet, but I've found this really cool cart by @spywhere:
pim: vim-like editor for Pico-8

It would be nice to launch #pim from the file manager passing the .p8l file as a parameter.