aspire tray command for managing local AppHosts
Questi contenuti non sono ancora disponibili nella tua lingua.
aspire tray - Manage the desktop tray companion.
Synopsis
Section titled “Synopsis”aspire tray [command] [options]Description
Section titled “Description”The aspire tray command manages the Aspire tray companion, a desktop panel icon for managing local AppHosts. The tray is available on Windows, macOS, and glibc Linux (x64 and ARM64). The command is hidden from help on unsupported operating systems and on musl-based Linux.
Linux requirements
Section titled “Linux requirements”On Linux, the tray uses a StatusNotifierItem icon. GNOME renders its D-Bus menu through an AppIndicator extension; other desktops display an Aspire-owned panel. Headless sessions and musl-based distributions aren’t supported. The following host dependencies, which aren’t bundled with the CLI, must also be present:
- A graphical desktop session
- GTK 3
- On GNOME, an AppIndicator library, such as Ayatana AppIndicator or a compatible libappindicator, and an enabled AppIndicator extension
- On non-GNOME Wayland desktops,
libgtk-layer-shell.so.0and a compositor that supports the layer-shell protocol - On non-GNOME X11 desktops, a compositing manager to open the panel
- A StatusNotifierItem tray host, such as Waybar with its tray module enabled
If no tray host is available when you run aspire tray start, the CLI reports it. The icon appears as soon as tray support becomes available.
Options
Section titled “Options”The following options are available:
-
-?, -h, --helpPrints help and usage documentation for the available commands and options.
-
-l, --log-level <Critical|Debug|Error|Information|None|Trace|Warning>Set the minimum log level for console output. Use this option to increase diagnostics while troubleshooting or reduce output in scripted runs.
-
--non-interactiveRun the command in non-interactive mode, disabling all interactive prompts and spinners.
-
--nologoSuppress the startup banner and telemetry notice.
-
--bannerDisplay the animated Aspire CLI welcome banner.
-
--wait-for-debuggerWait for a debugger to attach before running a command.
Commands
Section titled “Commands”The following commands are available:
| Command | Status | Function |
|---|---|---|
aspire tray start | Preview | Start or restore the tray icon. |
aspire tray stop | Preview | Stop the tray without stopping AppHosts. |