Skip to main content
Version: 2.0.0-preview

Materials and Templates

The package store includes Extensions, Materials, and Templates. A package can contain both materials and templates.

Install a package​

  1. Open the Extensions window.
  2. On Home, choose Materials or Templates in the tabs at the top.
  3. Click a package card to open its details.
  4. Select a release in the version picker under the buttons in the header, and press Install.

The details page is a single column: the header with the install, update, and uninstall buttons and the version picker, then any screenshots, the description, the selected release's notes, and an Info list of the name, versions, website, and tags. Installed packages also offer update and uninstall actions.

Library lists your packages in the same kind of tabs: Packages and Local Packages. Check update is on the tab row.

To find a package by name, use the search box at the top right of the window. Ctrl + F (Cmd + F on macOS) moves to it and selects its text, and the page you are on stays open until you search.

Use the installed files​

Open the Files tab and choose the pinned Materials or Templates folder. Installed materials and object templates are grouped by package name.

Drag supported media or object templates to the timeline. Object templates can show thumbnails in the file browser.

Scheduled changes​

Some install, update, or uninstall actions cannot finish while Beutl runs and are scheduled for application exit. While a change is scheduled, the package's row in Library offers Restart, and the package details show Restart above Cancel. Restart quits Beutl as Exit does, after your work is saved. The package tools then apply every scheduled change, and remove the packages those changes leave unneeded, without waiting for you, unless a package asks you to accept its license. Their last page offers Start Beutl next to Close. When you exit Beutl instead, the package tools open and wait for you to press Start. Pending changes are stored and restored across sessions. To withdraw a scheduled action, choose Cancel in the row's … menu or in the package details.

Updating extensions​

Extensions installed from the store update automatically by default: Beutl downloads their updates in the background and applies them the next time it starts, before a project opens. To be notified instead, or to update them only together with Beutl, change Update timing in Settings → Extensions.

Update buttons and update notifications offer the newest release that supports your Beutl version, and the package details select that release at first. A package whose newer releases are all for other Beutl versions offers no update.

Extension compatibility​

An extension that requires APIs absent from your installed Beutl cannot be loaded, installed, or updated. Open Details in the error notification to see the affected package and compatibility report. Choose an extension release compatible with your Beutl version, or update Beutl to the version the extension targets. A rejected update leaves the previously installed version in place.

When such packages have a newer release, Beutl shows one short warning instead of an error for each: Package updates are required. It appears once the update check has finished, and its Open button opens the library and checks for updates, so the update buttons are ready. A package without an update, and a side-loaded package, keep the full error.

Source​