From 25e01d13b095003ff93d5e4e7ba5fe7f755904b5 Mon Sep 17 00:00:00 2001 From: wonipapa Date: Sun, 1 Apr 2018 14:44:29 +0900 Subject: [PATCH] Update README.md --- README.md | 253 +----------------------------------------------------- 1 file changed, 1 insertion(+), 252 deletions(-) diff --git a/README.md b/README.md index b76f838..00154cc 100644 --- a/README.md +++ b/README.md @@ -1,252 +1 @@ -# 공지 -리포지터리 삭제되었습니다 - -# 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 +Channel.json 파일및 Channel.json 리포지터리는 5월 1일부로 삭제하도록 하겠습니다.