NanumOS

Files

Status: Ready

See and organise your folders and files: open, rename, move, trash.

Files

About this app

An app to browse and organise folders and files: open, rename, move and send to the trash.

At a glance

In one line: See, open, rename and trash folders and files.

The screen

Task 1. Open a folder

  1. Choose a folder with the arrow keys
  2. Press Enter
  3. Press Backspace to come back

Say: "Open the Documents folder in Files"

Task 2. Make a new folder

  1. Press Shift+Ctrl+N
  2. Type a name
  3. Press Enter

Say: "Make a Trip folder in Documents"

Task 3. Find by name

  1. Press the search box on top
  2. Type a name
  3. Open a result with Enter

Say: "Open the Files app"

Basics

How to use it

Double-click a file to open it in its default app. Use Open With ▸ to choose another app for one opening, then Always use this app to remember that choice for files with the same extension. This applies to files in Downloads and other folders too. Press Space for a preview without changing apps.

  1. Pick with the arrows and open a folder with Enter; Backspace returns to the parent.
  2. Shift+Ctrl+N makes a folder, F2 renames, Del sends to the trash.
  3. Select a file and press Space to preview it without opening.
  4. Open a music file to play it once without adding it to the library. Add to Music puts it in the library; you can also drag it onto the Music window.
  5. Wallpaper: right-click a picture (JPEG, PNG, BMP) › 「Set as Wallpaper」, or drag it onto the 「My photo」 tile in Settings › Wallpaper, and it is copied and becomes the desktop picture. GIF, WebP, TIFF, AVIF and camera RAW work too. HEIC gets 「This format can't be a wallpaper yet」. Settings › Wallpaper.
  6. Archives (zip, 7z, rar, tar.gz, tar.xz, tar.zst, tar.bz2, and .gz/.xz/.zst/.bz2 files) unpack right next to themselves with a double click. One folder inside comes out as that folder; anything else goes into a new folder named after the archive. Right-click › 「Compress」 makes a zip; 「Compress As…」 lets you pick tar.gz, tar.xz, tar.zst or tar.bz2. Big ones show a progress bar with 「Cancel」 at the bottom of the window.

Try it yourself

Try it: make a folder, rename it, send it to the trash with Del, then restore it from the trash.

Import from the cloud

Picture it like this: your drawer is at home and the cloud is a storeroom in another house. You leave the key once (in the Vault) and fetch one thing at a time. Nothing in the storeroom changes — this only brings things home.

What this app takes (cloud)

What it takes: it asks the WebDAV server address you typed (for example https://cloud.example.com/…) for the folder list and the files you choose. What it does not take: it never changes or deletes anything on your server and looks at nothing outside it. Where to: the one server you typed (no other server). For how long: only while you connect or open. How to stop: remove it from the sidebar (delete the Vault entry in the Vault app).

How it works

Technical details

Tags and recent items are lists the app keeps. “Delete now” cannot be undone, so a confirmation card comes first.

Previews are made by a program that runs on its own

Selecting a file is enough to show its preview, and it may be a file you never opened. So Quick Look's words of .docx, .xlsx and .hwpx files and the small pictures of photos are made by a small program (oodoc) outside the system. If a damaged file makes that program stop, the file shows its icon without words or picture, and Files and your other apps stay as they were. Search's (Spotlight's) photo preview works the same way.

How archives are unpacked

An archive is like a box with things packed tightly inside. Unpacking reads the box's list and takes things out into a new folder, always keeping a few rules:

Try it: pick a folder, 「Compress As…」 › tar.xz, then double-click the new file and see it come out as "name 2".

Technical details

Unpacking and packing are done by a separate program, arc (in the Terminal: tar, zip, unzip, 7z, unrar, gzip, xz, zstd, bzip2), not by the Files app. Reading is libarchive 3.8.11; compression is zlib, liblzma (xz), zstd and libbz2. The program runs with permission to make new names only, so whatever an archive says, it cannot change a file that exists. Names are shortened to this system's 31 bytes per name (~), Hangul written in separate letters by Mac tools is joined, and the Mac's __MACOSX folder is left out. Contract: docs/contracts/ARCHIVE.md.

FAQ

Can I keep long names and big videos?

Yes. A name can be up to 255 bytes (about 85 Hangul syllables) and one file up to 64 GB; they come in and go out unchanged. Think of the notebook's columns getting wider. The first time a long name or a file over 256 MB is saved, the storage area switches to the new layout; from then on an older NanumOS version leaves this storage area alone (it does not open or erase it). The Mac app keeps a copy of the storage area (home-before-<version>.raw) before a new version first opens it. Once the long names and big files are gone, the next save is in the old layout again.

The archive has a password

zip (the old way and AES-256 alike) asks for the password when you unpack it. Password-protected 7z and RAR files are reported as not supported.

It stopped, saying "possible zip bomb"

A file that unpacks to more than a thousand times its size may be trying to fill the computer up, so it stops. If it came from somewhere you trust, press 「Extract Anyway」.

Why can't I make RAR or 7z files?

7z and RAR are unpack-only. The program that makes RAR files is commercial, and the RAR maker's own unpacking code (unrar) is not used because of its licence terms. Unpacking uses libarchive's RAR reader, written separately under a free (BSD) licence. To make an archive, choose zip (opens everywhere) or tar.xz (smallest).

How do I get a deleted file back

Files sent to the trash can be restored from there. Ones removed with “Delete now” or after emptying the trash cannot.

How do I find a file by name

Type the name in the search box at the top; results narrow as you type.

How do I open my NAS or a Windows shared folder

Press Ctrl+K, type smb:// and the server's name (for example smb://nas), then your user name and password on that server, and choose one of its shared folders. It stays in the sidebar under "Network".

Try this

1. Open a folder

  1. Pick an item with the arrow keys. A folder opens with nothing selected.

Open a folder 1

  1. Enter opens it; Backspace or the top row "Enclosing folder" goes back up.

Open a folder 2

2. Make a new folder

  1. Press Ctrl+N and type a name.

Make a new folder 1

  1. Enter makes it.

Make a new folder 2

3. Find by name

  1. Click the search field at the top.

Find by name 1

  1. The results narrow as you type.

Find by name 2

4. Quick Look and views

  1. Select a file and press Space: a preview over the window (pictures, text and Markdown, the words of .docx, .xlsx and .hwpx, sound played in the background, a video's facts, a folder's item count; a PDF opens on its first page in the PDF app). The arrows show the next file; Space or Esc closes it.

Quick Look and views 1

  1. Ctrl+1 list · Ctrl+2 icons · Ctrl+3 columns (← up, → in) · Ctrl+4 gallery. In the list, View › "Group by Kind" or "Group by Date"; click a column name to sort by it.

Quick Look and views 2

5. Get Info and tags

  1. Ctrl+I shows kind, size (a folder: everything in it), where and when it was modified.

Get Info and tags 1

  1. Click a colour dot (or a colour in the right-click menu) to tag and untag. A colour under "Tags" in the sidebar gathers its items, "Recents" the files any app opened lately. Drag a folder onto the "Favorites" heading to add it; right-click › "Remove from Sidebar" takes it out.

Get Info and tags 2

Shortcuts

KeyWhat it does
Shift+Ctrl+NNew Folder
F4New File
Ctrl+FFind
SpaceQuick Look
Ctrl+IGet Info
Ctrl+OOpen
F2Rename…
Ctrl+DDuplicate
DelMove to Trash
Shift+DelDelete Immediately…
Shift+Ctrl+DelEmpty Trash…
Ctrl+1as List
Ctrl+2as Icons
Ctrl+3as Columns
Ctrl+4as Gallery
Shift+Ctrl+TAdd to Sidebar
Shift+Ctrl+FRecents
Shift+Ctrl+Izcloud
Ctrl+KConnect to Server…
Ctrl+WClose Window
Ctrl+ZUndo
Ctrl+XCut
Ctrl+CCopy
Ctrl+VPaste
Ctrl+ASelect All

Settings

Settings › Apps › Files:

Shortcuts (.zlink files, such as the ones in the NanumOS Introduction folder on the desktop) show their name in the system language and their own icon; a double click opens the app, screen or file they point to. See What's New.

On a phone (NanumOS Mobile) one tap opens an item. To rename or delete it, hold your finger on it for a moment to select it, then use the buttons at the bottom.

In sidebar Trash, the title and breadcrumb say “Trash”; use Empty Trash at the top right, then its confirmation card, to remove everything.

The bottom line shows, next to the item count, "Storage 10% used, 25 MB free" — how full the space that survives turning the computer off is. Over 90 % a notice appears. What to do now: if it is nearly full, delete or move big files.

Network — see the devices on the same network

Open the sidebar "Network" › "Nearby devices" and the devices on the same Wi-Fi or wired network are listed. Each line shows a name, an address and what the device offers (file sharing, SSH, printing, screen casting), with a picture by kind (computer, phone, printer, TV, speaker, NAS, NanumOS). A separate "My devices (Wire)" group lists the devices on your own Wire network.

How it works: devices announce themselves with the standard way ("I am a printer", "I share files": mDNS and DNS-SD, the same idea as Bonjour on a Mac), and this listens. It also adds the addresses that show up in the address checks (ARP) already passing on the network. It never connects to another device and never knocks on ports; it keeps only names and kinds, sends and stores them nowhere, and the list is gone when the window closes.

Connect to a server — a NAS or a Windows shared folder

A shared folder on a NAS or another computer opens in Files like any folder: you browse it, open files with their apps, copy files in and out and save into it.

  1. Press Ctrl+K (Go › Connect to Server…).
  2. Type the server's address, for example smb://nas — after you sign in its shared folders are listed and you choose one — or the folder directly: smb://nas/photos. Press Connect.
  3. Choose Registered User and type your user name and password on that server — or Guest for a folder anyone may open.
  4. The folder opens. The server stays in the sidebar under "Network"; the next time one click opens it.

How it works: NanumOS speaks SMB, the language Windows, Macs and NAS boxes use for shared folders — only its current, safe versions (SMB 3). Every answer from the server carries a signature made with a key only you and the server know, so nobody on the way can change it; when the server asks (or you choose), everything is also encrypted. The old SMB1, which spread ransomware, is never used: a server that speaks only SMB1 is refused with an explanation.

Technical details

SMB 3.0, 3.0.2 and 3.1.1 (SHA-512 pre-authentication integrity; 3.0.x: validate negotiate), NTLMv2 sign-in inside SPNEGO, signing AES-128-GMAC (or AES-128-CMAC), encryption AES-128-GCM / AES-128-CCM, reads and writes up to 1 MiB. The share is a mount at /Net in the kernel (src/smb/), beside the Mac folders at /Mac. Port 445 unless the address says another (smb://nas:4450/photos). Check: /proc/smb (counts only) and the assistant's system check row 「네트워크 공유」. Details: docs/contracts/SMB.md.

What it cannot do

NanumOS 0.1.8349 · 2026-11-16