An open source digital cable tuner network encoder for SageTV.

OpenDCT packaged releases are hosted on Bintray.com.

On Linux platforms it is recommended to only use the architecture of your distribution.

apt-get install default-jre-headless
dpkg -i opendct_x.x.x-x_arch.deb

yum install java-1.8.0-openjdk-headless
rpm -i opendct_x.x.x-x_arch.rpm

dnf install java-1.8.0-openjdk-headless
rpm -i opendct_x.x.x-x_arch.rpm

On Windows platforms, unless you have the 64-bit Java Runtime installed, use the 32-bit (x86) installer. The Windows installer will do upgrades so it is unnecessary to uninstall before installing a new version. It is however necessary to stop the service before upgrading.

The majority of the configuration is done inside opendct.properties. The file is automatically populated after the first time the program is run. Do not make changes to this file while the program is running since your changes will be overwritten. This list is just the very basics to keep the program from communicating with undesired devices.

• sagetv.device.global.ignore_devices_csv=
• This is a comma delimited list of tuners or entire devices to be ignored if they are discovered. The names on this list must perfectly match the name of the tuner or "parent" device as it is named when discovered. When a device is on the list, all tuners on that device will be excluded.
• sagetv.device.global.only_devices_csv=
• This property if set always supersedes ignore_devices_csv. This is a comma delimited list of tuners or entire devices allowed to be initialized if they are discovered. The names on this list must perfectly match the name of the tuner or "parent" device as it is named when discovered.
• sagetv.device.global.required_devices_loaded_timeout_ms=30000
• This is the amount of time allowed in milliseconds to pass while waiting for the required number of devices before the program will exit with a failure.
• sagetv.device.global.required_devices_loaded_count=0
• This is the number of devices that need to be detected and loaded before the required timeout.

Available as of version 0.4 (compile only; not yet released)

• upnp.service.configuration.ignore_interfaces_csv=
• Specify the name of interfaces in a comma delimited list of network interfaces as they are named by Java to be ignored when UPnP is performing discovery.
• upnp.service.configuration.ignore_local_ip_csv=
• Specify the IP addresses of local interfaces in a comma delimited list to be ignored when UPnP is performing discovery.

After configuring OpenDCT, the SageTV service needs to be stopped. Open Sage.properties and find the property network_encoder_discovery and change the value to true. Start the SageTV service again while OpenDCT is running to discover the available capture devices.

OpenDCT builds are created using Gradle. The following commands should get you started.

gradlew eclipse

gradlew idea

Note: Building the Windows installer is currently only supported on Windows.

1. Install the latest Java JDK for your OS architecture.

2. Install the WiX Toolset so you can build the packages for Windows.

• You may need to re-open the console window so the newly set WIX environment will be available.
• Optionally you can tell the script where the binary is located. See the README.md under scripts/wix for details.
• If the WiX binaries cannot be found, the build will fail after the Linux packages have been created.

3. Execute:

gradlew packageAll

The packages will be found under build/distributions.

First check the SageTV forums to help eliminate other possibilities in your environment/configuration that are unrelated to OpenDCT. Also the forums could help if the issue is actually a problem involving an incorrect configuration of OpenDCT. If it is determined that it must be an issue with OpenDCT that should be addressed, please create a new issue on GitHub. Please be very specific and attach SageTV and OpenDCT log files if possible.

All contributions are very appreciated and if you have already made any thank you for your time. You do not need to be a programmer to contribute. For example, if you have extra resources to test potentially unstable builds, we would like your feedback on issues you encounter even if the issue is as trivial as intuitiveness of the provided interfaces.

If you would like to contribute to the source code, please create a new issue on GitHub so everyone knows what you're working on and we can collaborate on the best way to implement your proposed change. The only exception to this rule is if you're just making a trivial modification like fixing a typo. Anything that actually changes how the code works in any way should be posted as an issue before committing the changes.

Contributions must be your own. If your code requires any licensed code, the licensed code must use a license compatible with the Apache License, Version 2.0 license. Libraries must be properly attributed under distribution/licenses. Licensed source code must be attributed in the header of the source file using the licensed source code and attributed in compliance with any other attribution requirements of the licence.

This project is licensed under the Apache License, Version 2.0 with no warranty (expressed or implied) for any purpose.