File Browser
Browse and preview files on your TrueNAS
NAS Guard includes a built-in file browser that navigates your TrueNAS filesystem directly via the API (filesystem.listdir). No SMB or NFS setup required.
How it works
- Browse directories by tapping into them. Files and folders are sorted alphabetically with folders first.
- Tap a file to open it in QuickLook, the built-in audio player, or the built-in video player.
- Files are downloaded temporarily to your iPhone for preview and cleaned up automatically.
- Maximum download size for QuickLook preview is 50 MB.
QuickLook preview (documents & images)
The following file types are supported for QuickLook preview:
- Images: jpg, jpeg, png, gif, heic, webp, tiff, bmp
- Documents: pdf, txt, log, conf, cfg, json, xml, yaml, yml, md, rtf, csv, html, htm
- Source code: sh, py, rb, pl, go, rs, c, h, cpp, hpp, swift, css, js, ts, sql, ini, properties, toml
- Office: doc, docx, xls, xlsx, ppt, pptx, pages, numbers, key
Audio player
The built-in audio player supports:
- mp3, flac, wav, aac, ogg, m4a
The audio player includes a visualizer with bars and waveform modes.
Video player & streaming
The built-in video player supports the following container formats:
- mp4, mov, m4v, mkv, avi, webm, wmv, flv, mpg, mpeg, ts, m2ts, mts, 3gp
Streaming via Agent: If the NAS Guard Agent is installed and reachable, videos are streamed directly without downloading the full file first. The Agent provides a direct stream endpoint and an HLS remux endpoint for formats that AVPlayer cannot play natively.
File icons
Files are displayed with type-specific icons:
- Images: photo icon
- Videos: film icon
- Audio: music note icon
- PDF: richtext document icon
- Archives (zip, tar, gz, 7z, rar, bz2): zipper icon
- Disk images (iso, img): optical disc icon
- Text/config (txt, log, conf, cfg, md, rtf, csv, ini, properties, toml): text icon
- Structured data (json, xml, yaml, yml, html, htm): text-below-ecg icon
- Source code (sh, py, rb, pl, go, rs, c, h, cpp, hpp, swift, js, ts, css): code icon
- Databases (db, sqlite, sql): cylinder icon
- Other: generic document icon