첫 실행부터 최종 내보내기까지 Luxel을 사용하는 방법입니다.

Luxel 설치

1. Luxel을 설치하고 실행합니다.
2. 권한을 부여하기 전에 앱을 일정한 위치에 두십시오.
3. Finder 또는 Launchpad에서 Luxel을 엽니다.
4. macOS 메뉴 막대에서 Luxel 상태 항목을 찾습니다.

Luxel에는 macOS 26.0 이상이 필요합니다. 메뉴 막대에서 실행되므로 메뉴 막대 항목이 캡처 시작과 설정을 여는 기본 위치입니다.

첫 캡처

1. 메뉴 막대에서 Luxel을 엽니다.
2. 대상에서 대상을 선택하거나 영역을 사용해 사용자 지정 구역을 그립니다.
3. 녹화에 필요한 경우에만 시스템 오디오, 마이크 또는 카메라를 켭니다.
4. 소스 녹화, 영역 녹화 또는 오디오 녹화를 클릭합니다.
5. 메뉴 막대 상태 제어, 활성 녹화 제어 또는 단축키로 녹화를 중지합니다.

알림 활성화

1. 설정 > 녹음을 여세요.
2. 음성이 감지되면 알림을 켜세요.
3. 안내를 읽은 다음 활성화를 선택해 동의하세요.
4. 먼저 알림을 허용한 다음 마이크 접근을 허용하세요.
5. 시스템 기본값 또는 특정 마이크를 선택하세요.

로그인한 뒤에도 기능을 사용하려면 로그인 시 열기를 켜세요. Luxel이 열려 있는 동안에만 감지가 작동합니다.

동작 선택

Luxel이 신호를 감지하면 알림에 녹음 시작과 닫기가 표시됩니다. 녹음 시작은 선택한 마이크로 오디오 전용 녹음 하나를 시작합니다. 닫기는 아무 작업도 하지 않으며 알림을 열기만 하면 녹음 없이 Luxel이 활성화됩니다.

집중 모드와 기타 macOS 알림 설정으로 인해 알림이 늦거나 표시되지 않을 수 있습니다. 알림은 편의 기능이며 Luxel이 대화를 인식한다는 보장은 없습니다.

리플레이 버퍼 설정

1. 설정 > 리플레이 버퍼를 엽니다.
2. 리플레이 버퍼를 활성화하고 최초 사용 동의 요청을 승인합니다.
3. 길이: 30초, 1분, 2분 또는 5분을 선택합니다.
4. 24 FPS 또는 30 FPS를 선택합니다.
5. 클립에 Mac 오디오가 필요할 때만 시스템 오디오 포함을 켭니다.
6. 클립을 편집기에서 열지 빠른 내보내기 대상으로 보낼지 선택합니다.

메뉴에서 사용

1. 메뉴 막대 제어에서 리플레이 버퍼를 시작합니다.
2. 상태가 시작 중에서 버퍼링 중으로 바뀔 때까지 기다립니다.
3. 내보내기를 클릭해 선택한 최근 시간을 저장합니다.
4. 시작과 중지로 버퍼를 켜거나 끕니다.
5. 리플레이 버퍼 클립 단축키 또는 luxel clip 로 같은 작업을 수행합니다.

선택 영역 그리기

영역을 클릭해 전체 화면 선택 오버레이를 엽니다. 드래그해 구역을 그리고 핸들로 크기를 바꾸거나 전체 디스플레이를 사용합니다. 최소 선택은 32 × 32픽셀입니다.

크기 프리셋은 1280 × 720, 1920 × 1080, 800 × 600이며, 화면 비율은 자유, 16:9, 4:3, 1:1, 9:16, 21:9입니다.

유용한 제어

• 카운트다운, 이후 중지, 오디오, 카메라, 비율 및 크기 제어를 선택합니다.
• 권한이 허용되면 마이크와 카메라를 전환합니다.
• 정확한 가장자리를 위해 확대경을 사용합니다.
• 프리셋 설정에서 다른 디스플레이를 어둡게 하거나 마지막 선택을 복원합니다.
• 방해를 줄이려면 알림 안내에서 집중 모드 설정을 엽니다.

편집기에서

1. 오디오가 있는 녹화를 편집기에서 엽니다.
2. 전사 미리보기에서 텍스트를 생성하거나 검토합니다.
3. 전사 텍스트를 검색하거나 구간을 선택해 재생 위치로 이동합니다.
4. 자동 발화 묶음을 위해 전사 발화 분할을 켜 둡니다.
5. 긴 녹화의 원시 전사를 더 빨리 얻으려면 설정 > 전사에서 끕니다.

화자 식별 및 관리

1. 설정 > 전사에서 화자 식별을 켭니다.
2. 전사를 생성해 감지된 각 음성을 로컬에서 분리하고 레이블을 붙입니다.
3. 화자 카드에서 자동 감지를 사용하거나 정확한 수 또는 범위를 정한 뒤 다시 감지합니다.
4. 음성 예시를 재생하고, 화자 이름을 지정하고, 알려진 화자로 저장하거나 기존 프로필에 연결하거나 무시합니다.
5. 이후 전사에서 저장된 알려진 화자를 자동으로 일치시킬 수 있습니다.

음성 프로필과 화자 처리는 Mac에만 남습니다.

명령줄에서

luxel transcribe demo.m4a > demo.txt
luxel transcribe demo.mp4 --output demo.json --format json --overwrite
luxel transcribe demo.mp4 --locale en_US --semantic-turns --diarize

기본적으로 일반 텍스트가 stdout에 출력됩니다. --format json 를 사용하면 전체 발화별 전사 데이터를 얻으며, --diarize 가 활성화되면 화자 레이블도 포함됩니다.

Luxel과 페어링

luxel pair
luxel doctor

페어링하면 Luxel에 승인 요청이 표시됩니다. 앱과 CLI는 자격 증명을 macOS 키체인에 별도로 저장합니다. 설정 > 명령줄에서 언제든 제어를 끄거나 페어링된 클라이언트를 취소할 수 있습니다.

일반 예시

luxel record --display main --fps display --countdown 3
luxel record --active-window --fps 120
luxel toggle --last-area
luxel stop
luxel clip --seconds 30
luxel latest --reveal
luxel preferences

미디어 예시

luxel record --active-window --preset "Default" --save-to ~/Movies/Luxel
luxel editor ~/Movies/demo.mp4
luxel convert demo.mp4 demo.webm
luxel convert demo.mp4 demo-av1.mp4 --format av1
luxel convert demo.mp4 demo.gif --start 2 --duration 5 --fps 15 --width 800 --height 450
luxel convert demo.mp4 demo.mov --format prores422 --quality high
luxel export request.json output.webm --overwrite --json
luxel transcribe demo.m4a > demo.txt
luxel transcribe demo.mp4 --output demo.json --format json --diarize --overwrite

에이전트 스킬

Luxel Skills를 설치하면 호환되는 코딩 에이전트가 전체 CLI를 사용하거나 검토용 WebM 증거를 선별해 만들 수 있습니다.

npx skills add https://github.com/rawcontext/luxel-skills
npx skills add https://github.com/rawcontext/luxel-skills --skill luxel
npx skills add https://github.com/rawcontext/luxel-skills --skill luxel-evidence

명령 참고와 작업에는 luxel을, 의도적인 녹화 및 첨부 워크플로에는 luxel-evidence를 선택하세요.

GitHub의 Luxel Skills 페이지를 이용하세요.

폴더 접근

Luxel은 동영상 폴더, 설정된 녹화 폴더 및 앱에서 승인한 폴더를 사용할 수 있습니다. 터미널 경로는 App Sandbox를 우회하지 않습니다.

luxel access add ~/Desktop/Exports
luxel access check ~/Desktop/Exports/demo.mp4
luxel access list
luxel access revoke <grant-id>

access add 는 Luxel 폴더 선택기를 엽니다. 그곳에서 선택한 폴더에 앱 사용 권한이 부여됩니다.

보안 및 개인정보 보호

각 호출은127.0.0.1의 인증된 단기 연결을 사용합니다. Luxel은 페어링되지 않은 클라이언트, 오래된 요청, 재사용된 nonce, 변조된 본문 및 비루프백 엔드포인트를 거부합니다. CLI는 보안 범위 책갈피를 받거나 직접 미디어를 처리하지 않습니다.

URL 스킴

Luxel은 luxel:// URL 스킴을 등록합니다. 호출자가 권한을 받지 않았다면 캡처 시작과 리플레이 버퍼 클립에 확인이 필요할 수 있습니다. stop, preferences, latest 등은 기본적으로 허용됩니다.

luxel://record?target=display&display=main&fps=display&countdown=3
luxel://record?target=activeWindow&preset=Default
luxel://toggle
luxel://stop
luxel://clip?seconds=30
luxel://preferences
luxel://latest?reveal=true

x-callback URL

자동화 명령은 x-success 및 x-error 콜백 URL을 받습니다. 파일 생성에 성공한 명령은 filePath, 녹화 시작은 recordingID, 실패는 errorMessage를 이용하세요.

를 추가합니다. x-callback 자동화에는 URL 스킴을 직접 사용합니다.

빠른 프리셋

내보내기 프리셋은 추가, 복제, 삭제, 이름 변경 및 빠른 녹화 지정이 가능합니다. 포맷, 크기 규칙, 프레임 속도, 대상 및 후속 작업을 지원합니다. 대상은 녹화 폴더 또는 클립보드입니다. GIF, MP4, HEVC MP4, ProRes 422 MOV, ProRes 4444 MOV 및 APNG를 제공하며 WebM과 AV1은 편집기와 CLI에서 사용할 수 있습니다.

리플레이 버퍼

리플레이 버퍼 설정은 활성화, 클립 길이, 24/30 FPS, 시스템 오디오, 실행 시 재개 및 편집기나 빠른 내보내기 대상을 제어합니다.

명령줄

명령줄 설정은 외부 제어, CLI 저장소, 클라이언트 취소 및 명령줄 요청용 폴더를 관리합니다.

시스템 동작

시스템 설정에는 메뉴 막대 타이머, 알림, 로그인 시 실행, 업데이트 및 감사의 말이 있습니다.

지원 로케일

• 영어
• 독일어(독일)
• 스페인어(유럽)
• 프랑스어(프랑스)
• 이탈리아어(이탈리아)
• 일본어(일본)
• 한국어(대한민국)
• 베트남어
• 중국어(간체)
• 포르투갈어(브라질)
• 포르투갈어(포르투갈)

권한 요청

카메라, 마이크, 화면 캡처 및 음성 인식 요청은 선택한 언어로 표시됩니다. Luxel은 관련 기능이 켜지거나 녹화를 시작할 때만 권한을 요청합니다.

Luxel은 macOS 언어 설정을 자동으로 따릅니다.