# Black Glass — 선택형 사용자 스킨

검정 터미널 배경에 옅은 초록 강조색과 밝은 글자를 더한 gdmux·gid 스킨입니다.
처음 설치할 때의 기본 테마는 Tokyo Night이며, 이 스킨은 원하는 경우에만 적용합니다.

설정은 사용자별로 적용합니다. 먼저 기존 설정 파일을 백업하고 필요한 항목만 합치세요.
아래 경로는 별도의 설정 경로 환경 변수를 지정하지 않은 경우입니다.

## gid

1. [gid.json](./gid.json)을 받아 `~/.config/gid/themes/black-glass.json`으로 저장합니다. 폴더가 없으면 만드세요.
2. `~/.config/gid/config.json`의 `ui.theme` 값을 `black-glass`로 지정합니다. 다른 설정과 `ui` 안의 다른 값은 남깁니다.

아래는 해당 항목만 보여주는 예시이며, 기존 파일 전체를 대체하는 용도가 아닙니다.

```json
{
  "ui": { "theme": "black-glass" }
}
```

다음 실행부터 적용됩니다. 실행 중에는 `/reload`로 설정을 다시 읽을 수 있습니다.
실행 중 적용하고 개인 기본값으로 저장하려면 테마 파일을 저장한 뒤 `/theme black-glass`를 실행하세요.
프로젝트의 `.gid/settings.json`에 지정한 테마는 개인 설정보다 우선합니다.

## gdmux

1. [gdmux.toml](./gdmux.toml)을 받습니다.
2. `~/.config/gdmux/config.toml`의 `[theme]`와 `[theme.colors]`에 다운로드한 값을 합칩니다. 기존 테마 항목은 교체하되 다른 설정은 남깁니다. 같은 섹션을 두 번 만들지 마세요.
3. gdmux 화면을 다시 엽니다. 테마 적용을 위해 실행 중인 작업이나 세션 관리 프로그램을 종료할 필요는 없습니다.

`--theme` 옵션이나 `GDMUX_THEME` 환경 변수를 지정하면 파일의 사용자 색상 대신 해당 기본 테마가 적용됩니다.
gdmux 안에서 실행하는 셸·에디터의 자체 색상은 별도로 설정합니다.

## 반투명 배경

gid의 `canvas = default`, gdmux의 `background = terminal`은 터미널 배경을 사용한다는 뜻입니다.
스킨이 터미널 설정을 자동으로 바꾸지는 않습니다. 투명도를 지원하는 터미널에서 직접 설정하세요.

Ghostty의 검정 반투명 배경 설정 예시:

```ini
background = 000000
background-opacity = 0.7
background-blur = true
```

기존 Ghostty 설정의 해당 값만 바꾸고 설정을 다시 읽으세요.
바탕은 반투명해지지만 글자를 읽는 패널은 불투명한 어두운 색상을 유지합니다.
macOS 네이티브 전체 화면에서는 배경이 불투명하게 보일 수 있습니다.
배경 화면과 터미널 설정에 따라 색감과 가독성이 달라집니다.

소개 페이지의 대표 화면은 기본 Tokyo Night 테마를 사용합니다.
Black Glass는 개인 설정 예시이며, [gdmux 예시](../../brand/gdmux-canvas-20261008.png)와
[gid 예시](../../brand/gid-review-20261008.png)를 별도로 볼 수 있습니다.
이 두 스킨 예시는 실제 터미널 출력에 합성 배경을 적용한 이미지로, macOS 화면을 그대로 캡처한 이미지는 아닙니다.

## 원래 테마로 돌아가기

- gid: 개인 설정의 `ui.theme`를 `tokyo-night`으로 변경합니다. 실행 중인 대화에서는 `/theme tokyo-night`을 사용합니다. 프로젝트별 테마도 확인하세요.
- gdmux: `[theme]`의 `name`을 `tokyo-night`으로 바꾸고 Black Glass용 `[theme.colors]` 색상 항목을 제거한 뒤 화면을 다시 엽니다. 다른 설정은 남깁니다.
- 터미널: 스킨과 별개이므로 Ghostty의 배경·투명도 설정은 따로 원래 값으로 돌립니다.

색상 파일에는 계정 정보, 개인 경로, 대화 기록이 포함되어 있지 않습니다.