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.
| Tab | What is in it |
|---|---|
| General | Network, Time zone, Volume, Display scale, Lock PIN, Lock after, Passwords, Language & Region |
| Appearance | Appearance, Terminal profile |
| Wallpaper | Wallpaper, Light or dark, My photo, Photo fit, "NanumOS" on the wallpaper |
| Display & Power | Screen saver and display-off times, Require password, Hot corner |
| Weather | Location |
| Fonts | Interface font, Terminal font, Text size |
| Terminal | Terminal text size |
| Screenshots | Save screenshots to |
| Models | The model list |
| Accounts | Mail accounts |
| Apps | The list of apps that have settings |
| Notifications | Do Not Disturb, Use the Mac's Notification Center, Previews on the Mac (per kind) |
General
| Setting | What it does | Default |
|---|---|---|
| Network | The 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 zone | The 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 |
| Volume | A 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 scale | Pick 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 PIN | Set PIN… makes a PIN. When one exists the button is Change…. The value is None or On. See below. | None |
| Lock after | Locks the screen after this much idle time. Pick Never, 1, 2, 5, 10, 15, 30 or 60 min. | Never |
| Language & Region | Shows 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 thing | Once 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 |
| Passwords | Access… 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:
- Press
Set PIN…. If a PIN exists, it first asks forCurrent PIN. - Type at least 4 characters in
New PINand pressEnter. Leave it empty and pressEnterto remove the PIN (PIN removed). - Type the same PIN in
Againand pressEnter. If they differ you getThe two PINs differ - try again. - 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.
| Setting | What it does | Default |
|---|---|---|
| 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 |
| Region | Automatic, 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 week | Sunday / Monday. Calendar starts its rows on this day. | Sunday in South Korea and the US, Monday in the UK |
| 24-hour time | On: 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 with | All 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).
| Setting | What it does | Default |
|---|---|---|
| Do Not Disturb | On: 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 Center | Only 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 notifications | One 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 isdocs/contracts/NOTIFY.md. - On the Mac, the app's
host_notify.swifttakes them on vsock port 0x5a42. By default the only line that crosses isN <number> <kind> <app> NanumOS <fixed words> <flags>.
Appearance
| Setting | What it does | Default |
|---|---|---|
| Appearance | Pick Light, Dark or Auto with ‹ ›. Auto is dark from 7 pm until 7 am and light in the daytime. | Light |
| Menu bar logo | Picks 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 apps | Shows 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 profile | The colours of the terminal window: Basic (light) or Pro (dark). | Basic (light) |
Wallpaper
| Setting | What it does | Default |
|---|---|---|
| Wallpaper | Pick 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 dark | Light, 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 wallpaper | Shows 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 fit | How 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.
- Fill: the photo covers the whole screen. If the shapes differ, a little is cut off at the top and bottom or the sides (the middle stays).
- Fit: the whole photo is shown. If the shapes differ, there are bands at the sides or top and bottom, in the photo's own average colour, darkened.
- Center: the photo is not enlarged or reduced, just put in the middle. A small photo gets bands all round; of a big one you see the middle.
How to use it.
- In Settings › Wallpaper click 「Choose a photo…」. The Pictures folder opens.
- Pick a photo and click Open. 「Applying…」 shows for a moment; when it is ready, the wallpaper changes with a soft fade.
- Under 「Photo fit」 choose Fill, Fit or Center.
- 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」.
- 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.
- 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. - *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.
- What if I delete the original photo? The wallpaper stays: it uses the copy.
- It says 「This format can't be a wallpaper yet」. HEIC (a photo format some phones use) cannot be unpacked yet. JPEG, PNG, BMP, GIF, WebP, TIFF, AVIF and camera RAW can. Save the photo as JPEG and it works.
- The top or bottom got slightly darker. That is a faint shade so the lettering reads. Where the contrast is enough, nothing is shaded.
- Why 「Applying…」 instead of at once? The photo is being made screen-sized once. A big photo takes a few seconds; you can carry on meanwhile.
- I want the old one back. Click a thumbnail, or [Undo] on the assistant's card.
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).
| Setting | What it does | Default |
|---|---|---|
| Screen saver on battery / on power adapter | How long with nothing happening before the screen saver starts | 2 min on battery, 10 min on the adapter |
| Display off on battery / on power adapter | How long before the display turns off | 5 min on battery, 30 min on the adapter |
| Require password | Whether 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 locks | Off |
Weather
| Setting | What it does | Default |
|---|---|---|
| Location | Pick 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
| Setting | What it does | Default |
|---|---|---|
| Interface font | The font of menus, windows and apps: Pretendard or JetBrains Mono. | Pretendard |
| Terminal font | The font of the terminal: JetBrains Mono or Pretendard. | JetBrains Mono |
| Text size | A 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.
- Bigger:
Ctrl/Cmd+=, View › Bigger, A+ in Help - Smaller:
Ctrl/Cmd+-, View › Smaller, A- in Help - Normal size:
Ctrl/Cmd+0, View › Actual Size - A touchpad pinch,
Ctrl/Cmd+ wheel and a two-finger pinch on the phone do the same. - You can also ask the assistant: "make Help's text bigger" (it happens at once, no approval card).
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
| Setting | What it does | Default |
|---|---|---|
| Terminal text size | The 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
| Setting | What it does | Default |
|---|---|---|
| Save screenshots to | Where 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.
Add Account…at the right of theMail accountsrow sets up a new account (Gmail, Naver, Daum, Outlook, iCloud or any other).- Each account has an
Edit…and aRemove…button. - Removing deletes the account file and its secret. If the account password is in the vault, it asks
Keep Vault(keep the vault entry),Delete Vault(delete the vault entry too) orCancel. - With no account you see a note that starts with
No mail account yet.
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
| Key | What it does |
|---|---|
Tab, Shift and Tab | Next or previous pane |
↑, ↓ | Pick a setting inside the pane |
←, → | Change the value of the picked setting |
Enter | Items 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
- Volume cannot be changed on a device without an audio driver.
- The
Add Account…,Edit…andRemove…buttons of the Accounts pane are not translated to Korean yet. - The six first wallpaper names have no Korean names yet (the eight new ones do).
- A photo wallpaper cannot use HEIC yet (JPEG, PNG, BMP, GIF, WebP, TIFF, AVIF and camera RAW work). The phone screen has no photo wallpaper yet.
- There is no
ApplyorRevertbutton and no reset-all. To undo a change, change the same setting again.
NanumOS 0.1.8349 · 2026-11-16