Shinobi CCTV 한국어 한글패치 설치 방법

Shinobi는 웹브라우저에서 여러 대의 IP 카메라를 관리하고 녹화할 수 있는 오픈소스 CCTV/NVR 프로그램입니다.

카메라 실시간 화면 확인, 녹화 영상 재생, 움직임 감지, 저장공간 관리, 사용자 계정 관리 등의 기능을 웹 화면에서 사용할 수 있습니다.

다만 기본 화면이 영어로 제공되기 때문에 처음 사용하는 분은 설정 메뉴가 다소 어렵게 느껴질 수 있습니다.

제가 직접 Shinobi 화면에 맞게 번역한 **한국어 언어 파일 ko.json**을 GitHub에 공개했습니다.

이 한글패치는 Shinobi 공식 프로젝트가 아니며, 한국어 사용자를 위해 별도로 제공하는 번역 파일입니다.

주요 특징

Shinobi 관리 화면 한국어 번역
CCTV 환경에 맞는 자연스러운 용어 사용
Docker 설치 환경 지원
별도의 프로그램 설치 없이 파일 교체로 적용
오역과 미번역 항목 지속 수정
무료 오픈소스 배포

번역에서는 단순 직역보다는 실제 CCTV 관리 화면에서 이해하기 쉬운 표현을 사용했습니다.

예를 들면 다음과 같습니다.

영어 메뉴	한국어 번역
Monitor	카메라
Videos	녹화 영상
Detector	움직임 감지
Region Editor	감지 영역 설정
Storage	저장공간
Dashboard	대시보드
API Keys	API 키
Timelapse	타임랩스
Event Filter	이벤트 필터
Disk Usage	저장공간 사용량

한글패치 다운로드

아래 GitHub 저장소에서 ko.json 파일을 다운로드합니다.

GitHub 저장소

github에서 다운로드

https://github.com/fire-olli/Shinobi-Korean

GitHub 페이지에서 ko.json 파일을 선택한 후 오른쪽 위의 Download raw file 버튼을 누르면 다운로드할 수 있습니다.

저장소 전체를 내려받으려면 다음 순서로 진행해도 됩니다.

GitHub 페이지에서 Code 버튼을 누릅니다.
Download ZIP을 선택합니다.
압축을 해제합니다.
압축을 푼 폴더 안의 ko.json 파일을 사용합니다.

Docker 설치 환경에서 적용하기

Shinobi를 Docker로 설치했다면 다운로드한 ko.json 파일이 있는 폴더에서 다음 명령어를 실행합니다.

docker cp ko.json shinobi:/home/Shinobi/languages/

명령어의 shinobi는 Docker 컨테이너 이름입니다.

컨테이너 이름이 다르다면 먼저 다음 명령어로 확인합니다.

docker ps

예를 들어 컨테이너 이름이 shinobi-cctv라면 다음과 같이 입력합니다.

docker cp ko.json shinobi-cctv:/home/Shinobi/languages/

파일을 복사한 뒤 Shinobi를 재시작합니다.

docker restart shinobi

README에 안내된 기본 Docker 경로와 재시작 명령도 위와 같습니다.

한국어 설정 활성화하기

ko.json 파일만 복사하면 한국어가 바로 적용되지 않을 수 있습니다.

Shinobi 설정 파일인 conf.json에서 기본 언어를 한국어로 지정해야 합니다.

conf.json 파일을 열고 다음 항목을 추가하거나 수정합니다.

"language": "ko",

설정 예시는 다음과 같습니다.

{
  "port": 8080,
  "language": "ko",
  "isFailover": false
}

JSON 형식에서는 각 항목 사이에 쉼표가 필요합니다. 기존 설정 중간에 추가할 때는 앞뒤 쉼표가 빠지지 않도록 주의해야 합니다.

설정을 저장한 다음 Shinobi 컨테이너를 재시작합니다.

docker restart shinobi

conf.json에 "language": "ko"를 설정해야 한다는 점은 저장소의 적용 안내에도 명시되어 있습니다.

적용되지 않을 때 확인할 사항

한국어가 바로 보이지 않는다면 브라우저에 기존 영어 화면이 캐시되어 있을 수 있습니다.

윈도우에서는 다음 키를 눌러 강력 새로고침을 합니다.

Ctrl + Shift + R

또는 Shinobi에서 로그아웃한 뒤 다시 로그인해 봅니다.

그래도 적용되지 않는다면 다음 항목을 확인합니다.

ko.json 파일이 /home/Shinobi/languages/ 폴더에 복사되었는지
파일 이름이 정확히 ko.json인지
conf.json에 "language": "ko"가 들어 있는지
JSON 문법에 쉼표 오류가 없는지
수정 후 Docker 컨테이너를 재시작했는지
다른 이름의 Shinobi 컨테이너를 재시작한 것은 아닌지

브라우저 강력 새로고침이나 재로그인이 필요할 수 있다는 내용도 README에 안내되어 있습니다.

기존 파일 백업하기

한글패치를 설치하기 전에 기존 ko.json 파일이 있다면 백업해 두는 것이 좋습니다.

컨테이너 안에서 백업하려면 다음 명령어를 실행합니다.

docker exec shinobi cp \
/home/Shinobi/languages/ko.json \
/home/Shinobi/languages/ko.json.backup

나중에 기존 파일로 되돌리려면 다음 명령어를 사용합니다.

docker exec shinobi cp \
/home/Shinobi/languages/ko.json.backup \
/home/Shinobi/languages/ko.json

그다음 컨테이너를 재시작합니다.

docker restart shinobi

업데이트 방법

번역 파일이 업데이트되면 GitHub에서 최신 ko.json 파일을 다시 다운로드한 후 기존과 같은 방법으로 덮어쓰면 됩니다.

docker cp ko.json shinobi:/home/Shinobi/languages/
docker restart shinobi

브라우저에서 다음 키를 눌러 최신 번역 파일을 다시 불러옵니다.

Ctrl + Shift + R

주의사항

이 한글패치는 Shinobi 프로그램 자체를 수정하거나 기능을 추가하는 패치가 아닙니다.

관리 화면에 표시되는 영어 문구를 한국어로 바꾸는 언어 파일입니다.

Shinobi 업데이트로 메뉴 이름이나 언어 항목이 변경되면 일부 문장이 영어로 표시되거나 번역이 맞지 않을 수 있습니다.

오역이나 번역되지 않은 항목을 발견하면 GitHub의 Issues 메뉴에 해당 영어 문구와 사용된 화면을 남겨주세요.

마무리

Shinobi는 기능이 매우 많지만 영어 메뉴 때문에 처음에는 어렵게 느껴질 수 있습니다.

이번 한국어 번역 파일을 적용하면 카메라 추가, 녹화 영상 확인, 움직임 감지, 저장공간 설정 등의 메뉴를 보다 쉽게 확인할 수 있습니다.

번역 파일은 무료로 사용할 수 있으며 MIT 라이선스로 배포합니다. 저장소에서는 오역 제보와 번역 개선을 위한 Issue 및 Pull Request도 받고 있습니다.

도움이 되었다면 GitHub 저장소에서 Star를 눌러주시면 번역을 계속 개선하는 데 큰 힘이 됩니다.

다운로드 및 자세한 설명

https://github.com/fire-olli/Shinobi-Korean