본문으로 건너뛰기
로그인 둘러보기
오피스·문서·PDF · 윈도우즈 유틸

Miro

0

Miro(miro-pdf)는 Windows, macOS, Linux(Wayland/X11) 데스크톱에서 동작하는 네이티브 PDF 뷰어로, mupdf를 렌더링 엔진으로 사용하고 Rust로 작성되었습니다.

PDF 뷰어네이티브크로스플랫폼키바인딩 설정
소개상세정보시스템 요구사항

소개

Miro(miro-pdf)는 Windows, macOS, Linux(Wayland/X11) 데스크톱에서 동작하는 네이티브 PDF 뷰어로, mupdf를 렌더링 엔진으로 사용하고 Rust로 작성되었습니다. 구성 가능한 키바인딩과 마우스 바인딩, 설정 파일을 통해 조작 방식을 자유롭게 변경할 수 있다는 점이 특징입니다. PDF를 빠르게 열어 읽고 탐색하는 데 초점을 둔 경량 뷰어 소프트웨어입니다.

상세정보

문서 보기 및 탐색

  • 네이티브 PDF 뷰어로 빠른 문서 로딩과 렌더링을 지원
  • 다크 모드 적용(인터페이스 및 PDF 양쪽 모두 지원)
  • 여러 PDF를 탭으로 동시 열기
  • 내부 링크(목차 등) 및 외부 링크(이메일, 웹사이트 등) 탐색
  • 북마크 및 점프리스트 지원
  • 페이지 테두리 표시, 전체화면, UI를 숨기는 발표 모드 제공
  • 최근 열어 본 파일 목록 표시

키보드 및 마우스 조작

  • Vim 스타일 기본 키바인딩 제공
  • 키 바인딩, 마우스 바인딩, 설정을 담은 구성 파일 지원
  • 키 조합 및 다중 키 시퀀스(예: “Z Z” 형태의 키 코드) 바인딩 가능
  • Ctrl, Shift 등 수정 키와 함께 마우스 버튼에 동작 할당 가능

문서 작업 및 검색

  • 열려 있는 PDF 자동 새로 고침(Latex/Typst 등 PDF로 컴파일되는 결과물 작업에 유용)
  • 문서 내 텍스트 복사 및 코멘트/주석 읽기
  • 일반 텍스트 및 정규식을 이용한 문서 검색
  • RPC 서버 활성화 및 포트 설정으로 외부 프로그램에서 뷰어 제어 가능
  • 기본 웹 브라우저를 통한 인쇄 기능
  • 터미널에서 PDF를 열 수 있는 CLI 인수 제공

사전 빌드 바이너리 설치

공식 GitHub 저장소의 Releases 페이지에서 운영체제에 맞는 최신 바이너리를 내려받아 사용합니다. 설치 후 실행 파일을 PATH가 잡히는 위치에 두면 됩니다. Windows에서는 winget 명령으로도 설치할 수 있습니다.

Nix Cachix 바이너리 캐시

Nix 환경에서는 miro-pdf.cachix.org의 바이너리 캐시를 substituters와 trusted-public-keys에 추가하면 사전 빌드된 바이너리를 받아 사용할 수 있습니다.

crates.io를 통한 설치

Rust 환경이 갖춰져 있다면 다음 명령으로 설치할 수 있습니다.

  • cargo install miro-pdf

소스에서 직접 빌드

Linux에서는 저장소를 클론한 뒤 릴리스 모드로 빌드하여 결과 바이너리를 /usr/bin/ 등으로 복사합니다.

  • git clone https://github.com/vincent-uden/miro.git
  • cd miro
  • cargo r –release
  • cp ./target/release/miro-pdf /usr/bin/miro-pdf

Windows에서는 mupdf-sys 크레이트 빌드 관련 이슈가 있을 수 있어 공식적으로 사전 빌드 바이너리 사용을 권장합니다. macOS에서는 테스트되지 않으며 소스 빌드 또는 crates.io 설치만 지원합니다.

PDF 열기 및 탐색

  • Releases에서 받은 바이너리를 실행해 프로그램을 시작
  • 파일 열기 메뉴 또는 터미널에서 CLI 인수로 PDF 파일을 지정해 열기
  • 탭을 통해 여러 PDF를 동시에 열어 두고 비교/탐색

구성 파일로 조작 방식 변경

설정 파일은 운영체제 홈 디렉터리의 ~/.config/miro-pdf/miro.conf 위치에 작성하며, 저장소 내 /assets/default.conf가 모든 기본 바인딩을 포함한 예시 파일입니다.

  • 키 바인딩: Bind
  • 마우스 바인딩: MouseBind
  • 설정 변경: Set

사용 가능한 설정에는 Rpc, RpcPort, TrackpadSensitivity가 있으며, 시작 시에만 적용되는 기본 설정에는 DarkModePdf, DarkModeUi, OpenSidebar, PageBorders가 있습니다. 구성 파일 파서는 한 줄에서 오류가 발생해도 나머지 줄은 계속 해석하며 줄 번호가 포함된 오류 메시지를 표시합니다.

Miro의 라이선스는 무엇인가요?

공식 저장소에 명시된 라이선스는 AGPL-3.0이며, 자세한 내용은 저장소의 LICENSE 파일에서 확인할 수 있습니다.

Windows에서 설치하는 가장 안정적인 방법은 무엇인가요?

공식 README에서는 mupdf-sys 빌드 이슈로 빌드가 실패할 수 있다고 안내하고 있으므로, Releases 페이지의 사전 빌드 바이너리를 내려받아 사용하는 방식을 권장합니다.

키바인딩을 Vim 스타일에서 다른 방식으로 바꿀 수 있나요?

네. ~/.config/miro-pdf/miro.conf 구성 파일에서 Bind, MouseBind 명령으로 키와 마우스 입력을 원하는 동작에 자유롭게 매핑할 수 있습니다.

PDF를 자동으로 다시 불러오게 할 수 있나요?

공식 README에 따르면 열려 있는 PDF는 자동으로 다시 로드되며, Latex, Typst 등 PDF로 컴파일되는 결과물을 작성할 때 특히 유용합니다.

시스템 요구사항

- Windows, macOS, Linux 중 하나의 운영체제(Linux는 Wayland 또는 X11 환경)
- 빌드 시 Rust 툴체인(cargo) 필요
- Linux에서 소스 빌드 시 libfontconfig1-dev(Ubuntu/Debian), fontconfig-devel(Fedora), fontconfig(Arch) 등 fontconfig 헤더와 clang, unzip 필요
- Windows에서 소스 빌드 시 MSVC 등 mupdf-sys 빌드 요구 사항 필요(공식 README에서는 Windows용 사전 빌드 바이너리 사용을 권장)