문서 / 문제 해결

문제 해결

문제가 생겼나요? 아래에서 가장 흔한 문제의 해결 방법을 찾아보세요. 카드마다 특정 증상과 해결 방법을 다룹니다.

권한

“BetterStage가 윈도우를 제어하지 못해요”

BetterStage가 윈도우를 읽고 이동하려면 손쉬운 사용 권한이 필요합니다. 시스템 설정 > 개인정보 보호 및 보안 > 손쉬운 사용을 열고 BetterStage가 목록에 있고 켜져 있는지 확인하세요. 이미 켜져 있었다면 껐다가 다시 켜 보세요. 권한을 변경한 후에는 BetterStage를 다시 시작하세요. BetterStage가 실행 중일 때 권한이 취소되면 앱이 이를 알리고, 숨겨진 윈도우를 화면 밖에 그대로 두지 않고 복원합니다. 이제 손쉬운 사용 권한을 취소해도 BetterStage가 키보드나 마우스 입력을 붙잡고 있지 않습니다. 권한을 다시 허용해도 진행 중인 저장된 워크스페이스, 연속성, 깨우기 복원은 중단되지 않습니다.

“단축키가 작동하지 않아요”

BetterStage는 키보드 단축키에 기본 Carbon 단축키 API를 사용하므로 입력 모니터링 권한이 필요 없습니다. 단축키가 작동하지 않으면 먼저 손쉬운 사용 권한이 켜져 있는지 확인하세요. 다른 앱이 같은 키 조합, 마우스 버튼, 트랙패드 제스처를 사용하고 있지 않은지도 확인하세요. 단축키가 충돌하면 BetterStage가 이벤트를 받지 못합니다. 키보드, 마우스, 트랙패드 조작은 설정 > 단축키에서 다시 지정할 수 있습니다.

“윈도우가 감지되지 않아요”

윈도우 감지에는 macOS 손쉬운 사용 API를 사용하며, 이는 손쉬운 사용 권한에 포함됩니다. 시스템 설정 > 개인정보 보호 및 보안 > 손쉬운 사용에서 권한이 켜져 있는지 확인하세요. 일부 앱은 손쉬운 사용 API로 감지되지 않을 수 있는 비표준 윈도우 유형(플로팅 패널, 사용자화된 Chrome 윈도우 등)을 사용한다는 점에 유의하세요.

윈도우 동작

“macOS 스테이지 매니저와 BetterStage를 함께 써도 되나요?”

아니요. BetterStage를 사용하기 전에 Apple의 내장 스테이지 매니저를 끄세요. 두 도구 모두 윈도우 표시 여부를 관리하므로, 함께 사용하면 혼란스러운 전환, 숨겨진 윈도우, 엉뚱한 위치에 나타나는 윈도우 같은 문제가 생길 수 있습니다. 시스템 설정 > 데스크탑 및 Dock > 스테이지 매니저를 열어 스테이지 매니저를 끄고, 작업 공간이 여전히 이상해 보이면 BetterStage를 다시 실행하세요.

“Firefox/Chrome 윈도우가 즉시 스냅되지 않고 애니메이션으로 움직여요”

일부 브라우저(Firefox, Chrome 및 Electron 기반 앱)는 AXEnhancedUserInterface라는 손쉬운 사용 플래그를 켜는데, 이 때문에 윈도우가 즉시 스냅되지 않고 애니메이션으로 이동합니다. BetterStage는 해당 앱에서 이 플래그를 자동으로 감지해 끕니다. 그래도 애니메이션이 보이면 브라우저를 종료했다가 다시 열어 BetterStage가 수정 사항을 다시 적용하게 하세요.

“Firefox 윈도우가 깜박이거나, 원하는 위치에 놓이지 않거나, 스테이지 전환보다 늦게 따라와요”

Firefox는 윈도우를 비표준 방식으로 처리하기 때문에 윈도우 관리와 항상 잘 맞지는 않습니다. 윈도우가 잠깐 깜박이거나, 정확한 위치에 놓이지 않거나, 스테이지 전환보다 늦게 따라올 수 있습니다. 알려진 문제이며 Firefox 호환성을 계속 개선하고 있습니다.

“빈 스테이지로 전환하면 Finder가 나타나요”

macOS는 전면 앱에 보이는 윈도우가 없을 때 Finder를 활성화할 수 있습니다. BetterStage 2.2.0은 앱 전체를 가리는 대신 개별 윈도우를 비공개 Space에 숨깁니다. 빈 스테이지에 윈도우가 예기치 않게 나타나면, 앱 이름과 그 현상을 일으킨 스테이지 또는 데스크탑 전환 순서를 알려 주세요.

“잠자기나 화면 보호기 후에 윈도우가 엉뚱한 스테이지로 옮겨졌어요”

디스플레이 배치가 안정될 때까지 기다리세요. 기억된 디스플레이의 레이아웃은 저절로 돌아오며, 복구 안내가 나타나면 워크스페이스 복원 또는 현재 레이아웃 유지를 선택하세요. 데스크탑이 제거된 후에도 숨겨진 채로 남아 있거나 디스플레이 변경 후 화면 밖으로 나간 윈도우는 메뉴 막대에서 윈도우 긴급 복구를 사용하세요. BetterStage가 macOS Spaces를 사용할 수 없다고 알리면 데스크탑 전환을 마치고 다시 시도를 선택하세요. 문제가 계속되면 BetterStage를 다시 시작하세요.

“대화상자나 플로팅 윈도우가 TabStack 뒤에 갇혔어요”

스냅 휠을 열고 추가 동작에서 플로팅 항목 앞으로 가져오기를 선택하세요. 레이아웃을 바꾸거나 숨겨진 탭을 드러내지 않고 이 모니터의 플로팅 및 추적되지 않은 윈도우를 앞으로 가져옵니다. 윈도우 긴급 복구는 원래 데스크탑이 제거된 윈도우를 포함해 BetterStage가 비공개 Spaces에 숨긴 윈도우도 복구합니다.

“충돌 후 윈도우가 사라졌어요”

BetterStage는 비공개 Spaces로 옮긴 윈도우를 기록하고 별도의 복구 도우미를 실행합니다. BetterStage가 예기치 않게 종료되면 도우미가 이 기록을 사용해 숨겨진 윈도우를 저장된 데스크탑으로 되돌립니다. 그래도 윈도우가 없다면 BetterStage를 다시 실행하고 윈도우 긴급 복구를 사용하세요. 데스크탑이 제거되었거나 디스플레이 연결이 끊긴 경우에는 접근 가능한 대체 대상이 필요할 수 있습니다.

앱 구성

“터미널에서 실행할 때와 .app 번들로 실행할 때의 차이”

터미널에서 swift run으로 BetterStage를 실행하면, macOS는 손쉬운 사용 권한을 BetterStage가 아니라 터미널 앱에 부여합니다. 시스템 설정에 BetterStage가 이름으로 표시되도록 권한을 올바르게 처리하려면 .app 번들을 빌드해서 실행하세요.

“스테이지 막대가 나타나지 않아요”

스테이지 막대는 핫 에지(커서를 화면 맨 위로 이동)나 키보드 단축키 Opt+Up Arrow로 열 수 있습니다. 설정에서 핫 에지가 켜져 있는지 확인하세요. 그래도 스테이지 막대가 나타나지 않으면 BetterStage에 필요한 손쉬운 사용 권한이 있는지 확인하세요.

노치가 있는 Mac 내장 디스플레이에서는 설정 > 스테이지 > 스테이지 막대 > 디스플레이 노치 피하기를 사용하면 위쪽 가장자리의 나머지 부분은 활성 상태로 두고 노치 부분만 제외할 수 있습니다.

“다시 연결한 모니터가 인식되지 않아요”

BetterStage는 macOS가 할당하는 디스플레이 ID뿐 아니라 모델명과 일련번호 같은 하드웨어 정보로 모니터를 인식합니다. 드물게 드라이버 업데이트 후나 다른 포트 또는 어댑터를 사용할 때 이 정보가 바뀔 수 있습니다. 모니터 연결을 해제했다가 다시 연결한 다음 BetterStage를 다시 시작해 보세요. 그래도 모니터가 인식되지 않으면 설정 > 디스플레이에서 다시 구성하세요.

“⌘Tab을 누르면 여전히 macOS 앱 전환기가 나타나요”

BetterStage ⌘Tab 전환기는 선택 기능이며 기본적으로 꺼져 있습니다. 설정 > ⌘Tab 전환기에서 BetterStage ⌘Tab 사용을 켜고, Pro, 체험 또는 일일 Pro 미리 체험이 활성 상태인지 확인하세요. 미리보기가 없으면 앱 아이콘이 표시되며, 실시간 축소판을 보려면 화면 기록을 허용하세요. ⌘Tab 전환기 가이드를 참고하세요.

“2.0.x로 되돌린 후 스테이지가 불러와지지 않아요”

BetterStage 2.2에서 저장한 스테이지는 이전 버전에서 열 수 없습니다. 2.0.x를 다시 설치했다면 스테이지가 불러와지지 않으니, 대신 다운로드 페이지에서 최신 버전으로 업데이트하세요.

버그 신고하기

BetterStage는 디스크를 가득 채우지 않도록 최대 10MB로 제한된 순환 진단 로그를 유지합니다. 버그 신고에 첨부하려면 BetterStage 메뉴 막대 아이콘을 열고 Reveal Diagnostic Log…를 선택하세요. Finder에서 로그 파일이 열리므로 Discord 메시지, GitHub 이슈 또는 이메일로 드래그하면 됩니다.

릴리스 빌드는 윈도우 제목이 기록될 수 있는 상세 로깅을 하지 않습니다. 문제를 재현하면서 더 자세한 기록이 필요하다면 베타나 릴리스 후보 빌드를 실행해 로그를 수집한 다음, 이후에 릴리스 채널로 돌아가세요.

아직 도움이 필요하신가요?

위에서 다루지 않은 문제라면 연락해 주세요. 문제가 해결되도록 도와드리겠습니다.