설정 파일
pytmux.conf 로 동작을 바꾸거나, 통합 설정 팝업 :settings 로 카테고리별로
조정합니다. :settings 에서 바꾼 파일 설정은 설정 파일에 자동으로 되쓰기 되고
(주석·바인딩 보존), 서버 옵션(window-size·vt-parser·
automatic-rename 등)은 서버가 opts.json 에 영속합니다 — 어느 쪽이든 다시 켤 때 유지됩니다.
설정 파일 위치와 형식
설정 파일은 ~/.config/pytmux/config, ~/.pytmux.conf, 또는 환경변수
PYTMUX_CONFIG 로 지정한 경로에서 읽습니다(pytmux.conf.example 참고).
여러 곳에 있으면 PYTMUX_CONFIG → $PYTMUX_HOME/config →
~/.config/pytmux/config → ~/.pytmux.conf 순으로 먼저 있는 하나만 씁니다.
각 줄은 set <이름> <값> 형식이고, source-file 로 다시 읽습니다.
현재 값은 show-options 로 확인합니다.
실행 중에 바꿀 때는 명령 프롬프트에서 set 을 빼고
옵션 이름을 그대로 칩니다(예: :strip-box-drawing off, :lang en) —
:set … 이 먹는 것은 mouse·prefix·mode-keys 처럼
일부뿐이라, 가장 확실한 방법은 설정 팝업(:settings)에서
고르는 것입니다.
자주 쓰는 옵션
| 설정 | 값 (기본) | 설명 |
|---|---|---|
prefix | C-a 등 (C-b) | prefix 키 |
mouse | on|off (on) | 마우스 on/off |
mouse-drag-copy | on|off (on) | 좌드래그로 선택→클립보드 자동 복사(off=앱에 전달) |
alt-scroll | on|off (on) | on=pytmux 가 휠 스크롤백 처리 / off=터미널 기본 |
mode-keys | vi|emacs (vi) | 복사/스크롤 모드 키 스타일 |
ambiguous-width | auto|narrow|wide (auto) | CJK 모호폭 셀 크기(단말 자동 감지) |
tab-bar | always|auto (always) | 상단 탭바: 항상 / 2개 이상일 때만 |
default-path | current|home|<경로> (current) | 새 탭/패널 시작 디렉토리 |
strip-box-drawing | on|off (on) | 붙여넣기 시 패널 테두리(박스드로잉) 제거 |
inactive-dim | on|off (on) | 비활성 패널 흐리게 |
inactive-dim-ratio | 0.0–0.8 (0.18) | 흐림 강도 |
language | ko|en (LANG) | UI 언어 |
상태줄 · 화면
| 설정 | 값 | 설명 |
|---|---|---|
status | on|off|0–5 | 상태줄 줄 수 |
status-position | bottom|top | 상태줄 위치 |
status-left / status-right | 포맷 문자열 | #S·#h·#{pane_title}·strftime 등 |
status-interval | 1–60 | 상태줄 갱신 주기(초) |
status-bg / status-fg | 색 | 상태줄 배경/전경색 |
set-titles / set-titles-string | on|off / 포맷 | 터미널 창 제목 설정 |
single-border | on|off|toggle | 패널이 하나일 때도 테두리 |
pane-border-status | on|top|off | 패널 테두리 제목줄 |
동작 · 고급
| 설정 | 값 | 설명 |
|---|---|---|
automatic-rename | on|off | 실행 앱으로 탭 자동 명명 |
monitor-activity / monitor-bell | on|off | 비활성 탭 활동/벨 감지 |
synchronize-panes | on|off | 패널 입력 동기화 |
coalesce-repaints | on|off|toggle | ssh 반응성: 전체 리페인트 병합 |
nest-auto-attach | on|off|toggle | 중첩 pytmux 시 자동 remote-attach |
win-mouse-motion | on|off|toggle (off) | Windows 마우스 이동 전달 |
vt-parser | pyte|native | VT 파서 백엔드(재시작 후 적용) |
window-size | smallest|latest|largest (smallest) | 여러 클라이언트가 한 세션을 볼 때 공유 격자 크기 기준(10장) |
net_rtt_threshold | 초 (0.4) | 응답성 저하 판정 문턱(파일 전용) |
pytmux.conf 예시
아래 줄을 그대로 복사해 붙여넣으면 됩니다. 키 바인딩도 함께 둘 수 있습니다.
통합 설정 팝업 · 언어
:settings(별칭 config·preferences)는 옵션을
표시 · 입력 · 동작 · 상태줄 · 고급 · 키 카테고리(+ 플러그인의 Claude 카테고리)로
묶어 보여 줍니다. 여기서 바꾼 값은 파일 설정이면 설정 파일에, 서버 옵션이면 서버 opts.json 에
각각 자동 반영됩니다. UI 언어는 lang ko|en
(별칭 language)으로 즉시 바꾸며, 선택은 클라이언트에 저장됩니다.
:settings) — 카테고리별 조정.