ned.cam

Mac에서 연결된 카메라 영상을 미니멀한 윈도로 보여주는 앱

ned.cam은 Mac에 연결된 카메라(내장 카메라, 외장 웹캠, Continuity Camera 등) 중 하나를 선택해 실시간 영상을 표시하는 macOS 앱입니다.

프레젠테이션, 화상회의 세팅 점검, 촬영 구도 확인처럼 "내 카메라 화면만 빠르게 띄우고 싶은" 상황에 맞춰 설계되었습니다.

주요 기능

• 연결 가능한 비디오 입력 디바이스 자동 탐색 및 목록 표시
• 메뉴에서 카메라 장치 즉시 전환
• 크기 조절 가능한 미니멀 윈도(타이틀바/기본 버튼 숨김)
• 윈도 내부 어느 영역에서든 드래그 이동 가능
• Always on Top 토글로 다른 앱 위 고정 표시 지원
• 비디오 프리뷰를 창에 가득 채우는 resizeAspectFill 렌더링

기술 스택

• SwiftUI (App, WindowGroup, CommandMenu)
• AVFoundation (AVCaptureSession, AVCaptureDevice, AVCaptureVideoPreviewLayer)
• AppKit 연동 (NSViewRepresentable, 윈도 레벨/스타일 제어)

Requirements

• Xcode: 26.3+
• macOS: 26.0+

시작하기

1. 저장소를 클론합니다.

   git clone https://github.com/nedpark/ned.cam.git
   cd ned.cam

2. Xcode에서 프로젝트를 엽니다.
   • NedCam/NedCam.xcodeproj
3. 실행 대상(내 Mac)을 선택하고 실행합니다.

첫 실행 시 macOS 카메라 접근 권한 요청이 표시되며, 허용해야 영상이 표시됩니다.

사용 방법

1. 앱 실행 후 카메라 영상이 윈도에 표시됩니다.
2. 상단 메뉴 Cameras에서 원하는 입력 장치를 선택합니다.
3. 상단 메뉴 Window의 Always on Top으로 윈도 고정을 토글합니다.
4. 윈도 내부를 드래그해 위치를 옮기고, 가장자리를 드래그해 크기를 조절합니다.

프로젝트 구조

NedCam/
  NedCam/
		CameraManager.swift      # 카메라 권한/디바이스 탐색/입력 전환
		CameraPreview.swift      # AVCaptureVideoPreviewLayer 기반 프리뷰
		ContentView.swift        # 메인 뷰 구성
		WindowAccessor.swift     # NSWindow 스타일/동작 제어
		WindowStateManager.swift # Always on Top 상태 관리
		NedCamApp.swift          # 앱 엔트리 및 메뉴 구성

현재 구현 상태

• 카메라 권한 요청 및 기본 디바이스 자동 선택
• 메뉴 기반 카메라 전환
• Always on Top 토글
• 창 내부 드래그 이동
• 단축키 설정
• 선택 장치 영구 저장

Credits

• Ned Park

License

Licensed under the MIT license.