72 lines
4.5 KiB
Markdown
72 lines
4.5 KiB
Markdown
# zap2xml
|
|
|
|
Automate TV guides to XMLTV format. Easy to use, up-to-date. See below for getting started.
|
|
|
|
I also _somewhat_ maintain a version of the original in the [historical-perl branch](https://github.com/jef/zap2xml/tree/historical-perl) if you're interested in that.
|
|
|
|
## How to use
|
|
|
|
### Retrieving your Lineup ID
|
|
|
|
Visit the [Retrieving Lineup ID](https://github.com/jef/zap2xml/wiki/Retrieving-Lineup-ID) in the Wiki.
|
|
|
|
### Node.js
|
|
|
|
```bash
|
|
npm i && npm run build && node dist/index.js
|
|
```
|
|
|
|
See [Command line arguments](#command-line-arguments) for configuration options.
|
|
|
|
### Docker
|
|
|
|
| Tag | Description |
|
|
| ------- | ----------------------- |
|
|
| latest | Stable zap2xml releases |
|
|
| nightly | HEAD zap2xml release |
|
|
|
|
#### docker-compose
|
|
|
|
```yaml
|
|
services:
|
|
zap2xml:
|
|
container_name: zap2xml
|
|
image: ghcr.io/jef/zap2xml:latest
|
|
environment:
|
|
OUTPUT_FILE: /xmltv/xmltv.xml
|
|
volumes:
|
|
- ./xmltv:/xmltv
|
|
restart: unless-stopped
|
|
```
|
|
|
|
See [Environment variables](#environment-variables) for configuration options.
|
|
|
|
## Configuration
|
|
|
|
### Environment variables
|
|
|
|
| Variable | Description | Default |
|
|
| ------------- | --------------------------------------------------------------------------------------------------------------- | -------------------------------- |
|
|
| `LINEUP_ID` | Lineup ID; Read more in the [Wiki](https://github.com/jef/zap2xml/wiki/Retrieving-Lineup-ID) | `USA-lineupId-DEFAULT` (Attenna) |
|
|
| `TIMESPAN` | Timespan in hours (up to 360 = 15 days, default: 6) | 6 |
|
|
| `PREF` | User Preferences, comma separated list. `m` for showing music, `p` for showing pay-per-view, `h` for showing HD | (empty) |
|
|
| `COUNTRY` | Country code (default: `USA`) | USA |
|
|
| `POSTAL_CODE` | Postal code of where shows are available. | 30309 |
|
|
| `USER_AGENT` | Custom user agent string for HTTP requests. | Uses random if not specified |
|
|
| `TZ` | Timezone | System default |
|
|
| `SLEEP_TIME` | Sleep time before next run in seconds (default: 10800, Only used with Docker.) | 10800 |
|
|
| `OUTPUT_FILE` | Output file name (default: xmltv.xml) | xmltv.xml |
|
|
|
|
### Command line arguments
|
|
|
|
| Argument | Description | Default |
|
|
| -------------- | --------------------------------------------------------------------------------------------------------------- | -------------------------------- |
|
|
| `--lineupId` | Lineup ID; Read more in the [Wiki](https://github.com/jef/zap2xml/wiki/Retrieving-Lineup-ID) | `USA-lineupId-DEFAULT` (Attenna) |
|
|
| `--timespan` | Timespan in hours (up to 360 = 15 days, default: 6) | 6 |
|
|
| `--pref` | User Preferences, comma separated list. `m` for showing music, `p` for showing pay-per-view, `h` for showing HD | (empty) |
|
|
| `--country` | Country code (default: `USA`) | USA |
|
|
| `--postalCode` | Postal code of where shows are available. | 30309 |
|
|
| `--userAgent` | Custom user agent string for HTTP requests. | Uses random if not specified |
|
|
| `--timezone` | Timezone | System default |
|
|
| `--outputFile` | Output file name (default: xmltv.xml) | xmltv.xml |
|