plasmoid/README.md

# Plasmoid

<img src="assets/plasmoid.svg" width="96" alt="Plasmoid logo">

A minimalist and opinionated app launcher for Android.

## Screenshots

<table>
  <tr>
    <td align="center"><a href="https://codeberg.org/randogoth/plasmoid/src/branch/main/screenshots/01.png" target="_blank"><img src="screenshots/01.png" width="180"></a><br><sub>Dark mode with tags</sub></td>
    <td align="center"><a href="https://codeberg.org/randogoth/plasmoid/src/branch/main/screenshots/02.png" target="_blank"><img src="screenshots/02.png" width="180"></a><br><sub>Light mode</sub></td>
    <td align="center"><a href="https://codeberg.org/randogoth/plasmoid/src/branch/main/screenshots/03.png" target="_blank"><img src="screenshots/03.png" width="180"></a><br><sub>Search filter</sub></td>
    <td align="center"><a href="https://codeberg.org/randogoth/plasmoid/src/branch/main/screenshots/04.png" target="_blank"><img src="screenshots/04.png" width="180"></a><br><sub>Swipe to pin</sub></td>
    <td align="center"><a href="https://codeberg.org/randogoth/plasmoid/src/branch/main/screenshots/05.png" target="_blank"><img src="screenshots/05.png" width="180"></a><br><sub>Tag editor</sub></td>
  </tr>
</table>

## Features

**Search & Launch** — Start typing to filter apps by name or tag. Tap to launch immediately.

**Tagging** — Long-press an app and choose Edit Tags to assign tags. Tags are searchable using prefixes: `@context`, `#general`, `+project`.

**Gestures**
- Swipe right to pin an app to the top (swipe right again to unpin)
- Swipe left to demote an app to the bottom (swipe left again to restore)
- Long-press for Edit Tags, App Info, and more

**Settings** — Toggle icon visibility, color mode, theme, sort order, auto-focus, status icons, and demoted app visibility from the menu.

## Download

Get the latest .apk on the [Release Page](https://codeberg.org/randogoth/plasmoid/releases)

## Build

```sh
flutter build apk --release
```

On systems without Flutter installed, [devbox](https://www.jetify.com/devbox) provides a reproducible environment:

```sh
devbox install
devbox shell
flutter build apk --release
```

---

Made with love by randogoth — icon by [Game Icons.net](https://game-icons.net/).