Settings Popup
pytmux의 거의 모든 설정은 하나의 통합 설정 화면에서 보고 바꿀 수 있습니다. 설정이 config 파일·런타임 명령·서버 옵션·플러그인 전용 화면에 흩어져 있던 것을 한 곳에 모은 화면으로, 값을 바꾸면 즉시 적용되고 영속됩니다.
- 명령 프롬프트에서:
ESC→:→settings입력 후 Enter- 별칭(같은 화면):
config,preferences,prefs,옵션
- 별칭(같은 화면):
- 메뉴에서: 메뉴(prefix + Enter) → ⚙ 설정…
-
좌측 — 카테고리 세로 탭:
표시 · 입력 · 동작 · 상태줄 · Claude · 고급 · 키탭을 클릭(또는Tab)하면 우측 목록에서 그 카테고리 위치로 점프합니다. -
우측 — 전체 설정 목록(스크롤): 카테고리별 dim 헤더(
── 표시 ──)로 묶인 단일 목록. 각 행은설정 이름+ 현재값/선택지를 보여 줍니다.
| 키 / 동작 | 효과 |
|---|---|
↑ ↓
|
행 이동 |
← → (또는 값 클릭) |
값 변경 — 즉시 적용 + 영속 |
Enter |
문자열 설정은 입력 모달, 링크 행은 전용 화면 열기 |
Tab / 카테고리 탭 클릭 |
해당 카테고리로 점프 |
Esc · [x] · 바깥 클릭 |
닫기 |
행 종류에 따라 ←→가 다르게 동작합니다.
-
켜기/끄기(bool) —
켜짐 ⇄ 꺼짐토글 -
선택지(enum) — 한 줄에 펼친 선택지를 순환(예: 탭 바 표시
항상 / 자동) -
숫자(ratio·int) —
‹ 0.18 ›처럼 증감(흐리게 세기, 상태줄 갱신 주기 등) -
문자열(str) —
Enter로 입력 모달을 열어 값 입력(prefix, 시작 경로, 상태줄 포맷 등) -
링크(link) —
Enter/클릭으로 그 기능의 전용 화면을 엽니다(Claude·플러그인 항목)
값은 변경 즉시 반영되며, 백엔드에 따라 알맞은 경로로 저장됩니다 — 표시/입력/동작 설정은
config 파일에, 서버 옵션(단일 테두리·자동 이름 등)은 서버 옵션에, 언어는 로케일 설정에
기록됩니다. 일부 항목은 (재시작 시 발효)로 표시됩니다(예: VT 파서).
| 설정 | 종류 | 설명 |
|---|---|---|
| 비활성 패널 흐리게 | bool | 비활성 패널을 흐리게 표시 |
| 흐리게 세기 | ratio | 흐림 강도(0.0–0.8) |
| 탭 바 표시 | enum |
항상 / 자동(2개 이상일 때만) |
| 상태줄 위치 | enum |
아래 / 위
|
| 단일 패널 테두리 | bool | 패널이 하나일 때 테두리 생략 |
| 패널 헤더 표시 | bool | 패널 상단 이름/상태 표시 |
| 언어 | enum |
한국어 / English
|
| 설정 | 종류 | 설명 |
|---|---|---|
| 마우스 | bool | 마우스 조작 사용 |
| 복사 모드 키 | enum |
vi / emacs 키맵 |
| 휠 스크롤백 | bool | alt 화면에서 휠로 스크롤백 |
| prefix 키 | str | prefix 키 조합(기본 Ctrl-b) |
| 붙여넣기 테두리 제거 | bool | OS 네이티브 선택으로 복사할 때 딸려온 패널 테두리(박스드로잉 ─│├┤ 등)를 붙여넣기 단계에서 제거(기본 ON, #붙여넣기-테두리-정화) |
| 설정 | 종류 | 설명 |
|---|---|---|
| 새 패널 시작 경로 | str | 새 패널의 작업 디렉토리 |
| 터미널 제목 설정 | bool | OSC 제목을 창 제목에 반영 |
| 상태줄 갱신 주기(초) | int | 상태줄 갱신 간격(1–60) |
| 탭 자동 이름 | bool | 활성 프로그램으로 탭 이름 자동 |
| 활동/벨 모니터 | bool | 비활성 탭의 활동·벨 표시 |
| 패널 동기화 | bool | 입력을 모든 패널에 동시 전송 |
| 리페인트 병합 | bool | 출력 폭증 시 리페인트 병합 |
| 중첩 자동 어태치 | bool | 중첩 세션 자동 승격 |
| Windows 마우스 모션 | bool | Windows 에서 마우스 any-motion 패스스루(기본 off — ConPTY 마우스 리포트 누출 방지) |
| VT 파서 | enum |
pyte / native (재시작 시 발효) |
| 설정 | 종류 | 설명 |
|---|---|---|
| status-left / status-right | str | 좌/우 상태줄 포맷 문자열 |
| status-bg / status-fg | str | 상태줄 배경/전경 색 |
Enter/클릭으로 전용 화면을 엽니다.
- Claude: 토큰 절감 설정(token-saver) · 모델 선택 · 시작 규칙(claude-rules) · 토큰 로그 → 자세한 내용은 Claude-Code-Plugins
- 고급: 플러그인 관리(plugins) · 키 바인딩 목록(list-keys)
키 탭은 ESC 모드·prefix 모드의 내장 키와 사용자 바인딩을 읽기 전용 레퍼런스로
보여 줍니다(여기서는 값을 바꾸지 않습니다). 전체 키 목록은 User-Manual의 키 바인딩
레퍼런스를 참고하세요.
OS(터미널 에뮬레이터) 네이티브 마우스 드래그로 pytmux 화면을 복사하면, 패널 좌/우
경계의 박스드로잉 문자(│ ├ ┤ ─ 등)와 가로 구분선이 클립보드에 함께 섞여 코드
붙여넣기가 깨집니다. 붙여넣기 테두리 제거(strip-box-drawing, 입력 탭, 기본 ON)는
pytmux 의 붙여넣기(Ctrl+V/paste-clipboard) 경로에서 각 줄 앞·뒤에 붙은 박스드로잉 런만
타깃 제거하고, 테두리/구분선 전용 줄은 버립니다.
- 줄 내부의 박스드로잉(markdown 표·아트)·원래 빈 줄·ASCII 파이프(
|)·들여쓰기는 보존하므로 일반 텍스트 붙여넣기에는 안전합니다(박스드로잉이 없으면 무동작). - 터미널 bracketed paste(예: 의도적 표 붙여넣기)는 보존을 위해 필터를 적용하지 않습니다.
- 토글:
settings→ 입력 → "붙여넣기 테두리 제거", 또는 명령strip-box-drawing on|off. - 한계: 비활성 패널 텍스트 혼입(출처 패널 가로 범위 필요)은 붙여넣기 경로에서 잘라낼 수 없어, pytmux 자체 선택(복사 모드)으로 처리합니다.
- User-Manual — 전체 사용법·키 바인딩·명령 레퍼런스
- Claude-Code-Plugins — Claude 관련 링크 항목의 전용 화면들
-
Plugin-System —
plugins링크가 여는 플러그인 관리