Tests: 
Browse and recover individual scripts from ioBroker backup archives — without restoring the entire backup.
The script-restore adapter adds a tab to the ioBroker admin interface that lets you open backup archives and browse all contained JavaScript, TypeScript, Blockly and Rules scripts. You can view the source code of each script and download or copy it individually.
The archive is parsed entirely in the browser — no files are written to disk during browsing.
- Browse backup archives directly from the ioBroker admin tab
- Load local backup files from the backup directory (default:
/opt/iobroker/backups) - Upload archive files directly from your computer
- Supported formats:
.tar.gz,.tar,.json,.jsonl - Tree view of all scripts organized by folder
- Filter scripts by type: JS, TypeScript, Blockly, Rules
- Full-text search across script names, paths and source code
- View source code (JS/TS/Blockly/Rules)
- Copy source code to clipboard or download as file
- Fully browser-based parsing — no server roundtrip for uploads
- Restore scripts directly into ioBroker with a configurable suffix (default:
_rcvr) — existing scripts are never overwritten
| Setting | Description | Default |
|---|---|---|
| Backup path | Directory where ioBroker backup files are stored | /opt/iobroker/backups |
- Open the Script Restore tab in ioBroker admin
- Click the Local files dropdown
- Select a backup file from the list — scripts are loaded automatically
- Open the Script Restore tab in ioBroker admin
- Click Upload archive and select a file from your computer
- The archive is parsed in the browser and all scripts are displayed
- Click a script in the tree to view its source code
- Use the Copy button to copy the source to the clipboard
- Use the Download button to save the script as a file
| Format | Description |
|---|---|
.tar.gz |
Standard ioBroker backup (iobroker_YYYY-MM-DD-HH-mm_SS_backupiobroker.tar.gz) |
.tar |
Uncompressed tar archive |
.json |
JavaScript adapter script export |
.jsonl |
ioBroker objects export (JSON lines) |
- (ipod86) drop Node.js 20 support (EOL 2026-04-30), require >= 22
- (ipod86) fix: move @iobroker/types to production dependencies to fix CI integration test
- (ipod86) add .npmrc with legacy-peer-deps to resolve peer dependency conflicts
- (ipod86) update dependencies: webdav, basic-ftp, typescript, @types/node, @iobroker/eslint-config
- (ipod86) add common.singleton to prevent multiple instances
- (ipod86) complete i18n translations for all supported languages (fr, es, it, nl, pl, pt, ru, uk, zh-cn)
- (ipod86) add type filter (JS/TS/Blockly/Rules) in script sidebar
- (ipod86) add direct restore into ioBroker with suffix input and confirm modal
- (ipod86) remove obsolete admin/words.js and .prettierignore
- (ipod86) fix jsonConfig responsive sizes lg/xl for backupPath (E5509)
- (ipod86) trim news entries to 7 (W1032)
- (ipod86) add Dependabot npm cooldown of 7 days (W8915)
- (ipod86) fix jsonConfig: add responsive size attributes (E5507)
- (ipod86) add i18n translation files (W5022)
- (ipod86) remove outdated index_m.html and style.css (W5047)
- (ipod86) remove invalid copyToField attribute (W5512)
MIT License
Copyright (c) 2026 ipod86 david@graef.email
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.