Nexa Dir

파일 목록과 보기

파일 목록이 이 앱의 심장입니다. 10만 항목도 첫 렌더 115ms·스크롤 60fps로 다루는 가상화 리스트 위에 보기 3종과 컬럼 시스템이 얹혀 있습니다.

• 보기 모드 3종 — 트리 · 플랫 · 타일 트리 보기(기본)는 별도 트리 패널 없이 목록 안 제자리에서 폴더를 펼치고, 플랫 보기는 계층 없는 일반 목록, 타일 보기는 아이콘 32px 그리드입니다. 보기 모드는 탭별 상태로 세션에 저장되고 새 탭은 현재 모드를 물려받습니다.
• 가상화 리스트 가시 영역의 행만 커스텀 드로잉합니다. 10만 행 첫 렌더 115ms, 스크롤 2.1ms/프레임. 프레임 비용이 창 높이에만 비례하므로 항목이 아무리 많아져도 스크롤이 느려지지 않습니다.
• 5컬럼 시스템 기본 컬럼은 이름 · 확장자 · 크기 · 수정한 날짜 · 종류입니다. 가상 "내 PC" 루트에서는 전체 크기·사용 가능한 공간 컬럼이 자동으로 붙습니다. 말줄임 트리밍·가로 스크롤·타임존 반영 날짜를 지원합니다.
• 컬럼 리사이즈 · 재배열 · auto-fit 헤더 경계를 끌면 해당 컬럼만 넓어지거나 좁아지고 이웃 컬럼은 그대로입니다(탐색기 규약 — 전체 폭이 화면을 넘으면 가로 스크롤). 헤더를 잡아 끌면 고스트 헤더와 삽입 미리보기가 따라오고 Esc로 취소합니다. 경계를 더블클릭하면 내용 너비에 맞춰집니다.
• 다중열 정렬 헤더 클릭은 오름차순 → 내림차순 → 해제 3상태 순환이고, Shift+클릭으로 열을 겹쳐 정렬합니다. 화살표(▲▼)는 앞에, 순번(①②)은 뒤에 상시 표시됩니다. 폴더 우선 정렬과 대소문자 구분 정렬을 따로 켤 수 있습니다.
• 인라인 펼침 — 폴더 교차 다중 선택의 토대 ▸/▾ 마커 클릭이나 캐럿에서 →/←로 폴더를 제자리에서 펼치고 접습니다. 삼각형 마커(=펼침)와 행 본문(=선택)이 분리되어 있어 서로 다른 폴더의 항목을 동시에 고를 수 있습니다. 펼침 상태는 탭별로 세션에 남습니다.
• 빈 폴더 펼침 글리프 억제 (v0.17.0) 현재 보기(숨김·점 파일 필터) 기준으로 보여줄 내용이 없는 폴더에는 ▸를 그리지 않습니다 — 펼쳐 봐야 비어 있는 폴더를 미리 구분할 수 있습니다. 설정 파일 목록 → 빈 폴더의 펼침 글리프 숨김(기본 켬)으로 끌 수 있고, 판정 비용 때문에 네트워크(UNC·원격) 폴더는 항상 마커를 유지합니다.
• 컬럼 너비 동기화 듀얼 패널의 좌/우 컬럼 폭을 실시간으로 맞춥니다(기본 켬·영속). 끄면 패널별로 독립하고, 다시 켜면 포커스한 패널을 기준으로 정렬됩니다. 탭은 패널 폭을 상속합니다.

탐색 · 이동

경로를 짚는 방법이 여럿이라 그때그때 손이 가는 대로 고르면 됩니다.

• 경로 바 — 브레드크럼 ↔ 편집 세그먼트를 클릭하면 그 폴더로 이동하고, 우클릭하면 텍스트 편집 모드로 바뀝니다. 입력에 따라 자동완성 드롭다운이 뜨고 ↑/↓로 고릅니다. Enter 제출 · Esc 취소이며 한글 IME 조합 창 캐럿 위치까지 맞춥니다.
• shell: 스킴 입력 shell:common startup처럼 특수 폴더 경로를 경로 바에 그대로 입력할 수 있습니다. KnownFolders와 GUID가 자동으로 커버되므로 시작프로그램 폴더 같은 곳도 한 줄로 엽니다.
• 뒤로 · 앞으로 · 위로 · 히스토리 Alt+←/Alt+→/Alt+↑, 마우스 X1·X2 버튼, 패널별 내비 버튼(활성·비활성 흐림 표시)을 모두 지원합니다. 히스토리는 탭마다 독립이고, 새 이동을 넣으면 앞으로 스택이 잘립니다.
• 가상 "내 PC" 루트 드라이브 루트에서 Alt+↑를 누르면 드라이브 목록으로 올라갑니다. 타일 보기에서는 용량 바가, 상세 보기에서는 전체/사용 가능 용량 컬럼이 보이며, 연결된 클라우드도 여기에 함께 표시됩니다.
• 타입어헤드 검색 목록에 포커스한 채 글자를 치면 그 항목으로 바로 점프하고, 같은 접두사를 반복 입력하면 순환합니다. 화면에 HUD 배지가 뜹니다. 검색 범위(전체·현재 계층·가시 스트림)·입력 리셋 시간(200~10000ms)·배지 위치를 설정에서 고릅니다.
• 위로 이동 시 선택 위치 Alt+↑로 상위 폴더에 올라갔을 때, 방금 떠나온 폴더를 뷰의 상단·중단·하단 중 어디에 둘지 정할 수 있습니다. 깊은 트리를 오르내릴 때 시선이 튀지 않습니다.

패널 · 탭 · 세션

• 싱글 / 듀얼 파일 패널 커맨더 규약의 좌우 2패널로 한쪽에서 다른 쪽으로 곧장 복사·이동합니다. 싱글로 접어도 우 패널의 탭과 위치는 보존되어 듀얼로 돌아오면 그대로 복원됩니다.
• 패널별 독립 탭 각 패널에 자기 탭 바가 있고 탭마다 뷰와 히스토리가 독립입니다. Ctrl+T 새 탭 · Ctrl+W 닫기 · Ctrl+Tab 다음 탭 · Tab 패널 전환. 탭 바 빈 공간을 더블클릭해도 새 탭이 열립니다.
• 패널 간 탭 드래그 (v0.14.0) 탭을 반대 패널의 탭 바로 끌어 옮길 수 있습니다. 끌고 가는 동안 놓일 자리가 실제 위치로 미리 보이고, Esc를 누르면 원래 패널·원래 자리로 되돌아갑니다.
• 탭 잠금 · 고정 · 복제 탭 우클릭 메뉴에서 실수 방지용 잠금(닫기에서 제외), 고정(📌), 같은 위치의 새 탭 복제를 고릅니다. 탭을 더블클릭했을 때 무엇을 할지(닫기·고정·잠금)는 설정에서 정합니다.
• 세션 복원 앱을 다시 켜면 패널별 탭 목록·활성 탭·펼침 상태·정렬 모드·컬럼 표시와 폭·활성 패널이 그대로 돌아옵니다. 변경은 1초 디바운스로 묶여 exe 옆 data\session.cfg에 저장됩니다.

파일 조작

복사·이동부터 되돌리기까지 하나의 전송 엔진과 하나의 실행 취소 스택으로 이어집니다.

• 폴더 교차 다중 선택 (★ 플래그십) 트리를 펼친 상태에서 서로 다른 부모 폴더의 항목을 동시에 선택합니다. Ctrl+클릭 토글 · Shift+클릭 범위 · Ctrl+A 전체 · 빈 영역 드래그 러버밴드를 지원합니다.
• 복사 · 이동 (전송 엔진) 단일 전송 경로로 처리합니다 — 4MB 청크 진행률, 같은 볼륨 fast path, 순환(자기·하위) 드롭 금지, 같은 폴더 복사는 " (2)" 순번. 충돌은 항목별로 덮어쓰기 / 모두 덮어쓰기 / 건너뛰기 / 취소를 묻고, 고른 선택은 남은 충돌 전체에 적용됩니다.
• 붙여넣기 대상 규칙 Ctrl+V는 폴더를 하나 고른 상태면 그 폴더 안으로, 파일을 하나 고른 상태면 그 파일이 있는 폴더로 붙여넣습니다. 트리로 펼친 하위 폴더의 파일을 골랐다면 보이는 최상위가 아니라 그 파일이 실제로 있는 폴더입니다. 선택이 없거나 여럿이면 현재 폴더입니다.
• 잘라내기 표시 Ctrl+X한 항목은 목록에서 흐리게 보입니다. 탐색기에서 잘라낸 파일도 똑같이 흐려지고, 복사·붙여넣기 등으로 클립보드가 바뀌면 자동으로 풀립니다(OS 클립보드 단일 출처).
• 가상 파일 붙여넣기 (v0.17.0) 실제 경로가 없는 소스를 붙여넣습니다 — 원격 데스크톱(RDP)으로 복사한 파일 · Outlook 첨부 · 탐색기 zip 폴더 안 항목 · 폰(MTP) 파일. 대용량도 백그라운드로 전송되어 창이 멈추지 않고 진행 창에서 취소할 수 있으며, 붙여넣은 결과는 Ctrl+Z로 되돌아갑니다. 드래그로 놓아도 되고, 클라우드 탭에 붙여넣으면 임시 폴더를 거쳐 자동 업로드됩니다.
• 드래그앤드롭 (OLE) 수신은 Ctrl=복사 / Shift=이동 / 기본은 볼륨별 규칙입니다. 드래그 중 목록 위·아래 가장자리에 커서를 대면 자동 스크롤되고, 다른 탭 위에 3초(조절 가능) 머물면 그 탭이 활성화되며, 접힌 폴더 이름 위에 머물면 그 폴더가 펼쳐집니다.
• Undo / Redo 이동·복사·이름 변경·새로 만들기와 휴지통 삭제까지 되돌립니다(스택 2개·상한 100). 일괄 이름 변경도 배치 전체가 한 번에 되돌아갑니다. Ctrl+Z / Ctrl+Y. 완전 삭제만은 되돌릴 수 없습니다(설계).
• 삭제 · 이름 변경 · 새로 만들기 Del은 휴지통, Shift+Del은 완전 삭제(확인창 기본값이 취소)입니다. F2로 인라인 오버레이 이름 편집, Ctrl+Shift+N으로 새 폴더 — 만들자마자 이름 편집 상태로 들어갑니다.

폴더 자동 반영

"가끔 F5를 눌러야 한다"를 없애기 위해 갱신 계기를 이벤트 2종 + 보험 1종으로 나눴습니다. 반영은 무간섭 재열람이라 펼침·선택·캐럿·스크롤 위치가 그대로 보존됩니다.

• 폴더 변경 통지 (OS) 파일 조작이 즉시 반영됩니다(300ms 동안 모아 1회). 변경이 쏟아져도 최대 1초 안에 한 번은 반영되도록 상한을 두었고, 현재 폴더뿐 아니라 화면에 보이는 하위 폴더까지 감시합니다.
• 셸 변경 통지 (v0.17.0) OneDrive·SharePoint가 클라우드 변경을 로컬에 내려놓는 순간을 탐색기와 같은 채널로 받습니다. 이 경우 OS 파일 통지가 오지 않는다는 것이 실측으로 확인된 사실이라 별도 채널이 필요했습니다 — 앱이 비활성이어도 즉시 반영됩니다.
• 변경 프로브 (보험) 통지가 오지 않는 예외 경로(일부 네트워크·도구)를 위해 활성 3초·비활성 30초마다 폴더 상태를 싸게 확인합니다. 최소화 중에만 완전히 멈춰 유휴 배터리 규율을 지킵니다. 변경이 없으면 재로드도 없습니다.
• 탭 · 창 활성화 = 갱신 (v0.17.0) 비활성 탭이나 다른 앱에 가 있던 동안 생긴 변경은 그 탭·창이 다시 보이는 순간 재열람으로 해소됩니다. 밖에서 저장하고 돌아왔을 때 낡은 목록을 보는 일이 없습니다.
• 알려진 한계 항목이 4,096개를 넘는 폴더는 프로브가 생성·삭제만 감지하고, 클라우드 직접 연결 탭은 네트워크 호출 비용 때문에 프로브 대상이 아닙니다(탐색하거나 F5). 클라우드 변경이 로컬로 내려오는 시점 자체는 동기화 클라이언트 소관입니다. 언제든 F5로 수동 새로 고침할 수 있습니다.

클라우드

클라우드는 두 갈래입니다 — 이미 깔려 있는 동기화 폴더를 얹는 링크, 클라이언트 없이 브라우저 로그인만으로 붙는 직접 연결.

• 링크 (Link) — 네트워크 통신 0 PC에 설치된 동기화 클라이언트(OneDrive 개인·비즈니스, Google Drive, Dropbox)를 시작할 때 자동으로 찾아 "내 PC" 목록에 얹습니다. 네트워크 요청이 전혀 없이 로컬 폴더 그대로 다루므로 오프라인에서도 동작합니다.
• 직접 연결 (Connect) — 디스크를 쓰지 않음 동기화 클라이언트 없이 브라우저 로그인만으로 OneDrive·Google Drive·Dropbox를 탐색합니다. 디스크를 전혀 쓰지 않고, 같은 서비스에 계정을 여러 개 붙일 수 있습니다. Cloud 메뉴나 "내 PC" 우클릭에서 연결을 추가·해제합니다.
• 클라우드 파일 조작 · 계정 간 복사 탐색·다운로드·업로드(폴더 재귀)·삭제·이름 변경·새 폴더를 지원합니다. 같은 계정 안의 복사·이동은 내려받지 않고 서버에서 처리하고, Google Drive → OneDrive 같은 계정 간 복사도 됩니다. 전송 중에는 로컬 복사와 같은 진행 창(파일별 세그먼트·실제 바이트·취소)이 뜹니다.
• OAuth 2.0 + PKCE 로그인은 인가 코드 + PKCE로만 이뤄져 앱이 비밀번호를 보지도 저장하지도 않습니다. 리디렉션은 127.0.0.1 루프백을 1회 수신한 뒤 즉시 닫힙니다.
• 토큰 DPAPI 보관 갱신 토큰은 Windows DPAPI로 암호화해 data\secrets\에만 둡니다. 키가 이 사용자 + 이 PC에 묶이므로 포터블 폴더를 다른 PC로 옮기면 재로그인이 필요합니다 — USB를 잃어버려도 토큰이 새지 않게 하려는 의도된 안전장치입니다. 자세한 내용은 개인정보처리방침을 참고하세요.
• 내 Client ID로 쓰기 (고급) 동봉된 기본 Client ID는 전체 사용자가 함께 쓰므로 서비스별 한도가 있습니다(Google Drive 100명 · Dropbox 500명 · OneDrive 조직 계정은 동의 제한). data\settings.cfg에 자기 ID를 넣으면 한도에서 벗어나고, OAuth가 필요 없는 링크 방식을 써도 됩니다.
• 되돌리기는 클라우드에 적용되지 않습니다 Ctrl+Z는 로컬 조작 전용입니다. 클라우드에서 잘못 지운 항목은 각 서비스의 휴지통에서 복구하세요.

하단 도크 — 정보 · 미리보기 · 터미널

파일 목록 아래 전폭 밴드에서 정보·미리보기·터미널 세 가지를 갈아 끼웁니다. 도구 모음의 도크 버튼이나 보기 메뉴로 접고 폅니다.

• 정보 패널 선택 항목의 이름 · 종류 · 크기(원시 바이트) · 수정 날짜 · 경로를 보여 주고 선택이 바뀌면 자동 갱신됩니다. 듀얼(좌↔좌·우↔우 독립)과 싱글(전폭 공유·활성 패널 추종)을 오갑니다. 도크 텍스트는 드래그 선택 후 Ctrl+C로 복사됩니다.
• 미리보기 — 텍스트 · 이미지 텍스트는 첫 16KB를 UTF-8로 디코드해 최대 200줄, 이미지는 9종 확장자(png·jpg·bmp·gif·ico·tif·webp 등)를 WIC로 디코드해 비율 유지로 그립니다. F3 또는 ↗ 버튼으로 독립 창에서 크게 봅니다.
• 서식을 살린 복사 미리보기에서 드래그로 문자 단위 선택 후 Ctrl+C하면 평문과 모노 서식(RTF) 이 함께 복사됩니다. 표나 다이어그램을 Word 등에 붙여도 정렬이 흐트러지지 않습니다.
• WASM 미리보기 플러그인 확장자별 미리보기를 data\plugins\*.wasm으로 갈아 끼웁니다. wasmi 런타임에서 연료(fuel) 상한을 두고 격리 실행하므로 플러그인이 앱을 멈출 수 없고, 설정에서 항목별로 켜고 끕니다(해제하면 내장 미리보기로 대체). 마크다운 뷰어(GitHub 근사 렌더 + Mermaid 다이어그램)를 참조 구현으로 함께 제공합니다.
• 내장 ConPTY 터미널 별도 프로그램 없이 현재 위치에서 셸을 띄웁니다(pwsh → powershell → cmd 폴백). VT 파서(SGR 색·CSI) · 스크롤백 800줄 · 전각(2폭) 셀 · 마우스 드래그 선택 · 리사이즈 동기를 지원하고, 글꼴·크기·줄 바꿈·열 수를 설정에서 조절합니다.
• 레이아웃 · 스플리터 도크 높이는 경계를 끌어 조절하고(비율 0.15~0.5·양 패널 동기), 도크 안의 좌/우 분할은 파일 패널 비율과 별개의 스플리터입니다. 표시 여부·높이·분할이 모두 세션에 남습니다.

일괄 이름 변경

동작 카드를 파이프라인으로 쌓아 위에서 아래로 적용하고, 결과를 실시간으로 확인한 뒤 한 번에 반영합니다. Ctrl+Shift+R로 엽니다.

• 동작 6종 파이프라인 치환(텍스트) · 치환(정규식) · 대소문자 변경(유지·대문자·소문자·단어별·문장형) · 텍스트 삽입(접두·접미) · 연번 붙이기(시작·증가·자릿수·위치) · 날짜 삽입(수정한/만든 날짜 · ${YYYY}-${MM}-${DD} 토큰). 카드를 +/−로 더하고 빼며 순서대로 적용합니다.
• 적용 대상 (스코프) 동작마다 이름의 어느 부분에 적용할지 따로 고릅니다 — 이름 / 이름+확장자 / 확장자 / 확장자(점 포함).
• 실시간 미리보기 · 충돌 표시 우측 그리드에 이전 → 이후가 즉시 나타나고 {N}개 항목이 변경됩니다 건수가 붙습니다. 빈 이름·금지 문자·중복·이미 존재를 충돌로 표시하며, [이름 변경] 버튼은 충돌이 0이고 변경이 1건 이상일 때만 활성화됩니다. 행별 제외 토글도 됩니다.
• 프리셋 · 한 번에 되돌리기 자주 쓰는 파이프라인을 이름 붙여 data\renames\에 저장하고 다시 불러옵니다. 적용은 하나의 트랜잭션이라 Ctrl+Z 한 번으로 배치 전체가 되돌아갑니다.

도구 모음 · 메뉴 · 커스터마이즈

• 도구 모음 새로 고침 · panel 그룹(파일 패널 토글 · 하단 도크 · 정보 패널 · 컬럼 너비 동기화 · 항상 맨 위에 표시) · view 그룹(트리 · 플랫 · 타일) · show 그룹(숨김 파일 · 점 파일 · 폴더 우선 정렬) · 설정. 자체 SVG 서브셋 파서로 그린 3상태 아이콘과 현재 언어 툴팁이 붙습니다.
• 항상 맨 위에 표시 (v0.17.0) 도구 모음의 압정 버튼 또는 보기 메뉴 → 항상 맨 위에 표시로 창을 다른 앱 위에 고정합니다. 두 곳의 체크 상태가 서로 동기되고 재시작 후에도 유지됩니다.
• 바 크기 (v0.16.0) 도구 모음은 28px 버튼 · 아이콘 20×20, 그 아래 퀵 런처 바는 24px 버튼 · 아이콘 16×16으로 두 바의 높이가 서로 독립입니다. 고DPI 화면에서는 배율에 맞춰 함께 커지며 래스터 버킷과 정확히 맞아 늘림 없이 선명합니다.
• 순서 / 표시 편집 — 공통 편집 창 도구 모음 · 파일 컬럼 · 컨텍스트 메뉴 세 가지를 같은 편집 창에서 다룹니다. 체크박스로 표시 여부(그룹을 끄면 하위가 통째로 숨음), 셰브론으로 그룹 펼침, 위/아래 버튼이나 드래그(고스트 박스 · 삽입 미리보기 · 가장자리 자동 스크롤 · Esc 취소)로 순서를 바꿉니다.
• 셸 컨텍스트 메뉴 통합 우클릭하면 Windows 셸 메뉴가 그대로 뜹니다(7-Zip · Git · 보내기 · 속성 등 셸 확장 포함). 여기에 완전 삭제 · 폴더에 붙여넣기 · 실행 취소/다시 실행 · 경로 복사 · 이름 복사 같은 앱 고유 항목이 병합되고, delete·rename·paste 동사는 앱이 가로채 되돌리기·인라인 편집·전송 엔진에 합류시킵니다.
• 퀵 런처 바 자주 쓰는 외부 프로그램을 도구 모음 아래 버튼으로 둡니다. 누르면 %path%가 활성 패널의 현재 폴더로 치환되어 실행됩니다(작업 디렉터리 동반). 항목은 data\settings.cfg의 launcherN=라벨|exe|인자로 정의하며 VS Code · pwsh · cmd가 기본 시드됩니다.

설정 · 테마 · 언어

• 설정 창 — 검색 + 즉시 적용 VS Code식 사이드바 카테고리에 검색 상자가 붙습니다. 다중 토큰 AND로 라벨·설명을 걸러 {N}개 일치를 보여 줍니다. 대부분의 옵션은 바꾸는 즉시 적용·저장되어(저장 버튼 없음) 비정상 종료로 설정을 잃을 일이 없습니다. Ctrl+,로 엽니다.
• 테마 — 시스템 · 라이트 · 다크 시스템 테마는 OS 설정을 실시간 추종하고(레지스트리 변경 감지) DWM 다크 타이틀바까지 맞춥니다. 보기 메뉴 라디오 또는 F6 순환으로 바꾸며 영속됩니다.
• 언어 3종 내장 · 동적 전환 한국어 · 영어 · 일본어를 내장하고 exe 옆 data\lang\에 키 단위로 덮어쓸 수 있습니다. 시스템을 고르면 OS 언어를 따릅니다. 재시작 없이 바뀝니다(테이블 스왑 + 메뉴·컬럼 재구성 + 재그리기).
• 글꼴 슬롯 용도별로 글꼴을 따로 지정합니다 — 기본(메뉴·탭·경로·도크) / 파일 목록(+헤더 공유·폴더 굵게·헤더 굵게·이탤릭) / 콘솔(터미널) / 상태바 / 우클릭 메뉴 / 대화상자. 드롭다운이 설치된 글꼴을 각자의 서체로 렌더해 고르기 쉽습니다.
• 저장 위치 — exe 옆 data 폴더뿐 모든 설정이 실행 파일 옆 data\ 폴더에만 생깁니다(레지스트리 · %APPDATA% 비의존) — settings.cfg · session.cfg · lang\ · renames\ · secrets\. 제거는 파일 삭제만으로 끝나고, 쓰기 불가한 위치면 %LOCALAPPDATA%\NexaDir\data로 자동 폴백합니다.

성능 예산 · 배포

"예산이 정체성"이라 숫자를 마일스톤마다 실측해 병합 게이트로 씁니다. 예산을 넘긴 상태로는 병합하지 않습니다.

• 실측 (v0.17.0) 단일 exe 약 3.71MB(예산 10MB) · 유휴 RSS 16.86MB(예산 30MB) · 임포트는 OS 인박스 21종뿐(외부 DLL 0) · 10만 항목 첫 렌더 115ms · 스크롤 2.1ms/프레임.
• 검증 게이트 워크스페이스 테스트 194건 green(앱 116 · GUI 78) · clippy 경고 0(-D warnings) · 비Windows 교차 컴파일 확인 · exe 크기와 임포트 목록 실측을 릴리스마다 통과시킵니다.
• 포터블 · 설치형 2채널 포터블은 NexaDir-<버전>-win-x64.exe 하나만 받아 원하는 폴더나 USB에 두고 실행합니다. 설치형 NexaDir-Setup-<버전>.exe는 시작 메뉴·제거 목록을 등록하며 제거해도 data\를 보존합니다. 릴리스 자산에는 zip 2종과 SHA256SUMS.txt가 함께 올라옵니다.
• 라이선스 PolyForm Noncommercial 1.0.0 — 개인·비상업 사용은 무료입니다. 상업 사용은 별도 유료 라이선스가 필요합니다(문의 [email protected]). 자세한 조건은 서비스 약관을 참고하세요.