FolderView Plus

FolderView Plus gives Unraid a cleaner, folder-first way to manage Docker containers and VMs.
It is built for real libraries: easier organization, safer imports, faster recovery, and better day-to-day control.

Why Install This

• Keep large Docker/VM setups readable with folder grouping in Docker, VMs, and Dashboard
• Recover faster with automatic backups, snapshot compare, and one-click restore
• Import safely with preview diff and selective apply before making changes
• Reduce manual work using regex/label-based assignment rules
• Manage everything from a modern settings flow that works on desktop and mobile

Requirements

• Unraid 7.0.0+

Install

Unraid UI (Plugins -> Install Plugin) or CLI:

plugin install https://raw.githubusercontent.com/alexphillips-dev/FolderView-Plus/main/folderview.plus.plg

Update

Warning

If update detection is cached, use a one-time commit URL install, then return to main updates.

• Preferred: Plugins -> Check for Updates
• Manual: rerun the same plugin install command

If update caching delays detection, install once from a commit URL:

https://raw.githubusercontent.com/alexphillips-dev/FolderView-Plus/<commit>/folderview.plus.plg

Then return to normal main updates.

Version format:

• Stable: YYYY.MM.DD.UU
• UU is zero-padded for reliable Unraid ordering

Uninstall

Caution

Removing the plugin deletes its plugin-managed config directory.

plugin remove folderview.plus

Feature Highlights

Organization and Control

• Folder views for Docker, VMs, and Dashboard
• Folder runtime actions (Start, Stop, Pause, Resume)
• Sort modes: created, manual, A-Z
• Reliable manual reordering with up/down controls
• Pinned folders and status/health/update visibility controls

Automation and Scale

• Auto-assignment rules:
  • Docker: name regex + label/image/compose matching
  • VM: name regex
• Rule tester, simulator, and conflict inspector
• Bulk assignment for Docker and VMs
• Folder templates for faster reuse

Safer Data Operations

• Import preview with Merge, Replace, Skip existing
• Per-type import presets and defaults
• Pretty-printed schema exports with metadata
• Automatic pre-import backup + restore latest
• Scheduled backups, snapshot compare, and rollback checkpoints
• Change history and one-click undo

UX and Compatibility

• Built-in, third-party, and uploaded icon support
• Custom CSS/JS extension loading
• Full mobile/touch support
• Modern browser support (Chrome, Edge, Firefox, Safari)

Quick Start

1. Open Settings -> FolderView Plus.
2. Create folders in Docker and/or VM sections.
3. Choose sort mode and view options.
4. Save.
5. Confirm folder groups in Docker/VM tabs.

Rules Quick Guide

1. Switch to Advanced.
2. Open Auto-assignment rules.
3. Choose folder, rule kind, and action (Include/Exclude).
4. Add rule, then save.
5. Use Test rule priority or Simulate all items to validate behavior.

Import, Export, and Backups

Export files:

• Docker: FolderView Plus Export.json
• VM: FolderView Plus Export VM.json
• Single folder: <FolderName>.json

Export format:

• Pretty-printed JSON
• Includes schemaVersion, pluginVersion, exportedAt

Recommended import flow:

1. Export current config first.
2. Import and review preview diff.
3. Choose mode/preset.
4. Apply import.
5. Use Restore latest backup if needed.

Security and Reliability

• Request token and guarded endpoint protections
• Safer dynamic rendering to reduce XSS risk
• Automated regression checks (including mobile and release guards)

Browser Support

Supported current major browsers:

• Chrome
• Edge (Chromium)
• Firefox
• Safari (macOS + iOS)

Not supported:

• Internet Explorer 11
• Legacy Edge (EdgeHTML)

Paths

• Config root: /boot/config/plugins/folderview.plus
• Custom CSS: /boot/config/plugins/folderview.plus/styles
• Custom JS: /boot/config/plugins/folderview.plus/scripts
• Third-party icons: /usr/local/emhttp/plugins/folderview.plus/images/third-party-icons
• User-uploaded icons: /usr/local/emhttp/plugins/folderview.plus/images/custom

Included Icon Pack Credits

• https://github.com/sameerasw/folder-icons
• https://github.com/hernandito/unRAID-Docker-Folder-Animated-Icons---Alternate-Colors

Development

• Runtime source: src/folderview.plus/
• Manifest: folderview.plus.plg
• Archives: archive/

Build package:

bash pkg_build.sh

Prepare release (build + checks):

bash scripts/release_prepare.sh

Run tests:

node --test tests/*.mjs

Support

• Issues: https://github.com/alexphillips-dev/FolderView-Plus/issues
• Forum support thread: https://forums.unraid.net/topic/197631-plugin-folderview-plus/

Sponsor

Tip

If the plugin helps you, support ongoing development here: https://buymeacoffee.com/alexphillipsdev

Credits

• chodeus - FolderView Plus is built on the strong foundation of folder.view3. Thank you for the original architecture and groundwork.
• sameerasw and hernandito - Thank you for creating and sharing icon packs that improve local icon workflows.

License

See LICENSE.md.