원문 캡처 · github.com
원문 캡처 · github.com

merkwerk는 macOS에서 회의 음성을 받아 적고 회의록과 일일 업무 기록을 만드는 오픈소스 앱이다. 음성 인식과 노트 작성은 기본 설정에서 로컬로 처리하며, 기록은 사용자의 맥에 파일로 저장한다.

회의가 감지되면 기본적으로 녹음 여부를 묻고, 사용자가 원할 때 자동 녹음을 켤 수 있다. 마이크와 시스템 오디오를 각각 ‘me’와 ‘them’으로 기록하며, 캘린더 초대가 있는 1대1 회의에서는 상대방 이름을 표시할 수 있다. 회의록에는 다음 단계와 담당자·날짜를 먼저 담고, 녹음 중이나 이후에 회의 내용을 질문할 수도 있다. 답변에는 타임스탬프가 붙는다.

앱은 macOS 접근성 기능으로 화면의 창 제목과 텍스트를 읽어 업무 활동을 기록하고, 매일 프로젝트별 업무 로그를 만든다. 화면 활동 기록은 끌 수 있고, 비밀번호 입력란·비밀번호 관리자·잠금 화면·비공개 브라우저 창은 수집 대상에서 제외한다. API 키와 비슷한 문자열은 파일에 저장하기 전에 가린다.

음성 인식 모델은 Parakeet TDT 0.6B v3 또는 Whisper를 선택할 수 있다. 회의록은 기본적으로 Ollama를 통해 로컬 LLM이 작성하며 LM Studio나 OpenAI 호환 엔드포인트도 이용할 수 있다. 단, MERKWERK_LLM_URL을 호스팅 API로 지정하면 녹취와 활동 텍스트가 해당 서비스로 전송된다. 기본 설정에서는 분석·텔레메트리·업데이트 확인을 위한 네트워크 요청을 하지 않으며, 모델을 처음 받을 때 Hugging Face에 연결한다.

설치에는 macOS 14.6 이상이 필요하고 Apple Silicon을 권장한다. Rust 도구 체인도 필요하며, 노트 작성을 위한 Ollama 또는 LM Studio는 선택 사항이다. 앱 설치와 모델 다운로드, 실행은 다음 명령으로 진행한다.

cargo install --git https://github.com/ArzelaAscoIi/merkwerk --tag v0.0.1
merkwerk model # one-time download: Parakeet v3 (~670 MB) + Silero VAD (1 MB)
ollama pull gemma4 # the default notes model
merkwerk install # writes ~/Applications/merkwerk.app
open -a merkwerk # opens the notes window and starts watching

macOS가 마이크, 시스템 오디오 녹음, 접근성, 캘린더 권한을 요청한다. 시스템 오디오 권한 문제 때문에 터미널에서 실행하지 말고 merkwerk.app으로 실행해야 한다. 앱은 MIT 라이선스로 배포되지만, 포함되는 음성 모델은 별도 라이선스를 따른다.

제작자는 녹음 전에 참여자의 동의를 받으라고 안내한다. 녹음과 화면 모니터링에 적용되는 법과 사내 규정은 지역과 상황에 따라 다를 수 있다. 헤드폰을 쓰지 않으면 스피커 소리가 마이크에 들어가 상대방 음성이 자신의 채널에 잡힐 수 있으며, 일부 터미널·원격 데스크톱·게임처럼 화면을 픽셀로 그리는 앱은 활동 로그에 창 제목만 나타난다. 자세한 내용과 변경 사항은 저장소와 릴리스에서 확인할 수 있다.