# Nebula Applications

Shared C++ service for discovering and launching installed Linux applications from `.desktop` entries.

Desktop and the future Bigscreen shell should both use this library. It has no Desktop-specific QML.

## Behaviour

- Scans XDG application directories (`XDG_DATA_HOME`, `XDG_DATA_DIRS`, with the usual `~/.local/share` and `/usr/share` defaults).
- Hides entries with `Hidden=true` or `NoDisplay=true`, and respects `OnlyShowIn` / `NotShowIn` / `TryExec`.
- Exposes a `QAbstractListModel` to QML (`desktopId`, `name`, `genericName`, `comment`, `iconName`, `categories`, `terminal`).
- Launches with `QProcess::startDetached` and `QProcess::splitCommand`. Does not use a shell.
- Strips or substitutes common Exec field codes when launching without files/URLs.

QML module URI: `Nebula.Applications`.

See `shells/desktop/README.md` for launcher behaviour and session integration.