NanumOS

Phone edition (Lite)

A light NanumOS that you open straight in a phone browser. There is nothing to install. The apps run inside the browser, and if you add it to the home screen it works like an app.

What it is

Lite is a phone-shaped NanumOS screen. It has a home screen, app search, recent apps and a control center. Apps open one at a time, full screen.

It uses the same app code as desktop NanumOS. So Notepad, News and Calculator open with the same names and the same look. Only the apps that can run on a phone have been moved so far.

Putting NanumOS on a real phone and booting it is a different story. That is still an experiment and outside this manual.

How to open it

  1. The home screen appears. The first time takes a moment while the fonts download.
  2. In iPhone Safari, tap "Share, then Add to Home Screen". It then opens like an app, without the address bar. After the first download it also opens without internet.

To try it before you have an invite link, there is the try build (/try), with only the apps that use no server — see "Try it right away" in the Web desktop chapter.

The screen and gestures

The home screen has a 4-column app grid, a search bar and a dock at the bottom. When there are many apps they split into pages, and you swipe left and right. The dock holds Zeus, Browser and Files by default. Touch and hold an app for the iPhone's edit mode; rest one app on another for a moment to make a folder. Every app is in the App Library past the last page (Apps and folders).

To do thisDo this
Open an appTap its icon.
Go homeSwipe up from the home bar at the bottom.
See recent appsSwipe up from the home bar and pause. Tap a card to open it, swipe a card up to close it.
Go backSwipe in from the left edge. On an app's first screen this goes home.
Find an appTap the search bar on the home screen and type. Open the first result with Enter. Close with Esc.
Control centerPull down from the right end of the status bar.
Ask about this appTap the round ⚡ next to "‹ Home" at the top of the app. A new chat about that app opens and Zeus explains it right away (the chat you were having stays in the list). A green dot by the ⚡ means Zeus opened that app for you; then the ⚡ goes back to that chat.

You type with the phone's own keyboard. Lite does not draw a keyboard of its own.

Spread or pinch two fingers: text apps change their text size, Photos and Viewer scale the picture about your fingers. Move a zoomed photo with one finger; a double tap toggles fit / 100 %.

What differs from the desktop

Apps that open today

Notepad, News, Zeus (chat with Kim), Zeus Radio, Calculator, Clock, Mail, Terminal, Vault, Files, Music, Photos, Video, Voice Memos, Virtual Machines, Help, Contacts, Reminders, Unit Converter, Console and Network. Apps still being tried, and apps a phone's browser cannot run, are together in the Lab folder on the home screen.

An app a phone's browser cannot run (Chromium, for one) keeps its tile. Tap it and it says in plain words why, and what to use on mobile instead.

Opening your own files

Tap 「Open my file」 (「Open my photo」 in picture apps) on an app's empty screen once: the phone's Photo Library or Files opens, and the file you choose opens right in that app — like a parcel handed straight to the room it is for. On a computer you can also drop a file on the window, or paste a copied picture.

What to do now: open Photos, tap 「Open my photo」 and choose one picture.

Technical details

Every app uses the same road (kd_phone_pick): the browser's file chooser opens inside your tap (an iPhone opens it only then). If that moment was missed, the page shows a 「Choose a file」 card to tap once more. Each open sends one line, hit/open?app=…&kind=…&size=…&ok=…&why=… (no name, no byte count, no contents); an open that failed adds the file's type from a fixed list (&ft=heic, &ft=mov:nodec) so the cause can be found.

Keeping your files (Storage & Backup)

On Lite your notes, photos and documents live only in this phone's browser. We never upload them to our server. The browser's storage is like a drawer: when the phone runs low on space, the browser may empty it. So keep a second copy in a place of your own.

What to do now: open Settings › Storage & Backup and pick a backup place. On an iPhone, before moving to a Home Screen app, make a backup file in Safari first (the Home Screen app starts empty).

Backup placeWhat happens
Google Drive (backs up by itself)Sign in with your Google account and the backup file in your Drive is replaced whenever you save. A sign-in lasts about an hour; then one tap carries on. It may show "Coming soon" for now.
iCloud Drive (tap now and then)A web page cannot upload to iCloud by itself. Tap Save to iCloud Drive and choose Save to Files → iCloud Drive in the share sheet. A reminder comes every 7 days.
My zcloud (backs up by itself)Enter your home NAS address, name and password; every saved file is copied there.
Save as a fileAll files and settings in one file (.zip), kept on the phone through the share sheet or a download.
Technical details
  • Files: the browser's IndexedDB (zeusos-weblite). The request to keep them is navigator.storage.persist(); the space is navigator.storage.estimate().
  • Backup file: an uncompressed .zip — files/<path>, settings.json (this page's settings, without the zcloud password), manifest.json (SHA-256 per file). A restore checks every SHA-256.
  • zcloud: standard WebDAV, uploaded under a hidden name and then moved. The address must be https:// (a browser blocks sending from an https page to http) and zcloud must accept this page's address (CORS). The address, name and password stay in this browser (localStorage).
  • Google Drive: browser-only OAuth (no server, no client secret), scope drive.file (only files this app made). The token stays in this tab (sessionStorage).

Moving to a new build

Lite moves to a new build by itself. There is no need to close and reopen the browser — like the apps on a phone that update overnight.

What to do now: nothing. When the notice shows, finish what you are typing and tap it.

Not yet

Troubleshooting

NanumOS 0.1.8349 · 2026-11-16