flywithu/epg2xml
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Update README.md

Browse Source
This commit is contained in:
wonipapa 2017-07-25 12:34:19 +09:00
parent 2abd8db344
commit a90df8be49
1 changed files with 47 additions and 45 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

92
README.md
View File

@ -1,23 +1,21 @@
# EPG2XML
이 프로그램은 EPG(Electronic Program Guide)를 웹상의 여러 소스에서 가져와서 XML로 출력하는 프로그램으로 python2.7 및 php5.4.45 이상에서 사용 가능하도록 제작되었다.
python3과 php 5.4.45 이하에서는 정상적인 작동을 보장하지 못한다.
또한 외부의 소스를 분석하여 EPG 정보를 가공하여 보여주는 것이므로 외부 소스 사이트가 변경되거나 삭제되면 문제가 발생할 수 있다.
이 프로그램은 EPG(Electronic Program Guide)를 웹상의 여러 소스에서 가져와서 XML로 출력하는 프로그램으로 python2.7 및 php5.4.45 이상에서 사용 가능하도록 제작되었다.
python3과 php 5.4.45 이하에서는 정상적인 작동을 보장하지 못한다.
또한 외부의 소스를 분석하여 EPG 정보를 가공하여 보여주는 것이므로 외부 소스 사이트가 변경되거나 삭제되면 문제가 발생할 수 있다.
## 필요 모듈
### epg2xml.py
BeautifulSoup(bs4), lxml, requests 모듈이 추가로 필요하다.
설치 OS별로 모듈을 설치하기 위한 사전 설치 방법이 다를 수도 있으므로 검색해서 설치하도록 한다.
pip install beautifulsoup4, pip install lxml, pip install requests 로 추가할 수 있다.
* easy_install로 설치시 모듈이 인식되지 않는 경우가 있으므로 pip로 설치하기를 권한다.
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.php와 동일하다.
## 설정방법
### epg2xml.json
@ -34,15 +32,16 @@ default_xml_socket : External XMLTV 사용시 xmltv.sock가 있는 경로로
</pre>
### Channel.json
Channel.json 파일을 텍스트 편집기로 열어보면 각채널별 정보가 들어 있다.
이중 Enabled:1로 되어 있는 부분을 Enabled:0으로 바꾸면 EPG정보를 가져오지 않는다.
필요없는 채널정보를 가져오지 않게 하는 것으로 EPG 정보 수집시 시간을 단축할 수 있다.
삭제된 채널등으로 인해서 오류 발생시에도 Enabled:0으로 변경하면 오류 발생을 차단할 수 있다.
Channel.json 파일의 최신버전 https://github.com/wonipapa/Channel.json 에서 다운받을 수 있다.
Channel.json 파일을 텍스트 편집기로 열어보면 각채널별 정보가 들어 있다.
이중 Enabled:1로 되어 있는 부분을 Enabled:0으로 바꾸면 EPG정보를 가져오지 않는다.
필요없는 채널정보를 가져오지 않게 하는 것으로 EPG 정보 수집시 시간을 단축할 수 있다.
삭제된 채널등으로 인해서 오류 발생시에도 Enabled:0으로 변경하면 오류 발생을 차단할 수 있다.
## 옵션 소개
### epg2xml.py, epg2xml.php 옵션
실행시 사용가능한 인수는 --help 명령어로 확인이 가능하다
epg2xml.json의 설정을 옵션의 인수를 이용하여 변경할 수 있다.
실행시 사용가능한 인수는 --help 명령어로 확인이 가능하다.
epg2xml.json의 설정을 옵션의 인수를 이용하여 변경할 수 있다.
<pre>
-h --help : 도움말 출력
--version : 버전을 보여준다.
@ -58,14 +57,15 @@ epg2xml.json의 설정을 옵션의 인수를 이용하여 변경할 수 있다.
</pre>
### epg2xml-web.php 옵션
실행시 사용가능한 인수는 epg2xml.php?help 명령어로 확인이 가능하다
epg2xml.json의 설정을 옵션의 인수를 이용하여 변경할 수 있다.
실행시 사용가능한 인수는 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 부분을 아래와 같이 변경해준다.
tv_grab_file 안의 cat xmltv.xml 또는 wget 부분을 아래와 같이 변경해준다.
python 경로와 php의 경로는 /usr/bin에 있고, epg2xml 파일은 /home/hts에 있는 것으로 가정했다.
#### PYTHON의 경우
<pre>
@ -81,8 +81,8 @@ tv_grab_file 안의 cat xmltv.xml 또는 wget 부분을 아래와 같이 변경
#### PHP WEB의 경우
<pre>
http://domain/epg2xml.php 또는
http://domain/epg2xml.php?i=ALL&l=2
wget -O - http://domain/epg2xml.php 또는
wget -O - http://domain/epg2xml.php?i=ALL&l=2
</pre>
### XMLTV SOCKET 사용시
@ -100,6 +100,9 @@ http://domain/epg2xml.php?i=ALL&l=2
/home/hts/epg2xml.php
</pre>
#### PHP WEB의 경우
php web 버전은 xmltv.sock을 지원하지 않는다.
## 라이센스
BSD
@ -110,7 +113,7 @@ https://github.com/wonipapa/epg2xml/wiki
https://github.com/wonipapa/epg2xml/wiki/FAQ
## 변경사항
### Version 1.2.1
### Version 1.2.1
- SKB 함수 추가
- 가져오는 날짜 최대 2일로 변경
- 타이틀이 1부, 2부 등 을 포함할 때 1부, 2부를 서브타이틀로 이동
@ -119,26 +122,26 @@ https://github.com/wonipapa/epg2xml/wiki/FAQ
- Channel 소스 변경
- GCN 채널 삭제
- readme.txt Readme.md로 통합
### Version 1.2.0
### Version 1.2.0
- 커넥션 관련 에러 예외 처리 추가
- 채널 소스 변경
- Channel.json release date 추가
### Version 1.1.9
### Version 1.1.9
- 언어 버전 사항 체크
- 필요 모듈 사항 체크
- 버그 수정
- php 버전 웹 버전 추가
- php 버전 file_get_contents를 curl 사용으로 수정
### Version 1.1.8
### Version 1.1.8
- KBS 함수 추가
- 채널 변경 사항 반영
- 스카이라이프 url 변경
- EPG 누락 데이터 수정
### Version 1.1.7
### Version 1.1.7
- PHP 7.0 지원
- 채널 변경 사항 반영
- 라디오 채널 추가
### Version 1.1.6
### Version 1.1.6
- iptv 선택 항목에 ALL 추가
- 에피소드 넘버 출력 수정
- 시작 시간 에러 출력 수정
@ -146,51 +149,51 @@ https://github.com/wonipapa/epg2xml/wiki/FAQ
- 서브타이틀 추출 수정
- 데이터 중복 출력 문제 수정
- php 버전이 5.6.3 이전일 때 DOM access 관련 에러 수정
### Version 1.1.5
### Version 1.1.5
- inline 변수 재추가
### Version 1.1.4
### Version 1.1.4
- epg2xml.json 파일 도입
- inline 변수 삭제
- PHP 버전 추가
- 버그 수정
### Version 1.1.3
### Version 1.1.3
- 제목에 회차정보, 재방송 정보 추가시 오류 수정
### Version 1.1.2
### Version 1.1.2
- 재방송정보, 회차정보 옵션 추가
### Version 1.1.1
### Version 1.1.1
- sk 카테고리 오류 수정
### Version 1.1.0
### Version 1.1.0
- 채널 아이콘 추가
- 오류 메시지 통합
### Version 1.0.9
### Version 1.0.9
- 소켓파일이 없을 때 오류 추가
- 채널 변경 사항 반영
### Version 1.0.8
### Version 1.0.8
- 정지 시간 추가
- 오류 출력 구문 디버그시만 출력으로 변경
- 채널 소스 변경
### Version 1.0.7
### Version 1.0.7
- urllib2를 requests로 변경
- User Agent 변경
- 오류 처리 추가
- 채널 변경 사항 반영
- 채널 소스 변경
- 지역 지상파 채널 추가
### Version 1.0.6
### Version 1.0.6
- urllib를 urllib2로 변경
- User Agent 추가
- 채널 변경 사항 반영
### Version 1.0.5
### Version 1.0.5
- epg.co.kr의 epg 정보 못가져오는 것 수정
### Version 1.0.4
### Version 1.0.4
- KODI에서 사용가능하도록 수정
- 제목에서 서브타이틀 및 회차 분리
- 서브타이틀 추가
- 출연, 제작진 개인별로 분리
### Version 1.0.3
### Version 1.0.3
- Channel.json 파일 오류 수정
- LG를 소스로 하는 EPG 정보 기간 오류 수정
### Version 1.0.2
### Version 1.0.2
- ISP별 분리된 채널통합
- 개별 채널별 EPG 정보 수집가능하도록 Enabled 추가
- getMyChannel 함수 삭제
@ -200,14 +203,13 @@ https://github.com/wonipapa/epg2xml/wiki/FAQ
- EPG 정보 가져오는 기간 설정 추가
- 채널 아이콘 설정 URL 설정 추가
- tvheadend 전용 카테고리 추가
### Version 1.0.1
### Version 1.0.1
- EPG 소스 변경
- 등록된 채널 정보만 EPG 정보 가져오도록 설정
- IPTV별 개인화
### Version 1.0.0
### Version 1.0.0
- first release
- KBS 함수 추가
- Channel.json 소스 변경
- 스카이라이프 url 변경
- EPG 누락 데이터 수정
- EPG 누락 데이터 수정