Skip to main content
Version: 2.0.0-preview

Browser

Browse websites in a dockable tab, bookmark pages, and download files for your project.

Tab characteristics​

  • Open by default: No
  • Allow multiple instances: Yes

How to open​

Open View → Tools → Browser. Each instance can show a different page. If the browser engine is unavailable, follow the runtime-installation guidance shown in the tab.

Enter an HTTP/HTTPS URL or search terms in the address bar. Use back, forward, and reload. When a page takes longer than 200 ms to load, the tab's header shows a spinning ring in place of its globe icon until the load finishes, stops, or fails, also while the tab is in the background. On a new tab’s blank page, choose Add bookmark to register a URL and name. The tab menu includes New Tab, Find in page, zoom, Open in Default Browser, and Print.

While viewing a web page, the tab menu's Add bookmark saves its current URL and page title directly to your bookmarks.

A page's window.open() and links that open a new window open in a new tab. That tab sends the opening page's origin as its referrer, so material sites that refuse hotlinks accept the request. It sends none when the page or the link asks for no referrer, or when an HTTPS page opens an HTTP one. Tabs that are not shown keep their pages, so switching back does not reload them (except with WPE WebKit on Linux). On Linux, cookies are kept across restarts.

  • Ctrl + F (Cmd + F on macOS): Find in page. Enter moves to the next match, Shift + Enter to the previous match, and Esc closes the search.
  • Ctrl + + / Ctrl + - (Cmd on macOS): Zoom. Ctrl + 0 (Cmd + 0 on macOS) resets to 100%. Zoom ranges from 50% to 200%.

Downloads​

Downloads offer a destination in the project (resources/downloads) or the shared Materials folder. Any file can be saved, such as a ZIP of sound effects, fonts, or LUTs. The one exception is a web page served in place of the file, for example a sign-in page. Supported image, video, and audio files can also be added to the timeline.

A download that a page asks for, such as a click on a download link, opens the download options at once. It waits in a notification on the bar instead while another browser panel is open, such as bookmark editing, and when an extension takes the file over (see below). Files a page sends while the options are open wait in the notification after you cancel or close them. While a file downloads or waits in the notification, a click on another download link can be ignored. If you cancel the options a page opened twice in a row, Beutl ignores that page's download requests, along with the files it queued, until the page reloads. Ignore download requests until this page is reloaded in the notification does the same, except that while more files wait, it moves on to the next one. Until the page reloads or you close it, the notification says Ignoring download requests from this page until it is reloaded.

On Windows and macOS, every file the tab saves is marked as downloaded from the internet before it appears: a Zone.Identifier stream on Windows, with the address it came from, and the com.apple.quarantine attribute on macOS. SmartScreen, Protected View, and Gatekeeper then check it as they check a file a web browser downloaded. A volume that cannot hold the mark, such as FAT, leaves the file unmarked, and Linux has no such mark.

Files a page generates in script (blob: and data: URLs) are offered on the same bar, with the name the page gave them. The bar and the history credit the file to the page, or to another site when the browser engine names one as its creator.

On macOS, when a form you submit answers with a file, the tab saves the response it has already received, so the form is not sent again.

An installed extension can take over a file that a page offers, such as speech generated on a voice site, and place it in its own way. The bar then shows the extension's description in place of the file name, which moves to the tooltip. Nothing is added until you confirm. The file is then saved to the project's resources/downloads without the download options, and the extension adds it to the scene. If the extension declines the file, it is added as one element, as usual. Extensions are offered files only while the scene and its project are saved. Retrying from the download history keeps the download options.

Download file in the tab menu downloads the current page. On a web page, an installed extension that downloads media, such as a video downloader, gets the page first, at the address the page shows at that moment. While the extension downloads, the bar shows it, and you can cancel it there. When no extension takes the page, the download options open for it as usual.

Open Download history from the tab menu to open a downloaded media file or the folder of any file, import supported media, retry a download, or remove a history entry. Only media files can be opened from the history, because opening other files could run a downloaded program. A generated file, or a file saved from a form's response on macOS, cannot be retried. Removing an entry leaves the downloaded file on disk.

Search and privacy​

Open Search and privacy from the tab menu, or open the browser settings page:

SettingDefault
Search engineGoogle (Bing is also available)
Search suggestionsOn
Keep download historyOn
Block adsOff
Filter listEasyList

For ad blocking, enter HTTPS filter URLs, one per line, then use Update filters. EasyList is supported with some rule limitations; updates are manual.

You can clear local download history and delete browser cookies. Cookie deletion asks for confirmation because it signs you out of websites, and is available only when the browser engine supports it.

Source​