iobroker.script-restore
v0.1.4
Published
Restore ioBroker scripts from backup archives
Readme
ioBroker.script-restore
Tests:
script-restore adapter for ioBroker
Browse and recover individual scripts from ioBroker backup archives — without restoring the entire backup.
Description
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.
Features
- 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
Configuration
| Setting | Description | Default |
|---------|-------------|---------|
| Backup path | Directory where ioBroker backup files are stored | /opt/iobroker/backups |
Usage
Loading a local backup file
- Open the Script Restore tab in ioBroker admin
- Click the Local files dropdown
- Select a backup file from the list — scripts are loaded automatically
Uploading a backup file
- 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
Viewing and downloading scripts
- 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
Supported backup formats
| 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) |
Changelog
0.1.4 (2026-05-24)
- (ipod86) add syntax highlighting for JS/TS, Blockly (XML) and Rules (JSON) — pure JS, no external deps
- (ipod86) fix language detection: read ioBroker system language via adapter (system.config) instead of browser/DOM
- (ipod86) translate all remaining loader texts (reading file/archive, extracting, loading URL)
0.1.3 (2026-05-24)
- (ipod86) fix language flash: skip socket override when language already detected from admin frame
- (ipod86) replace all hardcoded status strings with translated t() calls
- (ipod86) add codeHint translation key in all 11 languages
0.1.2 (2026-05-24)
- (ipod86) add full i18n to tab UI: all strings translated into de/en/fr/es/it/nl/pl/pt/ru/uk/zh-cn
0.1.1 (2026-05-24)
- (ipod86) allow overwriting existing scripts during restore (confirmation dialog with path display)
- (ipod86) allow empty suffix to restore script under its original name
- (ipod86) prompt to start script immediately after successful restore
0.1.0 (2026-05-13)
- (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
License
MIT License
Copyright (c) 2026 ipod86 [email protected]
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.

