NanumOS

ZBrowser

Status: Ready

A full-screen browser for web addresses.

ZBrowser

About this app

ZBrowser shows web pages with NanumOS's own engine. It does not chase the whole web: it focuses on showing text-first sites (news, wikis, blogs) fast and light, and on letting the assistant read the web as structure and tidy it. Video and complex sites belong to the Browser (the Mac web view in NanumOS.app).

Tidy view

Every site has its own design and its own way of writing. The tidy view shows any page in one NanumOS template — title, site and date, a three-line plain summary, then the blocks that fit the kind of page.

Tidy view — a recipe

At a glance

In one line: A browser that opens web addresses.

The screen

Task 1. Open an address

  1. Press Ctrl+L
  2. Type an address or search words
  3. Press Enter

Say: "Open the browser"

Task 2. Open a new tab

  1. Press Ctrl+T
  2. Type an address

Say: "Open the browser"

Task 3. Tidy a page

  1. Open a page
  2. Press the tidy view button

Say: "Tidy this page for me"

Basics

How to use it

Tidy view

  1. Open a page in ZBrowser.
  2. Press the tidy view button (a lined page, right of the reader view button) or Shift+F9.
  3. On a site seen for the first time the summary box says 「Writing the summary…」 for a moment, then the page takes its kind's template.
  4. Press it again for the page itself. Following a link or going elsewhere closes the tidy view too.
  5. Or ask the assistant: 「tidy this page」 (the tidy_page action — reading only, so no approval card). Questions like 「what are the ingredients?」 are answered from the tidy structure with block numbers (tidy_section).

How it works

ZBrowser reads a page into the DOM with our engine (user/webengine), lays it out and draws it in its window. Scripts run inside our engine too. The older text view (Launcher › Browser) loads its page in the background: the status row says "Loading… N s" with Cancel (or Esc), and after 20 seconds it says so; Reload tries again.

Tidy view

Think of moving house: the tidy view puts your things (the page's text) into the same chest of drawers every time. The things stay as they are; only the drawers are ours.

  1. Code takes the skeleton. From the page ZBrowser's engine already built (the DOM): title, date, author, the main text, headings, lists, tables, picture descriptions, what the page declares about itself (JSON-LD, microdata, OpenGraph: price, ingredients, steps, comments …), the comment tree and how many input fields there are. Nothing else is fetched — only the page the person opened.
  2. The model only chooses. The outline (candidate parts and numbered blocks) goes to the assistant's head once; with one tool call it returns the kind of page, which candidate is which part, and a three-line summary. No word list guesses the kind.
  3. Learned once, fast after. Code checks the head's picks on the page (a title and a body really there, a sane body length) and keeps them as the site's tidy rule: where the title and the text are (selectors) and the kind — nothing else. The next page of the same kind on that site is tidied by the rule without the head (「Get a summary」 when you want one). When the site's layout changes and the rule no longer fits, it is learned again. A small line under the template says 「This site's tidy rule: learned / learned again」.
  4. Drawn in our template. The text and the picks become the NanumOS template (HTML), drawn by the same engine. No scripts, pictures or ads are loaded.

Try it: on a recipe page press Shift+F9, Shift+F9, Shift+F9 (tidy, back, tidy again). The second time the summary box shows 「Get a summary」 and the page appears at once — the learned rule did it. Settings › Apps › ZBrowser › 「Sites learned for the tidy view」 lists the site.

Technical details
  • Extraction: user/webengine/tidy.c (web_tidy → ZTD1 records, web_tidy_brief, web_tidy_html, web_tidy_rule); the body comes from the same web_rdoc as reader view. Contract: docs/contracts/TIDY.md.
  • The head: zeus --tidy-kind reads the outline on standard input (a pipe), offers the single tool tidy_page_kind and prints @kind, @sum, @title … lines (user/zeus/appdo.py tidy_verdict checks only their shape).
  • HTML or text handed over from another browser (the Chromium VM, the Mac host browser) goes through the same web_load → web_tidy path.

What is not kept — and why

FAQ

What if the summary differs from the original?

The summary box says 「written by the assistant — may differ from the original」. The text below and 「Open original」 are what count.

Can I pay or sign in from the tidy view?

No. Such pages are shown read-only with [Open the site] to do it on the site itself.

How do I make it forget a site?

Settings › Apps › ZBrowser › 「Sites learned for the tidy view」: [Forget] or [Forget all]. To stop learning, turn off 「Learn site tidy rules」.

What if there is no assistant head?

The template and the text still appear; the summary box says why (「No summary: …」). The kind shows as 「Other」 — code does not guess it.

Try this

1. Open an address

  1. Press Ctrl+L to type in the address field.

Open an address 1

  1. Type an address or words to search, then press Enter.

Open an address 2

2. Open a new tab

  1. Press Ctrl+T for a new tab.

Open a new tab 1

3. Close a tab

  1. Press Ctrl+W to close the tab.

Close a tab 1

Shortcuts

KeyWhat it does
Ctrl+LType in the address field; Enter goes.
Ctrl+T / Ctrl+WNew tab (New Tab page) / close the tab (the last one quits ZBrowser)
Tab with Ctrl heldNext tab; with Shift too, the previous one. Ctrl with a digit 1 … 8 goes to that tab, Ctrl+9 to the last
Ctrl+DAdd to / remove from the favourites
F5 or Ctrl+RReload
Alt with the left / right arrow, BackspaceBack / forward, back
Tab (with Shift: backwards), EnterNext / previous link, follow it
Ctrl+F or F3Find in page
Ctrl+A / Ctrl+C / Ctrl+VSelect all / copy / paste
Ctrl+= / Ctrl+- / Ctrl+0Zoom in / out / 100% (remembered per site)
F9Reader view
Shift+F9Tidy view (again: the page itself)
Up / Down in the address fieldChoose a suggestion
EscStops typing the address, finding or loading; in full screen, back to the window.
Green buttonFull screen / back to the window (Esc too)
Red button, Cmd+Q, Ctrl+QQuit ZBrowser

Korean / English input: Shift+Space, right Alt or the Han/Eng key. Ctrl+click opens a link in a new tab.

Settings

NameValues
Search engineAutomatic (by language: Korean → Naver, otherwise Bing) · Naver · Google · Bing · DuckDuckGo
Home pageWhere the Home button goes; default about:home (the New Tab page)
Learn site tidy rulesOn (default) or off. Off: the tidy view asks the assistant every time instead of learning each site
Sites learned for the tidy viewThe learned sites, each with [Forget], and [Forget all]

Overview

An app to view web pages. It opens in a window like any app (the top bar, the Dock and the clock stay) and draws the page with an engine NanumOS made itself. The "Browser" in NanumOS.app is the Mac web view — a different app; where there is no Mac web view, ZBrowser is the Browser.

What it does

Screen

There is no menu bar; everything is the top row's buttons and keys. F1 opens help.

Version

ZBrowser 1.5.0 (tidy view: any site in one NanumOS template — blocks per kind, a three-line summary, learned site rules). ZBrowser 1.3.0 (a page keeps moving, drawing and answering your keys while it waits for its own data from the internet; more news front pages such as daum.net and hankookilbo.com show properly). 1.2.1 (pages that show dates in other time zones open properly, and the browser gives memory back after each page). 1.2.0 (faster pages: several files at a time, compressed answers). 1.1.0: New Tab page, search engine setting, favourites, suggestions, in-place notice and crash page.

For developers

Set-up that the user's screens do not show:

What it cannot do

NanumOS 0.1.8349 · 2026-11-16