tv_grab_uk_atlasp - Daring di Awan

PROGRAM:

NAMA

tv_grab_uk_atlas - Ambil daftar program TV dan radio untuk Inggris dari situs web MetaBroadcast
(database Atlas).

RINGKASAN

tv_grab_uk_atlas --bantuan

tv_grab_uk_atlas --info

tv_grab_uk_atlas --versi

tv_grab_uk_atlas --kemampuan

tv_grab_uk_atlas --deskripsi

tv_grab_uk_atlas
[--hari N] [--offset N] [--dst] [--channel S]
[--file-config FILE]
[--output FILE] [--tenang] [--debug]

tv_grab_uk_atlas
--jam N [--offset N] [--channel S]
[--file-config FILE]
[--output FILE] [--tenang] [--debug]

tv_grab_uk_atlas
--tanggal TANGGAL [--dst] [--channel S]
[--file-config FILE]
[--output FILE] [--tenang] [--debug]

tv_grab_uk_atlas --konfigurasi [--file konfigurasi FILE]

tv_grab_uk_atlas --configure-api [--nama panggung]
[--file-config FILE]
[--berkas keluaran]

tv_grab_uk_atlas --daftar-saluran [--config-file FILE]
[--output FILE] [--tenang] [--debug]

tv_grab_uk_atlas --daftar-baris [--output FILE]
[--tenang] [--debug]

tv_grab_uk_atlas --get-lineup [--config-file FILE] [-output FILE]
[--tenang] [--debug]

DESKRIPSI

Keluaran daftar TV dalam format XMLTV untuk banyak saluran yang tersedia di Inggris. Datanya berasal dari
<http://atlas.metabroadcast.com>

Pertama kamu harus lari tv_grab_uk_atlas --konfigurasi untuk memilih saluran mana yang Anda inginkan
menerima.

Lalu berlari tv_grab_uk_atlas tanpa argumen akan mendapatkan daftar dalam format XML untuk
saluran yang Anda pilih untuk hari yang tersedia termasuk hari ini.

PILIHAN

--konfigurasi Minta saluran mana untuk mengunduh dan menulis file konfigurasi.

--file konfigurasi FILE Atur nama file konfigurasi, defaultnya adalah
~/.xmltv/tv_grab_uk_atlas.conf. Ini adalah file yang ditulis oleh --konfigurasi dan baca kapan
meraih.

--keluaran FILE Saat mengambil, tulis output ke FILE daripada output standar.

--jam N Saat mengambil, ambil N jam data.

--hari N Saat mengambil, ambil N hari daripada semua hari yang tersedia.

--mengimbangi N Mulai ambil hari ini/sekarang + N hari. Kapan --jam digunakan ini adalah jumlah
jam bukannya hari. N mungkin negatif.

--tanggal N Ambil hanya tanggal ini (bukan hari/offset).

--dst Beberapa PVR mengalami masalah dengan waktu BST dan "kehilangan" satu jam di penghujung hari
Jadwal. Ini menambahkan satu jam ekstra ke jadwal yang diambil.

--saluran S Ambil saluran ini saja (abaikan saluran di file konfigurasi). Dapat
ditentukan baik sebagai id saluran Atlas (misalnya "cbbw") atau nama saluran yang dipetakan (misalnya
"selatan.bbc1.bbc.co.uk").

--diam Menekan bilah kemajuan yang biasanya ditampilkan pada kesalahan standar.

--debug Berikan informasi lebih lanjut tentang kemajuan ke stderr untuk membantu dalam debugging.

--daftar-saluran Tulis pemberian keluaran elemen untuk setiap saluran yang tersedia di
konfigurasi saat ini.

--list-lineup Tulis output yang memberikan daftar wilayah tampilan yang tersedia.

--dapatkan barisan Tulis pemberian keluaran elemen untuk setiap saluran yang tersedia di
barisan saat ini.

--kemampuan Tunjukkan kemampuan mana yang didukung oleh grabber. Untuk informasi lebih lanjut, lihat
<http://wiki.xmltv.org/index.php/XmltvCapabilities>

--Versi: kapan Tunjukkan versi grabber.

--membantu Cetak pesan bantuan dan keluar.

--info Cetak halaman bantuan dan keluar.

INSTALASI

1. Pertama, Anda harus mendapatkan kunci Atlas API dari MetaBroadcast. Ini gratis (di
waktu sekarang) untuk penggunaan pribadi dan diperlukan untuk memungkinkan Anda mengakses jadwal lengkap
diterbitkan oleh Asosiasi Pers. Setiap penggunaan komersial dari data yang diperoleh dari Atlas
akan membutuhkan lisensi berbayar.

Instruksi tersedia di sini:
<http://metabroadcast.com/blog/create-and-manage-your-atlas-api-key>

Anda harus memasukkan kunci API Anda selama tahap --configure.

Ingatlah untuk meminta Press Association (PA) sebagai penyedia konten pada kunci API Atlas Anda.

2. Konfigurasi Grabber terdiri dari yang biasa: tv_grab_uk_atlas --konfigurasi

Atlas memiliki data regionalisasi yang berarti Anda dapat memperoleh daftar khusus untuk TV Anda
wilayah. Saat Anda menjalankan opsi --configure, Anda akan ditanyai platform tampilan mana
(misalnya Freeview; Sky HD) dan wilayah (misalnya London; Tenggara) yang ingin Anda akses. (Kamu bisa
pilih hanya 1 wilayah!).

Kemudian Anda memilih saluran mana yang ingin Anda ambil.

3. Berkas tv_grab_uk_atlas.user.map.conf memiliki dua tujuan. Pertama, Anda dapat memetakan
id saluran yang digunakan oleh Atlas menjadi sesuatu yang lebih berarti bagi PVR Anda. Misalnya

peta==cbdm==FILM4

akan mengubah "cbdm" menjadi "FILM4" di XML keluaran.

Catatan: barisnya berbentuk "map=={channel id}=={my name}".

Tujuan kedua adalah untuk juga menerjemahkan nama genre. Jadi, jika PVR Anda tidak memiliki
kategori untuk "Fiksi Ilmiah" tetapi menggunakan "Sci-fi" sebagai gantinya, maka Anda dapat menentukan

cat==Fiksi Ilmiah==Fiksi Ilmiah

dan XML keluaran akan memiliki "Sci-fi".

PENTING: "tv_grab_uk_atlas.user.map.conf" yang diunduh berisi baris contoh ke
ilustrasikan formatnya - Anda harus mengedit file ini agar sesuai dengan tujuan Anda sendiri!

PENGGUNAAN

Semua kemampuan XMLTV normal disertakan tetapi ada parameter tambahan
"--jam". Atlas memungkinkan data jadwal diambil baik berdasarkan jumlah hari atau menurut
jumlah jam.

Jika memungkinkan, Anda harus menggunakan fasilitas "jam" ini untuk mengurangi beban yang tidak perlu pada
server Atlas.

Ketika --hours ditentukan --offset ditafsirkan sebagai jam.

Sebagai contoh:

- untuk mengambil jadwal untuk 12 jam ke depan:

tv_grab_uk_atlas --jam 12

- untuk mengambil jadwal untuk 12 jam ke depan mulai besok:

tv_grab_uk_atlas --jam 12 --offset 24

Atau Anda dapat menggunakan format "hari" yang sudah dikenal:

tv_grab_uk_atlas --hari pertama

tv_grab_uk_atlas --hari 1 --offset 1

Angka negatif diperbolehkan, jadi misalnya yang berikut ini valid:

tv_grab_uk_atlas --offset -4 --jam 12

tv_grab_uk_atlas --offset -1 --hari 1

Perhatikan bahwa Atlas hanya memiliki data maksimal 14 hari ke depan dan bervariasi; beberapa saluran
memiliki kurang dari ini.

Parameter tambahan "--date YYYYMMDD" memungkinkan Anda mengambil jadwal hanya untuk ini
tanggal. (Ini jelas mirip dengan --days 1 dengan --offset yang sesuai tetapi menghindari Anda
harus menghitung offset; ini lebih mudah untuk beberapa pengambil otomatis.) Mis

tv_grab_uk_atlas --tanggal 20130923

Parameter baru "--dst" memungkinkan Anda menambahkan satu jam ekstra ke jadwal yang diambil dari
Atlas. Beberapa PVR mengalami masalah dengan waktu BST dan "kehilangan" satu jam di penghujung hari
Jadwal. Parameter ini mungkin membantu meringankannya.

tv_grab_uk_atlas --hari pertama --dst

Parameter baru "--channel" memungkinkan Anda mengganti file konfigurasi dan mengambil data untuk a
saluran tertentu:

tv_grab_uk_atlas --offset -4 --jam 12 --channel cbdm

BROWSER INTERFACE

Jika Anda ingin menjalankan fetcher melalui browser maka Anda dapat menginstal skrip cgi yang disediakan.

(Perhatikan bahwa Anda jelas harus menginstal server web atau menggunakan host web untuk ini
kerja.)

Salin file getatlas.pl ke direktori cgi-enabled di ruang web Anda. (Petunjuk: Ini
direktori ini sering disebut "cgi-bin".) Pastikan file memiliki izin eksekusi.

(Catatan teknis: gunakan penangan cgi "normal" untuk menjalankan file ini; fastcgi mungkin tidak berfungsi.)

Tentukan parameter pada URI sebagai berikut:
offset=xxxx
jam = xxx
hari=xxxx
tanggal=YYYYMMDD
saluran = xxx
dst

misalnya
http://my.webspace.com/cgi-bin/getatlas.pl?jam=12
http://my.webspace.com/cgi-bin/getatlas.pl?jam=12&offset=6
http://my.webspace.com/cgi-bin/getatlas.pl?tanggal=20130930
http://my.webspace.com/cgi-bin/getatlas.pl?hari=1&dst

Kombinasi yang valid adalah:
"offset" dan "jam"
atau "offset" dan "hari" - dalam hal ini offset adalah "hari" juga (jika tidak
"jam")
atau "tanggal" - ambil hanya hari ini

ERROR PENANGANAN

Jika grabber gagal mengunduh data untuk beberapa saluran pada hari tertentu, ia akan mencetak
pesan kesalahan ke STDERR dan kemudian lanjutkan dengan saluran dan hari lainnya. Pengambil
akan keluar dengan kode status 1 untuk menunjukkan bahwa data tidak lengkap.

LINGKUNGAN VARIABEL

Variabel lingkungan HOME dapat diatur untuk mengubah tempat file konfigurasi disimpan.
Semua konfigurasi disimpan di $HOME/.xmltv/. Pada Windows, mungkin perlu untuk mengatur
HOME ke jalur tanpa spasi di dalamnya.

DIDUKUNG SALURAN

Untuk informasi tentang saluran yang didukung, lihat file tv_grab_uk_atlas.map.channels.conf di
direktori $HOME/.xmltv/supplement/tv_grab_uk_atlas/ Anda setelah Anda menjalankan grabber di
paling tidak sekali.

XMLTV VALIDASI

tv_validate_grabber dapat melaporkan kesalahan yang mirip dengan:

"Baris 5 ID saluran BBC 1 tidak valid"

Ini karena ValidateFile.pm bersikeras bahwa channel-id mematuhi RFC2838 meskipun
xmltv.dtd hanya mengatakan "sebaiknya" bukan "HARUS". (Memiliki id saluran dalam bentuk
"bbc1.bbc.co.uk" akan ditolak oleh banyak PVR karena mereka memerlukan data untuk mencocokkan
daftar sendiri.)

Kesalahan ini dapat diabaikan.

Pertanyaan Umum (FAQ)

1. Apa yang dimaksud dengan "Masukkan kunci API Atlas Anda"?

Anda harus mendapatkan kunci API gratis dari Atlas MetaBroadcast sebelum Anda dapat menggunakan grabber ini.
Instruksi tersedia di sini:


2. Saya mendapatkan kesalahan "Status: 400 Permintaan Buruk"

Biasanya ini karena Anda belum memasukkan kunci API Anda selama tahap --configure.
Atau kunci API Anda tidak mengizinkan akses ke data Asosiasi Pers (masuk ke akun Anda di
http://atlas.metabroadcast.com/admin dan "Minta Akses" ke data sumber "PA"). Atau jika Anda
meminta saluran tertentu dengan opsi --channel tetapi saluran tidak dapat ditemukan.

DISCLAIMER

Lisensi gratis MetaBroadcast untuk data ini tidak mengizinkan penggunaan non-pribadi.

Tentu saja setiap penggunaan komersial dari data daftar yang diperoleh dengan menggunakan grabber ini akan melanggar
undang-undang hak cipta, tetapi jika Anda hanya menggunakan data untuk penggunaan pribadi Anda sendiri maka Anda
mungkin baik-baik saja.

Dengan menggunakan grabber ini, Anda biasanya menggunakan data listingan untuk penggunaan pribadi Anda sendiri
saja dan Anda membebaskan penulis dari tanggung jawab apa pun berdasarkan undang-undang hak cipta atau sebaliknya.

Gunakan tv_grab_uk_atlasp online menggunakan layanan onworks.net