TV 데이터베이스 API 키 생성 및 사용 방법: Kodi 개발자 팁

Kodi 소프트웨어는 무료 오픈 소스이므로 누구나 코드를 확인하거나 핵심 기능에 대한 변경 사항을 기여할 수 있습니다. 하지만 Kodi의 진정한 힘은 바로 커뮤니티입니다. Kodi는 사용자가 제작한 애드온과 연동되도록 설계되었으며, 이러한 애드온은 Kodi 핵심 팀만으로는 구현할 수 없는 다양한 콘텐츠를 제공합니다. 이러한 애드온을 비공식 애드온이라고 하며, 만들기가 매우 쉬워서 오후 한나절 만에 직접 만들 수 있습니다!

Kodi 애드온 개발자에게 제공되는 매우 유용한 서비스 중 하나는 TheTVDB.com이나 Trakt와 같은 TV 데이터베이스 인덱서입니다. 두 사이트 모두 웹에서 메타데이터를 스크래핑하여 대중에게 무료로 제공합니다. 즉, 다양한 TV 프로그램을 검색하는 애드온을 만들고 TheTVDB를 사용하여 모든 프로그램을 분류하고, 라벨을 지정하고, 정렬할 수 있습니다. 직접 정보를 가져오거나 추적기를 직접 만들 필요가 없습니다. TV 데이터베이스에서 API 키를 가져와 애드온에 연결하기만 하면 됩니다. 아래 가이드를 통해 처음부터 끝까지 과정을 안내해 드립니다.

1위 VPN을 받으세요

68% 할인 + 3개월 무료

알림

Kodi용 애드온을 개발하고 있다면, 이 소프트웨어가 대중의 눈에 얼마나 잘 드러나는지 잘 알고 계실 겁니다. Kodi 자체는 안전하며, 대부분의 애드온 또한 안전합니다. 하지만 인터넷 서비스 제공업체(ISP)와 콘텐츠 제작자는 종종 그렇게 생각하지 않기 때문에, Kodi에서 스트리밍하는 순간부터 계정이 감시될 수 있습니다. 애드온의 정품 여부와 관계없이, 제한되거나 계정이 추적될 위험에 노출될 수 있습니다.

다행히 가상 사설망(VPN)은 이러한 사생활 침해를 쉽게 차단할 수 있는 방법입니다. VPN을 사용하면 데이터가 기기에서 나가기 전에 암호화되어 다른 사람이 어떤 사이트를 방문하고 어떤 Kodi 스트림에 접속하는지 알 수 없습니다. 또한 VPN은 사용자의 신원이나 위치를 알아내기 어렵게 만들어 월드 와이드 웹의 익명성을 어느 정도 확보합니다.

Kodi를 위한 최고의 VPN – IPVanish

IPVanish는 Kodi와 함께 사용하기에 완벽한 VPN으로, 모든 면에서 완벽한 선택입니다. 60개국에 950개 이상의 서버를 제공하는 빠른 속도를 자랑하므로 어디에 살든 항상 저지연 연결을 이용할 수 있습니다. 또한 256비트 AES 암호화, DNS 유출 방지, 모든 기기에 대한 자동 킬 스위치 기능을 제공하여 보안도 뛰어납니다. 트래픽에 대한 무기록 정책을 활용하여 토렌트 및 P2P 네트워크 콘텐츠를 완벽한 익명성으로 다운로드할 수 있습니다. IPVanish를 사용하면 앱만 실행하면 안전하게 연결할 수 있습니다.

IPVanish의 추가 기능:

Windows, Mac, Linux, Android, iOS에서 사용하기 쉬운 앱입니다.

속도 제한이나 속도 조절 없이 무제한 대역폭을 제공합니다.

Kodi의 모든 애드온에 대한 완전하고 익명의 접근이 가능합니다.

IPVanish는 7일 환불 보장을 제공하므로, 일주일 동안 위험 부담 없이 체험해 보실 수 있습니다. WebTech360 Tips 독자분들은 IPVanish 연간 플랜에서 무려 60%를 절약하실 수 있으며 , 월 이용료는 $4.87/월입니다.

시작하기 전에

모든 훌륭한 개발자가 그렇듯, 먼저 조사를 하고 나서야 비로소 시작할 수 있습니다. 다음 섹션을 읽고 혹시라도 오해할 만한 부분을 바로잡은 후, API를 가져와서 테스트를 시작해 보세요.

TV 데이터베이스 API 키 생성 및 사용 방법: Kodi 개발자 팁

TV 데이터베이스란 무엇인가?

Kodi 애드온을 개발 중이라면 상당량의 영화나 TV 프로그램 콘텐츠를 인덱싱할 계획일 것입니다. 이러한 파일을 제공하는 사이트는 대개 비디오만 제공하며, 콘텐츠를 식별하는 데 도움이 되는 관련 데이터는 제공하지 않습니다. 파일 이름에는 프로그램, 시즌, 에피소드 번호가 포함될 가능성이 높지만, 출연진이나 에피소드의 실제 제목은 어떻게 될까요? 바로 이 부분에서 인덱싱 데이터베이스가 중요한 역할을 합니다.

Kodi 애드온을 좋은 데이터베이스에 연결하면 프로그램이 웹에서 접근하는 모든 콘텐츠의 이름을 지정하고 분류할 수 있습니다. 애드온에서 에피소드를 쉽게 정렬하고 검색할 수 있으며, 인덱싱 서비스에서 수집된 메타데이터 덕분에 보기에도 훨씬 편해집니다.

데이터베이스에는 어떤 정보가 포함되어 있나요?

이는 사용하는 서비스에 따라 다를 수 있지만, 대부분의 인덱서는 다음을 포함하는 핵심 데이터 세트에 중점을 둡니다.

이 쇼의 전체 제목과 원래 방영 날짜입니다.

에피소드 이름과 번호.

장르 정보.

배우, 감독, 작가 등에 대한 데이터

팬이 만든 것과 공식 박스 아트.

사용자 평점과 비평가 리뷰 점수.

다른 언어로 번역된 메타데이터.

정보는 어디에서 나오는가?

여러분을 놀라게 할 만한 다양한 출처. 정확한 정보가 중요하기 때문에 데이터베이스 스크래퍼는 가능한 한 출처에 가깝게 접근합니다. 이는 일반적으로 Amazon이나 IMDB와 같은 공식 사이트를 참조하는 것을 의미하는데, 두 사이트 모두 스튜디오에서 직접 영화 제목과 관련 정보를 가져옵니다. 이것이 실패하면 다른 인덱서들이 다른 공개 추적기와 콘텐츠를 교차 참조하거나 사용자가 제출한 데이터를 사용하여 영화 개봉작에 태그를 지정합니다.

API 키

API는 애플리케이션 프로그래밍 인터페이스(Application Programming Interface)의 약자입니다. API 키는 특정 서비스에 대한 프로그램 접근 권한을 부여하는 작은 권한 파일이나 무작위 문자 및 숫자 문자열입니다. 예를 들어 Twitter에서 사용할 앱을 개발하는 경우, 웹사이트에서 코드가 Twitter 콘텐츠와 상호 작용할 수 있도록 API 키가 필요합니다. TV 데이터베이스 인덱스 키도 거의 같은 방식으로 작동합니다. Kodi 애드온에 API 키를 추가하면 외부 웹사이트에서 데이터를 가져와 Kodi 내에서 사용하는 데 필요한 자격 증명을 제공하게 됩니다.

어떤 데이터베이스를 사용할 것인가

월드 와이드 웹에는 여러 색인 데이터베이스가 존재합니다. 어떤 데이터베이스는 다른 데이터베이스보다 사용하기 쉽고, 어떤 데이터베이스는 경쟁 데이터베이스보다 최신 정보를 제공합니다. 아래 가이드에서는 TV 팬들을 위한 오픈 데이터베이스인 TheTVDB.com의 API 생성 과정을 살펴보겠습니다. TheTVDB.com은 가장 포괄적인 리소스 중 하나이며, 설정과 배포가 간편합니다.

메타데이터 인덱스는 합법적인가요?

물론입니다. 아래에서 사용할 TV 데이터베이스와 같은 색인 서비스는 콘텐츠 자체에는 접근하지 않고 콘텐츠와 관련된 메타데이터에만 접근합니다. 이러한 서비스를 사용하여 스트리밍할 수도 없고, 어떤 방식으로든 불법 복제에 기여하지도 않습니다. 또한 일반적으로 크리에이티브 커먼즈 라이선스에 따라 무료 배포됩니다. DVD 컬렉션을 선반에 정리하는 것과 같은 디지털 방식입니다. 완벽하게 안전하고 100% 합법적입니다.

TV 데이터베이스 API 키 생성

Kodi 애드온 프로젝트를 작동 상태로 만들면 API 키를 가져와서 테스트를 시작할 수 있습니다.

TV 데이터베이스 API 키 생성 및 사용 방법: Kodi 개발자 팁

1단계 – 계정 만들기

TheTVDB.com을 방문하여 서비스 계정을 만드세요. 일관성을 위해 코딩 닉네임이나 애드온 이름을 사용하세요. 등록 후 로그인 후, 아래로 스크롤하여 페이지 하단의 확인란을 선택하여 이용 약관에 동의해야 합니다.

2단계 – 키 생성

계정이 생성되면 API 키 등록 페이지 로 이동하세요 . 하단에 프로젝트 이름과 공식 웹사이트를 입력해야 합니다. 입력이 완료되면 "API 키 가져오기"를 클릭하세요.

3단계 – API 키 저장

TheTVDB는 별도 페이지에 키 코드를 표시합니다. 이 코드는 안전한 곳에 복사하고, 신청서용으로만 생성되었으므로 다른 사람과 공유하지 마세요. 나중에 참조해야 하므로 가까운 곳에 보관하세요.

Kodi 애드온에서 API 키 사용

TheTVDB 또는 다른 메타데이터 인덱싱 서비스를 사용하여 API 키를 생성했으면 이제 애드온 코드에 연결하여 제대로 작동하는지 확인해야 합니다. 이 과정은 애드온을 어떻게 구성했는지에 따라 달라질 수 있습니다. 여기서는 Kodi 애드온과 트래커를 결합하는 데 널리 사용되는 방법인 Jen 템플릿을 사용하겠습니다.

TV 데이터베이스 API 키 생성 및 사용 방법: Kodi 개발자 팁

1단계 – Jen 템플릿 다운로드

Jen Template의 github 페이지를 방문하세요 . 오른쪽 상단의 "복제 또는 다운로드"라고 적힌 녹색 버튼을 클릭하고 zip 파일을 데스크톱에 다운로드하세요. 압축을 풀고 별도의 폴더에 저장한 후 편집할 준비를 하세요.

2단계 – Addon.xml 편집

방금 압축을 푼 plugin.video.jen-master 폴더 안에 addon.xml이라는 파일이 있습니다. 코드 편집기에서 이 파일을 여세요. 템플릿이 참조하는 데이터를 사용자 지정하려면 일부 줄을 수정해야 합니다. 아래에서 참조하는 파일의 두 번째 줄에 정보를 입력하세요. 공백이나 비표준 문자는 사용할 수 없고, 문자와 숫자만 사용해야 하며, 버전 번호도 설정하는 것을 잊지 마세요.

다음으로, 19번째 줄과 21번째 줄을 편집하여 애드온에 대한 정보를 조금 더 추가하세요.

애드온 요약

더 긴 애드온 설명

다른 언어를 참조하는 중복된 줄이 표시될 수 있습니다. 그대로 두거나 필요에 따라 제거할 수 있습니다.

addon.xml 파일을 저장하면 일단 편집은 끝났습니다.

TV 데이터베이스 API 키 생성 및 사용 방법: Kodi 개발자 팁

3단계 – Default.py 편집

API 키 정보를 입력하는 부분입니다. 같은 최상위 폴더에서 default.py라는 파일을 찾으세요. 코드 편집기에서 열고, 아래에 참조된 줄이 나올 때까지 아래로 스크롤하세요. 25번째 줄쯤에 있을 겁니다.

__builtin__.tvdb_api_key = "여기에 API 키를 붙여넣으세요" # tvdb API 키

위에 표시된 곳에 TV 데이터베이스 API 키를 입력하세요. 실제 줄에는 따옴표 두 개만 있고 그 사이에는 아무것도 없습니다.

default.py를 저장하고 종료하세요. API 키가 입력되었습니다!

4단계 – Settings.xml 편집

마지막으로 편집할 파일 하나만 더 추가한 후, 다시 테스트로 돌아갑니다. 플러그인 작업 디렉터리에 있는 resources 폴더로 이동합니다. 코드 편집기에서 settings.xml 파일을 열고 27번째 줄까지 아래로 스크롤합니다. Jen 템플릿 설정을 완료하려면 여기에 몇 가지 정보를 입력해야 합니다.

파일 코드에서 다음 줄을 확인하세요. 27, 31, 36번 줄에 세 번 나타나야 합니다.

action="RunPlugin(plugin://plugin.video.jen/?mode=ScraperSettings)"/>

plugin.video.jen 이라고 적힌 부분이 보이시나요 ? 이 부분을 addon.xml 파일에 입력한 것과 같은 플러그인 이름으로 변경하세요. 예를 들어 plugin.video.addictivetips라고 입력했다면 해당 줄은 다음과 같습니다.

액션="RunPlugin(plugin://plugin.video.addictivetips/?mode=ScraperSettings)"/>

이 파일을 저장하고 종료합니다.

5단계 – 이름 바꾸기 및 테스트

API 및 사용자 지정 데이터를 입력했으니 이제 마무리할 준비가 되었습니다. 편집한 모든 파일을 저장했는지 확인한 후, 파일을 종료하고 데스크톱으로 돌아가세요. 작업 중인 폴더의 제목은 다음과 같습니다.

플러그인.비디오.jen-마스터

addon.xml 파일에 입력한 이름과 같은 섹션에 입력한 버전 번호를 합친 이름을 이 이름으로 변경하세요. 위의 예를 사용하면 파일 이름은 다음과 같습니다.

플러그인.비디오.중독성팁.0.1.zip

이제 TVDB API 데이터를 애드온에 추가했으므로 웹에서 메타데이터를 스크래핑할 준비가 되었습니다.

기타 추가 기능 사용자 정의

Jen 템플릿과 TV 데이터베이스 API 키를 준비했다면, 이제 몇 가지 맞춤 설정 기능을 추가하여 출시작의 브랜드를 강화해 보는 건 어떨까요? 빠르고 간단한 단계들을 통해 애드온을 더욱 눈에 띄게 만들 수 있습니다.

아이콘 추가

Kodi에서 애드온을 강조 표시할 때마다 화면 왼쪽에 아��콘 이미지가 표시됩니다. 아이콘을 추가하면 제목을 읽지 않고도 콘텐츠를 쉽게 찾을 수 있어 생각보다 훨씬 유용할 수 있습니다! 아이콘을 사용하려면 텍스트나 Kodi 브랜딩이 없는 256x256 PNG 파일을 만든 다음, icon.png라는 이름의 폴더 최상위에 추가하기만 하면 됩니다. 끝!

팬아트를 사용하세요

위 아이콘과 마찬가지로, 팬아트는 Kodi에서 사용자가 콘텐츠를 강조 표시할 때마다 선택 텍스트 뒤에 나타나는 스플래시 배경 이미지입니다. 아이콘 브랜딩과 관련이 있을 수도 있고, 애드온 콘텐츠와 관련된 테마일 수도 있습니다. 예를 들어, 플러그인이 TV 프로그램을 제공하는 경우, "How I Met Your Mother"의 캐릭터가 등장하는 독창적인 팬아트 배너를 제작할 수 있습니다. 이 배너를 출시에 추가하려면 1280x720 JPG 이미지를 만들고 fanart.jpg라는 이름으로 애드온의 최상위 폴더에 붙여넣으세요.

결론

애드온 개발은 복잡하고 어려울 수 있습니다. 하지만 커뮤니티에서는 개발 과정에 도움이 되는 유용한 리소스를 많이 제공합니다. TV 데이터베이스 API 키를 추가하는 것은 애드온과 연동하여 사용할 수 있는 사용자 제작 콘텐츠의 한 예일 뿐입니다. Kodi 개발자를 위한 유용한 팁이 있으신가요? 아래 댓글에 여러분의 지식을 공유해 주세요!