NanumOS

Browser (Chromium VM, Lab)

The Lab way to open web sites: in a Chromium VM.

Browser (Chromium VM, Lab)

It is off unless Settings › Apps › Browser › "Lab: run the Browser as a Chromium VM" is on; the normal Browser is the Mac web view (NanumOS.app) or ZBrowser — see Browser.

About this app

With the Lab switch on, the dock's Browser runs real Chromium (the browser Google Chrome is built on) in a small virtual computer inside NanumOS and shows it in a window. Any web site opens as on an ordinary computer; keyboard, pointer, Korean input and sound go straight through.

Basics

A virtual computer (a virtual machine, VM) is another computer running inside this one. NanumOS is the hypervisor (the layer that runs virtual computers): it starts a small Linux in the VM, and Chromium runs on that Linux. The picture comes straight from the VM's memory; input goes over VNC (the standard remote-screen protocol). To learn more, press ⚡ "Teach me this app's basics".

How to use it

  1. Click Browser in the dock. Prepared, it opens at once; otherwise the first time takes 15–20 s.
  2. Type an address in the address bar and press Enter.
  3. Closing the window lets the Browser sleep and wait, so the next click opens it at once.

Try it yourself

Try it: start the desktop, leave it alone for about a minute, then click the dock's Browser. If it opens at once, it was prepared.

How it works

Why the first click opens at once

The Browser runs in a small virtual computer (a virtual machine, VM) inside NanumOS. The first click used to make it (copy its disk), start it (Linux and Chromium) and wait for its first picture: 15–20 seconds. Now that work is done ahead of time, while you rest.

  1. About 20 s after the desktop starts, after 15 s without a key or the pointer, with the CPUs quiet, the power cord in (when there is a battery) and memory to spare, it begins.
  2. If the browser VM does not exist, it is made; then it is started.
  3. When Chromium in the VM shows its first window (the guest prints one "screen" line), it waits 3 s for the first page to draw.
  4. Then the VM is put to sleep: its CPUs stop, its memory stays. Asleep, it uses no CPU at all.
  5. A click on the dock's Browser only wakes it and connects the picture — about a second.

Like lighting the stove before guests arrive and keeping it banked: when they come, you only open the damper.

What it costs

Try it

  1. Start the desktop and leave it alone for about a minute.
  2. Ask the assistant for a check-up, or System › Run diagnostics. The "브라우저 VM" row says asleep (opens at once) when it is prepared; ready = running, none = off (the first click takes 15–20 s).
  3. Click the dock's Browser: it opens at once.
Technical details
  • Sleep is vmx park (the vCPU threads sleep, RAM and devices stay); waking is the window's show.
  • Log lines: GUI browser prewarm start …, … first window ms=, … ready ms= vm_mb= free_before_mb= free_mb=, and why it waits: … wait why=user-active|cpu-busy|on-battery|small-ram|low-memory|….

FAQ

Why was the first click slow?

Making and starting the virtual computer takes 15–20 s. With "Prepare the Browser in the background" on, that is done ahead of time while you rest.

How much memory does preparing cost?

The browser VM's share (about 1.5 GB in the Mac window, about 2 GB on x86), held while it sleeps. Machines with 3 GB or less never do it, and it lets go by itself when memory runs short.

Is it less secure?

No. The same VM, the same network fence, the same screen password made new at every start.

Try this

1. Get started

  1. First start a Chromium VM in the Virtual Machines app.

Get started 1

2. Open an address

  1. Type an address in the window and press Enter. Keyboard and mouse go straight through.

Open an address 1

3. Use the Reader instead

  1. With no VM, use the Reader or the Browser.

Use the Reader instead 1

4. Watch full screen

  1. When a web page goes full screen (YouTube's full-screen button ⛶ or its f key), the browser window covers the whole screen: no window frame, top bar or Dock, the video fills the screen. Press Esc, or leave full screen in the page, and the window comes back where it was.

Watch full screen 1

  1. To give the window the whole screen whatever the page does, click the window's green button or press Ctrl+Cmd+F. Press Ctrl+Cmd+F again, or move the pointer to the top edge and click the button there, to come back.

Watch full screen 2

Shortcuts

KeyWhat it does
Ctrl+Cmd+FFull screen, and back to the window (the same as the green button)
Ctrl+Alt+EnterSwitch between full screen and the desktop

Settings

Settings › Apps › Browser (or the window's menu "Settings…") has two:

You can also ask the assistant ("turn off preparing the browser"). It is a settings change, so an [Allow] card comes first.

What it cannot do

NanumOS 0.1.8349 · 2026-11-16