Nexa Clip 사용 설명서

개요

Nexa Clip은 복사한 것을 모두 기억해 두었다가 단축키 한 번으로 다시 꺼내 붙여넣는 클립보드 매니저입니다. Windows · macOS · Linux에서 똑같이 생긴 화면으로 동작합니다. 전부 Rust로 만든 실행 파일 하나이고, Qt·WebView·Electron 없이 화면의 모든 픽셀을 직접 그립니다.

• 이력은 내 PC에 암호화되어 저장됩니다(기본 켜짐). 텍스트·서식(HTML/RTF)·이미지·파일 경로·Office 원본 형식을 잡습니다.
• 퀵 팝업: Shift+Alt+C를 누르면 마우스 위치에 팝업이 뜨고, 검색어를 친 뒤 Enter를 누르면 원래 쓰던 앱에 바로 붙여넣어집니다.
• 메인창: 이력을 정리·검색·고정·삭제하고 미리보기로 내용을 확인합니다.
• 동기화는 선택입니다. 켜면 아이디와 페어링 암호가 같은 내 기기끼리, 6자리 대조 코드를 눈으로 확인해 승인한 기기와만 종단 간 암호화(Noise)로 클립보드를 주고받습니다. 같은 네트워크에서는 서버 없이도 연결되고, 다른 네트워크의 기기와는 릴레이 서버를 거칩니다(서버는 내용을 볼 수 없습니다).
• 파일도 오갑니다(v0.1.4부터). 다른 기기에서 복사한 파일을 붙여넣으면, 그 순간 원본 기기에서 내용을 받아 와 진짜 파일로 붙여넣습니다.

참고: 이 설명서는 v0.2.6(2026-11-06 공개) 기준입니다. 화면 예시 그림 일부는 이전 버전(v0.1.x)에서 찍은 것이라 세부 모양이 다를 수 있습니다. 특히 설정 창은 v0.2.0에서 카드형으로 바뀌었습니다.

라이선스는 PolyForm Noncommercial 1.0.0입니다. 개인·비상업적 사용은 무료이며, 상업적 사용에는 별도 라이선스가 필요합니다. 자세한 조건은 서비스 약관을 참고하세요. 앱 소개는 Nexa Clip 소개 페이지에 있습니다.

시스템 요구사항

• Linux는 현재 x86_64 자산만 제공합니다(ARM Linux 자산 없음).
• Linux .deb의 필수 의존은 libc6 (>= 2.17)뿐이며, libx11-6·libxkbcommon0·libwayland-client0을 권장 패키지로 둡니다.
• 설치하면 실행 파일이 두 개 들어갑니다. nexa-clip(본체)와 nclip-imgdec(이미지를 격리된 별도 프로세스에서 해석하는 보조 프로그램)입니다. nclip-imgdec를 지우면 이미지 섬네일과 이미지 전송 변환이 빠집니다.

설치와 제거

모든 배포 파일은 GitHub Releases에 있고, 릴리스마다 SHA256SUMS.txt가 함께 올라옵니다. 배포본에는 정식 코드 서명이 없으므로(macOS는 애드혹 서명) 받은 파일을 SHA256SUMS.txt로 먼저 확인하는 것을 권장합니다.

어떤 파일을 받나

패키지 관리자 현황 (2026-11-07 기준)

참고: winget과 Chocolatey 설치본은 검수를 통과해야 위 명령이 동작합니다. 통과 전에는 Windows 설치본을 GitHub Releases에서 직접 받으세요. 직전 제출이 검수 중이면 새 버전은 제출을 건너뛰므로, 검수를 통과한 뒤에도 한동안 최신 버전보다 낮은 버전이 설치될 수 있습니다.

Windows

설치본(권장)

1. GitHub Releases에서 nexa-clip-<버전>-windows-x64-setup.exe(ARM64 PC는 windows-arm64)를 받습니다. 브라우저가 .exe 다운로드를 막으면 같은 파일을 묶은 -setup.exe.zip을 받아 푸세요.
2. 실행합니다. 사용자 단위 설치라 관리자 권한이 필요 없고 UAC 창이 뜨지 않습니다. 설치 위치는 %LOCALAPPDATA%\Programs\NexaClip입니다.
3. SmartScreen이 “알 수 없는 게시자” 경고를 띄우면 추가 정보 → 실행을 누릅니다(코드 서명 인증서가 아직 없습니다).
4. 설치가 끝나면 Nexa Clip이 트레이에 상주합니다. 시작 메뉴에도 바로가기가 생깁니다.

포터블

1. nexa-clip-<버전>-windows-x64-portable.zip을 원하는 폴더에 풉니다.
2. nexa-clip.exe를 실행합니다. 설정·이력·동기화 신원은 실행 파일 옆 data\ 폴더에 생기므로 폴더째 옮기면 그대로 따라옵니다.
3. 같은 폴더의 nclip-imgdec.exe는 지우지 마세요.

Chocolatey 포터블

choco install nexa-clip-portable

받은 파일 확인

Get-FileHash .\nexa-clip-0.2.6-windows-x64-setup.exe -Algorithm SHA256

출력된 값이 SHA256SUMS.txt의 같은 파일 줄과 같은지 확인합니다.

업그레이드: 새 setup.exe를 그대로 실행하면 덮어씁니다. 실행 중이면 트레이 메뉴 → 종료로 먼저 끄세요. 설정·이력·기기 목록·승인 상태는 남습니다.

macOS

Homebrew Cask(권장)

brew install --cask kiros33/tap/nexa-clip

Cask는 설치 시점에 격리 표식을 떼어 주므로 경고 없이 바로 실행됩니다. 또 설치할 때 낡은 손쉬운 사용 권한 항목을 정리해 두어, 첫 실행의 권한 대화상자에서 켜기만 하면 됩니다. 업그레이드는 다음과 같습니다.

brew upgrade --cask kiros33/tap/nexa-clip

포터블(Homebrew Formula)

brew install kiros33/tap/nexa-clip-portable

.dmg로 직접 설치

1. Apple Silicon은 macos-arm64.dmg, Intel은 macos-x64.dmg를 받습니다.
2. .dmg를 열고 Nexa Clip.app을 응용 프로그램 폴더로 끌어 놓습니다.
3. 처음 실행할 때 Gatekeeper가 막으면 터미널에서 격리 표식을 뗍니다.

xattr -dr com.apple.quarantine "/Applications/Nexa Clip.app"

Linux

APT 저장소(Debian·Ubuntu · 권장)

SosomLab의 서명된 패키지 저장소 pkg.sosomlab.com을 한 번 등록하면 apt upgrade로 자동 갱신됩니다.

저장소 등록 (최초 1회) — 다른 SosomLab 앱으로 이미 등록했다면 건너뜁니다.

sudo curl -fsSLo /usr/share/keyrings/sosomlab-archive-keyring.gpg https://pkg.sosomlab.com/sosomlab-archive-keyring.gpg
sudo curl -fsSLo /etc/apt/sources.list.d/sosomlab.sources https://pkg.sosomlab.com/apt/sosomlab.sources

설치

sudo apt update && sudo apt install nexa-clip

DNF 저장소(Fedora · RHEL · Rocky · AlmaLinux)

저장소 등록 (최초 1회) — 다른 SosomLab 앱으로 이미 등록했다면 건너뜁니다.

sudo curl -fsSLo /etc/yum.repos.d/sosomlab.repo https://pkg.sosomlab.com/rpm/sosomlab.repo

설치

sudo dnf install nexa-clip

처음 설치할 때 dnf가 서명 키 가져오기를 물으면 지문이 2522614046FAEE116F4A2FD706236F6AA8EB8FD6인지 확인하고 승인합니다. 갱신은 sudo dnf upgrade입니다.

.deb / .rpm 직접 설치

sudo dpkg -i nexa-clip-0.2.6-linux-x64.deb

.deb·.rpm 설치본은 /usr/bin/nexa-clip과 앱 메뉴 아이콘을 등록합니다. 업그레이드는 새 파일로 같은 명령을 다시 실행합니다.

포터블

tar xzf nexa-clip-0.2.6-linux-x64-portable.tar.gz
./nexa-clip

Linuxbrew를 쓴다면 brew install kiros33/tap/nexa-clip-portable도 됩니다.

주의: 설치본은 앱 메뉴의 Nexa Clip 아이콘으로 실행하세요. GNOME에서는 다른 앱(예: VS Code)의 통합 터미널에서 띄우면 전역 단축키가 그 앱 이름으로 등록되어 꼬일 수 있습니다(문제 해결 참고).

처음 한 번 묻는 권한

전역 단축키는 macOS에서 별도 권한 없이 동작합니다.

설치 위치와 데이터 위치

• 실행 파일 옆 폴더에 쓸 수 없거나 업그레이드 때 통째로 교체되는 자리(macOS 앱 번들, Homebrew 설치 폴더)면 사용자 설정 폴더를 씁니다.
• 데이터 폴더에는 설정·암호화된 이력·동기화 신원 키·기기 목록·승인 상태가 있고, 업그레이드해도 남습니다.
• 다른 기기에서 받은 파일은 따로 다운로드 폴더 아래 Nexa Clip 폴더에 저장됩니다(설정으로 변경 가능 · 파일 주고받기 참고).

제거

주의: 제거 전에 설정 → 일반의 로그인 시 자동 시작을 먼저 끄세요. 자동 시작 등록은 앱이 사용자 계정에 만든 것이라, 프로그램 파일만 지우면 등록이 남을 수 있습니다.

Windows 설치본

1. 트레이 메뉴 → 종료로 앱을 끕니다.
2. 설정 → 앱 → 설치된 앱에서 Nexa Clip을 제거합니다(또는 설치 폴더의 uninstall.exe).
3. 제거 프로그램은 설치한 파일만 지웁니다. 이력까지 지우려면 %LOCALAPPDATA%\Programs\NexaClip\data 폴더를 직접 삭제하세요.

Windows 포터블: 앱을 종료하고 폴더를 통째로 지웁니다. Chocolatey로 설치했다면 choco uninstall nexa-clip-portable.

macOS

brew uninstall --cask kiros33/tap/nexa-clip          # 앱만 제거
brew uninstall --zap --cask kiros33/tap/nexa-clip    # 데이터 폴더까지 제거

직접 설치했다면 Nexa Clip.app을 휴지통으로 옮기고, 데이터까지 지우려면 ~/Library/Application Support/nexa-clip을 삭제합니다.

Linux

sudo apt remove nexa-clip      # APT로 설치한 경우
sudo dnf remove nexa-clip      # DNF로 설치한 경우
sudo dpkg -r nexa-clip         # .deb를 직접 설치한 경우

저장소 등록까지 지우려면 다음을 실행합니다.

sudo rm /etc/apt/sources.list.d/sosomlab.sources /usr/share/keyrings/sosomlab-archive-keyring.gpg   # APT
sudo rm /etc/yum.repos.d/sosomlab.repo                                                               # DNF

데이터까지 지우려면 ~/.config/nexa-clip을 삭제합니다. 다른 기기에서 받은 파일은 다운로드 폴더 아래 Nexa Clip에 남아 있습니다.

시작하기

실행

• 앱을 실행하면 트레이(macOS는 메뉴 막대)에 상주합니다. 콘솔 창은 뜨지 않습니다.
  • Windows: 시작 메뉴의 Nexa Clip 또는 nexa-clip.exe
  • macOS: Nexa Clip.app
  • Linux: 앱 메뉴의 Nexa Clip 아이콘
• 로그인 시 자동 시작은 기본으로 켜져 있습니다. 첫 실행 때 로그인 항목에 등록되며, 원하지 않으면 설정 → 일반에서 끕니다. 앱 밖에서(예: 시작 프로그램 관리 도구로) 등록을 지우면 앱도 그 뜻을 따라 설정을 끔으로 바꿉니다.
• 같은 PC에서 한 번 더 실행하면 두 번째 실행은 이미 떠 있는 Nexa Clip에 “열기”만 전달하고 조용히 끝납니다.

처음 5분 따라 하기

1. 아무 앱에서 글자 몇 개를 복사(Ctrl+C, macOS ⌘C)합니다. 이미지나 파일도 복사해 봅니다.
2. 메모장 같은 편집기에 커서를 둔 채 Shift+Alt+C(macOS ⇧⌥C)를 누릅니다. 마우스 위치에 퀵 팝업이 뜹니다.
3. 검색어를 두세 글자 칩니다. 목록이 바로 걸러집니다.
4. ↑/↓로 고르고 Enter를 누르면 팝업이 닫히고 편집기에 붙여넣어집니다.
5. 트레이 아이콘을 왼쪽 클릭하면 메인창이 열립니다. 이력을 정리하거나 고정할 때 씁니다.

참고: macOS는 첫 붙여넣기 때 손쉬운 사용 권한을, Linux GNOME/Wayland는 포털 원격 데스크톱 승인을 한 번 요청합니다. 허용해야 원래 앱에 자동으로 붙여넣어집니다. 허용하지 않아도 고른 항목은 클립보드에 실리므로 직접 붙여넣을 수 있습니다.

상태 점검 명령

터미널에서 다음을 실행하면 이 PC에서 무엇이 되고 무엇이 안 되는지(클립보드 감시, 붙여넣기 주입 권한 등) 점검 결과를 보여 줍니다.

nexa-clip status

명령 출력은 영어로 나옵니다(v0.2.1부터). 앱 화면은 시스템 언어를 따릅니다.

화면 구성

트레이 아이콘

트레이 아이콘의 작은 점은 동기화 상태를 알려 줍니다(v0.1.7부터 세 점이 각각 따로 켜집니다).

퀵 팝업

전역 단축키(기본 Shift+Alt+C)로 여는 작은 창입니다. 항목을 고르면 닫히면서 원래 있던 창에 붙여넣습니다.

• 위: 검색줄(열리자마자 바로 입력 가능)
• 가운데: 항목 목록. 19번째 행 오른쪽에 번호 배지가 붙습니다(Ctrl+19로 바로 선택). 행 왼쪽 끝의 점 자리를 클릭하면 고정·해제합니다(v0.2.3부터).
• 아래: 힌트 줄. 지금 고른 항목의 종류에 따라 쓸 수 있는 키가 바뀌어 보입니다.
• 위치는 기본이 마우스 위치이며 설정에서 화면 중앙·마지막 위치로 바꿀 수 있습니다. 기본 보기는 일반 보기입니다.

메인창

이력을 관리하는 창입니다. 트레이 왼쪽 클릭으로 엽니다.

• 왼쪽 세로 툴바: 고정/해제 · 삭제 · 복사 · 평문으로 복사 · 중복 제외(토글) · 미리보기 · 최상위 고정 · 캡처 중지/재개 · 동기화 연결 아이콘 · 파일 전송 패널 · 설정. 아이콘에 마우스를 올리면 지금 지정된 단축키가 함께 보입니다.
• 검색줄: 앞의 드롭다운으로 검색 방식(정확히 · 유사 · 정규식)을 고릅니다.
• 목록: 기본은 간략 보기입니다. 고정한 항목은 위쪽 고정 구역에 모입니다.
• 미리보기: 서식·색·표·이미지·터미널 색(ANSI)까지 그려 보여 줍니다. 스크립트 실행이나 네트워크 접근은 하지 않습니다.
• 하단 상태줄: 오른쪽 점이 동기화 상태를 나타냅니다(녹색 = 릴레이 연결 · 파랑 = 같은 네트워크만 · 회색 = 동기화 끔 · 흐림 = 릴레이 설정됐지만 미연결).

보기 모드 세 가지

macOS는 ⌥1/2/3입니다. 보기 단축키는 메인창에서 동작하며, 팝업 보기는 설정 → 모양 → 팝업 보기에서 정합니다.

기록 보기 · 검색 · 고정

무엇이 기록되나

• 어느 앱에서 복사했는지(출처 앱)도 함께 기록합니다.
• 같은 내용을 다시 복사하면 새 항목을 만들지 않고 기존 항목을 맨 위로 올리며 복사 횟수(×N)가 늘어납니다.
• Excel에서 셀 범위를 복사하면, 범위가 작을 때(기본 200행 · 50열 · 5,000셀 이하)만 그림 표현을 함께 보관합니다. 행·열 전체 복사는 그림 없이 글·서식만 보관합니다.
• 기록할 종류는 설정 → 캡처에서 끄고 켭니다.

캡처 잠시 멈추기

메인창 툴바의 캡처 중지/재개 버튼을 누르면 그동안 복사한 것은 기록하지 않습니다. 다시 누르면 재개합니다.

검색

검색줄에 입력하는 즉시 목록이 걸러집니다. 라벨뿐 아니라 본문 전체를 대소문자 구분 없이 찾습니다.

검색줄 앞 드롭다운으로 바로 바꿀 수 있고, 기본 방식은 설정 → 검색에서 정합니다. 팝업과 메인창이 같은 방식을 씁니다.

고정(핀)

자주 쓰는 항목은 고정해 두세요. 고정한 항목은 목록 위쪽에 모이고, 보관 개수·기간·용량 상한에 걸려도 지워지지 않습니다.

1. 메인창에서 항목을 고릅니다.
2. Ctrl+P(macOS ⌘P)를 누르거나 툴바의 핀 버튼, 또는 우클릭 → 고정을 누릅니다.
3. 다시 누르면 고정이 풀립니다.

퀵 팝업에서도 됩니다(v0.2.3부터). Ctrl+P(macOS ⌘P)를 누르거나 행 왼쪽 끝의 점 자리를 클릭하면 선택한 항목을 고정·해제하고, 팝업은 열린 채로 있습니다.

항목 우클릭 메뉴

메인창에서 항목을 우클릭하면 맨 위에 출처(예: 출처 Code · ⇄ win-b)가 보이고, 그 아래에 항목 종류에 맞는 동작이 나옵니다.

• 복사 · 평문으로 복사 · 개체로 복사 · 경로만 복사(파일 항목)
• 고정 / 고정 해제
• 편집(평문화): 내용을 평문으로 고쳐 저장합니다. 편집기에서 Ctrl+Enter 저장 · Esc 취소 · Alt+Z 줄 바꿈 전환.
• 이미지로 복사: 서식 있는 내용이나 개체를 그림으로 클립보드에 올립니다(PowerPoint에 그림처럼 붙일 때).
• 삭제

중복 제외 보기

툴바의 중복 제외 토글(기본 켬)이 켜져 있으면 같은 내용은 한 행만 보입니다.

• 대표 행: 고정한 것 → 서식이 있는 것 → 내 PC에서 복사한 것 순으로 고릅니다. 내 것이 없으면 가장 최근에 받은 것입니다.
• 출처는 합쳐서 보이고(내 앱 이름이 앞, ⇄ 기기들이 뒤) 복사 횟수는 합산됩니다.
• 끄면 출처별로 나뉜 행이 모두 보입니다. 팝업도 같은 규칙을 따릅니다.

삭제

• 한 항목: 메인창에서 고르고 Delete 키, 툴바 삭제 버튼, 또는 우클릭 → 삭제.
• 전부: 설정 → 고급 → 기록 모두 삭제를 2초 안에 두 번 누릅니다. 고정 항목은 남고, 되돌릴 수 없습니다.
• 앱을 끌 때마다 비우려면 설정 → 보안·개인정보 → 종료 시 기록 비우기를 켭니다.

붙여넣기

퀵 팝업에서 붙여넣기

1. 붙여넣을 앱에 커서를 둡니다.
2. Shift+Alt+C로 팝업을 엽니다.
3. 검색하거나 ↑/↓로 고르고, 아래 키 중 하나를 누릅니다.

• 항목 종류에 따라 쓸 수 있는 키만 힌트 줄에 보입니다.
• Ctrl+1~9의 번호는 지금 화면에 보이는 순서입니다. 검색으로 거르면 번호가 다시 매겨집니다. 숫자는 키보드의 물리적 자리로 판정하므로 한글 자판에서도 동작합니다.
• 설정 → 붙여넣기의 자동 붙여넣기(기본 켬)를 끄면, 항목을 골랐을 때 클립보드에만 올리고 붙여넣기는 직접 합니다.
• 항상 평문으로 붙여넣기를 켜면 Enter도 평문으로 붙여넣습니다.

평문 붙여넣기 단축키

Shift+Alt+X(전역)를 누르면 팝업 없이 지금 클립보드 내용을 서식 없이 붙여넣고, 원래 클립보드 내용은 되돌려 놓습니다. 웹 페이지에서 복사한 글을 서식 없이 문서에 넣을 때 편합니다.

붙여넣기 스택 — 여러 개를 순서대로

양식을 채우거나 여러 조각을 차례로 옮길 때 씁니다.

1. 팝업에서 항목을 고르고 Ctrl+Space(또는 Ctrl+클릭)로 담습니다. 담은 행에는 왼쪽 막대와 순번(1, 2, 3…)이 붙고, 다시 누르면 빠집니다.
2. 다 담았으면 아래 키 중 하나를 누릅니다. 담은 순서대로 원래 앱에 차례로 들어갑니다.

• 줄바꿈은 마지막 항목 뒤에는 넣지 않습니다. 평문이 없는 항목(이미지)은 원본으로 들어갑니다.
• 자동 붙여넣기가 켜져 있어야 합니다.

메인창에서 복사하기

메인창에서는 붙여넣는 대신 클립보드에 올립니다. Enter 복사 · Shift+Enter 평문으로 복사 · Ctrl+1~9 N번째 항목 복사. 그다음 원하는 앱에서 직접 붙여넣으세요.

터미널과 특수한 창

• Linux 터미널: 터미널은 Ctrl+V 대신 Ctrl+Shift+V를 씁니다. X11/XWayland의 터미널 창이면 v0.1.7부터 Nexa Clip이 알아서 Ctrl+Shift+V를 보냅니다. Wayland 전용 터미널은 대상 창을 알아낼 수 없어 Ctrl+V를 보내므로, 이때는 클립보드에 실린 내용을 직접 붙여넣으세요.
• Windows 관리자 권한 창: 관리자 권한으로 실행한 앱에는 일반 권한 앱이 키를 넣을 수 없습니다. 클립보드에는 실려 있으니 직접 Ctrl+V를 누르세요.

암호화 저장과 개인정보 보호 기능

암호화 저장(기본)

이력은 내 PC의 데이터 폴더에 암호화되어 저장됩니다(ChaCha20-Poly1305). 따로 켤 필요가 없고 끌 수도 없습니다. 암호화 키는 같은 데이터 폴더의 device.key에서 나옵니다.

주의: 이 암호화는 이력 파일만 따로 유출되거나 지운 뒤 남은 조각을 막기 위한 것입니다. 데이터 폴더 전체(즉 device.key까지)가 유출되면 이력을 열 수 있습니다. 앱에 별도의 잠금 암호(마스터 비밀번호) 기능은 없으므로, PC 자체의 계정 잠금·디스크 암호화와 함께 쓰세요.

• 비밀이 실리는 파일(설정, 기기 키, 동기화 신원 키, Linux 포털 토큰)은 macOS·Linux에서 소유자만 읽을 수 있게(0600) 만듭니다.
• 기기 키가 바뀌면 옛 이력은 지워지지 않고 index.locked로 보관됩니다.

기록하지 않는 것

모두 설정 → 보안·개인정보에 있습니다. 표식을 보내지 않는 앱에서 복사한 비밀번호·토큰은 이력에 남을 수 있으니, 그런 앱은 제외 앱에 넣어 두세요.

보관 한도

설정 → 보관에서 정합니다. 한도를 넘으면 오래된 고정 안 한 항목부터 지웁니다.

기기 승인과 동기화

동기화는 기본으로 꺼져 있습니다. 켜지 않으면 Nexa Clip은 네트워크 통신을 전혀 하지 않습니다.

동작 방식 한눈에

• 내 기기들은 아이디(핸들) 와 페어링 암호가 같을 때 서로를 찾습니다. 페어링 암호는 만남 지점을 계산하는 데만 쓰고 서버로 보내지 않습니다.
• 만난 기기는 기기 목록에 뜨지만, 양쪽에서 승인하기 전에는 아무것도 주고받지 않습니다.
• 전송은 두 기기 사이의 종단 간 암호화(Noise) 로 봉인됩니다. 릴레이 서버는 봉투만 전달하고 내용을 볼 수 없습니다.
• 같은 네트워크(같은 Wi‑Fi·유선)에서는 서버 없이 직접 연결됩니다. 다른 네트워크의 기기와는 릴레이 서버를 거칩니다.
• 기기가 셋 이상이면(v0.2.2부터) 승인된 기기끼리 서로 아는 기기를 알려 주어, 직접 만나지 못한 기기도 찾아 연결합니다. 이렇게 찾은 기기도 승인 전에는 클립보드 항목과 파일을 주고받지 않습니다.

무엇이 오가나

• 받은 항목은 이력 맨 위에 들어가고 클립보드에도 실려 바로 붙여넣을 수 있습니다.
• 받은 항목에는 녹색 점과 출처 ⇄ 기기 이름이 붙고, 다시 상대에게 되돌려 보내지 않습니다.
• 한 번에 32MB를 넘는 텍스트·이미지는 보내지 않습니다. 밀린 항목이 있으면 가장 최근 것 하나만 보냅니다.
• 승인된 기기끼리는 클립보드 외에 내가 승인한 기기의 공개키 목록도 암호화된 세션으로 주고받습니다(v0.2.2부터). 받은 목록은 저장하지 않고 연결 시도에만 씁니다.

두 기기 연결하기

1. 두 기기 모두에서 설정 → 동기화를 엽니다.
2. 동기화 사용을 켭니다.
3. 내 아이디(핸들) 에 같은 짧은 이름(예: kiros33)을 넣습니다. 아이디를 넣으면 페어링 암호가 자동으로 추천되어 채워집니다.
4. 한 기기의 페어링 암호를 눈 버튼으로 확인하고, 다른 기기에도 똑같이 넣습니다. (생성 버튼을 2초 안에 두 번 누르면 새 암호를 만듭니다.)
5. 릴레이 서버를 고릅니다.
   • 다른 네트워크의 기기와도 쓰려면 기본값 beepd.sosomlab.com(SosomLab 공식 릴레이)을 두고 연결 테스트를 누릅니다.
   • 같은 네트워크에서만 쓰려면 None을 고릅니다. 테스트 없이 바로 서로를 찾습니다.
6. 잠시 뒤 기기 목록에 상대가 “연결됨 (LAN)” 또는 “연결됨 (relay)“으로 뜹니다.
7. 양쪽 화면의 6자리 대조 코드가 같은지 눈으로 확인한 뒤, 각 기기에서 상대 행의 승인을 누릅니다.
8. 이제 한쪽에서 복사하면 다른 쪽 이력 맨 위에 들어갑니다.

• 아이디와 페어링 암호 둘 다 채우기 전에는 접속하지 않습니다.
• 승인은 기기당 한 번이며 파일에 기록됩니다. 기기 목록의 해제로 승인을 거두고, 삭제로 목록에서 지울 수 있습니다.
• 기기 이름을 비워 두면 컴퓨터 이름을 정리해 씁니다. 바꾸면 약 1초 뒤 연결된 기기에 새 이름이 전달됩니다.
• 연결 테스트에 성공하면 자동 접속이 켜져 다음 실행부터 같은 상태로 시작합니다. 연결 해제는 지금 릴레이 세션을 끊습니다(다음 시작 때 다시 연결).
• 아이디·암호·서버·포트를 바꾸거나 동기화를 끄면 즉시 연결이 끊깁니다.
• 기기 목록 갱신(v0.2.2부터)은 알려진 기기 재연결 · 페어링 랑데부 · 같은 네트워크 비콘을 즉시 한 번 실행합니다. 새 기기는 1분 안에 목록에 뜹니다.

릴레이 서버

• 연결 테스트에 성공하면 주소와 서버 핀(서버 신원) 앞 8자가 표시됩니다. 첫 접속 때 서버 핀을 기억해 두고, 이후 서버 키가 바뀌면 접속을 멈추고 경고합니다. 운영자가 알린 새 핀이 아니면 접속하지 마세요. 공식 서버의 핀 값은 Nexa Clip 위키의 릴레이 서버 페이지에 공개되어 있습니다.
• 공식 서버는 개인·소규모 사용을 위한 것이며 가용성을 약속하지 않습니다.
• 릴레이 서버 프로그램은 Nexa Clip에 들어 있지 않습니다. 직접 운영하려면 Nexa Beep 프로젝트가 배포하는 nexa-beepd를 받아 실행하고(brew install kiros33/tap/nexa-beepd 또는 nexa-beep 릴리스의 beepd-v*), 방화벽에서 TCP·UDP 47300을 엽니다. 첫 실행이 출력하는 서버 핀 64자를 사용자에게 알려 주세요.
• 같은 서버를 Nexa Beep도 쓰지만, 두 앱은 서버에서 서로를 볼 수 없습니다.

같은 네트워크 직접 연결

• 각 기기가 5초마다 UDP 비콘(포트 47301)을 보내 같은 아이디·암호의 기기를 찾고, 찾으면 TCP로 직접 연결합니다. 상대와 연결되면 비콘 간격은 30초로 늘어납니다.
• 비콘에는 아이디·암호에서 계산한 태그와 기기 공개키, 연결 포트만 실립니다. 암호 원문이나 클립보드 내용은 실리지 않습니다.
• 릴레이를 골라도 같은 네트워크 연결을 함께 시도합니다. 같은 기기와 두 경로가 모두 서면 나중 것을 버립니다.
• Windows는 처음 연결할 때 방화벽 허용 창에서 허용해야 합니다.
• 게스트 Wi‑Fi처럼 기기끼리 격리된 네트워크, 가상 머신의 호스트↔게스트 사이에서는 찾지 못할 수 있습니다. 이때는 릴레이 서버를 쓰세요.

재시도 대기

연결이 실패할 때마다 다시 시도하기 전 대기가 두 배로 늘고, 성공하면 처음으로 돌아갑니다. 설정 → 동기화 → 재시도 대기에서 고릅니다.

파일 주고받기

v0.1.4부터 다른 기기에서 복사한 파일을 붙여넣을 수 있습니다.

1. 기기 A에서 파일 탐색기(Finder·파일 관리자)로 파일을 복사합니다(잘라내기는 보내지 않습니다).
2. 기기 B의 이력에 그 파일 항목이 들어옵니다. 이때는 경로 목록(이름·크기·수정 시각)만 옵니다.
3. 기기 B에서 그 항목을 붙여넣으면(팝업 Enter 등):
   • 같은 경로에 파일이 실제로 모두 있으면(공유 폴더·네트워크 드라이브 등) 그 파일을 그대로 씁니다.
   • 없으면 그 순간 기기 A에서 내용을 받아 와 진짜 파일로 붙여넣습니다. 3초 안에 다 받으면 바로 붙여넣고, 더 걸리면 다 받은 뒤 “파일 준비됨” 알림을 띄우니 그때 직접 붙여넣으세요.
4. 받은 파일은 다운로드 폴더 아래 Nexa Clip 폴더(항목마다 하위 폴더)에 저장되고, 다시 붙여넣을 때 재사용됩니다.

• 작은 파일은 미리 받아 둡니다. 합계가 50MB 이하인 파일 항목은 받자마자 백그라운드에서 천천히(기본 초당 1,024KB 이하) 받아 두므로, 붙여넣기가 즉시 되고 원본 기기가 꺼져도 쓸 수 있습니다.
• 합계가 1,000MB를 넘으면 내용을 받지 않고 경로를 글자로 붙입니다(사유는 로그에 남습니다).
• 받은 파일 보관 용량이 2,000MB를 넘으면 오래된 것부터 지웁니다.
• 원본 기기가 꺼져 있으면 전송은 “오프라인”으로 기다렸다가 다시 연결되면 이어서 받습니다. 끊겨도 받던 지점부터 이어 받습니다.
• 메인창 툴바의 파일 전송 패널 버튼을 누르면 파일별 진행률을 보고 중지·재시도할 수 있습니다. 전송 중에는 패널이 저절로 열리고, 트레이 아이콘 오른쪽 아래에 주황 점이 뜹니다.
• 파일은 승인한 내 기기끼리만 오갑니다.

관련 설정(설정 → 동기화):

주의: 동기화를 켜면 파일 경로 전파와 파일 내용 받기도 기본으로 켜진 상태입니다. 파일을 주고받고 싶지 않으면 위 두 설정을 끄세요. 받은 파일은 실행 파일이라도 그대로 저장되니, 출처를 알 수 없는 파일은 열지 마세요.

한 PC에서 두 기기처럼 시험하기

동기화를 한 PC에서 시험하려면 프로필로 두 번째 인스턴스를 띄웁니다.

nexa-clip --profile b

• 데이터 폴더가 data/profiles/b로 갈라져 설정·이력·신원 키·기기 목록이 모두 따로입니다. 즉 다른 기기로 보입니다.
• 창 제목 끝에 [b]가 붙고, 기본 기기 이름은 컴퓨터이름-b가 됩니다.
• 프로필 실행은 로그인 자동 시작 등록을 건드리지 않습니다.
• 두 번째 인스턴스는 전역 단축키 등록에 실패하는 것이 정상입니다(첫 인스턴스가 쥐고 있음). 트레이 왼쪽 클릭으로 여세요.
• 프로필 이름은 영문·숫자·-·_ 1~32자입니다.

단축키

전역 단축키(어느 앱에서나)

전역 단축키에는 Ctrl·Shift·Alt·Win(⌘) 중 하나가 들어가야 합니다(F키는 단독 가능).

창 안 단축키(팝업·메인창이 앞에 있을 때)

스택에 담은 항목이 있을 때 Enter 계열 키는 스택 순차 붙여넣기로 동작합니다.

바꿀 수 없는 키

단축키 바꾸기

1. 설정 → 일반 그룹 → 단축키를 엽니다. 전역과 창 안 두 묶음이 있습니다.
2. 바꿀 항목의 칸을 누르고 원하는 조합을 누르면 잡힙니다. 확인·취소하거나 바로가기 제거로 없앨 수 있습니다(없앤 키는 배지·툴팁·힌트에서도 사라집니다).
3. 저장은 자동입니다. 전역 단축키는 바로 다시 등록됩니다(Linux도 v0.1.7부터 실행 중 다시 등록). 적용되지 않으면 앱을 다시 시작하세요.

• 창 안 단축키에서 글자·숫자·,는 Ctrl·Alt·Win 중 하나와 함께, Enter·Delete·Space는 단독으로도 지정할 수 있습니다.
• 다른 앱이 같은 조합을 쓰고 있으면 등록에 실패하고 로그에 사유가 남습니다. 다른 조합으로 바꾸세요.

설정

메인창의 설정 버튼, 트레이 메뉴 → 설정, 또는 Ctrl+,(macOS ⌘,)로 엽니다.

설정 창 사용법(v0.2.0부터)

• 왼쪽 그룹 트리: 그룹을 누르면 그 그룹의 모든 항목이 이어서 보입니다.
• 오른쪽 카드: 항목마다 제목 · 키 이름(⧉로 복사 · 복사하면 그 위에 복사한 키가 잠깐 표시됨) · 설명 · 컨트롤 · 기본값이 보입니다. 값이 기본과 다르면 [초기화] 버튼이 나타납니다.
• 즉시 적용: 바꾸는 즉시 적용되고 잠시 뒤 저장됩니다. 저장 버튼은 없습니다.
• 검색: 위 검색칸에 낱말을 치면 모든 항목에서 찾습니다. 여러 낱말은 모두 포함하는 것만, 한글은 자모 단위로도 찾습니다(조합 중인 글자 포함). ↑/↓로 이전 검색어를 다시 부릅니다.
• 고급 스위치(하단): 끄면 드물게 쓰는 항목을 숨기고 숨긴 개수를 안내합니다.
• 변경 스위치(하단 · v0.2.5부터): 켜면 기본값과 다른 항목만 보여 줍니다.
• 스크롤(v0.2.5부터): PageUp·PageDown·Home·End로 오른쪽 패널을 움직입니다. 왼쪽 트리 위의 휠은 트리를 움직입니다.
• 잠긴 항목: 위 항목이 꺼져 있으면 아래에 딸린 항목이 흐리게 잠기고 “○○을(를) 켜면 쓸 수 있습니다”라고 알려 줍니다. 값은 그대로 남습니다.
• 내보내기… 는 설정을 JSON 파일로 저장하고, 가져오기… 는 파일에 있는 키만 적용합니다(모르는 키·틀린 값은 알려 줌). JSON 편집… 은 데이터 폴더의 settings.json을 기본 프로그램으로 열고, 저장하면 바뀐 키를 즉시 적용합니다(v0.2.5부터).
• 설정 파일(settings.cfg)은 고급의 설정 파일 카드에서 엽니다. 거기서 고친 값은 재시작 뒤 적용됩니다. 닫기 또는 Esc로 창을 닫습니다.

주의: 내보낸 JSON 파일과 settings.json에는 동기화 페어링 암호가 평문으로 들어갑니다. 다른 사람에게 보내거나 공유 폴더에 두지 마세요.

그룹과 카테고리

항목별 설명과 기본값

일반

캡처

붙여넣기

검색

보관과 보안·개인정보는 보관 한도와 기록하지 않는 것을 참고하세요.

모양

알림·움직임(v0.2.5부터)

동기화는 기기 승인과 동기화를 참고하세요. 동기화 사용을 끄면 그 아래 항목이 모두 잠깁니다.

고급

정보

• 이 빌드: 버전 · git 커밋 · 빌드 시각 · 실행 중인 실행 파일의 SHA-256 · OS · 데이터 폴더를 보여 줍니다.
• 빌드 정보 복사: 위 내용을 평문으로 클립보드에 복사합니다(문의·버그 보고용).
• 라이선스: 라이선스 참고.

라이선스

v0.2.0부터 설정 → 고급 → 정보에 라이선스 카드가 있습니다.

• 비상업적 사용은 라이선스 파일 없이 무료이며, 이때 상태는 “무료 — 비상업적 사용”으로 표시됩니다. 라이선스가 없어도 잠기는 기능은 없습니다.
• 상업적 사용 라이선스를 받으려면 [라이선스…] 화면에서 요청 코드 복사를 눌러 화면에 표시된 연락처로 보냅니다. 요청 코드에는 이 PC를 가리키는 기기 코드가 들어갑니다.
• 받은 .license 파일은 라이선스 파일 열기… 로 설치합니다. 서명 검증을 통과한 파일만 설치되고, 제거로 지울 수 있습니다.
• 라이선스 확인은 PC 안에서만 하며, 이를 위해 인터넷에 접속하지 않습니다.
• 터미널에서도 다룰 수 있습니다.

nexa-clip --license status                    # 상태
nexa-clip --license request "이름" "이메일"     # 요청 코드 만들기
nexa-clip --license install ./my.license      # 설치(검증 통과만)
nexa-clip --license remove                    # 제거
nexa-clip --license path                      # 설치 위치

데이터와 개인정보

내 PC에 저장되는 것

데이터 폴더(위치는 설치 위치와 데이터 위치)에 다음이 저장됩니다.

이와 별도로, 다른 기기에서 받은 파일은 다운로드 폴더 아래 Nexa Clip(설정으로 변경 가능)에 저장됩니다.

밖으로 나가는 것

• 동기화를 켜지 않으면 네트워크 통신이 없습니다. 분석·텔레메트리·광고·자동 업데이트 확인 기능이 없고, 계정 가입도 없습니다.
• 동기화를 켜면 같은 네트워크에 비콘(태그·기기 공개키·포트)을 보내고, 승인한 기기와 암호화된 세션으로 클립보드 항목·파일과 내가 승인한 기기의 공개키 목록을 주고받습니다.
• 릴레이 서버를 쓰면 서버가 공인 IP 주소와 연결 시각·바이트 수 같은 메타데이터는 알 수 있지만, 내용·아이디·페어링 암호는 서버에 닿지 않습니다.
• 앱 로그에는 항목 내용을 남기지 않습니다(v0.1.8부터 종류만 기록).

자세한 내용은 개인정보처리방침을 참고하세요.

이력 지우기

• 한 항목: 메인창에서 Delete.
• 전부: 설정 → 고급 → 기록 모두 삭제(2초 안에 두 번 · 고정 항목 제외).
• 완전히: 앱을 종료하고 데이터 폴더를 삭제합니다. 받은 파일 폴더(다운로드/Nexa Clip)는 따로 지웁니다.

참고: SSD 특성상 또는 직접 만든 백업에 옛 데이터가 남을 수 있으며, 앱은 물리적 완전 삭제를 보장하지 않습니다.

문제 해결

로그 보는 법

트레이로 실행하면 콘솔이 없습니다. 터미널에서 직접 실행하면 그 터미널에 로그가 찍힙니다.

# Windows (cmd)
nexa-clip.exe > run.log 2> run.err
# macOS
"/Applications/Nexa Clip.app/Contents/MacOS/nexa-clip"
# Linux (앱 메뉴로 띄운 인스턴스의 출력은 저널로 갑니다)
journalctl --user -f

동기화 관련 줄은 동기화:·LAN 직결:로, 단축키 등록 실패는 전역 단축키:로 시작합니다.

주의: Linux(GNOME)에서 터미널로 직접 띄우면 전역 단축키 등록이 실패할 수 있습니다. 로그만 확인한 뒤 앱 메뉴 아이콘으로 다시 띄우세요.

단축키가 동작하지 않는다

• 다른 앱이 같은 조합을 쓰고 있으면 등록에 실패합니다. 설정 → 단축키에서 다른 조합으로 바꾸세요. 트레이 왼쪽 클릭으로 메인창은 언제나 열 수 있습니다.
• Linux(GNOME): 전역 단축키는 포털이 앱 이름 단위로 관리합니다. VS Code 같은 다른 앱의 통합 터미널에서 띄우면 그 앱 이름으로 등록되어 이후 정상 실행분이 충돌합니다. 앱 메뉴 아이콘(또는 자동 시작)으로 띄우세요. 이미 꼬였다면 GNOME 설정의 앱별 전역 단축키 항목에서 엉뚱한 앱 아래 등록된 Nexa Clip 조합을 지우고 다시 띄웁니다.
• Linux에서 조합을 바꿨는데 옛 조합만 먹는다: v0.1.7에서 고쳤습니다. 업그레이드하세요.
• 같은 PC의 두 번째 인스턴스(--profile)는 단축키 등록에 실패하는 것이 정상입니다.

팝업을 열었더니 검색창에 글자가 들어간다 / 글자가 계속 입력된다

• 단축키를 누른 손을 떼기 전에 팝업이 뜨면서 글자가 들어가던 문제는 v0.1.2에서 고쳤습니다.
• Linux(GNOME/Wayland)에서 손을 뗐는데도 c 같은 글자가 끝없이 입력되던 문제는 v0.1.5에서 고쳤고, v0.1.7에서 한글 입력 상태에서 생기던 경우까지 막았습니다. 드물게 그 직후 같은 글자를 처음 칠 때 한 번 빠질 수 있습니다(두 번째부터 정상).
• 단축키를 길게 누르면 팝업이 열렸다 닫혔다 반복하던 문제(GNOME)는 v0.1.7에서 고쳤습니다.

골랐는데 원래 앱에 붙여넣어지지 않는다

설정 → 붙여넣기의 자동 붙여넣기가 켜져 있는지도 확인하세요.

Windows에서 실행하자마자 꺼진다 (v0.1.3 이하)

v0.1.3 이하 Windows 배포본은 Visual C++ 런타임(VCRUNTIME140.dll)이 없는 PC에서 실행 즉시 종료되었습니다. v0.1.4 이상으로 업그레이드하세요.

글자가 □(두부)로 보인다

주 글꼴에 없는 기호·이모지입니다. OS별 기호 글꼴로 자동 대체합니다. macOS·Linux의 컬러 이모지(그림 글꼴)는 v0.1.7부터 그려집니다. 기동 로그의 글꼴 폴백: 줄에서 어느 글꼴이 붙었는지 확인할 수 있습니다.

동기화가 연결되지 않는다

1. 양쪽의 아이디와 페어링 암호가 정확히 같은지 확인합니다. 둘 중 하나라도 비어 있으면 접속하지 않습니다.
2. 릴레이를 쓴다면 연결 테스트 결과를 봅니다. “N초 뒤 재시도(실패 k회)“가 보이면 재시도 중입니다.
3. 같은 네트워크만 쓴다면(None) 방화벽 허용, 게스트 Wi‑Fi의 기기 격리, 가상 머신 어댑터를 확인합니다.
4. 기기 목록에 상대가 “승인 대기 중”이면 양쪽에서 승인해야 클립보드가 오갑니다.
5. 두 기기의 시계가 하루 이상 어긋나면 만남 지점이 어긋납니다. 시계를 맞추세요.
6. “서버 핀 불일치” 경고가 뜨면 서버 키가 바뀐 것입니다. 운영자가 알린 새 핀이 아니면 접속하지 마세요.
7. 셋째 기기가 목록에 안 뜨면 모든 기기를 v0.2.2 이상으로 올리고 설정 → 동기화의 기기 목록 갱신을 누릅니다. 네트워크가 다른 기기를 찾으려면 양쪽 모두 릴레이를 써야 합니다(None이면 만날 수 없습니다).

다른 기기에서 받은 파일이 붙여넣어지지 않는다

• 원본 기기가 켜져 있고 연결되어 있어야 내용을 받아 올 수 있습니다(미리 받아 둔 50MB 이하 파일은 예외).
• 3초 안에 다 받지 못하면 바로 붙여넣지 않고 “파일 준비됨” 알림을 띄웁니다. 알림이 뜬 뒤 직접 붙여넣으세요.
• 합계가 1,000MB를 넘으면 경로 글자로 붙습니다. 설정 → 동기화(고급) → 붙여넣기 시 최대 크기를 늘리세요.
• 받은 파일 붙여넣기가 경로 텍스트만으로 되어 있지 않은지, 붙여넣을 때 파일 내용 받기가 켜져 있는지 확인하세요.
• 메인창의 파일 전송 패널에서 실패한 전송을 재시도할 수 있습니다.

같은 내용이 여러 행으로 보인다

툴바의 중복 제외 토글이 꺼져 있으면 출처별로 나뉘어 보입니다. 켜면 한 행으로 합쳐집니다.

설정의 동기화 항목이 흐리게 잠겨 있다

동기화 사용이 꺼져 있거나, 릴레이가 None이라 포트·테스트·연결 해제가 의미 없거나, 연결 중이라 테스트가 잠긴 경우입니다. 파일 관련 항목은 파일 경로 전파 또는 붙여넣을 때 파일 내용 받기가 꺼져 있으면 잠깁니다.

Linux: 앱 메뉴 아이콘이 엉뚱한 실행 파일을 띄운다 / 창이 뒤에 뜬다

v0.1.2에서 고쳤습니다. 고친 뒤에도 셸이 옛 경로를 기억할 수 있으니 로그아웃 후 다시 로그인(또는 재부팅)을 한 번 하세요.

가상 머신(VMware) 게스트에서 파일 복사가 여러 번 전송된다

Linux 게스트에서 호스트의 파일 복사 한 번에 같은 파일이 여러 번 전송되던 문제는 v0.1.8에서 고쳤습니다.

문의할 때

설정 → 고급 → 정보의 빌드 정보 복사로 버전·빌드 정보를 복사해 함께 보내 주세요. 문의: [email protected] · GitHub 저장소

버전 변경 이력

버전 흐름 요약

v0.2.6 — 2026-11-06

수정

• Windows에서 원격 데스크톱(RDP) 재접속 뒤 창이 영영 “응답 없음”으로 멈추던 문제(작업 표시줄 재생성 때 창 라이브러리 교착을 앱 안에서 우회).

추가

• 창 투명도(설정 › 모양) — 포커스 있을 때(ui.transparency) · 없을 때(ui.transparency_blur)를 따로 정합니다. 대화상자로 포커스가 옮겨 갈 때 메인 창을 흐리지 않는 설정(ui.dialog_keeps_active)과 흐려지기 전 유예 시간(ui.blur_grace_ms)도 있습니다.

개선

• 1MB 이상 텍스트 항목(평문·HTML·RTF)도 유휴 시 메모리에서 내립니다.

변경

• 창 투명도가 기본으로 켜집니다(포커스 5% · 비포커스 10%). 불투명하게 쓰려면 두 값을 0으로 두세요.

v0.2.5 — 2026-11-03

추가

• 설정 창 하단의 변경 스위치로 기본값과 다른 항목만 봅니다.
• 알림·움직임 카테고리(토스트 · 플래시 메시지 · 고속 스크롤)를 추가했습니다.
• 고속 스크롤: 같은 방향의 휠 틱이 빠르게 이어지면 이동량을 늘리고 ×N을 표시합니다(메인창·팝업 목록·설정 창 · 기본 켬).
• 설정 내보내기 · 가져오기 · JSON 편집을 추가했습니다. 내보낸 파일과 settings.json에는 페어링 암호가 평문으로 들어갑니다.

변경

• 설정 창 하단 줄을 고급 · 변경 · 내보내기 · 가져오기 · JSON 편집 · 닫기로 정리하고, 설정 파일 열기는 고급의 설정 파일 카드로 옮겼습니다.
• 설정 창에서 PageUp·PageDown·Home·End로 스크롤합니다. 왼쪽 트리 위의 휠은 트리를 움직이고, 카테고리를 바꾸면 맨 위부터 보입니다.
• Windows 실행 파일에 버전·아이콘·매니페스트 정보를 넣고 설치본 압축 방식을 바꿨습니다(백신 오탐을 줄이기 위한 보조 조치 · x64 설치본 약 1.6MB). 코드 서명은 여전히 없습니다.
• 라이선스 파일 머리 안내를 영어로 바꿨습니다.

v0.2.4 — 2026-10-17

수정

• 트레이 메뉴의 최근 항목 수를 바꿔도 다음 복사 전까지 옛 개수로 보이던 문제를 고쳤습니다. 이제 다음 클릭에 반영됩니다.

개선

• 설정 카드에서 키 이름을 눌러 복사하면 복사한 키를 그 위(모자라면 아래)에 잠깐 표시합니다.

v0.2.3 — 2026-10-17

추가

• 퀵 팝업에서 Ctrl+P(macOS ⌘P) 또는 행 왼쪽 끝 점 자리 클릭으로 고정·해제합니다. 팝업은 열린 채로 있습니다.
• 트레이 메뉴의 최근 항목에 순번 배지를 표시합니다.
• 설정에 항목 용량 상한(기본 32MB · 고급)을 추가했습니다. 넘으면 필수가 아닌 표현을 큰 것부터 저장하지 않습니다.

수정

• Windows: 로그오프·시스템 종료 때 저장을 마친 뒤 끝납니다.
• 조합 중에 팝업이 닫히면 한글 한 글자가 검색줄에 남던 문제를 고쳤습니다.
• 팝업 일반 보기에서 핀·수신 점이 번호를 가리던 문제를 고쳤습니다.

개선

• 큰 복사의 메모리 피크를 낮추는 1차 조치를 넣었습니다(Windows는 크기를 먼저 확인해 버릴 표현을 읽지 않음). 실제 감소량은 아직 측정 중입니다.

v0.2.2 — 2026-10-15

추가

• 승인된 기기끼리 서로 아는 기기를 알려 주어, 기기가 셋 이상일 때 릴레이 너머의 기기도 찾습니다. 찾은 기기는 승인 대기로 뜹니다.
• 설정 → 동기화에 기기 목록 갱신을 추가했습니다.

변경

• 페어링 랑데부를 연결된 기기가 있어도 느린 주기(표준 5분)로 계속 엽니다.

수정

• 받은 글이 다시 읽히면서 새 항목으로 한 번 더 잡히던 문제를 고쳤습니다.
• 받은 내용을 다른 기기로 다시 전파하던 문제를 고쳤습니다.

v0.2.1 — 2026-10-10

수정

• Windows: 퀵 팝업에서 Enter로 붙여넣을 때, 대상 앱에 이미 글이 있으면 붙여넣기가 사라지던 문제를 고쳤습니다(대상 창으로 포커스가 완전히 넘어간 뒤에 붙여넣기 키를 보냅니다).
• Windows ARM64 설치본 제작이 외부 서버 일시 장애로 실패하지 않도록 재시도를 넣었습니다.

변경

• --help · status 등 명령줄 출력과 릴리스 노트를 영어로 바꿨습니다. 앱 화면은 계속 시스템 언어를 따릅니다.
• 릴리스 노트에 APT·DNF 설치 명령을 추가했습니다.

v0.2.0 — 2026-10-10

추가

• 라이선스 화면: 설정 → 고급 → 정보 → 라이선스. 상태·라이선스 ID·파일 위치·기기 코드 표시, 요청 코드 복사, 라이선스 파일 설치·제거. 명령줄 nexa-clip --license status|request|install|remove|path. 비상업 사용은 파일 없이 무료이며 잠기는 기능이 없습니다.
• 라이선스 파일을 고르는 파일 선택 창(앱 자체 화면).

변경

• 설정 창 개편: 왼쪽 그룹 트리(일반 · 클립보드 · 모양 · 동기화 · 고급) + 오른쪽 카드. 카드마다 키 이름 복사 · [초기화] · 기본값 표시.
• 고급 설정 스위치: 드물게 쓰는 9개 항목을 기본으로 숨깁니다.
• 종속 잠금: 위 항목이 꺼지면 딸린 항목이 흐리게 잠기고 안내가 뜹니다.
• 설정 검색이 여러 낱말 AND와 한글 자모 단위 검색을 지원하고, 이전 검색어를 ↑/↓로 다시 부릅니다.
• 하단에 설정 파일 열기… 와 닫기 버튼이 생겼습니다.
• 언어 기본값이 시스템 언어 따름이 되었습니다. 테마·언어의 “시스템” 항목에 지금 OS 값이 함께 표시됩니다.
• 화면 그리기 부품을 SosomLab 공통 UI 라이브러리로 옮겼습니다(기호 글꼴 대체 후보가 늘었습니다).

수정

• 설정 창의 [닫기]와 Esc가 반응하지 않던 문제를 고쳤습니다.

v0.1.9 — 2026-10-05

추가

• Linux .rpm 패키지(Fedora·RHEL·openSUSE 계열)를 배포합니다. 내용물은 .deb와 같습니다.
• pkg.sosomlab.com의 DNF 저장소에 등록되어 sudo dnf install nexa-clip으로 설치·갱신할 수 있습니다.

v0.1.8 — 2026-10-05

변경

• 앱 로그에 항목 내용 미리보기를 남기지 않습니다. 항목의 종류만 기록합니다(비밀 문자열이 로그에 남는 것을 막기 위함).
• 새 버전을 공개하면 pkg.sosomlab.com APT 저장소가 자동으로 갱신됩니다(sudo apt install nexa-clip · apt upgrade로 갱신).

수정

• Linux 가상 머신(VMware) 게스트에서 호스트의 파일을 한 번 복사했는데 같은 파일이 약 20번 반복 전송되던 문제를 고쳤습니다.

v0.1.7 — 2026-10-05

추가

• macOS·Linux에서 컬러 이모지를 그립니다(시스템 이모지 글꼴의 그림 글리프).
• 서식 미리보기에서 표의 열 폭을 맞추고 칸 배경·테두리를 그립니다.
• 트레이 메뉴 맨 위에 버전(Nexa Clip v0.1.7 형식)을 표시합니다.
• 트레이 아이콘 점을 세 개로 나눴습니다: 왼쪽 위 녹색 = 릴레이 · 왼쪽 아래 파랑 = 같은 네트워크 직결 · 오른쪽 아래 주황 = 파일 받는 중. 점에 흰 테두리를 둘러 잘 보이게 했습니다.

변경

• 파일 잘라내기는 다른 기기로 보내지 않습니다(세 OS 공통). 내 이력에는 남습니다.

수정

• Linux: 단축키 조합을 바꿔도 옛 조합만 동작하던 문제, 단축키를 바꾼 뒤 재시작해야 하던 문제를 고쳤습니다.
• Linux: 단축키를 길게 누르면 팝업이 열렸다 닫혔다 반복하던 문제를 고쳤습니다.
• Linux: 팝업 단축키 글자가 한글 입력 상태에서 계속 입력되던 문제를 스스로 풀도록 고쳤습니다.
• Linux: X11/XWayland 터미널에는 Ctrl+Shift+V로 붙여넣습니다.
• Linux: 클립보드 감시 재연결, 같은 내용 재복사, 출처 앱 표시, 두 번째 실행 시 열기, 트레이 재등록 등 안정성 수정.
• 가상 머신 클립보드 공유 도구가 다시 써 넣는 평문·그림이 이력에 새 항목으로 쌓이던 문제를 고쳤습니다(서식 글을 붙여넣으면 서식이 사라지던 원인).
• ONLYOFFICE 프레젠테이션 개체를 그림 개체로 잡고, 여러 개체를 원래 배치대로 합성합니다.
• 글 없이 그림만 든 HTML을 그림 개체로 다뤄 미리보기와 “이미지로 복사”가 됩니다.
• “이미지로 복사”를 각 OS가 알아보는 형식으로 올립니다(Linux·macOS).

v0.1.6 — 2026-10-04

추가

• 일반 보기에도 행 오른쪽 끝에 종류 아이콘을 표시합니다(메인창·팝업). 종류 아이콘 모양을 새로 그렸습니다.

수정

• Excel에서 행·열 전체를 복사하면 “그림이 너무 커서 잘립니다” 오류가 나던 문제를 고쳤습니다. 셀 범위는 크기를 보고 작은 범위만 그림을 함께 보관합니다.
• 이력에서 고른 Excel 항목이 그림판에 붙지 않던 문제, “이미지로 복사”가 복사 때 받은 원본 그림을 먼저 쓰도록 고쳤습니다.
• 고정 항목이 고정 구역에서 사라지던 문제, 고정 구분선이 잘못 표시되던 문제를 고쳤습니다.
• 파일 항목을 평문·경로로 붙여넣으면 항상 전체 경로가 들어갑니다.
• macOS에서 다른 기기의 항목을 받을 때 창이 멈추던 문제를 고쳤습니다(받은 항목 게시를 별도 작업으로 분리).

변경

• winget·Chocolatey 패키지 설명을 영어로 바꿨습니다.

v0.1.5 — 2026-09-27

수정

• Linux(GNOME/XWayland): 팝업 단축키의 수식 키를 쥔 채 글자 키를 먼저 떼면 그 글자(예: c)가 끝없이 입력되던 문제를 고쳤습니다. 팝업이 뜰 때 눌려 있던 키는 뗄 때까지 입력으로 받지 않습니다.

변경

• Chocolatey에 처음 제출했습니다(nexa-clip · nexa-clip-portable · 검수 대기).

v0.1.4 — 2026-09-14

추가

• 기기 간 파일 공유: 다른 기기에서 복사한 파일을 붙여넣으면 그 순간 원본 기기에서 내용을 받아 와 진짜 파일로 붙여넣습니다. 이어 받기, 작은 파일 미리 받기(백그라운드 · 속도 제한), 받은 파일 재사용(캐시)을 지원합니다.
• 파일 경로 전파: 같은 경로가 있는 기기(공유 폴더 등)에서는 파일 그대로, 없으면 경로 글자로 붙습니다.
• 메인창 파일 전송 패널(파일별 진행률 · 중지 · 재시도)과 툴바 토글 버튼, 트레이 진행 표시·알림.
• 받은 파일 저장 폴더 설정(기본 = 다운로드 폴더/Nexa Clip)과 파일 관련 설정.
• 정보 화면(설정 → 정보): 버전 · 빌드 정보 · 실행 파일 SHA-256 · 데이터 폴더 · 복사 버튼.
• 숫자 설정 설명에 단위를 표시합니다.

수정

• Windows: Visual C++ 런타임이 없는 깨끗한 Windows에서 실행 즉시 종료되던 문제를 고쳤습니다(런타임 내장).
• 파일 항목 붙여넣기 문제 3건을 고쳤습니다(평문 붙여넣기 경로, macOS·Linux 경로 붙여넣기, Linux에서 붙여넣기가 성공한 것처럼 보이지만 실제로 안 들어가던 문제).
• 두 PC 사이에서 같은 파일 항목이 계속 오가던 문제를 고쳤습니다.

v0.1.3 — 2026-09-08

추가

• 붙여넣기 스택 순차 붙여넣기 4변형: 원본 · 평문 × 항목 사이 줄바꿈 있음/없음(Enter · Alt+Enter · Shift+Enter · Shift+Alt+Enter).
• 창 안 단축키 14종을 설정 → 단축키 → 창 안에서 바꿀 수 있습니다. 지정한 키가 배지·상태줄·툴팁·힌트에 표시됩니다.
• 설정 열기 Ctrl+,(macOS ⌘,).

변경

• 항목 선택이 Ctrl+19(macOS ⌘19)가 되고, 보기 전환은 Alt+1/2/3(macOS ⌥1/2/3)으로 옮겼습니다.

수정

• macOS: Homebrew로 업그레이드한 뒤 손쉬운 사용 권한 목록에 죽은 항목이 남던 문제를 자동으로 정리합니다.

v0.1.2 — 2026-09-05

추가

• 설정 → 단축키 카테고리: 퀵 팝업 · 보조 팝업 · 평문 붙여넣기 조합을 바꾸고 바로 다시 등록합니다.
• 기기 이름을 바꾸면 약 1초 뒤 연결된 기기에 새 이름이 전달됩니다.
• 릴레이 None 상태에서 아이디·암호를 나중에 채워도 같은 네트워크 연결이 자동으로 시작됩니다.

수정

• Linux: 붙여넣기가 영영 안 되던 문제(포털 세션 자동 복구), 포털 승인 창이 매번 뜨던 문제, 창이 뒤에 뜨던 문제, 전역 단축키가 등록되지 않던 원인, 앱 메뉴 아이콘이 다른 빌드를 띄우던 문제를 고쳤습니다.
• 팝업을 열면 검색창에 단축키 글자가 들어가던 문제를 고쳤습니다(Linux·Windows).
• 받은 이미지가 “[이미지]“로만 보이던 문제(팔레트·16비트 PNG)를 고쳤습니다.
• 설정 창 위치가 재시작 후 복원되지 않던 문제를 고쳤습니다.

변경

• 페어링 암호가 실리는 설정 파일, 기기 키, 포털 승인 토큰을 소유자만 읽을 수 있게(0600) 만듭니다.

v0.1.1 — 2026-09-04

개선

• 검색: 라벨과 본문 · 정확히/유사/정규식 · 한글 조합 중 검색.
• 메모리: 오래 안 본 본문은 내려 두고 섬네일은 필요할 때만 올려 기동 메모리와 시간을 크게 줄였습니다.
• 동기화 신원 점검 수정.

v0.1.0 — 2026-09-04

추가

• 첫 공개. Windows · macOS · Linux 클립보드 감시(텍스트 · 이미지 · 파일 경로 · 서식 · 원본 형식), 암호화 저장, 퀵 팝업 · 메인창 · 설정 · 트레이, 붙여넣기 4모드 · 붙여넣기 스택 · 평문 붙여넣기, 키 주입 붙여넣기.
• 기기 간 동기화(평문 · PNG): 아이디·페어링 암호, 기기별 승인과 6자리 대조 코드, 같은 네트워크 직결과 릴레이 서버, 중복 제외 보기, --profile.
• 5개 대상(Windows x64·ARM64, macOS Apple Silicon·Intel, Linux x64) 설치본·포터블 배포와 Homebrew.

알려진 제한

• 코드 서명이 없습니다. macOS Gatekeeper·Windows SmartScreen 경고가 뜹니다. 이 때문에 Chocolatey 설치본(nexa-clip)은 백신 검사 탐지로 검수가 멈춰 있어 설치할 수 없습니다(포터블은 가능).
• winget으로는 아직 설치할 수 없습니다(제출분 미병합).
• 잠금 암호(마스터 비밀번호)가 없습니다. 이력 암호화 키가 같은 데이터 폴더에 있어, PC 자체를 손에 넣은 사람에게서 이력을 지키지는 못합니다.
• 동기화는 서식(HTML/RTF)을 보내지 않습니다(받는 쪽은 평문).
• 동기화는 아이디·페어링 암호가 같은 내 기기와, 승인한 기기가 알려 준 기기하고만 됩니다(어느 쪽이든 승인 필요). 다른 사람에게 보내는 기능, 모바일 기기는 지원하지 않습니다.
• 받은 파일은 실행 파일이라도 별도 격리 없이 저장됩니다.
• Linux는 x86_64만 제공합니다. Wayland 전용 터미널에는 자동 붙여넣기가 Ctrl+V로 가서 들어가지 않을 수 있습니다.
• 같은 네트워크 직결은 게스트 Wi‑Fi(기기 격리)·가상 머신 호스트↔게스트 사이에서 찾지 못할 수 있습니다.
• Windows에서 taskkill /PID(창 닫기 신호)로는 앱이 끝나지 않고 트레이로 숨습니다. 종료는 트레이 메뉴 → 종료를 쓰세요(로그오프·시스템 종료 때는 저장 뒤 끝납니다 · v0.2.3부터).
• 설명서의 일부 화면 그림은 v0.1.x에서 찍은 것입니다.

↑ 맨 위로