이 가이드는 Windows, macOS, 리눅스, Android, Fire TV/Firestick, Xbox, Nvidia Shield TV, Raspberry Pi(LibreELEC/OpenELEC), 그리고 Android 기반 스마트 TV에서 Kodi를 안전하게 업데이트하는 방법을 단계별로 설명합니다. 각 플랫폼에서의 차이와 사전 준비, 일반적인 문제해결, 롤백 방법, 보안 권장사항까지 포함합니다.
중요: 업데이트 전 반드시 아래의 사전 점검(백업, 애드온 목록 기록 등)을 진행하세요. 애드온이나 커스텀 설정이 손실될 수 있습니다.
업데이트 전 점검과 권장 준비
- 백업(한 줄 정의): 미디어 라이브러리, 설정, 애드온 목록을 백업하면 문제가 생겨도 이전 상태로 복원할 수 있습니다.
- 왜 백업이 필요한가: 재설치 과정에서 설정 파일이나 애드온 데이터가 초기화될 수 있습니다.
체크리스트
- 미디어 라이브러리 데이터베이스(advancedsettings.xml, MyVideos*.db 등) 복사
- 애드온 목록과 설정 스냅샷(스크린샷 또는 파일 복사)
- 현재 설치된 Kodi 버전 기록(설정 > 시스템 정보에서 확인)
- 공인 출처에서 설치 파일 또는 스토어를 이용할 것
Note: 공식 저장소나 플랫폼 스토어를 사용하면 보안 위험이 줄어듭니다. 비공식 빌드나 서드파티 저장소는 문제가 될 수 있습니다.
Windows에서 Kodi 업데이트하는 방법
Windows는 다른 플랫폼과 달리 인스톨러 기반으로 업데이트(재설치)합니다. 라이브러리는 일반적으로 유지되지만 백업을 권장합니다.
단계별 가이드
- 웹 브라우저에서 Kodi Windows 인스톨러 페이지로 이동합니다(공식 Kodi 사이트 사용 권장).
- Windows 링크를 클릭하여 ZIP 파일을 다운로드합니다.
- Kodi를 실행하고 메인 메뉴에서 Add-ons(애드온)로 이동합니다.
- 상자 모양 아이콘(패키지 설치기)을 클릭하고 Install from ZIP file(ZIP에서 설치)을 선택합니다.
- 다운로드한 ZIP 파일의 경로로 이동하여 ZIP을 선택합니다.
- 설치 스크립트가 적용되면 Add-Ons 섹션에서 해당 스크립트를 열어 최신 버전의 Kodi를 선택해 설치를 진행합니다.
- 설치가 완료되면 시스템을 재시작합니다.
팁 및 유의사항
- 관리자 권한으로 설치 프로그램을 실행하세요.
- 이전 설정이 덮어쓰여질 수 있으므로 사용자 폴더에 있는 설정 파일을 미리 복사하세요.
- 문제가 발생하면 백업한 설정과 DB를 원래 위치로 복사하여 복원하세요.
macOS에서 Kodi 업데이트하는 방법
macOS는 앱을 응용 프로그램 폴더에 덮어쓰는 방식으로 업데이트합니다. Gatekeeper 보안 경고가 나타날 수 있으니 권한 부여가 필요합니다.
단계별 가이드
- macOS에서 Kodi 공식 웹사이트를 방문합니다.
- 상단의 Download 버튼을 클릭하고 macOS 섹션으로 이동합니다.
- Recommended 탭이 선택되어 있는지 확인한 뒤 Installer (64 bit) 버튼을 클릭해 파일을 다운로드합니다.
- 다운로드가 완료되면 .dmg 파일을 열고 Kodi 앱 아이콘을 Applications 폴더로 드래그합니다.
- 기존 앱을 교체하겠냐는 메시지가 나오면 Replace(바꾸기)를 클릭합니다.
- 만약 ‘확인되지 않은 개발자’ 경고가 뜨면 시스템 환경설정 > 보안 및 개인 정보에서 ‘허용’을 선택하세요.
팁 및 유의사항
- Apple Silicon(M1/M2) 장치의 경우 Intel 빌드와의 호환성을 확인하세요. 가능한 경우 공식 빌드가 Apple Silicon을 지원하는지 확인합니다.
- .dmg 파일의 서명이 비공식 빌드일 수 있으므로 공식 사이트를 이용하세요.
리눅스에서 Kodi 업데이트하는 방법
리눅스 배포판에 따라 업데이트 방법이 달라집니다. 가장 일반적인 APT 기반(예: 우분투, 데비안)의 명령을 예로 듭니다.
터미널 명령 예시
# 저장소 목록 갱신
sudo apt-get update
# 패키지 업그레이드
sudo apt-get upgrade
# 배포판 업그레이드(의존성 포함 최신 안정 버전으로)
sudo apt-get dist-upgrade추가 팁
- 공식 Kodi PPA를 추가한 경우
sudo add-apt-repository ppa:team-xbmc/ppa같은 명령을 사용했는지 확인하세요. - Snap 또는 Flatpak으로 설치한 경우 각각
snap refresh kodi또는flatpak update를 사용합니다. - 소스 빌드로 설치한 경우, 빌드 절차(소스 코드 재빌드)를 따르세요.
문제해결
- 의존성 충돌이 발생하면
/var/log/apt/로그를 확인하세요. - 특정 리눅스 배포판의 패키지 관리 정책 때문에 최신 버전이 바로 제공되지 않을 수 있습니다.
Android에서 Kodi 업데이트하는 방법
Android 기기는 공식적으로 Google Play 스토어를 통해 업데이트됩니다. 타사 APK로 설치한 경우 수동으로 APK를 다시 설치해야 합니다.
스텝
- Android 기기에서 Google Play 스토어를 엽니다.
- 프로필 아이콘을 탭하고 Manage apps & device(앱 및 기기 관리)를 선택합니다.
- 업데이트 가능한 앱 목록에서 Kodi를 찾습니다.
- 업데이트가 있으면 Update 버튼을 눌러 설치합니다.
비공식 APK 사용자
- 비공식 APK를 사용하면 자동 업데이트가 적용되지 않습니다. 최신 공식 APK를 다운로드해 재설치해야 합니다.
- 설정 > 보안에서 ‘알 수 없는 출처’ 허용 여부를 확인하세요(버전 및 보안 권장사항에 따라 이 옵션 활성화는 권장되지 않습니다).
Fire TV / Firestick에서 Kodi 업데이트하는 방법
Fire TV는 Amazon Appstore에 있는 앱을 통해 업데이트하거나, Downloader 앱으로 공식 웹사이트에서 APK를 내려받아 설치합니다.
스텝(Downloader 앱 사용)
- Amazon Appstore에서 Downloader 앱을 설치합니다.
- Downloader를 열고 주소창에 https://kodi.tv 를 입력합니다.
- Download 페이지에서 Android 로고를 탭하고 Recommended 탭에서 ARMV7a (32-bit) 또는 장치에 맞는 아키텍처를 선택합니다.
- APK를 다운로드한 뒤 설치합니다.
주의사항
- Firestick의 모델(최신/구형)에 따라 아키텍처(ARMV7, ARM64)가 다릅니다. 장치 아키텍처를 확인하세요.
- ‘알 수 없는 출처’ 허용을 켜야 합니다(설정 > 보안 및 제한 사항).
Xbox에서 Kodi 업데이트하는 방법
- Xbox 컨트롤러에서 Xbox 버튼을 눌러 가이드를 엽니다.
- My apps & games > See all(내 앱 및 게임 > 모두 보기)로 이동합니다.
- 왼쪽에서 Kodi를 선택한 다음 Manage(관리)를 선택합니다.
- 사용 가능한 업데이트가 있다면 Update(업데이트) 버튼을 클릭하여 설치합니다.
팁
- Xbox 스토어에서 공식 Kodi 버전만 사용하세요. 개인적으로 패키징된 비공식 앱은 권장되지 않습니다.
Nvidia Shield TV에서 Kodi 업데이트하는 방법
- Shield TV에서 Google Play 스토어를 열고 My apps(내 앱)으로 이동합니다.
- 설치된 앱 목록에서 Kodi를 찾습니다.
- Update All(모두 업데이트) 또는 Kodi 옆의 Update 버튼을 눌러 최신 버전으로 업데이트합니다.
팁
- Shield는 Android TV 기반이므로 Android 업데이트 방식과 유사합니다.
Raspberry Pi에서 Kodi 업데이트하는 방법
라즈베리 파이에 Kodi를 설치한 방법(LibreELEC/OpenELEC 등)에 따라 업데이트 절차가 달라집니다.
LibreELEC 업데이트 스텝
- Settings > LibreELEC/OpenELEC으로 이동합니다.
- System(시스템)에서 Updates(업데이트) 섹션을 찾습니다.
- Update Channel(업데이트 채널)을 Main Version 등 적절하게 설정합니다.
- Available Versions(사용 가능한 버전)에서 최신 버전을 선택하고 Confirm(확인)합니다.
- LibreELEC가 자동으로 다운로드 및 설치합니다.
팁
- SD 카드 이미지를 사용한 커스텀 설치일 경우, 이미지를 교체하거나 수동으로 패키지를 적용해야 할 수 있습니다.
- 부팅 문제 발생 시 SD 카드 백업으로 롤백하세요.
스마트 TV에서 Kodi 업데이트하는 방법
Android 기반 스마트 TV는 Google Play 스토어에서 Kodi를 업데이트할 수 있습니다. Tizen(OS)이나 webOS 기반 TV는 Kodi 공식 지원이 없습니다.
Android TV 업데이트 스텝
- TV에서 Google Play 스토어를 엽니다.
- 좌측 메뉴에서 My Apps(내 앱)를 선택합니다.
- 설치된 앱 목록에서 Kodi를 찾아 Update를 선택합니다.
제한 사항
- iOS, Chrome OS, tvOS(Apple TV) 등 공식적으로 업데이트 경로가 없는 플랫폼은 기존 앱을 삭제하고 재설치해야 합니다.
- Tizen 또는 webOS용은 공식 Kodi 앱이 없으므로 대체 방법이나 서드파티 빌드를 권장하지 않습니다.
문제 발생 시 일반적인 원인과 해결책
- 설치 후 라이브러리/설정이 사라짐
- 해결: 사전 백업한 DB와 설정 파일을 복원하세요.
- 애드온 충돌이나 동작 불가
- 해결: 애드온을 최신 버전으로 업데이트하거나 비활성화 후 재설치합니다.
- 아키텍처 불일치(ARMv7 vs ARM64)
- 해결: 장치 아키텍처에 맞는 빌드를 설치하세요.
- 권한 또는 Gatekeeper 문제
- 해결: macOS의 경우 보안 & 개인 정보에서 허용, Windows는 관리자 권한으로 실행하세요.
롤백 방법(간단)
- 백업을 이용해 이전 설정과 DB를 복원합니다.
- LibreELEC의 경우 이전 이미지로 SD 카드를 복원합니다.
- Windows/Mac에서는 이전 인스톨러를 구해 재설치합니다(공식 저장소에 보관된 경우에 한함).
보안 및 프라이버시 권장사항
- 공식 사이트나 공식 스토어에서만 설치하세요.
- 서드파티 애드온은 개인 정보와 보안을 위험에 빠뜨릴 수 있습니다.
- 네트워크 공유 설정을 검토하여 필요한 경우에만 SMB/NFS를 사용하세요.
- 원격 액세스(웹 인터페이스, SSH 등)를 활성화할 때는 강력한 비밀번호를 사용하고 로컬 네트워크로만 제한하세요.
중요: 비공식 컨텐츠를 제공하는 애드온은 법적·보안적 위험을 초래할 수 있습니다.
테스트 기준과 수락 조건
업데이트가 성공적으로 완료되었는지 확인할 체크리스트
- Kodi 버전이 최신 버전으로 표시된다(설정 > 시스템 정보)
- 미디어 라이브러리(비디오/오디오/사진 목록)가 정상적으로 표시된다
- 주요 애드온이 정상 작동한다(스캔, 스트리밍 테스트)
- 시스템 로그에 치명적 에러가 없는지 확인한다
수락 기준
- 위의 모든 항목이 통과되면 업데이트가 성공적으로 완료된 것으로 판단합니다.
역할별 체크리스트
엔드유저
- 백업 수행
- 공식 스토어/사이트에서 설치
- 설치 후 라이브러리와 애드온 테스트
시스템 관리자
- 네트워크 접근 제어 적용
- 내부 가이드(버전 정책, 승인된 애드온 목록) 배포
- 롤백 절차, 백업 스케줄 관리
간단한 의사결정 흐름도
flowchart TD
A[어떤 기기에서 업데이트할까요?] -->|Windows| B[Windows 인스톨러로 재설치]
A -->|macOS| C[공식 .dmg로 덮어쓰기]
A -->|Android| D[Google Play에서 업데이트 또는 APK 재설치]
A -->|Fire TV| E[Downloader로 공식 APK 설치]
A -->|LibreELEC| F[Settings > Updates 사용]
A -->|기타'지원없음'| G[앱 삭제 후 공식 설치 방법으로 재설치]
B --> H[백업이 있나요?]
H -->|예| I[업데이트 진행]
H -->|아니오| J[백업 안내 후 진행]대안적 접근과 예외 상황
- 자동 업데이트가 가능한 플랫폼(Android, Xbox, Shield)은 스토어 기반 업데이트를 우선 권장합니다.
- 리눅스처럼 패키지 관리자가 최신 버전을 제공하지 않을 때는 PPA나 스냅/플랫팩 대체를 고려하세요.
- iOS, tvOS처럼 공식 방법이 없는 플랫폼은 앱 삭제 후 재설치를 통해 버전을 교체할 수 있습니다.
언제 이 방법이 실패하는가(반례)
- 비공식 커스텀 빌드 또는 루트 권한으로 변경된 시스템에서는 기본 절차가 동작하지 않을 수 있습니다.
- 하드웨어 아키텍처가 지원되지 않는 경우(예: 오래된 ARMv6 기기)
체크포인트 요약
- 업데이트 전 백업: 필수
- 공식 출처 사용: 권장
- 아키텍처/스토어 방식 확인: 필수
- 업데이트 후 기능 점검: 필수
감사합니다. 이 가이드를 따라 각 플랫폼별로 안전하게 Kodi를 업데이트하시기 바랍니다. 문제가 지속되면 백업에서 복원하거나, 플랫폼별 포럼에서 로그를 공유하여 추가 지원을 받으세요.
