Use the store

The Community Store lists plugins and themes that people published in public GitHub repositories. Settings › Widgets opens the widget part, Settings › Design the theme part. This website shows the same catalog under Store.

What the labels mean

Every listing shows facts and only facts:

• Version and updated: the version in the plugin’s own manifest, and when it last changed.
• License: the license GitHub found in the repository, or a note that there is none.
• Stars: the repository’s GitHub stars, refreshed hourly and linked to the repository.
• Runtime: managed Python (smabar provides it) or an executable the plugin brings along.
• OS: which systems the author declared.
• Needs: external programs the plugin requires and does not bring along. They are named before install and never installed by smabar.
• Archived: the repository is archived and no longer receives changes.

There are no ratings, no review scores and no download counts. The store checks form only: a valid manifest, a free id, a license file. What a plugin does is the author’s business, and the install dialog says so.

Installing

Install asks for confirmation and repeats what the plugin needs. smabar then downloads the repository’s commit archive straight from GitHub, checks that its content matches what the signed catalog announced, and puts the plugin into ~/.smabar/plugins/. The plugin starts immediately, as its own process, with your user’s permissions.

Updates

A newer listed version is offered, never applied on its own. If you edited a plugin’s files yourself, smabar says so and backs your copy up before it replaces anything you accepted.

Blocked versions

The store can mark a version as blocked, for example because it turned out to be harmful. smabar then disables that version on your machine and shows the reason. It never deletes your files or data remotely.

Removing

Removing a plugin deletes its code folder and its data folder under ~/.smabar/data/. Nothing else on your system is touched.