# Plugins: add to the desktop itself

> Weather in the menu bar, a timer in Control Center, a clock on the desktop: get a plugin in the Store, see what it asks for, turn it on and off, and make your own.

Source: https://wolos.org/manual/plugins

## What it is

A plugin adds something to the desktop itself, not a new window: an item in the menu bar, a card on the desktop, a tile in Control Center, an icon in the Dock or results in Search. Plugins install for you only and update on their own, apart from WolOS updates. Every plugin in the Store was checked and signed by the WolOS plugin index.

## Why WolOS does it this way

A plugin sits very close to your desktop, so it must say what it wants before it gets it. Each plugin lists what it asks for in plain words ("Asks to: show notifications"), and gets only that. A plugin that asks for nothing can do nothing but draw. If a plugin fails three times in a row, WolOS turns it off by itself, so one broken plugin cannot spoil your desktop.

## How

1. **Open the App Store and choose Plugins** in the sidebar.
   You see **Your Plugins** (the ones you have) and **Available** (the ones you can get).

   ![The App Store, Plugins: 2 the line saying what the plugin asks for, 3 Get for a plugin you do not have yet, 4 Turn On for a plugin you have.](/img/manual/store-plugins-list-wide-annotated.png)
2. **Read what it asks for.** Under every name is one line: what the plugin does and what it asks for ("Asks for nothing", "Asks to: read data from the web").
3. **Click Get** on a plugin you want. It installs for you and does not need an administrator.
4. **Click Turn On.** Its parts appear where they belong: the weather in the menu bar, the clock card on the desktop.
5. **Turn it off or remove it** from the same row (**Turn Off**, **Remove**). When a new version is out, the row says **Update**, with the version.

A tile or a Dock item from a plugin that runs something only does so after you allowed it, the first time. The answer is kept and can be changed in System Settings > Privacy & Security ([Privacy and permissions](/manual/privacy)).

### Make your own

**Create Plugin…** at the top of the Plugins page opens Plugin Maker, an app with an editor that checks your work as you type and a preview of the menu bar, Dock and desktop that cannot change your real desktop. When it is ready, **Create Package** writes one file you can share. **Share…** shows the steps to send it to the plugin index. The same app has Theme Studio, for making a theme with sliders and contrast checks ([Looks and themes](/manual/themes)). The full description of a plugin file is in the Reference ([Plugin API reference](/reference/plugins)).

![Plugin Maker's preview: a sandbox sign, the menu bar, a Dock with three icons and a desktop card with a counter.](/img/manual/maker-preview.png)

## A worked example

Alice wants to know the time in Lisbon without opening anything. In the App Store she opens **Plugins**, reads "World Clock: Times in other cities. Asks for nothing.", clicks **Get** and then **Turn On**. A card with the times appears on her desktop. Later she finds she does not use it, so she opens the same row and clicks **Turn Off**. The card disappears; the plugin stays installed in case she wants it back.

## If something goes wrong

| What you see | What to do |
|---|---|
| A plugin says it needs a newer WolOS | Update WolOS in System Settings > Software Update, then try again. |
| A plugin turned itself off | It failed three times in a row. Turn it on again; if it stops again, remove it and tell its author. |
| A tile or a Dock item from a plugin does nothing | It is waiting for your permission to run. Click it once and answer the sheet. |
| A plugin's web request fails | A plugin may only talk to the sites it named, and cannot be sent to another one. |
| Too many notifications from a plugin | Plugin notifications are limited in number. Turn the plugin off in the Store, or turn its notifications off in System Settings > Notifications. |
| Create Plugin will not use a name | The first part of the name, org.wolos, is kept for the plugins WolOS ships. Choose another. |