FolderView Plus

FolderView Plus gives Unraid a cleaner, folder-first way to manage Docker containers, VMs, and Dashboard views. It is built for real libraries: easier organization, smarter setup, safer recovery, and clearer runtime diagnostics.

Quick links: Install | What It Does | Settings Overview | Getting Started | Backups and Recovery | Troubleshooting | Theme Guide | Support Policy | Docs Index

Screenshots

Why Install This

• Keep large Docker and VM libraries readable with folders, nested trees, and Dashboard grouping
• Use the Setup Assistant to build a starter layout quickly instead of hand-making everything
• Move from folder creation to automation, recovery, and diagnostics without leaving the plugin
• Recover safely with manual backups, scheduled backups, snapshot compare, restore, and undo
• Get real runtime and editor diagnostics when something fails instead of silent breakage

Requirements

• Unraid 7.0.0+
• A current major Chrome, Edge, Firefox, or Safari browser

Install

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

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

Dev (testing) install URL:

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

Update

Warning

If update detection is cached, use a one-time commit URL install, then return to normal main or dev 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 branch tracking.

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

What It Does

Day-to-day organization

• Folder views for Docker, VMs, and Dashboard
• Nested folders with parent/child tree support
• Manual ordering, pinned folders, and current table controls
• Folder runtime actions such as Start, Stop, Pause, and Resume
• Modern folder editor with live preview and shared runtime diagnostics

Smarter setup and automation

• Setup Assistant with smart-detect starter planning
• Auto-assignment rules:
  • Docker: regex, label, image, and compose project matching
  • VMs: regex-based assignment
• Source-switched Rules workspace for Docker and VMs
• 3-step Bulk Assignment workspace for Docker and VMs
• Reusable folder templates in the Operations workspace

Safer change management

• Pretty-printed schema exports with metadata
• Import preview with Merge, Replace, and Skip existing
• Manual backups, scheduled backups, snapshot compare, restore latest, and one-click undo
• Safety backup creation before restore

Diagnostics and compatibility

• Top-of-page runtime diagnostics on Docker and VMs when folder rendering degrades or fails
• Folder editor bootstrap diagnostics with copyable output
• Settings Diagnostics with health check, suggested fixes, copyable issue report, and a v2 support bundle export preview
• Sanitized support bundles redact names, paths, URLs, IPs, and user-agent values by default, then include a redaction manifest with per-bundle hash metadata
• Safe-mode conflict handling when legacy Folder View plugins are still installed
• Legacy import and legacy CSS/JS override compatibility

Settings Overview

FolderView Plus is split into two working modes:

• Basic
  • Day-to-day folder management for Docker and VMs
  • Table controls, filters, row actions, import/export, and common edits
• Advanced
  • Automation: Bulk Assignment
  • Rules: rule builder, ordering, testing, and conflict inspection
  • Recovery: backups, restore, compare, history, and undo
  • Operations: runtime folder actions and template library
  • Diagnostics: health check, recommended fixes, and support exports

Current behavior:

• Settings changes save automatically
• The page remembers whether you last used Basic or Advanced
• Rules, Recovery, and Operations remember whether you were working in Docker or VMs

Getting Started

1. Open Settings -> FolderView Plus.
2. Stay in Basic for normal folder setup.
3. Create Docker and/or VM folders, or run the Setup Assistant if you want a starter layout.
4. Confirm the folder groups on the Docker, VM, and Dashboard pages.
5. Switch to Advanced only when you need automation, recovery, operations, or diagnostics.

Common advanced workflows:

• Rules: use Advanced -> Rules to create ordered include/exclude assignments, then test priority, preview assignments, and scan conflicts before relying on them.
• Bulk Assignment: use Advanced -> Automation to select a target folder, filter members, review the live plan, and apply the move.
• Templates: use Advanced -> Operations to save a folder as a reusable template and reapply it later.

Backups and Recovery

Recovery now lives in one source-switched workspace for Docker and VMs.

From Settings -> FolderView Plus -> Advanced -> Recovery you can:

• create a manual backup
• restore the latest backup
• compare two snapshots before applying a restore
• run the scheduler immediately
• set scheduled backup interval and retention
• choose one snapshot from backup history and:
  • restore it
  • download it
  • delete it
• review recent changes and undo the latest change

Recommended flow before large changes:

1. Export current config first.
2. Create a manual backup.
3. Apply the change.
4. Use restore or undo if the result is not what you wanted.

Import, Export, and Templates

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, and exportedAt

Import flow:

1. Export current config first.
2. Import the file.
3. Review the preview diff.
4. Choose Merge, Replace, or Skip existing.
5. Apply only when the plan looks right.

Template workflow:

• Save a folder as a reusable template in Advanced -> Operations
• Reapply the template to another folder later from the same workspace

Troubleshooting

• Settings page appears blank on a fresh install:

  • Refresh once with Ctrl+F5.
  • Reopen Settings -> FolderView Plus.
  • If it is still blank, open browser console and share the console error or a screenshot of the failure.

• Docker or VMs page shows a runtime banner:

  • Use the banner Copy diagnostics action.
  • Share that output if you need help.

• Updates do not appear immediately:

  • Run Plugins -> Check for Updates.
  • If still cached, install once from a commit URL, then return to normal main or dev tracking.

Full troubleshooting, support bundle guidance, and path references live in docs/TROUBLESHOOTING.md.

Security and Reliability

• Request token and guarded endpoint protections
• Safer dynamic rendering to reduce XSS risk
• Runtime diagnostics instead of silent failure paths
• Automated regression checks, release guards, and raw-publish validation

Customization

• Full theme guide: docs/THEME_GUIDE.md
• Versioned theme API contract: docs/THEME_API_CONTRACT.md
• Visual/runtime contract: docs/visual-runtime-contract.md
• Legacy CSS/JS migration and stable selector policy: docs/SUPPORT_POLICY.md
• Troubleshooting paths and override directories: docs/TROUBLESHOOTING.md

Included Icon Pack Credits

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

Support

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

Sponsor

Tip

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

Credits

• sameerasw and hernandito - Thank you for the icon packs that improve local icon workflows.

License

See LICENSE.md.