> For the complete documentation index, see [llms.txt](https://docs.vdo.ninja/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vdo.ninja/advanced-settings/camera-parameters/and-focus.md).

# \&focus

Reference for the \&focus URL parameter in VDO.Ninja including behavior examples and related options.

#### **Description**

Manually sets the camera focus distance for devices that support manual focus control.

#### **Sender-Side Option**

This parameter overrides auto-focus and sets a specific focal distance for the camera.

#### **Usage**

* **`&focus=100`** - Sets focus distance to 100 units
* **`&focus=0`** - Sets focus to closest distance (macro)
* **`&focus=1000`** - Sets focus to far distance

#### **Examples**

```
https://vdo.ninja/?push=streamID&focus=100
https://vdo.ninja/?push=streamID&focus=500
```

#### **Details**

* Only works on devices/browsers that support manual focus control
* Most effective on mobile devices (smartphones/tablets)
* Desktop webcams rarely support manual focus via browser APIs
* Value represents arbitrary focus distance units (not standardized)
* Disables auto-focus when set

#### **Device Support**

* **Supported:** Most modern smartphones (iOS/Android)
* **Limited Support:** Some tablets
* **Rarely Supported:** Desktop webcams
* **Not Supported:** Virtual cameras, screen shares

#### **Notes**

* Useful for fixed-focus scenarios (e.g., document cameras, product demos)
* Can prevent focus hunting during streams
* May need experimentation to find optimal value for your setup
* Focus capability depends on browser MediaStream API support

#### **Related Parameters**

* [`&autogain`](https://docs.vdo.ninja/advanced-settings/audio-parameters/autogain.md) - Controls automatic gain (audio equivalent)
* [`&brightness`](https://docs.vdo.ninja/advanced-settings/camera-parameters/and-brightness.md) - Adjusts camera brightness
* [`&contrast`](https://docs.vdo.ninja/advanced-settings/camera-parameters/and-contrast.md) - Adjusts camera contrast
* [`&zoom`](https://docs.vdo.ninja/advanced-settings/video-parameters/and-zoom.md) - Controls camera zoom level


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.vdo.ninja/advanced-settings/camera-parameters/and-focus.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
