Commercial Marking and Skipping for EyeTV and iTunes Exports
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
src Update Comskip Apr 7, 2018
.gitmodules Add submodule matryoshka-name-tool for dynamic library support Nov 2, 2015
AUTHORS Update AUTHORS Mar 10, 2017
LICENSE migrating from sourceforge Jan 4, 2008
LICENSE.rtf Makefile Builds the mpkg file Mar 20, 2008
Makefile Recompile for macOS 10.13.4 Apr 7, 2018
README.md Update README.md Nov 8, 2015
example.png Example image Nov 4, 2015

README.md

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.