목차

컨트롤 바 버튼 사용자 지정

개요

컨트롤 바는 두 개의 영역으로 나뉩니다:

  • 왼쪽 (파일 수준): 외부 애플리케이션 연동 및 빠른 작업(예: "연결 프로그램...", "파일 탐색기에서 표시"). 설정 > 컨트롤에서 설정할 수 있습니다.
  • 오른쪽 (미리보기 수준): 뷰포트 제어(회전, 음소거, 확대/축소 등).

이 가이드는 왼쪽 영역 확장에 대해 설명합니다.

컨트롤 추가

설정 > 컨트롤에서는 기본 내장 버튼을 관리하거나, 사용자 지정 작업을 생성하거나, 컨트롤 플러그인을 설치할 수 있습니다.

1. 사용자 지정 작업

  1. 작업 목록 하단의 +를 클릭하고 실행할 프로그램이나 스크립트를 선택합니다.
  2. 오른쪽 패널에서 작업 세부 정보를 설정합니다:
    • 이름 (Name): 도구 설명(툴팁)에 표시되는 이름.
    • 실행 파일 (Executable): 대상 실행 파일(.exe)의 경로.
    • 인수 (Arguments): 명령줄 인수. 파일 경로를 전달하려면 "${input_file}"과 같은 자리 표시자를 사용합니다.
    • 파일 형식 (File Formats): 대상 파일 확장자(예: png, zip) 또는 특수 토큰(예: ${type_folder}).
    • 실행 성공 후 미리보기 닫기 (Close preview after successful launch): 외부 프로그램이 성공적으로 실행되면 미리보기 창을 닫습니다. Seer는 프로그램이 종료될 때까지 대기하지 않습니다.

2. 컨트롤 플러그인

컨트롤 플러그인은 패키지 형태의 사전 구성된 작업을 제공합니다. 사용자의 PC에 이미 있는 프로그램이나 스크립트를 지정하는 사용자 지정 작업과는 구분됩니다.

공식 컨트롤 플러그인

공식 컨트롤 플러그인 패키지는 다운로드 센터에 통합되어 있습니다. 플러그인 다운로드 - 컨트롤에서 필요한 .zip 패키지를 다운로드하세요. 압축을 풀지 않고 설정 > 컨트롤에서 바로 가져올 수 있습니다.

다운로드한 패키지 설치

  1. 설정 > 컨트롤에서 목록 하단의 +를 클릭합니다.
  2. 다운로드한 .zip 압축 파일을 직접 선택하거나, 압축을 푼 폴더에서 plugin.json을 선택합니다.
  3. 세부 정보 창에서 가져온 작업의 지원 형식과 동작 방식을 검토합니다.
  4. 확인을 클릭하여 저장하고 적용합니다. 취소를 클릭하면 가져오기가 취소됩니다.

패키지가 다른 기능 유형인 경우, Seer가 해당하는 설정 페이지로 자동 이동합니다.

작업 관리

  • 순서 변경: 목록의 항목을 끌어다 놓아(드래그 앤 드롭) 컨트롤 바에 표시되는 버튼 순서를 변경합니다.
  • 활성화 / 비활성화: 작업을 선택하고 세부 정보에서 활성화를 전환한 후 설정을 저장합니다.
  • 규칙 사용자 지정: 설치된 플러그인의 경우 일치하는 파일 형식과 CLI 인수를 언제든지 사용자 지정하거나 기본값으로 초기화할 수 있습니다.
  • 기본 버튼: 기본 내장 작업(기본 프로그램으로 열기, 파일 탐색기에서 표시, 동일 형식 탐색)은 개별적으로 켜거나 끌 수 있습니다.

자리 표시자 및 특수 토큰

1. 명령줄 인수 자리 표시자

외부 도구를 실행할 때 런타임에 동적으로 치환되는 내장 토큰이 제공됩니다:

자리 표시자 설명 예시
${input_file} 미리보기 중인 파일 또는 폴더의 절대 경로. C:\Users\Username\Documents\file.zip
${7z} 번들로 제공되는 7z.exe의 절대 경로. 실행 파일 입력란에서도 사용할 수 있습니다. C:\Program Files\Seer\plugins\7z.exe
${seer_exe} Seer.exe의 절대 경로. C:\Program Files\Seer\Seer.exe
${seerviewer_exe} SeerViewer.exe의 절대 경로. C:\Program Files\Seer\SeerViewer.exe
${seer_dir} Seer.exe가 있는 디렉터리. C:\Program Files\Seer
${screenshot} 현재 보기의 임시 PNG 스크린샷의 절대 경로. C:\Users\Username\AppData\Local\Temp\Seer\screenshot\view_1.png

경로에 공백이 포함될 수 있는 경우 자리 표시자를 큰따옴표로 묶으세요: "${input_file}".

자신만의 컨트롤 플러그인을 직접 작성하시겠습니까? 각 플러그인 기능별 지원 자리 표시자를 포함한 전체 자리 표시자 및 일치 토큰 매트릭스는 플러그인 개발 및 구현을 참조하세요.

2. 파일 형식 특수 토큰

비표준 파일 형식이나 폴더를 매칭하려면 파일 형식 입력란에 다음 토큰을 사용할 수 있습니다:

토큰 설명
${type_folder} 디렉터리 및 폴더와 일치합니다.
${type_file} 모든 파일(확장자가 없는 파일 포함)과 일치합니다.
${type_all} 모든 대상(파일 및 폴더 모두)과 일치합니다.
${type_pdf} PDF 문서와 일치합니다.
${type_image} 그림 파일과 일치합니다(내장 그림 뷰어와 동일한 분류).
${type_media} 오디오/비디오 파일과 일치합니다(내장 미디어 뷰어와 동일한 분류).
${type_web} 웹 페이지(HTML 및 Markdown)와 일치합니다(내장 HTML 뷰어와 동일한 분류).
${type_text} 텍스트/코드 파일과 일치합니다(내장 텍스트 뷰어와 동일한 분류).
${type_none} 위 어느 범주에도 속하지 않는 파일과 일치합니다(예: 압축 파일, 실행 파일).

참고: 토큰은 대소문자를 구분하지 않으며 공백이나 쉼표를 사용하여 일반 확장자와 함께 지정할 수 있습니다(예: png jpg ${type_folder}).

${type_*} 범주 토큰은 내장 뷰어와 동일한 확장자 표로 파일을 분류하며, 파일에만 일치합니다. 폴더도 대상으로 하려면 ${type_folder}와 조합하세요.

3. 설정 예시: 7-Zip으로 압축 파일 해제하기

번들 7-Zip을 사용하여 압축 파일을 해제하는 버튼을 추가하려면:

  1. 실행 파일: ${7z} (또는 사용자의 7z.exe 경로 지정).
  2. 인수: x "${input_file}" -r -y -o"C:\Output\Path\"
  3. 파일 형식: zip rar 7z tar gz

매개변수 세부 설명: * x: 전체 경로를 유지하며 압축 해제. * "${input_file}": 대상 압축 파일. * -r: 하위 디렉터리를 재귀적으로 처리. * -y: 모든 확인 메시지에 “예”(덮어쓰기)로 응답. * -o"...": 출력 디렉터리.