## Lens

Activity
Feedback
Are you enjoying Lens? Help us by giving it a rating.
★ ★ ★ ★ ★
Language
Choose the display language for the extension interface.
Version
You are using the latest version. An update is available.
Changelog
Help
Learn how to use Lens and get help troubleshooting.
Open

### Hotkeys

### Behavior

Save behavior
Choose the default option for saving pages. Alternate options appear in the dropdown menu next to the main button.
Default open behavior
Choose how Lens opens by default.
Open Lens to
Choose which screen Lens shows first: the home screen or the save form.
Save clipped note without opening it
Clipped notes will be saved but will not open as a new tab. Obsidian will still be brought to the foreground.

## Focus & highlights

Open highlights
Always show highlights
Display your saved highlights when you load a page. Turn off to only display highlights when highlighter mode is activated.
Clip behavior
Choose how highlighted content is saved to Obsidian. Defines the {{content}} variable.
Export highlights
Export your highlights to a file.
Import highlights
Import highlights from a file. Existing highlights are kept.

## Reading

Open Lens

File over app

Steph Ango · July 1, 2023 · stephango.com

File over app is a philosophy: if you want to create digital artifacts that last, they must be files you can control, in formats that are easy to retrieve and read. Use tools that give you this freedom.

### Reading profile

Starting point
Apply a recommended profile, then adjust any setting below. The dyslexia profile uses a clear sans-serif font, wider spacing, left alignment, and a warm light theme.
Open pages in Lens
Manual does nothing automatically. Offer shows the Lens handle on readable pages. Automatic opens high-confidence articles and respects per-site choices.

### Site rules

Choose which sites always use Lens or never offer it. Sites without a rule use the setting above.

No site-specific rules yet.
Add a site rule

### Fonts

Font options
Add fonts installed on your system. Press enter to add a font.

### Typography

Base font size
Letter spacing
Word spacing
Paragraph spacing
Text alignment
Left-aligned text is recommended. Justification can create uneven gaps between words.
Line height
Line width
Color links

### Theme

Appearance
Choose light or dark appearance.
Theme
Choose the colors used in reading view.
Dark mode color scheme
Use a different color scheme in dark mode.

### Images

Blend images
Blend images with the page background in reader mode.

### Transcripts

Pin player
Keep the video player visible while scrolling through the transcript.
Auto-scroll
Automatically scroll the transcript to follow playback.
Highlight active line
Highlight the current sentence in the transcript during playback.

### Advanced

Custom CSS
CSS applied automatically in reading view.

## Listen

Enable narration
Read pages aloud in Lens with synchronized highlighting. Uses an enhanced voice when configured, or a voice from your device.

### Enhanced voice

Connect to Reframe
Enter the team access code you received. It is stored only on this device and gives Lens access to Reframe narration. It is not your ElevenLabs key.
Quality
Fast is recommended for reading. Premium can sound better for some voices and languages.
Enhanced voice
Voices load after Lens is connected to Reframe.

### Device voice

Device voice
Voices provided by your browser or operating system. Voices marked "local" work without an internet connection; others are remote services chosen by your browser.
Fall back to device voice
If the enhanced voice fails, continue automatically with the device voice from the same position.

### Playback

Default speed
You can also change speed anytime from the player. Narration speed is a personal preference — pick what is comfortable.
Highlighting
How narration is highlighted while listening. Preferences vary — no one mode is right for everyone.
Follow along
Scroll the page to keep the narrated section visible. Respects your system's reduced-motion preference.

### Privacy

When the enhanced voice is used, Lens sends only the section currently being spoken to the Reframe narration service, which uses ElevenLabs to create the audio. Lens and the gateway do not log page text or audio. Device voices are provided by your browser: voices reported as local are processed on your device, while remote device voices send text to the voice service your browser uses.

## Explain

Enable Explain
Use natural language to extract data from pages. For example, you can use the template syntax {{"a summary of the page"}}. Requires an API key or custom model configured below. Learn more.
Automatically run
Run prompt variables immediately if the template contains any. This will consume API credits with your model provider. Turn off if you only want to run Explain manually.

### Providers

By using an external provider you agree to their terms and privacy policy. Explain requests are sent directly to the provider you choose. Reframe does not gather or store any data about your requests.
+ Add provider

### Models

+ Add model

### Advanced

Default explain context
Override the context used to process prompt variables. Variables can be used here.

## Save & integrations

### Vaults

By default, clipped notes are saved to the currently open vault. You can add vaults here if you want the option to save to different vaults. Vault names must exactly match the name of the Obsidian vault. Press enter to add a vault.

Import properties
To import your properties from Obsidian, locate the types.json file in the .obsidian folder within your vault. Note this folder is hidden by default on most operating systems.
Export properties
Save Lens note properties to a types.json file that can be imported into your Obsidian vault, or into Lens on other devices.
Remove unused properties
Remove all properties that are not used in any template.

### All properties

+ Add property

## Advanced

Legacy mode
Uses the URI clipping method compatible with Obsidian 1.6.7 or earlier. Note that the length of the content you can clip is limited by your browser and OS. Some pages may fail without any errors.
Early access features
Use features that require the latest early access version of Obsidian. Currently requires Obsidian 1.7.2 or later.
Reset default template
Remove any changes you've made to the default template.
Export all settings
Export all settings including templates and properties.
Import all settings
Import all settings including templates and properties. This will replace your current configuration.

## Edit template

### Template

Template name
Template triggers
Define rules to automatically select this template if it matches a URL pattern or contains schema.org data. One rule per line.

### Location

Behavior
Note name
Format for the file name of the note. You can use variables like {{title}}, {{date}}, and {{published}} to pre-populate data from the page.
Note location
The folder or path of the note.
Vault
Select the default vault for this template. Go to general settings to add or remove vaults.

### Content

Properties
Properties to add to the top of the clipped note. Use variables to pre-populate data from the page.
+ Add property
Note content
Customize the content of the note. Use variables to pre-populate data from the page.

### Advanced

Explain context
The context used to process prompt variables. Overrides the default context defined in Explain settings. Variables can be used here.
Import

Drag and drop file here

Or paste content below

Provider
Select the provider for this model.
Popular models
Choose from commonly used models or enter custom model details.
Display name
A name for this model.
Model ID
The model identifier from your provider.
Provider
Choose a Provider or add a custom one.
Provider name
Display name for this provider.
Base URL
The API endpoint URL for this provider.
API key
Your API key for this provider.
Thanks for your feedback

How can we improve Lens? Please visit our help page, where you can report bugs, suggest features, and get help with common issues.

Help