HOWTO: Command Line Usage

Introduction

If you do not use the web UI plugin then you must configure the Schedules Direct JSON service using the bundled command line tool. Follow the directions below.

Details

Open a command line and go to the following directory:

\SageTV\plugins\sdepg\tools\grabber\bin

From there, execute the following command:

sdjson-grabber --username [id] --password [password] info

Substitute the id and password with your Schedules Direct info. You may also have to replace java with the full path to the java executable on your system.

You should get output similar to the following:

UserStatus [userId=jdoe, expires=Thu Dec 26 10:17:22 EST 2013, lastServerRefresh=Mon Feb 11 18:56:45 EST 2013, userMessages=[], systemMessages=[], headendInfo={PC:90210=Wed Dec 31 19:00:00 EST 1969, 0005005=Wed Dec 31 19:00:00 EST 1969}, maxLineups=4]

Now use the tool to add your lineups to your account:

sdjson-grabber --username [id] --password [password] add --id PC:90210

The headend id, --id option above, must be a valid headend id recognized by Schedules Direct. Every account can only have so many headends registered. Use the info command to see the limits for your account. Users may only make a small number of changes per day to their registered headends.

Tip: You can list all of the headends for a given zip/postal code using search with the --zip-code [zip] --country [country] options. This is how you should find the headend ids you wish to register with your account. Remember, the lineups you have registered at the Schedules Direct web site mean nothing and are not registered to your JSON service account. You must do this initial configuration.

sdjson-grabber --username id --password pwd search --zip-code 90210 --country USA

Available headends for zip '90210'
CA00053      Time Warner Cable Beverly Hills
CA61222      Mulholland Estates Beverly Hills
CA66511      AT&T U-verse TV Los Angeles
CA67309      Time Warner Cable Westchester
CA67310      Time Warner Cable City of Los Angeles Eagle Rock
DISH803      DISH Los Angeles Los Angeles
DITV803      DIRECTV Los Angeles Los Angeles
PC:90210     Antenna Over-the-air

Reissue the info command above to verify that your lineups have been added to your account. Only those lineups registered and reported with this tool will actually be downloaded during EPG updates.