epr

프로그램 소개

epr은 터미널 환경에서 EPUB 전자책을 읽기 위한 커맨드라인 인터페이스(CLI) 리더입니다. 별도의 그래픽 인터페이스 없이 명령줄에서 바로 전자책을 열어 읽을 수 있게 설계되어 있어, 개발자나 터미널 사용자들에게 효율적인 독서 환경을 제공합니다.

주요 기능

• 마지막 읽기 위치 기억: 인자 없이 epr 명령만 실행하면 마지막으로 읽던 파일을 자동으로 열어줍니다.
• 파일별 읽기 상태 저장: 각 EPUB 파일에 대한 마지막 읽기 위치를 개별적으로 기억하여 나중에 이어서 읽을 수 있습니다. 이 정보는 $HOME/.config/epr/config 또는 $HOME/.epr 경로에 저장됩니다.
• 텍스트 영역 너비 조절: 터미널 크기에 맞춰 텍스트 영역의 너비를 자동으로 적응시킵니다.
• EPUB3 지원: 오디오 지원은 제외하고 EPUB3 형식의 전자책을 읽을 수 있습니다.
• 바이밍 바인딩: vim 스타일의 키 바인딩을 지원하여 익숙한 사용자에게 편의를 제공합니다.
• 이미지 열기: 텍스트 중간에 [IMG:n]으로 표시된 이미지 항목을 키보드로 선택하여 시스템의 기본 뷰어로 열 수 있습니다.
• 컬러 스킴 전환: ‘c’ 키를 눌러 기본 터미널 색상, 다크, 라이트 테마 간을 전환할 수 있습니다. 커스텀 색상은 소스 코드에서 수정할 수 있습니다.

다운로드·설치 방법

epr은 다양한 패키지 관리자를 통해 설치할 수 있습니다. Windows 환경에서는 Chocolatey를 사용하는 것이 가장 간편합니다.

• Chocolatey 설치: 관리자 권한 터미널에서 다음 명령을 실행합니다.
  choco install epr
• PyPI를 통한 설치: Python 패키지 설치 도구 pip를 사용할 수 있습니다.
  pip3 install epr-reader
• GitHub에서 직접 설치: pip와 Git을 결합하여 설치할 수도 있습니다.
  pip3 install git+https://github.com/wustho/epr.git

설치 후에는 ‘epr’ 명령어를 터미널에서 바로 실행할 수 있습니다.

기본 사용법

• 파일 열기: epr [파일경로.epub] 명령으로 특정 EPUB 파일을 엽니다.
• 최근 파일 열기: epr 명령만 입력하면 마지막으로 읽던 파일이 열립니다.
• 최근 파일 검색: epr [검색어] 형태로 명령하면 읽기 기록에서 해당 검색어가 포함된 파일을 찾아 엽니다.
• 읽기 기록 보기: epr -r 명령으로 모든 읽기 기록 목록을 확인할 수 있습니다.
• 이미지 열기: 읽기 중 [IMG:n]이 표시되면 ‘o’ 키를 눌러 이미지를 엽니다.
• 컬러 스킴 변경: ‘c’ 키를 눌러 색상 테마를 순환합니다. ‘0c’, ‘1c’, ‘2c’로 각각 기본, 다크, 라이트 모드로 즉시 전환할 수 있습니다.
• 콘텐츠 덤프: epr -d [파일경로.epub] 명령은 EPUB 내용을 단락 단위로 텍스트로 덤프하여 다른 도구와 파이프 연결에 유용합니다.

이런 경우에 유용합니다

epr은 터미널 환경에서工作效率을 중시하는 사용자에게 적합합니다. 예를 들어, 개발 작업 중 틈틈이 전자책을 읽고 싶을 때 그래픽 뷰어를 전환할 필요 없이 현재 터미널에서 바로 독서를 이어갈 수 있습니다. 또한, 스크립트나 grep 같은 텍스트 처리 도구와 함께 EPUB 콘텐츠를 분석하거나 인용구를 찾는 작업에도 활용될 수 있습니다.

지원 환경·시스템 요구사항

epr은 Python 3.6 이상이 설치된 환경에서 동작합니다. Windows, macOS, Linux 모두 지원됩니다. Windows에서는 추가로 windows-curses 패키지가 필요하며, Chocolatey로 설치 시 자동으로 포함될 수 있습니다.

제한 사항·확인 사항

• 터미널 너비가 최소 22열 이상이어야 합니다.
• 정규표현식(regex) 검색만 지원하며, 여러 줄에 걸친 문장을 검색하는 것은 어렵습니다.
• 가로 방향 왼쪽에서 오른쪽으로 쓰이는 텍스트만 지원됩니다.
• 현재 라틴 알파벳을 사용하는 언어만 완전히 지원합니다.
• 하이퍼링크는 지원하지 않습니다.
• 첨자(Superscript)와 첨자(Subscript) 텍스트는 특수 기호로 표시됩니다.
• 일부 EPUB 파일의 목차(TOC)에서 챕터 이름이 ‘-‘로 표시되거나 챕터가 건너뛸 수 있습니다.