NanumOS

Settings guide

This page explains every pane and setting of the Settings app, one by one. A short introduction to the app itself is on the Settings app page.

Opening Settings

Open the Settings app on the desktop. Pick it from the app list, or hold Alt and press 9. You can also search for Settings in the app list. A change applies at once and is saved at once. There is no Apply button. After each change you see Saved to <file path> at the bottom of the window. If saving fails, Could not save <file path> appears in red.

The panes

The panes are listed on the left of the window, with a search field on top (on a phone, a list of panes). These are the ones used most.

TabWhat is in it
GeneralNetwork, Time zone, Volume, Display scale, Lock PIN, Lock after, Passwords, Language & Region
AppearanceAppearance, Terminal profile
WallpaperWallpaper, Light or dark, My photo, Photo fit, "NanumOS" on the wallpaper
Display & PowerScreen saver and display-off times, Require password, Hot corner
WeatherLocation
FontsInterface font, Terminal font, Text size
TerminalTerminal text size
ScreenshotsSave screenshots to
ModelsThe model list
AccountsMail accounts
AppsThe list of apps that have settings
NotificationsDo Not Disturb, Use the Mac's Notification Center, Previews on the Mac (per kind)

General

SettingWhat it doesDefault
NetworkThe Turn On / Turn Off button switches the network. When it is on you see On · address/prefix; when it is off, Off. Same as the console commands net up and net down.Depends on the device
Time zoneThe offset from UTC (like UTC+9), changed one hour at a time with ‹ ›. The range is UTC-12 to UTC+14. Apps such as Clock and Calendar follow it.The device's time zone
VolumeA slider from 0 to 100%. It applies when you let go. On a device where volume cannot be changed it says not available (no audio driver yet).The device's current volume
Display scalePick Auto, 1x or 2x. 2x can be picked only when the screen is at least 1600 pixels wide. Auto shows the scale it chose, like Auto (1x).Auto
Lock PINSet PIN… makes a PIN. When one exists the button is Change…. The value is None or On. See below.None
Lock afterLocks the screen after this much idle time. Pick Never, 1, 2, 5, 10, 15, 30 or 60 min.Never
Language & RegionShows the language and region now (like English · Automatic (United Kingdom)). Clicking the row opens the Language & Region screen.Depends on the build
Show today's one thingOnce a day, the first time the desktop is idle after login, a "Today's one thing" note at the top right shows how to use an app you have not tried yet. Off: it never comes. See Notifications.On
PasswordsAccess… opens the vault's access screen. At the right you see the number of grants and the vault state, like N grants · locked or · unlocked.0 grants

To make a PIN:

  1. Press Set PIN…. If a PIN exists, it first asks for Current PIN.
  2. Type at least 4 characters in New PIN and press Enter. Leave it empty and press Enter to remove the PIN (PIN removed).
  3. Type the same PIN in Again and press Enter. If they differ you get The two PINs differ - try again.
  4. When done you see PIN set (Super+L locks).

Esc cancels (PIN unchanged).

With a PIN you can lock the screen with Super+L or from the power menu. After a wrong PIN you wait 1 second; after three wrong tries you wait 5 seconds. With no PIN, the lock screen opens with just Enter. On a device with user accounts, the lock screen asks for the account password instead.

Cable and Wi-Fi, back and forth

You never have to type anything to move between a LAN cable (or USB LAN adapter) and Wi-Fi. A cable plugged in after the computer started gets an address on its own, usually within 3 to 6 seconds. If you pull the cable, or turn Wi-Fi off, the computer looks for the other link every 3 seconds. If both a cable and Wi-Fi are available, the cable is preferred. To choose by hand, open the Control Center (the sliders icon in the top bar) and press Wired or Wi-Fi in its Network row; the console equivalents are net up (cable first) and net up wifi. Nothing needs net down first. If there is no cable link the log says no cable rather than pretending to be online. The Control Center is where you see which link is in use; os_check has a 망 지킴이 row with the last thing the keeper did.

Language & Region

The same screen as Language & Region on a Mac. A change applies to every app at once and is saved. Under Example you see today's date and time, a number, a temperature and a distance as they look with the settings now.

SettingWhat it doesDefault
Language한국어 / English. Every app, the top bar and its menus, the lock screen and the search sheet change at once. The words shown while the computer starts change from the next start.Depends on the build
RegionAutomatic, South Korea, United States, United Kingdom, picked with ‹ ›. Dates look like 2026년 11월 3일 (화) 오후 3:00 in South Korea, Tue, Nov 3, 3:00 PM in the United States and Tue 3 Nov 15:00 in the United Kingdom (the words in the chosen language). A new region sets the four rows below back to its own defaults.Automatic (South Korea in Korean)
First day of weekSunday / Monday. Calendar starts its rows on this day.Sunday in South Korea and the US, Monday in the UK
24-hour timeOn: 15:00; off: 3:00 PM. The top bar, Clock, the dates in Files and the lock screen follow.Off in South Korea and the US, on in the UK
Temperature°C / °F. The weather in the top bar and the Weather app follow.°F in the US, °C elsewhere
Korean input (2-Set)Off: the Han/Eng key types English only. English (ABC) input is always there.On
Switch input withAll three of Han/Eng key, Right Alt, Shift+Space, or Han/Eng key, Right Alt (Shift+Space types a space), or Han/Eng key, Shift+Space (Right Alt is Alt). The input menu in the top bar shows the same words.All three

Calendar's Week starts on, Clock's 24-hour time and Weather's Temperature unit follow this screen unless you picked something else in that app's own settings. In the top bar's input menu (가/A), Language & Region Settings… opens this screen. The phone (lite) has the same screen; at first it follows the phone browser's language.

Notifications

A notification slides in at the top right as a rounded card: the app's icon on the left, a bold title and one or two lines on the right. After about 8 seconds it slides away to the right; while the pointer is over it, it waits (and shows an × at its top left). When several come, they do not overlap: they show one after another. Past ones are in the Notification Center (click the clock in the top bar).

SettingWhat it doesDefault
Do Not DisturbOn: no cards; notifications only pile up in the Notification Center. "Today's one thing" rests too, and nothing goes to the Mac.Off
Use the Mac's Notification CenterOnly in the Mac app. On: notifications also show in the Mac's Notification Center. By default only a line without content goes there — "NanumOS · 1 new message", "Incoming call" (with Answer and Decline), "A reminder is due". No names, message text, phone numbers or file names. The line under it says whether the Mac allowed it (allowed, not allowed, not asked yet).Asked the first time
Previews on the Mac — Messages, Calls, Reminders, Downloads, Other notificationsOne switch per kind. Only a kind you turn on sends its real title and text to the Mac. On: this content is stored in the Mac's Notification Center — NanumOS may not be able to remove it from there. Changeable only while "Use the Mac's Notification Center" is on.All off

The first time a notification comes in the Mac app, NanumOS asks first with its own card: "Show these on the Mac too?" — it says what would cross, with [Use it] and [Not now]. Only after [Use it] does macOS show its own permission prompt. If macOS says no, notifications stay inside NanumOS (you still see them all). [Not now] means nothing is exchanged with the Mac. You can change it here later. Turning it off also removes NanumOS's notes from the Mac's Notification Center.

Clicking a notification on the Mac brings the NanumOS window forward and opens what it is about (in Messenger, that conversation). Answer/Decline on a call and the reply field of a message work right on the Mac (they go from the Mac into NanumOS only). The NanumOS icon in the Mac's Dock shows the number of unread messages. While the NanumOS window is in front, the Mac shows no banner of its own, only the list entry (so a note does not pop up twice).

Today's one thing. Once a day, the first time the desktop itself is in view (no window up) and idle after login (about 20 seconds without input), a note like "Today's one thing — Notes — try telling ⚡ “…”" comes. Apps you have not opened come first; nothing shown in the last 14 days is picked again. Click it: the app and its ⚡ chat open with that sentence in the box (you send it). × or simply waiting makes it go; it stays in no list. Turn it off in General, "Show today's one thing".

Technical details
  • An app sends a notification with notify_post (kinds: tip, message, call, reminder, download, system). The contract is docs/contracts/NOTIFY.md.
  • On the Mac, the app's host_notify.swift takes them on vsock port 0x5a42. By default the only line that crosses is N <number> <kind> <app> NanumOS <fixed words> <flags>.

Appearance

SettingWhat it doesDefault
AppearancePick Light, Dark or Auto with ‹ ›. Auto is dark from 7 pm until 7 am and light in the daytime.Light
Menu bar logoPicks the logo at the top left (the NanumOS menu) with ‹ ›: A Solid bolt, B Bolt tile, C Thunder Z, D Laurel, E Shield, F Split disc. The same shape is drawn in white on the purple tile of About NanumOS and System Information. The change shows at once and is saved. Why a solid shape: the logo in the bar is only about 18 pixels tall, where a thin line looks faint and a filled shape stays sharp (like a small stamp cut with thick strokes).B Bolt tile
Zeus button on appsShows or hides the ⚡ Zeus button at the top of every app (a switch). A press opens a new chat about that app and Zeus explains it right away (for an app Zeus opened, it goes back to that chat). See Desktop.On
Terminal profileThe colours of the terminal window: Basic (light) or Pro (dark).Basic (light)

Wallpaper

SettingWhat it doesDefault
WallpaperPick the desktop picture from the thumbnails or with the arrows: eight new looks (Bloom, Aurora, Ridge, Flow, Horizon, Nebula, Waves, Dunes) and the six first ones (Daylight, Dawn, Lake, Meadow, Dusk, Mist).Bloom
Light or darkLight, Dark, or By time of day (light from 07:00 to 19:00, dark at night, changing once with a soft fade). Only the new looks have both.Light
"NanumOS" on the wallpaperShows or hides the NanumOS lettering in the middle of the wallpaper (a switch, On / Off).On
My photo · Choose a photo…The two tiles at the end of the thumbnails. 「Choose a photo…」 opens the Pictures folder and the photo you pick becomes the wallpaper. 「My photo」 puts the last chosen photo back.None
Photo fitHow your photo sits on the screen: Fill, Fit, Center.Fill

Your own photo as the wallpaper

You can put a photo you took behind the desktop. It is like putting a photo in a frame: when the frame (the screen) and the photo have different shapes, the photo is trimmed a little to fill it, shown whole with empty edges, or put in the middle at its own size. What to do now: in Settings › Wallpaper click 「Choose a photo…」 and pick one.

Basics. A photo file is a picture made of dots (pixels). Phone and camera photos are usually JPEG (.jpg), screenshots usually PNG (.png). Both are stored packed, so they have to be unpacked (decoded) before they can be shown. A 4000×3000 photo has 12 million dots, so unpacking it and making it screen-sized takes a few seconds. There are three ways to fit it to the screen.

How to use it.

  1. In Settings › Wallpaper click 「Choose a photo…」. The Pictures folder opens.
  2. Pick a photo and click Open. 「Applying…」 shows for a moment; when it is ready, the wallpaper changes with a soft fade.
  3. Under 「Photo fit」 choose Fill, Fit or Center.
  4. Other ways: in Photos right-click a photo (or the File menu) › 「Set as Wallpaper」, in Files right-click a picture › 「Set as Wallpaper」, drag a picture from the desktop or Files onto the 「My photo」 tile, or tell the assistant 「make this photo my wallpaper」.
  5. To go back to a drawn wallpaper, click one of the thumbnails. Your photo is not deleted; it stays in the 「My photo」 tile.

How it works. A photo becomes the wallpaper in four steps.

  1. Unpack and resize (in the background): a small program, imgview, unpacks the photo in the background and makes it exactly screen-sized in the fit you chose. The desktop keeps moving meanwhile — that is why a big photo does not freeze the screen.
  2. *White or dark lettering is chosen, whichever reads better, and where the contrast is still below 3.3:1 only that area gets a faint shade (darker, or lighter). That is why names stay readable even on a very bright photo.

Common questions.

Technical details
  • The command that makes it: imgview --wall IN OUT W H FIT DIV — decoded with stb_image, box average when reducing, bilinear when enlarging. It is written under another name and renamed when done, so half a picture is never read. On a big screen where a screen-sized picture does not fit one file (16 MiB) it is made at half size and the desktop enlarges it.
  • Log lines: GUI wallpaper photo start, made ms=… loop_gap_max_ms=… (the longest gap of the screen loop meanwhile), shown fit=… ink=… scrim=…, GUI wallpaper stats … icons_contrast=….
  • The phone screen (a screen without the wallpaper cache) cannot show a photo wallpaper yet.

Display & Power

When you step away, the screen first dims a little, and a bit later the screen saver comes on: a big clock on black, today's date in words (like "Tuesday, November 3"), and under it, faintly, the purple Zeus bolt with "NanumOS · Screen Saver". The whole block moves a little every minute so nothing burns into the screen. What to do now: press any key or move the mouse and you are back (the first input only wakes).

SettingWhat it doesDefault
Screen saver on battery / on power adapterHow long with nothing happening before the screen saver starts2 min on battery, 10 min on the adapter
Display off on battery / on power adapterHow long before the display turns off5 min on battery, 30 min on the adapter
Require passwordWhether waking from the screen saver or a dark display asks for the password (Immediately, After 5 min, Never). It only asks when there is a PIN or an account password.Immediately
Hot corner (bottom right)Pushing the pointer into the bottom-right corner starts the screen saver, turns the display off, or locksOff

Weather

SettingWhat it doesDefault
LocationPick the city for the weather with ‹ ›. The weather in the top bar and the Weather app switch to that city, and Weather for <city> appears.The first city in the list

This pane carries one note: the weather comes from Open-Meteo.com (free, no account). Only the city centre is sent, and the location is never taken from your IP address.

Fonts

SettingWhat it doesDefault
Interface fontThe font of menus, windows and apps: Pretendard or JetBrains Mono.Pretendard
Terminal fontThe font of the terminal: JetBrains Mono or Pretendard.JetBrains Mono
Text sizeA slider from 85 to 130%. It applies when you let go and snaps to steps of 5%. Outside the slider (a pinch, or the assistant's text size action) the range is 75 to 200%.100%

A preview box under the slider shows Korean and English samples so you can judge the size before it applies. On the phone version, a two-finger pinch can change it from 75 to 200%.

Text size per app

Every app that shows text has its own text size. Think of a magnifier for each app: making Zeus Studio's text bigger leaves Notepad as it was. The size stays when the app opens again and after a restart.

There are eight sizes: 80 · 90 · 100 · 115 · 130 · 150 · 175 · 200 %. Each press moves one step; at the largest size A+ is dimmed, at the smallest A- is. When the size changes the text wraps again to the window (no cut-off lines). Zeus Studio, Help, Notepad, zOffice Documents, Mail, News, Reader, Dictionary, Files and Settings share these steps, and the Terminal sizes its cells with them. Photos, PDF and Viewer zoom the picture instead of the text.

Try it now: press A+ three times in Help, watch the text grow, then Ctrl+0 to go back.

Terminal

SettingWhat it doesDefault
Terminal text sizeThe zoom of newly opened terminal windows. Pick 75, 90, 100, 110, 125, 150, 175, 200, 250 or 300% with ‹ ›.100% (125% on a 2x screen at least 3000 pixels wide)

Screenshots

SettingWhat it doesDefault
Save screenshots toWhere screenshots go: Pictures/Screenshots or Desktop.Pictures/Screenshots

The keys for taking screenshots are on the Shortcuts page.

Models

Accounts

Manage your mail accounts in one place.

Opening the account settings from the Mail app opens this pane too.

Apps

The list of apps that have settings. Tap an app to open its settings. The Apps button goes back to the list. The same settings open from the Settings… menu inside the app. If no app has settings you see No app has settings yet. The settings of each app are described under Settings on that app's page in the app manual.

Using the keyboard

KeyWhat it does
Tab, Shift and TabNext or previous pane
↑, ↓Pick a setting inside the pane
←, →Change the value of the picked setting
EnterItems that act: Network on/off, Lock PIN, Passwords

With the mouse you click the tabs and buttons and drag the sliders.

Clipboard with the host computer

In a Mac or PC window, text copies and pastes both ways (Korean as is). Vault passwords do not cross, and the log keeps sizes only. Turn it off with the "Clipboard with the host computer" switch in Settings › Sharing (on by default). For copy and paste with VMs, see Virtual machines.

On the phone

The phone screen shows the list of panes first. Tap a pane to open it; swipe from the left edge or press the back arrow at the top to return to the list. At the bottom of the list you see the NanumOS release and the screen size.

Where settings are saved

Not yet

NanumOS 0.1.8349 · 2026-11-16