# Create Alias

There are three ways to create an alias: using the `add` keyword or via the `setup` keyword or via the settings.

## Using the `add` Keyword

- Type `add <alias_name>` and press `Enter` to open the creation page.<br>
  ![Add Keyword](../../assets/images/usermanual/create_alias_keyword.png)

## Using the `setup` Keyword

- Type `setup` and press `Enter` to open the setting page.<br>
  ![Setup alias](../../assets/images/usermanual/setup_alias.png)

- Normally, the Keyword page should be opened. If not just click on `Name of the menu here`.<br>
  ![Settings menu](../../assets/images/usermanual/settings_menu.png)

## Using the Settings

- Right-click the Lanceur icon in the system tray and select _Settings..._.<br>
  ![System Tray](../../assets/images/usermanual/system_tray_settings.png)

# Set Up the Alias and Save

You can now customise the alias to your preference. Once you have finished, click `Save` to apply your changes.

Below, you will find an explanation of each setting you can configure for an alias.

![Settings](../../assets/images/usermanual/create_alias.png)

| Nr  | Configuration              | Description                                                                          |
| --- | -------------------------- | ------------------------------------------------------------------------------------ |
| 1  | _Names_                    | Separate synonyms with a comma (`,`), allowing multiple names to start the same app. |
| 2  | _Comments_                 | Override the default app name with your own comment.                                 |
| 3  | _File name_                | Path of the application. Drag the file picker to select the running app's path.      |
| 4  | _Parameters_               | Parameters to send to the app (e.g., `--private-window` for Firefox).                |
| 5  | _Working directory_        | Set the working directory when the app starts.                                       |
| 6  | _Run As_                   | Choose _Current User_ or _Admin_ to run with higher privileges.                      |
| 7  | _Start mode_               | Choose _Maximised_, _Minimised_, or _Default_ to set the window's startup state.     |
| 8  | _Confirm before executing_ | Ask for confirmation before executing the alias.                                     |
| 9  | _Lua script_               | Run a Lua script before executing the alias. [More info](pages/usermanual/4.lua-scripting.md).                      |
| 10  | _Additional parameters_    | Add extra parameters by appending them after a semicolon (`;`). [More info](pages/usermanual/3.additional-params.md)    |

## Handling UWP Applications

Sometimes, the picker may not correctly return the file name of a process when dealing with a UWP (Universal Windows Platform) application. In such cases, you can click the following button:

![Process Picker](../../assets/images/usermanual/uwp_process_picker.png)

Then, select the application for which you want to create an alias:

![Choose UWP](../../assets/images/usermanual/uwp_choose_process.png)

Fill out the form as you would for any other process, then click `SAVE`. You'll know the configuration was successful when the `File name` field is populated. (Note: this is not a standard file path, but Lanceur knows how to handle it.)

![Infer UWP Information](../../assets/images/usermanual/uwp_filled_process.png)