# xdg-open links

Since the [2022.5.28 Release](https://usebottles.com/blog/release-2022.5.28/), Bottles support the launch programs using links with special Bottles’ protocol. Such links will be recognized by the **xdg-open** utility and redirected to Bottles to execute certain commands.

### xdg-open syntax

**xdg-open** command opens a file or URL in the user's preferred application. General syntax:

`xdg-open {file | URL}`

### Bottles URL syntax

The link to run the program in a bottle has the following syntax:

`bottles:run/<bottle>/<program>`

Where

`<bottle>` is the name of the bottle (displayed in the interface, or the *"Name"* parameter in *bottle.yml*);

`<program>` is the name of the program for launch (displayed in the interface, or the *"name"* parameter of the corresponding program in *bottle.yml*).

### Usage

For example, to run the program **"Notepad"** in the bottle **"MyLittleBottle"**, the full **xdg-open** command will look like this:

`xdg-open bottles:run/MyLittleBottle/Notepad`

Or you can just use the `bottles:run/MyLittleBottle/Notepad` URL in your browser.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.usebottles.com/advanced/xdg-open.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.