Plugins and bundles

DataMind Oda is built from plugins, and a bundle groups plugins together. The Plugins page shows what this installation runs: the plugins and feature bundles Oda ships with, and the bundles you have installed. Here you switch them on or off, look inside a bundle, and open the settings a plugin brings.

What the Plugins page shows

Open Plugins in the sidebar. In the web app it sits under Global panels. The page is part of Oda's developer surface: it appears once the Plugins page feature is on in Settings > Developer > Advanced features; Advanced features covers that switch.

• The Official group lists the feature bundles and built-in plugins Oda ships with; the Installed group lists the bundles added on this computer.
• Each row shows the name, description and icon its package declares, read before the plugin runs.
• The switch on a row records your saved choice. It is not a report that the plugin loaded: a bundle that failed to load keeps its row, with its error, and cannot be switched back on until it is repaired.
• A few rows manage Oda itself and stay read-only; Oda refuses to switch them off or uninstall them: Plugin management needs it; it cannot be switched off or uninstalled.
• For what is loaded right now, open Settings > Built-in plugins, a read-only list; Built-in plugins covers it.

Switch a plugin or a bundle on or off

1. Open Plugins in the sidebar.
2. Find the row of the plugin or the bundle.
3. Flip its switch.

• A plugin switch edits one entry. It changes only that plugin's entry in the settings file this computer keeps (The profile settings file); comments and expressions already in the file stay as they are, and switching twice ends where you started.
• A bundle switch changes the ordered bundle list. Switching a bundle on adds it at the end, and that order can change which setting wins, so one bundle can change how another setting resolves. Switching it off keeps the package installed.
• The change reaches every chat in this installation. Where live apply is on, it takes effect while Oda runs; otherwise the row reports The change takes effect at the next start. How changes apply and what start-up reports covers which case you are in.
• If a switch fails, the row reports it: Could not enable: {reason} or Could not disable: {reason}.

Look inside a bundle

Open the bundle: select View on its row and its page lists its Components.

• The summary counts them: {count} total, {count} running, {count} off, {count} failed.
• Each part shows its own state and its own switch, Enable component; switching a part changes only that part.
• Filter components narrows the list, and with nothing matching it reads No component matches.
• A package that brings no parts reads This plugin pack contains no components.

Change a plugin's settings

Some plugins and bundles bring settings you edit from their page.

1. Open the plugin or bundle and open its settings.
2. Edit the fields you need.
3. Choose Save.

• An edit stages in the page until you save; leaving the page drops what you have not saved.
• A value you override carries an Overridden badge, and Reset to default puts the base value back.
• An invalid value shows the reason and blocks saving until you correct it.
• When Oda runs with live apply, a saved change takes effect while Oda runs. Live plugin settings covers the forms; How changes apply and what start-up reports covers the timing.

Add a plugin

1. On the Plugins page, choose Add plugin.
2. In Package name or address, enter the plugin's package name, a GitHub repository address, or the path to a local folder on this computer.
3. Choose Install. Oda checks the address first, with Checking…, then downloads and installs the package.
4. When the run finishes, choose Enable now to switch the new plugin on, or Done to leave it installed and off.

• Registry beside the field names where the package is fetched from, and your last choice starts the next dialog.
• If a dependency wants to run install scripts, Oda lists them and waits; Allow these scripts and retry allows the scripts still waiting. They then run with your permissions, so allow only what you trust.
• A failed or cancelled install puts the package records back. Install a plugin follows the whole dialog step by step.

Remove a bundle

1. Open the bundle and choose Uninstall.
2. Confirm in the dialog, which asks Uninstall "{name}"? and explains What it provides goes away once it is uninstalled.

Oda unloads the bundle's parts before it removes the package.

• Oda refuses to remove a bundle it manages itself, a bundle Oda needs at start-up, a bundle whose parts are still active, or one a higher-priority setting keeps active: Other configuration still uses this bundle's components; switch them off first.
• A refused removal changes nothing. The same management from a chat, with the full rules for installs, removals and logs, is on Plugins and bundles.

When a plugin is broken

A bundle that fails to load stays where it is: its row reads Problem with a Reason, and its switch keeps your saved choice. You can switch it off, and switching it back on is refused until it is repaired. Do not install a second copy to fix it: repair or remove the same bundle.

A part inside a bundle can fail on its own, and it reads Problem in the parts list too.

When Oda changes plugins for you

You can ask Oda in a chat to install, switch or remove a plugin. Every one of these actions needs Full access or your approval for that single call; approving does not change the chat's access mode, and a declined, cancelled or unavailable approval changes nothing. Installing runs plugin code with your permissions, so approve only what you trust. When Oda needs more access covers approvals.

Questions, answered

What is a bundle, and how is it different from a plugin?

A plugin is one of the parts Oda is built from, and a bundle groups plugins together into one package with one switch. On the Plugins page you meet them side by side: Oda's own under Official, the bundles added on this computer under Installed. Switching a bundle moves its parts together; switching a single plugin changes only that one.

Why can I not find the Plugins page?

The page is part of Oda's developer surface, so it stays hidden until the Plugins page feature is on in Settings > Developer > Advanced features. Advanced features covers the switch and its risks.

What do the states beside a plugin mean?

A row or a part can read Running (loaded and working), Loading, Waiting for dependencies (something it needs has not started yet), Unloading, or Problem (it failed). A Problem row names its reason, and switching it back on is refused until it is repaired.

What does the switch next to a plugin record?

Your saved choice, not whether the plugin loaded. That is why a broken bundle keeps a switch that still shows what you chose; the error shows on the row itself. The choice belongs to this installation, so it stays across restarts and applies to every chat.

How do I see what is inside a bundle?

Open the bundle and read its Components: a summary count, each part's state, and each part's own switch. Filter components narrows the list; a package that brings no parts reads This plugin pack contains no components.

Can I change a plugin's settings from the Plugins page?

Yes, for plugins that bring settings. Open the plugin or bundle and open its settings: edits stage until you choose Save, an overridden value carries an Overridden badge with Reset to default, and leaving the page drops unsaved edits. Live plugin settings covers the values you change while Oda runs.

How do I remove a bundle?

Open the bundle and choose Uninstall, then confirm. Oda unloads the bundle's parts before the package is removed. Oda refuses a bundle it manages itself, one it needs at start-up, one whose parts are still active, or one a higher-priority setting keeps active.

Why does the page say it could not read all plugins?

Oda could not read every plugin's details, usually because of a network problem. Choose Retry to read them again.

Do my installed plugins survive an update?

Yes. Installed packages and their saved state are kept across restarts and app updates, so your bundles stay where they were.