Liquid Clipboard

macOS 전용 클립보드 매니저입니다. 텍스트, 링크, 파일 경로와 이미지를 자동으로 저장하고, 메뉴 막대에서 빠르게 다시 꺼내 쓸 수 있습니다.

앱으로 설치하기

필요한 것은 macOS, Git, 그리고 Node.js 20 이상입니다. Node.js가 없다면 nodejs.org에서 LTS 버전을 설치하세요.

터미널에서 아래 세 줄만 실행합니다.

git clone https://github.com/onlineschoolentry/clipboard.git
cd clipboard
open scripts/install-clipboard.command

설치 스크립트가 필요한 파일을 설치하고 macOS용 DMG 설치 파일을 만듭니다. DMG가 자동으로 열리면 Liquid Clipboard를 Applications 폴더로 드래그하세요. 그 뒤에는 일반 앱처럼 응용 프로그램 폴더, Spotlight 또는 Dock에서 실행할 수 있습니다.

Finder를 선호한다면 저장소를 내려받은 뒤 scripts/install-clipboard.command 파일을 더블클릭해도 됩니다. 처음 설치할 때는 네이티브 모듈과 DMG를 만들기 때문에 몇 분 정도 걸릴 수 있습니다.

현재 설치본은 Apple Developer ID로 서명하지 않은 로컬 빌드입니다. macOS가 실행을 막으면 앱을 우클릭한 뒤 열기를 선택해 한 번 허용하세요.

개발 모드로 바로 실행하기

앱을 설치하지 않고 코드 상태를 바로 실행하려면 아래를 사용하세요.

open scripts/start-clipboard.command

처음 실행이면 필요한 의존성을 자동 설치합니다. 이후에는 같은 파일을 더블클릭해 다시 실행할 수 있습니다.

사용법

• 메뉴 막대의 Liquid Clipboard 아이콘을 클릭하거나 ⌘⇧V를 누르면 클립보드 목록을 엽니다.
• ⌘⇧S를 누르면 영역 캡처를 시작합니다. 캡처한 이미지는 파일로 저장하지 않고 바로 클립보드에 들어갑니다.
• 목록의 항목을 클릭하면 현재 앱에 붙여넣습니다. 자동 붙여넣기에 실패하면 항목을 우클릭해 복사를 선택한 뒤 직접 붙여넣을 수 있습니다.
• 앱을 종료하려면 메뉴 막대 아이콘을 우클릭하고 종료를 선택합니다.

권한

자동 붙여넣기에는 macOS 접근성 권한이 필요합니다. 처음 실행한 뒤 붙여넣기가 되지 않으면 다음 위치에서 앱 또는 Electron을 허용하세요.

시스템 설정 → 개인정보 보호 및 보안 → 손쉬운 사용

개발용 명령어

npm run dev        # 개발 모드 실행
npm run typecheck  # TypeScript 검사
npm run build:mac  # macOS DMG 빌드

npm run build:mac 결과물은 release/ 폴더에 생성됩니다. 배포용 DMG를 다른 Mac에서 처음 열 때는 macOS 보안 안내에 따라 앱 열기를 허용해야 할 수 있습니다.

데이터 저장 위치

클립보드 히스토리와 이미지 파일은 macOS의 앱 데이터 폴더에 저장됩니다. 앱을 삭제해도 이 데이터는 자동으로 지워지지 않습니다.