Skip to content

FileManager

7h30th3r0n3 edited this page Jul 11, 2025 · 2 revisions

File Manager

General Overview

File Manager is a lightweight SD-card browser for the M5Stack Cardputer.
It lets you navigate directories, preview text files, and delete files directly from the built-in keyboard and IPS display.
Smooth vertical scrolling and a nine-line viewport make browsing fast, while single-key commands keep file operations snappy.

Directory Browsing

The file list is rebuilt every time you enter a directory. Folders are shown in cyan and suffixed with “/”. If you go above the ninth line the viewport scrolls automatically.

Key Action
; Move cursor up (wraps at top)
. Move cursor down (wraps at bottom)
Enter Open directory or file
Backspace Return to main menu

Text-File Preview

Press p on any regular file to open a read-only preview. The header line shows the filename; the body shows up to nine lines at once. Horizontal scroll uses “,” (left) and “/” (right); vertical scroll uses the same ;/. keys as the browser.

  • Vertical scroll: line-by-line, endless
  • Horizontal scroll: one column at a time, bounded by the longest line length
  • Exit preview: ` (back-tick)

File Deletion

Hitting d on a regular file pops up a confirmation dialog (confirmPopup()). If confirmed, SD.remove() erases the file and the list refreshes automatically.

File Scan (open)

Pressing Enter on a file streams its contents to the USB-serial console via scanFileManager(). Handy for quick hex-dumps or log checks without leaving the Cardputer.

Keyboard Cheat Sheet

Key Context Function
; List / Preview Scroll ↑
. List / Preview Scroll ↓
, Preview Scroll ←
/ Preview Scroll →
Enter List Open / scan
p List Preview text file
d List Delete file (with confirm)
` Preview Exit preview
Backspace List Return to main menu

Clone this wiki locally