# 공지
리포지터리 삭제되었습니다
# EPG2XML
이 프로그램은 EPG(Electronic Program Guide)를 웹상의 여러 소스에서 가져와서 XML로 출력하는 프로그램으로 python2.7 및 php5.4.45 이상에서 사용 가능하도록 제작되었다.
python3과 php 5.4.45 이하에서는 정상적인 작동을 보장하지 못한다. 또한 외부의 소스를 분석하여 EPG 정보를 가공하여 보여주는 것이므로 외부 소스 사이트가 변경되거나 삭제되면 문제가 발생할 수 있다.
## 개발자 후원하기
https://www.facebook.com/chericface
페이스북을 사용하신다면 개발자 후원하는 방법이라고 생각해주시고 위의 링크 들어가서 좋아요 눌러주시면 감사하겠습니다.
제가 관련된 곳에서 운영하는 페이스북인데 아직 초기라서 사람이 많이 없습니다. 화학공학 및 소재 관련 사이트입니다.
감사합니다.
## 필요 모듈
### epg2xml.py
BeautifulSoup(bs4), lxml, requests 모듈이 추가로 필요하다.
설치 OS별로 모듈을 설치하기 위한 사전 설치 방법이 다를 수도 있으므로 검색해서 설치하도록 한다.
pip install beautifulsoup4, pip install lxml, pip install requests 로 추가할 수 있다.
* easy_install로 설치시 모듈이 인식되지 않는 경우가 있으므로 pip로 설치하기를 권한다.
### epg2xml.php
json, dom, mbstring, openssl, curl 모듈이 필요하다. 일반적으로 PHP가 설치되어 있다면 대부분 설치되어 있는 모듈이나 설치되어 있지 않을 경우 추가로 설치해야 한다.
### epg2xml-web.php
epg2xml.php와 동일하다.
## 설정방법
### epg2xml.json
epg2xml.json 안의 항목이 설정 가능한 항목이다.
MyISP : 사용하는 ISP를 넣는다 .(ALL, KT, LG, SK가 사용가능하다)
MyChannels : EPG 정보를 가져오고자 하는 채널 ID를 넣는다. ("1, 2, 3, 4" 또는 "1,2,3,4")
output : EPG 정보 출력방향 (d: 화면 출력, o: 파일 출력, s:소켓출력)
default_icon_url : 채널별 아이콘이 있는 url을 설정할 수 있다. 아이콘의 이름은 json 파일에 있는 Id.png로 기본설정되어 있다.
default_rebroadcast : 제목에 재방송 정보 출력
default_episode : 제목에 회차정보 출력
default_verbose : EPG 정보 상세 출력
default_xmltvns : 에피소드 정보 표시 방법
default_fetch_limit : EPG 데이터 가져오는 기간.
default_xml_filename : EPG 저장시 기본 저장 이름으로 tvheadend 서버가 쓰기가 가능한 경로로 설정해야 한다.
default_xml_socket : External XMLTV 사용시 xmltv.sock가 있는 경로로 설정해준다.
### Channel.json
Channel.json 파일의 최신버전은 https://github.com/wonipapa/Channel.json 에서 다운받을 수 있다.
Channel.json 파일을 텍스트 편집기로 열어보면 각채널별 정보가 들어 있다.
## 옵션 소개
### epg2xml.py, epg2xml.php 옵션
실행시 사용가능한 인수는 --help 명령어로 확인이 가능하다.
epg2xml.json의 설정을 옵션의 인수를 이용하여 변경할 수 있다.
-h --help : 도움말 출력
--version : 버전을 보여준다.
-i : IPTV 선택 (ALL, KT, SK, LG 선택가능) ex) -i KT
-d --display : EPG 정보를 화면으로 보여준다.
-o --outfile : EPG 정보를 파일로 저장한다. ex) -o xmltv.xml
-s --socket : EPG 정보를 xmltv.sock로 전송한다. ex) -s /var/run/xmltv.sock
-l --limit : EPG 정보 가져올 기간으로 기본값은 2일이며 최대 7일까지 설정 가능하다. ex) -l 2
--icon : 채널 icon 위치 URL ex) --icon http://www.example.com
--rebroadcast : 제목에 재방송정보 표기 ex) --rebroadcast y
--episode : 제목에 회차정보 표기 ex) --episode y
--verbose : EPG 정보 상세하게 표기 ex) --verbose y
### epg2xml-web.php 옵션
실행시 사용가능한 인수는 epg2xml.php?help 명령어로 확인이 가능하다.
epg2xml.json의 설정을 옵션의 인수를 이용하여 변경할 수 있다.
ex : http://domain/epg2xml.php?i=ALL&l=2
## 사용방법
### tv_grab_file 사용시 (https://github.com/nurtext/tv_grab_file_synology)
tv_grab_file 안의 cat xmltv.xml 또는 wget 이 있는 부분을 아래와 같이 변경해준다.
python 경로와 php의 경로는 /usr/bin에 있고, epg2xml 파일은 /home/hts에 있는 것으로 가정했다.
이 경우 epg2xml.json의 output을 d로 해야 한다.
#### PYTHON의 경우
/usr/bin/python /home/hts/epg2xml.py 또는
/home/hts/epg2xml.py
#### PHP CLI의 경우
/usr/bin/php /home/hts/epg2xml.php 또는
/home/hts/epg2xml.php
#### PHP WEB의 경우
wget -O - http://www.examle.com/epg2xml-web.php 또는
wget -O - http://www.example.com/epg2xml-web.php?i=ALL&l=2
### XMLTV SOCKET 사용시
**xmltv.sock 사용시 socat 등을 사용하지 않고 바로 socket에 쓰기가 가능하다**
#### PYTHON의 경우
/usr/bin/python /home/hts/epg2xml.py 또는
/home/hts/epg2xml.py
#### PHP CLI의 경우
/usr/bin/php /home/hts/epg2xml.php 또는
/home/hts/epg2xml.php
#### PHP WEB의 경우
php web 버전은 xmltv.sock을 지원하지 않는다.
## 라이센스
BSD 3-clause "New" or "Revised" License
## WIKI
https://github.com/wonipapa/epg2xml/wiki
## FAQ
https://github.com/wonipapa/epg2xml/wiki/FAQ
## 변경사항
### Version 1.2.6
- SKB 함수 버그 수정
- KT, LG, SK, SKB, NAVER 이외의 함수 삭제
### Version 1.2.5
- SKB 함수 수정
- SKB 함수 수정(p1)
- SKY 함수 수정(p2)
- HCN 함수 삭제(p3)
### Version 1.2.4
- ISCS 함수 수정
- SKB 함수 수정(p1)
### Version 1.2.3
- PHP 버전통합
- PYTHON 버전 html Parser 변수 추가(libxml지원안하는 기기 편의 지원)
- everyontv 함수 추가
- Channel.json Enabled 항목 제거
- 에피소드 넘버 xmltv_ns 옵션 항목 추가 (epg2xml.json)
- 가져오는 날짜 최대 7일로 변경
- KT 함수 수정
- PHP 버전 socket 사용시 화면에 출력되는 문제 해결(p1)
- PHP 버전 한글 깨지는 문제 수정(p2)
- SK 함수 수정(p3)
- 이터레이션 수정(p4)
- oksusu함수 추가(p4)
- PHP 버전 Pooq함수 복구(p5)
### Version 1.2.2
- My Channel 추가
- 소스 추가
- 에피소드 넘버 xmltv_ns 추가
- PHP 공용함수 분리
- POOQ 함수 기간에 관계없이 하루만 가져오는 것 수정
- ISCS 함수 수정
- HCN 함수 수정
### Version 1.2.1
- SKB 함수 추가
- 가져오는 날짜 최대 2일로 변경
- 타이틀이 1부, 2부 등 을 포함할 때 1부, 2부를 서브타이틀로 이동
- Channel.json release date 삭제
- Channel.json 채널 기본 설정 Enalble 0으로 변경
- Channel 소스 변경
- GCN 채널 삭제
- readme.txt Readme.md로 통합
### Version 1.2.0
- 커넥션 관련 에러 예외 처리 추가
- 채널 소스 변경
- Channel.json release date 추가
### Version 1.1.9
- 언어 버전 사항 체크
- 필요 모듈 사항 체크
- 버그 수정
- php 버전 웹 버전 추가
- php 버전 file_get_contents를 curl 사용으로 수정
### Version 1.1.8
- KBS 함수 추가
- 채널 변경 사항 반영
- 스카이라이프 url 변경
- EPG 누락 데이터 수정
### Version 1.1.7
- PHP 7.0 지원
- 채널 변경 사항 반영
- 라디오 채널 추가
### Version 1.1.6
- iptv 선택 항목에 ALL 추가
- 에피소드 넘버 출력 수정
- 시작 시간 에러 출력 수정
- 타이틀 출력 수정
- 서브타이틀 추출 수정
- 데이터 중복 출력 문제 수정
- php 버전이 5.6.3 이전일 때 DOM access 관련 에러 수정
### Version 1.1.5
- inline 변수 재추가
### Version 1.1.4
- epg2xml.json 파일 도입
- inline 변수 삭제
- PHP 버전 추가
- 버그 수정
### Version 1.1.3
- 제목에 회차정보, 재방송 정보 추가시 오류 수정
### Version 1.1.2
- 재방송정보, 회차정보 옵션 추가
### Version 1.1.1
- sk 카테고리 오류 수정
### Version 1.1.0
- 채널 아이콘 추가
- 오류 메시지 통합
### Version 1.0.9
- 소켓파일이 없을 때 오류 추가
- 채널 변경 사항 반영
### Version 1.0.8
- 정지 시간 추가
- 오류 출력 구문 디버그시만 출력으로 변경
- 채널 소스 변경
### Version 1.0.7
- urllib2를 requests로 변경
- User Agent 변경
- 오류 처리 추가
- 채널 변경 사항 반영
- 채널 소스 변경
- 지역 지상파 채널 추가
### Version 1.0.6
- urllib를 urllib2로 변경
- User Agent 추가
- 채널 변경 사항 반영
### Version 1.0.5
- epg.co.kr의 epg 정보 못가져오는 것 수정
### Version 1.0.4
- KODI에서 사용가능하도록 수정
- 제목에서 서브타이틀 및 회차 분리
- 서브타이틀 추가
- 출연, 제작진 개인별로 분리
### Version 1.0.3
- Channel.json 파일 오류 수정
- LG를 소스로 하는 EPG 정보 기간 오류 수정
### Version 1.0.2
- ISP별 분리된 채널통합
- 개별 채널별 EPG 정보 수집가능하도록 Enabled 추가
- getMyChannel 함수 삭제
- 채널 변경 사항 반영
- KT TRU TV 채널 삭제
- ISP 선택 설정 추가
- EPG 정보 가져오는 기간 설정 추가
- 채널 아이콘 설정 URL 설정 추가
- tvheadend 전용 카테고리 추가
### Version 1.0.1
- EPG 소스 변경
- 등록된 채널 정보만 EPG 정보 가져오도록 설정
- IPTV별 개인화
### Version 1.0.0
- first release