Skip to content
You are looking at the legacy documentation of AGS v1. Go to aylur.github.io/ags for AGS v2.

Applications

signals

  • changed should emit when an app is installed or uninstalled but doesn’t always work

methods

  • query: (string) => App[] takes a string and returns a list of apps that match one of the following: app name, app description, executable name or .desktop file.
  • reload: () => void explicitly reload the application list.

properties

  • list: Application[] a full list of available applications

Application

properties

  • app: Gio.DesktopAppInfo the corresponding app info object
  • name: string name of the app
  • desktop: string | null the .desktop file
  • description: string | null description of the app
  • executable: string name of the executable binary
  • icon-name: string the Icon entry in the corresponding .desktop file, can be a named icon or a path to an image
  • frequency: ‘number’ number to take into consideration when sorting on query calls

methods

  • launch: () => void launches the app, you could also do Utils.execAsync(['bash', '-c', app.executable]), but the launch method keeps track of the frequency of launches which is used to sort the query
  • match: (string) => boolean returns whether a search term matches the app
  • reload: () => void rereads .desktop files

Example Applauncher