Marketplace and extensions

Install signed extensions that open new file types, and home layout templates. Update, disable, report, and check who signed what.

On this page
Documentation sections

The Marketplace is where you find two kinds of additions for Filarr: Extensions, which add editors for file types Filarr does not open yet, and Layout templates, ready-made home screens.

What an extension can and cannot do

An extension adds a new editor to Filarr. Every extension is signed by its author and runs isolated. It:

  • cannot reach the network: no upload, no tracking, no remote code;
  • cannot read your other files, only the document you open with it;
  • cannot see your account, your keys or your session;
  • cannot open windows or leave its own frame.

It can change the content of the document you open with it, since that is what an editor does. In the desktop app, the file's versions keep that reversible, see File version history.

Open the Marketplace

Click Marketplace in the sidebar. A badge on the entry counts the updates waiting.

At the top, choose Extensions or Layout templates. Each has three sections: Discover, then My extensions (or My templates), then Publish.

Install an extension

  1. In Extensions → Discover, search with Search extensions…, filter by category, or sort (Best match, Most installed, Recently updated, by name).
  2. Click an extension to open its page. Read What it does (the file types it opens), What it cannot do and Author and trust.
  3. Click Install.

Filarr checks the signature before installing, then again every time the extension loads. You then open a file of that type with the new editor: see Preview and open files.

An extension is installed on the device or in the browser where you install it. Install it again on your other devices.

Check the author's fingerprint

Under Author and trust, the Author fingerprint is 30 digits derived from the author's signing key. It stays the same as long as the same person signs. A line tells you if you already trust this author, for example First extension from this author on this device. An Official badge marks what Filarr publishes itself, checked against the signing key, not the displayed name.

If an update is signed by a different key, Filarr stops and shows A different key signed this update, with the two fingerprints side by side.

  • Keep my version: your current version keeps working and stays verified.
  • Trust the new key: the update installs, and later updates signed by this key install without asking.

Update, disable or remove an extension

Open Extensions → My extensions. Your extensions are grouped by state.

GroupWhat to do
To fixInstalled but not running. Each row says why and what to do.
Updates availableClick Update, or Update all. Updates are never installed on their own.
ActiveClick Disable to turn one off without removing it.
DisabledClick Enable to turn it back on.

Uninstall removes an extension. The To fix group can show three situations:

  • This extension no longer matches its signature: Filarr refused to load it. Repair reinstalls the version you trusted.
  • File type already taken: another editor already opens the same file types, so this one stays installed but inactive.
  • Needs a newer Filarr: update the app first.

Report an extension

On an extension's page, click Report, describe the problem in 10 to 500 characters, then click Send report. You can report each extension once per account, and a person reads every report.

Layout templates

Layout templates share home screens: a set of blocks, sized and arranged.

  1. In Layout templates → Discover, search, or filter by placement (Anywhere, Home, Folder, Board).
  2. Click Install. The template goes into My templates. Your home does not change.
  3. In My templates, preview it, then apply it when you want.

Applying a template creates a new layout, and the one you have stays untouched. My templates also lists the .filarrlayout files you imported, and Import a file… adds one. See Customize your home.

Publish your own

The Publish section is for authors. To publish an extension, the wizard has four steps: File, Identity, Capabilities and Review, then Sign and publish.

  • The file is a single .js bundle of 4 MiB at most.
  • The identifier is permanent, and each version number can be published only once. You can publish ten times per day.
  • Signing happens on your device: your private key never leaves it.
  • What becomes public: the bundle, its name, description, icon, category and file types, your publisher fingerprint, the published name signed into it if you have one, and the install count. Your email, your files and your notes stay private.

Publisher profile, in My extensions, is optional. It gives you a Public handle, a Published name and a public page for what you publish. Without it, your extensions show your key fingerprint only.

Before publishing, Test without publishing loads a bundle for the current session only, with the same isolation. Unpublish removes an extension from the catalogue; people who installed it keep a working copy. Layout templates have their own Publish section, with its own wizard.

When the Marketplace is not available

  • Offline: the catalogue needs a connection. Installed extensions keep working.
  • Session expired: sign in again from Settings → Account & Sync.
  • In an organization: admins can turn off the Marketplace or the layout templates, forbid publishing, or allow only some extensions. With No extensions, extensions already installed stop loading. See Run your organization.