Skip to content

Install

Jump to bottom
Sangyong Bae edited this page Aug 22, 2026 · 5 revisions

설치

모든 채널은 태그 릴리스(Releases)에서 나온다. 설치본과 포터블 2채널(DR-4) — 포터블은 압축 해제 즉시 실행, 영속물은 실행 파일 옆 data/(불가 시 사용자 폴더 폴백).

Windows

채널 방법
설치본(NSIS) nexa-beep-{버전}-windows-x64-setup.exe — 사용자 단위(HKCU)·무권한 · 무인 설치 /S
포터블 nexa-beep-{버전}-windows-x64-portable.zip 압축 해제 → nexa-beep.exe 더블클릭
winget / Chocolatey 매니페스트 준비 완료 — 중앙 저장소 게시는 준비 중

ARM64 자산(windows-arm64)도 동일 구성으로 제공된다.

macOS

brew tap kiros33/tap
brew install --cask nexa-beep        # .app 설치
# 또는 CLI 포터블:
brew install nexa-beep-portable

서명·공증 전이라 Cask가 설치 시 격리 표식을 제거한다(임시방편 — 서명은 로드맵). 수동 설치 시 dmg/tar.gz 자산 사용.

Linux

# deb
sudo dpkg -i nexa-beep-{버전}-linux-x64.deb
# 또는 포터블
tar xzf nexa-beep-{버전}-linux-x64-portable.tar.gz && ./nexa-beep

무결성 확인

릴리스마다 SHA256SUMS.txt가 함께 올라간다:

# Windows
(Get-FileHash .\nexa-beep-*-portable.zip -Algorithm SHA256).Hash

실행

  • 더블클릭(권장) — 창 모드 + 실물 발견으로 시작한다.
  • 터미널: nexa-beep --window --live(창) · --chat-live [이름](CLI 단말 — 아래 참조)
  • nexa-beep --help 로 전체 모드·옵션 · --version 으로 버전
  • 자동 실행 — 기본으로 시스템 시작 시 함께 뜬다(설정 ▸ 고급 app.autostart 에서 끌 수 있다)
  • 데이터 위치: 실행 파일 옆 data/(포터블) 또는 사용자 설정 폴더 — settings.cfg(설정)·identity.key(신원)·trust.seg(신뢰 핀·암호화)
  • 같은 폴더의 nbeep-imgdec(보조 실행 파일)를 지우지 말 것 — 이미지를 격리해서 디코드하는 별도 프로세스다. 없으면 사진 대신 이니셜 아바타로 폴백한다.

기기를 옮기거나 포맷할 때 — identity.key가 곧 신원이다. 백업해 두지 않으면 재설치 후 상대에게 다른 사람으로 보인다 (설정 ▸ 프로필에 백업·복원 기능이 있다). 대화 기록은 기기를 따라가지 않는다(v1 한계).

다른 네트워크의 상대와 (릴레이 서버)

같은 LAN이 아닌 상대(집↔회사 등)와는 릴레이 서버를 경유한다 — 설정 › Server → Managed만 켜면 공식 기본 서버(beepd.sosomlab.com — 앱 기본값)로 등록된다. 상대 찾기·검증·자가 호스팅은 Relay-Server 참조. 서버는 종단 암호화 때문에 대화 내용을 볼 수 없고 아무것도 저장하지 않는다.

서버 자체를 설치하려면(자가 호스팅):

brew install kiros33/tap/nexa-beepd     # macOS(Apple Silicon)·Linux
winget install SosomLab.NexaBeepd       # Windows (중앙 검수 통과 후)
choco  install nexa-beepd               # Windows (중앙 검수 통과 후)

명령어 사용법

대화창 명령 (GUI)

입력줄에서 /로 시작하면 메시지가 아니라 명령이다. 전부 로컬이라 상대에게 나가지 않는다.

명령 별칭 동작
/help /? · /명령 명령 목록
/fingerprint /fp · /지문값 내 지문 + 상대 지문 출력(대조용)
/verify /sas · /지문 · /대조 이 상대를 대조 완료로 표시(파란 실 배지)
/unverify /대조취소 대조 완료 취소(핀 상태로)
/trust /신뢰 신뢰 상태 한 줄
/close /quit · /q · /닫기 대화창 닫기(대화는 유지)

판정은 첫 글자 하나로 갈린다:

  • " /help"처럼 앞에 공백이 있으면 → 그냥 메시지
  • /help + Shift+Enter + 둘째 줄 → 메시지 전문(명령은 한 줄 · 뒷줄이 사라지지 않는다)
  • //안녕 → /안녕 메시지(escape — 없으면 /로 시작하는 문장을 못 보낸다)
  • /verifed(오타) → 보내지도 실행하지도 않고 안내만(잘못 나가면 실행된 줄 안다)

⚠️ /verify는 대조를 대신해 주지 않는다. 순서는 /fingerprint → 전화·대면 등 다른 채널로 상대와 맞춰 보기 → /verify다. 인증하려는 그 통로 안에서 "확인했어?"를 주고받아 승격하면 중간자가 그 문답까지 대신할 수 있다.

CLI 단말 (--chat-live)

터미널만으로 참여한다. 수신은 모든 상대에게서 받고, 상호 대화는 명시적으로 연결한 1명과 한다.

nexa-beep --chat-live 내이름

대기 중

명령 동작
/peers (/list) 발견된 상대 번호 목록
/connect <번호> 목록에서 골라 1:1 대화 시작
/connect <host[:port]> IP 직접 연결(포트 생략 = 47200)
/quit 종료

대화 중 — 한 줄 = 전송 · /send <파일…>(공백 구분 다중 · 요청당 최대 5) · /accept·/reject(요청 전체 승인/거절) · /quit = 대화만 끝내고 목록으로 복귀.

상대가 걸어온 연결은 받아서 세워 둔다 — 메시지가 {지문}(수신 전용)> 로 보이고 전달/읽음 확인도 되쏘지만, 대화 모드로 자동 진입하지는 않는다. 대화하려면 /connect 로 승격한다.

ℹ️ Windows에서 cmd/PowerShell로 --chat-live를 부르면 앱이 자기 콘솔 창을 새로 연다. 그 셸들은 GUI 앱을 기다리지 않아 프롬프트와 입력이 섞이기 때문이다(Git Bash·파이프는 그 자리 그대로).

Clone this wiki locally