KatchTV Manual - Contents

Welcome to KatchTV!

Contents

  1. What is KatchTV?
  2. How do I use this?
    1. Browsing Directories to Find Channels
    2. Choosing Episodes to Download
    3. Viewing Current Downloads
    4. Choosing Something to Watch
  3. Questions and Answers
  4. Sending Bug Reports, Patches, Comments, and General Contact Info
  5. Thanks
  6. What Else Should I Know?

What is KatchTV?

KatchTV is a broadcatcher; otherwise known as an Internet TV or iTV program. With KatchTV, you can subscribe to TV channels from all over the internet, choose the episodes you're interested in, and have them download in the background. When they're ready, just go to the Ready to Watch page, and you can watch the episodes from the very same program.

How do I use this?

Browsing Directories to Find Channels

By browsing the directory websites listed in the side panel, you can find many different channels to watch.

Most directories are organised by category, popularity, some combination of these.

Steps

  1. Expand the Channel Directories item in the side panel. To do this, just click the + button, or double-click the item.
  2. Choose a channel directory by double-clicking on it. The browser pane (where you're probably reading this help) will load the website.
  3. In the directory, find a channel you like the look of, and then find its feed link. Usually, this is an orange XML link, or a little orange square with radiating curves, like this: or . However, in the directories and even on some individual sites, you may have to look for a "feed" link. Basically, you have to use your imagination sometimes, since this is all quite new, and not well standardised yet.
  4. When you find the feed link, just click on it. After a moment, it should appear under "Subscribed Channels" in the side panel.
  5. If you can't find a direct link for a feed that works by clicking on it, you may be able to find out the URI (or URL) and copy it. Then, click the "Add" button below the side panel, and paste the URI in there instead.

Choosing Episodes to Download

Unlike TV, which is more like a continual stream of video, each podcatcher channel has many episodes, which you can individually choose to download and watch. This gives you much more freedom in watching what you like, and ignoring what you don't like. To choose episodes to watch, just follow these steps.

Steps

  1. Expand the "Subscribed Channels" item on the side bar so that you can see each channel. To do this, just double-click it, or click the + button beside it.
  2. Double-click on the channel you want to view. This will make the channel's episodes appear in the main browser area (where you are probably reading this manual).
  3. Browse the page for episodes you like the sound of. With most channels, you will get a description for each episode. However, some channels aren't very diligent about providing summaries for you. If it's missing, you'll just have to guess from the enclosure name. Which brings us to...
  4. In each episode, you'll see a list of enclosures. These are the actual downloadable movies or audio files (actually, they could be almost anything!). If there is more than one enclosure, it may be the same as the first, but in a different format that might play better on your computer. Another possibility is that the other enclosures might be different parts, like the first half of a movie, and the second. Normally, the episode or the enclosure name will give you a hint about what you're being offered.
  5. Enclosures you haven't yet downloaded are shown with the text "Click to Download". To download the enclosure of your choice, just click on its link.

Viewing Current Downloads

To view the media that is downloading, just double-click on "Downloads in Progress", on the side bar. Anything currently downloading will be shown there, along with the size, percentage downloaded, etc.

Note that as downloads finish, they will automatically disappear from this list, and be moved to the "Ready to Watch" page (see the next section for an explanation of that).

Also note that currently, only one item will download at a time. We plan to improve on this.

Choosing Something to Watch

To view items that have downloaded and are ready to watch, double-click on the "Ready to Watch" item on the side bar. Each downloaded movie, audio file, or other media item can be seen here. You can choose to watch the item by clicking on it, or you can delete the item (to free up hard disk space).

Questions and Answers

Isn't this like Democracy TV? Isn't this like a podcatcher? Why a whole new application?

Yes, this is largely inspired by Democracy TV, and by PenguinTV. The major difference with KatchTV is that KatchTV is designed for KDE. It takes advantage of advanced KDE technologies like KHTMLPart (the browser engine that makes Konqueror go) and the embedded media players available within KDE.

How Can I Rename a Subscribed Channel?

Just like most KDE apps that have columned lists, click twice slowly (don't double-click) on the name. Change the name, and press return. The subscribed channel list will be saved.

How Can I Change the Update Interval for a Subscribed Channel?

Just like editing the channel name (see above), click twice slowly (don't double-click) on the channel's "Update Mins" column. You may have to scroll the side bar horizontally to see this column. Edit the number of minutes, and press return to save it.

What's currently missing from KatchTV?

KatchTV is very new; I only started it a few weeks ago, as of this writing, and I've been working on other projects, and sick in that time too. So, there are some features currently missing. The most important of these are:

Sending Bug Reports, Patches, Comments, and General Contact Info

Please send any bug reports, comments or suggestions to Lee Braiden at Digital Unleashed.

Thanks

I'd like to take this opportunity to thank the Democracy TV folks for an innovative app that shows just how easy and world-changing a podcatcher can be. The first time I tried Democracy TV, it was slow and kludgy, but it worked well enough to show that traditional TV is doomed. KatchTV is mostly just an attempt to make a version of Democracy TV that's a little faster, and fits nicely into KDE. I'd also like to thank the PenguinTV team (notably Owen Williams) for his app; it was simple enough to get into that it encouraged me to contribute a (very) little bit of code, and really got me in the mood for writing my own podcatcher app. Unfortunately, PenguinTV isn't a KDE app either. Finally, I'd like to thank the Python, KDE, Qt, Eric3, and PyKDE/PyQt folks, for their products. I mean, so far, there are about five days of work in this app, which is my first GUI-based KDE program. Those are some great development tools!

What Else Should I Know?

Oh yes... enjoy!