v1.4 Copyright (c) 2003-2005 by Brian Nenninger
ciTV is a simple application that displays the television programs you have recorded using EyeTV. Its purpose is to provide direct access to the files containing the recorded programs so that you can easily copy them to other machines or manipulate them with tools such as ffmpeg.
When ciTV launches, if you have the EyeTV software installed it will automatically find your EyeTV recording folder and scan it for programs. Otherwise, it will ask you to locate a folder containing EyeTV recordings. (You can select a folder on a network volume; I use it on my Mac mini to access the programs on my desktop Mac that has the EyeTV attached). You can open additional windows pointing at different EyeTV recording folders using the "New" or "Open" menu commands.
ciTV shows the name, date, channel, length, and file size, and bitrate of each recording in a table. You can sort by any column by clicking the column header. When you click on a table row, the text field underneath the table will show the full path to the recording file. Clicking the "Show" button will open a Finder window with that file selected. Be sure not to rename or delete the recording file, if you do neither EyeTV nor ciTV will be able to access it. The larger text field below the path shows the description for the program, if available. The QuickTime movie view in the bottom right allows you to view the selected recording. Clicking the refresh icon in the upper right of the table will reload the contents of the recording folder. Double-clicking a table row will open the corresponding movie file in Quicktime Player, or another application of your choice which can be set in the Preferences window.
NOTE: The EyeTV 500 records HD programs in MPEG-2 transport format. Quicktime cannot play this format even if you have the MPEG-2 component installed, and attempting to do so can hang the running application. Thus, HD programs will not be displayed in the Quicktime preview, nor will they open in another application when double-clicked.
The "Create Program Aliases..." command in the ciTV menu will creates alias files pointing to your recordings. The aliases created will have readable names which will include the dates of the corresponding programs.
There is also a command-line tool that lists all EyeTV programs. (This is useful if you want to see the programs on a remote Mac that you have ssh access to). The tool is named "citv-console" and is located inside the ciTV application wrapper, in ciTV.app/Contents/MacOS. Executing citv-console with no arguments lists all programs in the default EyeTV recording folder. There are two optional arguments. "-p [directory]" specifies an alternate recording directory. "-a [directory]" will create aliases to your programs (like the "Create Program Aliases" command in the main application) in the given directory.
The citv-console tool is self-contained; you can copy it from the ciTV.app application wrapper to any other location and it will still work.
I appreciate any comments, bug reports, or suggestions for improvements. Contact me at brian@dozingcat.com.
ciTV is completely free, but if you find it useful you can support its development by:
1.4, Apr 25 2005:
1.3, Aug 1 2004:
1.2, Jan 18 2004:
1.1.1, Dec 10 2003:
1.1, Dec 7 2003:
1.0, Nov 13 2003: initial release
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
ciTV uses the BDAlias class by bDistributed.com, to which the following applies:
Copyright (c) 2001-2002, bDistributed.com, Inc.
All rights reserved.
Redistribution and use in source and binary forms, with or
without modification, are permitted provided that the following
conditions are met:
* Redistributions of source code must retain the above
copyright notice, this list of conditions and the following
disclaimer.
* Redistributions in binary form must reproduce the above
copyright notice, this list of conditions and the following
disclaimer in the documentation and/or other materials
provided with the distribution.
* Neither the name of bDistributed.com, Inc. nor the names of
its contributors may be used to endorse or promote products
derived from this software without specific prior written
permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES,
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE
LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY,
OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR
TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY
OF SUCH DAMAGE.