ScriptLogs adds a compact dashboard widget for selected User Scripts. It shows script status and log output directly on the Unraid Dashboard, without keeping the User Scripts page open.
- Dashboard tile for selected User Scripts.
- Color-coded script tabs for running and idle scripts.
- Collapsed dashboard state with compact status chips.
- Custom dashboard order for selected scripts.
- Scrollable log viewer with optional auto-scroll.
- Live log output for scripts running in the background.
- Optional display of the last known background log for idle scripts.
- Configurable refresh interval.
- Configurable log font size.
- Optional removal of empty log lines.
- Light and dark theme support.
- Dedicated settings page with compact script selection and drag handles.
- Unraid 6.9 or newer.
- User Scripts by Andrew Zawadzki.
ScriptLogs is available through Unraid Community Applications.
For manual installation:
-
Open the Unraid web interface.
-
Go to Plugins.
-
Click Install Plugin.
-
Paste this URL and install:
https://raw.githubusercontent.com/jo-sobo/scriptlogs-unraid-plugin/main/scriptlogs.plg
Open Settings > User Utilities > ScriptLogs Settings in the Unraid web interface.
Available settings:
- Automatic refresh: Enable or disable dashboard updates.
- Refresh interval: Set how often the widget checks script status and logs.
- Idle script logs: Show the last saved background log when a script is idle.
- Log font size: Choose the text size used in the dashboard log viewer.
- Empty log lines: Remove or preserve blank lines in log output.
- Script selection: Choose which User Scripts appear in the dashboard widget.
- Dashboard order: Drag selected scripts into the preferred tab order.
Click Apply to save changes. The dashboard widget updates on the next refresh.
The dashboard widget polls a local plugin API at the configured refresh interval.
Status detection uses the User Scripts runtime state:
- Foreground scripts are detected from the process list via
startScript.sh. - Background scripts are detected through
/tmp/user.scripts/running/.
Log output is read from User Scripts log files in:
/tmp/user.scripts/tmpScripts/<script-name>/log.txt
ScriptLogs tails the most recent log output, optionally removes empty lines, and displays it in the dashboard tile. It preserves the selected tab across refreshes when possible. Foreground scripts still write their live output to the User Scripts window, so ScriptLogs shows a short notice instead of duplicating that stream.
For general support, use the Unraid forum thread:
https://forums.unraid.net/topic/192397-plugin-scriptlogs
Source code and issue tracking are on GitHub:
https://github.com/jo-sobo/scriptlogs-unraid-plugin/issues
Thanks to Andrew Zawadzki for creating and maintaining the User Scripts plugin.
If ScriptLogs is useful to you, donations are welcome:
This project is licensed under the GPL v3. See LICENSE for details.