post

Author: jayychoi

posts/etc/layer-keymapping.md

@@ -0,0 +1,6 @@
+키가 부족해서 오른쪽 option, shift를 레이어 키로 쓰기로 함. via는 안쓰고 맥북에서도 동일한 레이아웃을 원하기 때문에 karabiner로 탭 기능 구현.
+
+맥북 쓸 때는 f19, f20을 썼는데, f키는 모디파이어가 아니라서 홀드해도 홀드 상태로 인식되지 않고, 반복 입력이 발생함.
+그래서 조합을 할 수 없었음.
+
+그런데! 오늘 karabiner-eventviewer로 다시 해보니 f20-f24는 반복 입력이 없었음. 바로 시도 ㄱㄱ

posts/etc/macos-korean-nfd.md

@@ -0,0 +1,99 @@
+---
+title: "macOS에서 한글 파일명이 깨지는 이유(NFD)"
+slug: macos-korean-nfd
+created: 2026-02-07
+category: etc
+type: [til]
+tags: []
+---
+
+## 증상
+
+macOS에서 만든 한글 파일명이 Windows나 Linux, 또는 일부 프로그램에서 자모가 분리되어 보이는 현상이 있다.
+예를 들어 `김범수 - 지나간다.opus`가 `ㄱㅣㅁㅂㅓㅁㅅㅜ - ㅈㅣㄴㅏㄱㅏㄴㄷㅏ.opus`처럼 풀어져서 표시된다.
+
+맥의 Finder에서 파일명을 한글로 변경했을 때 이런 현상이 발생하고, 터미널에서 `ls`로 출력해보면 글자가 깨져서 나온다.
+터미널에서 `mv`로 변경했을 때는 발생하지 않았다. 
+
+## 원인: 유니코드 정규화 (NFC vs NFD)
+
+유니코드는 같은 글자를 표현하는 두 가지 방식을 정의하고 있다.
+
+### NFC (Normalization Form Composed) — 완성형
+
+한글을 **완성된 한 글자**로 저장하는 방식이다.
+
+```
+"한" = U+D55C (1개의 코드 포인트)
+```
+
+Windows, Linux 등 대부분의 시스템이 이 방식을 사용한다.
+
+### NFD (Normalization Form Decomposed) — 분해형
+
+한글을 **초성 + 중성 + 종성**으로 분해하여 저장하는 방식이다.
+
+```
+"한" = ㅎ(U+1112) + ㅏ(U+1161) + ㄴ(U+11AB) (3개의 코드 포인트)
+```
+
+macOS의 파일시스템(APFS, HFS+)이 이 방식을 사용한다.
+
+### 비교
+
+| | NFC (완성형) | NFD (분해형) |
+|---|---|---|
+| `한` 저장 방식 | `U+D55C` (1개) | `U+1112 U+1161 U+11AB` (3개) |
+| 사용 환경 | Windows, Linux | macOS |
+| 눈에 보이는 차이 | 없음 (같은 글자로 렌더링) | 없음 (같은 글자로 렌더링) |
+| 바이트 수 | 적다 | 많다 |
+
+눈으로 보기에 같은 글자이지만 내부적으로 다른 바이트 시퀀스이기 때문에, NFD를 지원하지 않는 환경에서는 자모가 풀어져서 보이게 된다.
+
+## 확인 방법
+
+Python으로 파일명의 정규화 형태를 확인할 수 있다.
+
+```python
+import os, unicodedata
+
+for f in os.listdir('/path/to/dir'):
+    is_nfc = unicodedata.is_normalized('NFC', f)
+    print(f'NFC={is_nfc}  {f}')
+```
+
+macOS에서 생성한 한글 파일명은 대부분 `NFC=False`로 표시된다.
+
+## 해결 방법
+
+NFD로 저장된 파일명을 NFC로 변환하면 된다.
+
+### Python (macOS 기본 설치)
+
+```bash
+python3 -c "
+import os, unicodedata
+path = '/path/to/dir'
+for f in os.listdir(path):
+    nfc = unicodedata.normalize('NFC', f)
+    if f != nfc:
+        os.rename(os.path.join(path, f), os.path.join(path, nfc))
+        print('변환:', nfc)
+"
+```
+
+### convmv (전용 도구)
+
+```bash
+# 설치
+brew install convmv
+
+# 미리보기 (실제 변환하지 않음)
+convmv -f utf8 -t utf8 --nfc /path/to/dir/*
+
+# 실제 변환
+convmv -f utf8 -t utf8 --nfc --notest /path/to/dir/*
+```
+
+Python은 macOS에 기본 포함되어 있어서 별도 설치 없이 바로 사용할 수 있다.
+convmv는 Homebrew 설치가 필요하지만 명령어가 더 간결하다.

posts/etc/tmux-musikcube-popup.md

@@ -0,0 +1,71 @@
+---
+title: "tmux에서 플로팅 팝업으로 별도 세션 사용하기"
+slug: tmux-musikcube-popup
+created: 2026-02-07
+category: etc
+type: [til]
+tags: []
+---
+
+## 목표
+
+tmux 작업 중 어디서든 단축키 하나로 musikcube를 플로팅 팝업으로 열고, 음악을 재생한 상태로 팝업을 닫을 수 있도록 설정하는 것이다.
+
+## display-popup
+
+tmux 3.2부터 `display-popup` 명령이 추가되었다. 현재 창 위에 플로팅 윈도우를 띄우는 기능이다.
+
+```bash
+# 기본 사용법
+tmux display-popup -w 80% -h 80% "명령어"
+```
+
+주요 옵션은 다음과 같다.
+
+| 옵션 | 설명 |
+|------|------|
+| `-w`, `-h` | 팝업 너비, 높이 (퍼센트 또는 절대값) |
+| `-E` | 명령이 종료되면 팝업도 닫힘 |
+| `-d` | 팝업의 작업 디렉토리 지정 |
+
+## 단순한 방법 (문제 있음)
+
+가장 직관적인 설정은 다음과 같다.
+
+```bash
+# tmux.conf
+bind-key m display-popup -E -w 80% -h 80% "musikcube"
+```
+
+이 방법은 팝업이 잘 열리지만, **팝업을 닫으면 musikcube 프로세스도 함께 종료**된다.
+`display-popup`은 내부에서 실행 중인 프로세스의 생명주기를 관리하기 때문에, 팝업을 닫는 순간 musikcube에 SIGHUP이 전달되어 종료되는 것이다.
+
+음악을 재생한 상태로 팝업만 닫으려면 다른 접근이 필요하다.
+
+## 해결: 별도 tmux 서버 사용
+
+musikcube를 **별도의 tmux 서버**에서 실행하고, 팝업은 그 세션에 attach/detach만 하는 것이다.
+
+```bash
+# tmux.conf
+bind-key m display-popup -E -w 80% -h 80% "tmux -L Music new-session -A -s Music 'musikcube'"
+```
+
+### 동작 방식
+
+1. `tmux -L Music` — `Music`이라는 이름의 **별도 소켓**으로 독립된 tmux 서버를 실행한다
+2. `new-session -A -s Music` — `Music` 세션이 있으면 attach, 없으면 새로 생성한다
+3. `'musikcube'` — 해당 세션에서 musikcube를 실행한다
+4. `-E` — 팝업 내 명령(attach)이 종료되면 팝업을 닫는다
+
+### 사용법
+
+| 동작 | 키 |
+|------|-----|
+| 팝업 열기 | `prefix` → `m` |
+| 팝업 닫기 (음악 유지) | `prefix` → `d` |
+| 다시 열기 | `prefix` → `m` |
+
+팝업 안에서 `prefix + d`를 누르면 별도 서버의 세션에서 detach되면서 팝업이 닫힌다.
+musikcube는 별도 서버에서 계속 실행 중이므로 음악이 끊기지 않는다.
+다시 `prefix + m`을 누르면 `-A` 플래그 덕분에 기존 세션에 재접속된다.

posts/etc/tmux-server-socket.md

@@ -0,0 +1,152 @@
+---
+title: "tmux 서버와 소켓 구조"
+slug: tmux-server-socket
+created: 2026-02-07
+category: etc
+type: [til]
+tags: []
+---
+
+## tmux의 서버-클라이언트 구조
+
+tmux는 단순한 터미널 멀티플렉서처럼 보이지만, 내부적으로는 **서버-클라이언트 구조**로 동작한다.
+
+```
+터미널 (클라이언트) ──소켓──▶ tmux 서버 ─┬─ session A ─┬─ window 1 ─┬─ pane 1
+                                         │             │             └─ pane 2
+                                         │             └─ window 2 ─── pane 1
+                                         └─ session B ─── window 1 ─── pane 1
+```
+
+- **서버**: 모든 세션, 윈도우, 팬을 관리하는 백그라운드 프로세스이다. 세션 안에서 실행되는 모든 프로그램의 생명주기를 서버가 관리한다.
+- **클라이언트**: 터미널이 서버에 접속하여 화면을 렌더링하는 역할이다. `tmux attach`로 접속하고 `tmux detach`로 빠져나온다.
+
+이 구조 덕분에 터미널을 닫아도(클라이언트 종료) 서버에서 실행 중인 프로세스는 계속 살아있는 것이다.
+SSH 세션이 끊어져도 작업이 유지되는 이유이기도 하다.
+
+## 유닉스 소켓을 통한 통신
+
+서버와 클라이언트는 **유닉스 도메인 소켓**(Unix Domain Socket)을 통해 통신한다.
+유닉스 소켓은 같은 시스템 내에서 프로세스 간 통신(IPC)을 하기 위한 메커니즘으로, 파일시스템에 소켓 파일 형태로 존재한다.
+
+소켓 파일은 `/tmp/tmux-{UID}/` 디렉토리에 위치한다.
+
+```bash
+$ ls -la /tmp/tmux-501/
+srwxrwx--- jay wheel 0 B default
+```
+
+`s`로 시작하는 파일 타입이 소켓 파일이다.
+`tmux`를 처음 실행하면 `default`라는 이름의 소켓 파일이 생성되고, 이후 모든 `tmux` 명령은 이 소켓을 통해 서버와 통신한다.
+
+```bash
+# 아래 두 명령은 동일하다
+tmux new-session -s work
+tmux -L default new-session -s work
+```
+
+`-L` 옵션을 생략하면 자동으로 `default` 소켓을 사용하는 것이다.
+
+## -L 옵션: 별도 서버 실행
+
+`-L` 옵션은 소켓 이름을 지정한다. 소켓이 다르면 **완전히 독립된 별도 서버**가 실행된다.
+
+```bash
+# 기본 서버 (소켓: default)
+tmux new-session -s work
+
+# 별도 서버 (소켓: Music)
+tmux -L Music new-session -s Music
+```
+
+이렇게 하면 소켓이 두 개가 된다.
+
+```bash
+$ ls /tmp/tmux-501/
+default    # 기본 서버
+Music      # 별도 서버
+```
+
+각 소켓은 독립된 서버 프로세스를 가지며, 서로 완전히 격리되어 있다.
+
+### 독립되는 것들
+
+**설정 독립**
+
+각 서버는 자체 설정을 가진다.
+기본 서버에서 prefix를 `Ctrl+a`로 바꿨더라도, `-L Music`으로 띄운 서버는 기본값인 `Ctrl+b`를 사용한다.
+별도 서버에 다른 설정을 적용하고 싶다면 `-f` 옵션으로 설정 파일을 지정하면 된다.
+
+```bash
+tmux -L Music -f ~/.config/tmux/music.conf new-session -s Music
+```
+
+**세션 독립**
+
+`tmux ls`는 기본 서버의 세션만 보여준다.
+별도 서버의 세션을 확인하려면 `-L` 옵션을 명시해야 한다.
+
+```bash
+# 기본 서버 세션 목록
+tmux ls
+
+# Music 서버 세션 목록
+tmux -L Music ls
+```
+
+**프로세스 독립**
+
+서버가 다르면 프로세스도 완전히 분리된다.
+기본 서버를 `tmux kill-server`로 종료해도 Music 서버는 영향받지 않는다.
+
+```bash
+# 기본 서버만 종료 (Music 서버는 살아있음)
+tmux kill-server
+
+# Music 서버 종료
+tmux -L Music kill-server
+```
+
+## -S 옵션: 소켓 경로 직접 지정
+
+`-L`은 소켓 **이름**을 지정하며 파일은 `/tmp/tmux-{UID}/` 아래에 생성된다.
+소켓 파일의 **전체 경로**를 직접 지정하고 싶다면 `-S` 옵션을 사용한다.
+
+```bash
+tmux -S /var/run/tmux/my-server new-session
+```
+
+`-L`과 `-S`의 차이는 다음과 같다.
+
+| 옵션 | 소켓 경로 | 예시 |
+|------|----------|------|
+| `-L Music` | `/tmp/tmux-{UID}/Music` | 이름만 지정 |
+| `-S /path/to/sock` | `/path/to/sock` | 전체 경로 지정 |
+
+일반적인 용도에서는 `-L`만으로 충분하다.
+
+## 활용 예시
+
+별도 서버가 유용한 상황은 다음과 같다.
+
+**설정 충돌 방지**
+
+tmux 팝업(`display-popup`) 안에서 tmux 세션을 사용할 때, 별도 서버를 사용하면 prefix 키가 충돌하지 않는다.
+
+```bash
+# tmux.conf (prefix: Ctrl+a)
+bind-key m display-popup -E -w 80% -h 80% "tmux -L Music new-session -A -s Music 'musikcube'"
+# 팝업 안의 Music 서버는 prefix가 Ctrl+b이므로 충돌 없음
+```
+
+**격리된 환경 구성**
+
+특정 프로젝트나 용도별로 서버를 완전히 분리할 수 있다.
+
+```bash
+# 개발용 서버
+tmux -L dev new-session -s project
+
+# 모니터링 전용 서버 (다른 설정 파일 사용)
+tmux -L monitor -f ~/.config/tmux/monitor.conf new-session -s logs
+```