/etv-comskip

Commercial Marking and Skipping for EyeTV and iTunes Exports

Primary LanguageAppleScriptGNU General Public License v2.0GPL-2.0

etv-comskip

Commercial Marking and Skipping for EyeTV and iTunes Exports

Synopsis

Commercial detection and skipping for EyeTV, using Comskip.

These programs allow users of EyeTV to enjoy commercial-free recorded high definition (HD) television.

Example etv-comskip image Commercials are automatically marked and skipped during playback on OS X, iOS, and tvOS devices.

Description

EyeTV records tv shows, transcodes them for personal broadcast over an EyeTV server, and exports recordings to iTunes where they can be synced to iOS and tvOS devices. Comskip detects the commercials. ETVComskip marks and skips the commercials in both EyeTV recordings and iTunes exports. Helper software is used for commercials skipping. ComSkipper skips commercials in EyeTV recordings. The Videos app arrow keys are used in iOS devices, which may be triggered by a wide variety of headphone or bluetooth controls.

Operation

Recording, transcoding, and commercial detection are all performed sequentially because of their high computational cost. Comskip saves the detected commercials in an Edit Decision List (.edl) file located in the same EyeTV directory as the original h.264 .mpg recording. MarkCommercials sets the markers on the EyeTV recording, and uses the mp4chaps command to set the commercials as chapters within the mp4 .m4v transcodings both in the EyeTV directory and in any iTunes exports.

Commercials are kept in the recording; users are expected to use helper software to skip them. This avoids any infrequent yet frustrating problems with false detections and misalignment. Both Elgato's EyeTV.app and Turbo.264 HD apps respect .edl files for transcoding, allowing semi-automated commercial deletion from recordings.

Installation

Double-click on "Install ETVComskip".

This will install several files in /Library/Application Support/ETVComskip, and /Library/Application Support/EyeTV/Scripts/TriggeredScripts.

This will also create a user launchd item in ~/Library/LaunchAgents that automatically runs the ComSkipper program to make EyeTV automatically skip marked commercials on playback.

To uninstall these files and login item, double-click on "UnInstall ETVComskip", which is located in /Library/Application Support/ETVComskip.

Build

  • git clone --recursive https://github.com/essandess/etv-comskip.git
  • cd etv-comskip
  • make

Variations

Comskip also allows the capability for live commercial detection and skipping. This feature was once supported in the older Google code version of etv-comskip for non-HD recordings. etv-comskip has been refactored for sequential operations on HD recordings, but it would be possible to create a live commercial skipping.

Contributors

Jon Christopher wrote the original etv-comskip for non-HD recordings. Dick Gordon, Rick Kier, and Lycestra all contributed. I refactored the original code with work with the HD version of Comskip and handle MP4 transcodings and iTunes exports.

None of this would be possible without Erik Kaashoek's Comskip. Erik has a contributor's link at his website, and asks for $10 donations for the version of Comskip included in this distribution.

License

Licensed under the GNU General Public License, version 2.