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
- The home screen appears. The first time takes a moment while the fonts download.
- 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 this | Do this |
|---|---|
| Open an app | Tap its icon. |
| Go home | Swipe up from the home bar at the bottom. |
| See recent apps | Swipe up from the home bar and pause. Tap a card to open it, swipe a card up to close it. |
| Go back | Swipe in from the left edge. On an app's first screen this goes home. |
| Find an app | Tap the search bar on the home screen and type. Open the first result with Enter. Close with Esc. |
| Control center | Pull down from the right end of the status bar. |
| Ask about this app | Tap 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
- There are no windows. One app fills the screen, and the top bar has the title and a back arrow.
- Calculator has a black background with a big keypad and no history panel.
- News shows the list and the article one column at a time.
- Radio has the search field on its own row and a small player bar.
- Touch and swipes replace mouse menus and shortcuts.
- Radio sound comes straight from the station to your phone. Our server never passes broadcast sound along. So stations without an https address are not in the list.
- Your files and settings are kept inside this browser. The server keeps nothing about you.
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.
- When a file cannot be opened, one plain line says why and a 「This didn't work」 button appears. Tapping it sends only which app and what kind of file (no name, no contents).
- iPhone photos (HEIC) are turned into JPG on this device. Big videos are read in parts, not copied whole.
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).
- Asking the browser to keep them. The first time you save something, Lite asks the browser not to clear your files. The answer is at the top of Settings › Storage & Backup. "This browser keeps your files" means they are kept; "The browser may clear them when space runs low" means turn a backup on. The space used and available is shown too.
- iPhone Safari. In a Safari tab, files can be cleared after 7 days unused. An app added to the home screen is exempt. But the iPhone keeps a home-screen app's files apart from Safari's: the home-screen app starts empty. To bring what you used in Safari (notes, Zeus chats and so on), make a backup file in Safari and restore it in the home-screen app. The Safari copy stays where it was. Lite says so once when you first save; "Later" hides it.
- Choosing a backup place. Lite asks once after your first save. Change it any time in Settings.
| Backup place | What 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 file | All files and settings in one file (.zip), kept on the phone through the share sheet or a download. |
- Restoring. Settings › Storage & Backup › Restore from a backup, then pick the file. Lite asks first: Merge keeps the files here and adds the backup's; Replace all removes the files here first.
- Reminders. If some files have not been backed up for 7 days, a bar appears at the bottom. One tap on Back up is enough.
Technical details
- Files: the browser's IndexedDB (
zeusos-weblite). The request to keep them isnavigator.storage.persist(); the space isnavigator.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.
- It checks for a new build every time it opens, every 5 minutes while it is open, and when you come back from another app.
- If you are not typing, it switches at once. The screen blinks once and the app and note you had open come back.
- If you are typing, it waits. A small notice at the top says "새 판이 있어요 · 지금 바꾸기" (a new build is ready · update now). Tap it to switch then; otherwise it switches when you leave the app or the next time you open it. What you typed is saved first.
- When the build you run was made is shown in Settings › About, and the same words in System › Overview › Update.
What to do now: nothing. When the notice shows, finish what you are typing and tap it.
Not yet
- Apps that have not been moved say "soon".
- An app a browser cannot run shows an "Only on the desktop" card.
- Voice Memos cannot use the microphone yet.
- The picture "Screen" of the Virtual Machines app is not on Lite yet.
- Radio cannot play a station that does not use https.
- Photo formats the browser does not support are saved as they are. iPhone Safari converts HEIC and saves it as JPEG.
- The recent-apps screen remembers at most 8 apps and 6 screen pictures.
- If the page gets slow or stuck because of the browser or the phone, open it again.
Troubleshooting
- If the desktop opens: the phone screen is chosen when it is upright and its logical width is 500 or less. If you turned the phone sideways, turn it upright. On a NanumOS console, run
gui phone. - If the link does not open: the invite may have been cancelled. Ask whoever gave you the link for a new one.
- The first open can be slow. From the second time on, saved files are used.
NanumOS 0.1.8349 · 2026-11-16