Programmatically add timed recordings to SageTV?

[hagur]

Hi,

I'm looking for ways to programmatically add recordings to my SageTV server.

I've got a custom built application which I use to control my AV gear. From within this application I've also got an EPG view and I'd like to be able communicate to SageTV right from there to create timed recordings at the specified date and the specified channel. The Mobile Web UI provides this functionality for me, since you can easily POST data via HTTP to create timed recordings, but I'm having some issues getting the Mobile Web UI and the XmlTV plugin (which I use alot) to play nice and work simultaneously, like I've described in this thread:

http://forums.sagetv.com/forums/showthread.php?t=57387

So my question is, is there some other way I can programmatically create a timed recording? I believe the sageTCPServer plugin provides this functionality since the TiSageTV iOS app can create recordings through it. I'm having a hard time finding any documentation describing it though.

I could write my own plugin in java with which I could communicate somehow and the plugin would call the appropriate methods in Sage to create those recordings. I'm also having a hard time finding any API documentation for SageTV.

Any ideas for me? What would be the best way?

[BobPhoenix]

SageTV API is documented here.

[hagur]

Originally Posted by BobPhoenix

SageTV API is documented here.

Thanks!

[Fonceur]

Originally Posted by hagur

I believe the sageTCPServer plugin provides this functionality since the TiSageTV iOS app can create recordings through it.

Have you tried the SageTCPServer wiki?

RAS

Record a show.

Type|ShowID

Type = type of recording (Manual, FirstRun, ReRun, Any)
ShowID = ID of the show.

[hagur]

No, actually I had not seen that page

RAS expects a show ID, if I'm just creating a timed recording at a specified date with a specified duration, how does that work? Also, if Type = Manual, where exactly do I specify the date/time and duration?

I've also been reading the API documentation and AiringAPI.SetRecordingTimes seems to do what I want, but it takes in an Airing object. Do I need to create an Airing object first, using the AddAiring method, and then pass that object into SetRecordingTimes?

If that's the case, what should I set as the ShowExternalID of the Airing object, since the documentation states that the "Show should already have been added".

I'm a little confused ....

[Fonceur]

Typically, the assumption is that SageTV has already built a database, so the ShowID or AiringID can basically be seen as some index in a table. The ShowExternalID is the ID from the original guide data, something like EP1234567890.

In your case, you probably want to use CreateTimedRecording:

http://download.sage.tv/api/sage/api...lang.String%29

[hagur]

Thanks, this seems to be exactly what I was looking for :-)

I appreciate your help.

[hagur]

Hehe wow, I seem to suck more at Java than I thought

I'm just trying to write a simple test class that calls some functions in SageTV, this is what I have got:

import Sage.*;

public class CreateRecording
{
public static void main (String[] args)
{
//sage.api.Channel channel = sage.api.ChannelAPI.GetChannelForStationID(1);
System.out.println("Done");
}
}

Then I try to compile it using:
javac CreateRecording.java

I get this error:

CreateRecording.java:1: error: package Sage does not exist
import Sage.*;
^
1 error

I'm doing this from within the SageTV directory where Sage.jar resides.

I'm a complete newbie when it comes to Java, so please be kind

[tmiranda]

First I'd recommend using either Eclipse or Netbeans for an IDE rather than calling the Java compiler directly. There is a small learning curve, but probably less of a learning curve than using the compiler.

Next I'd recommend using the sagex api's by stuckless which provide a nice set of wrappers that make the Sage api's a lot more usable. (They also provide a way to execute the Sage api's remotely but that's another story.) Alternatively you can use GKusnick's api's which provide a strongly typed set of wrappers.

If you decide to use sagex the code would look like this:

import sagex.api.*;

public class CreateRecording {

    public static void main (String[] args) {
        Object channel = ChannelAPI.GetChannelForStationID(1);
    }
}

Edit: Your import probably isn't working because you capitalized "Sage.*", use "import sage.*;" instead.

[hagur]

Hi, just downloaded the Sagex API, this is the file I downloaded:

http://code.google.com/p/customsaget...2.zip&can=2&q=

It only containted this file here: sagex-api.jar which I copied to the sagetv/sagetv directory.

This is the exact code I'm trying to compile:

import sagex.api.*;

public class CreateRecording
{
	public static void main (String[] args)
	{
		Object channel = ChannelAPI.GetChannelForStationID(1);
		System.out.println("Done!");
	}
}

This is what I get:

C:\Program Files (x86)\SageTV\SageTV>javac CreateRecording.java
CreateRecording.java:1: error: package sagex.api does not exist
import sagex.api.*;
^
CreateRecording.java:7: error: cannot find symbol
Object channel = ChannelAPI.GetChannelForStationID(1);
^
symbol: variable ChannelAPI
location: class CreateRecording
2 errors

Still have not tried an IDE ... might try Eclipse soon.

Any ideas?

[Fonceur]

The import statement requires that the library (.jar) is somehow included in the project, not sure how you would do that from the command line, as using an IDE is simpler...

[tmiranda]

Originally Posted by Fonceur

The import statement requires that the library (.jar) is somehow included in the project, not sure how you would do that from the command line, as using an IDE is simpler...

Totally agree. Using an IDE (Eclipse or Netbeans) is the way to go. Once you do that there are settings where you tell the IDE where to find the necessary .jar files. I have no clue how to compile using the command line.

[hagur]

Oh that explains it then. My assumption was that the compiler would just pick it up since it was in the class path and I was referring to it with the using statement.

[Slugger]

By default, javac only includes that listed in the CLASSPATH environment variable in the classpath. Add -cp argument to javac to get it to compile that file.