# The &kmyapplication; Handbook

Jonas
Emanuel
Müller
zanoi AT zanoi.net
2010
Jonas Emanuel Müller
&FDLNotice;
2010-10-22
0.1.7

&kmyapplication; is a simple Internet TV application for &kde;

KDE
Videocatcher
Video
Audio
Feed
Channel
Episode
Internet
Television
TV
Multimedia

## Introduction

Screenshot of Videocatcher downloading a video

Videocatcher is an Internet television application powered by &kde;. &kmyapplication; makes it easy to subscribe to video feeds and download new videos. It works as a podcast client as well.

## Using &kmyapplication;

### If you are new to &kmyapplication;

If you are using &kmyapplication; for the first time, you will have to add a channel. In order to add a channel it is necessary to find the channels URL. These can be found by surfing the World Wide Web. Any URL linked to as "feed", "RSS", "atom" or "RDF feed" should work in Videocatcher. When you find such a link, copy its URL into the "add channel" dialog of Videocatcher and you are good to go.

The website is a good place to find channels (they call them feeds). In order to add one of its channels, copy the URL from the RSS button. Please note that the "Add Feed to Miro" button only works with Miro, not with Videocatcher.

Channels are often called feeds in other programs. Currently &kmyapplication; supports RSS, ATOM as well as RDF feeds.

After you have downloaded an episode you can play it back with an external player.

## Menu and Command Reference

### The main &kmyapplication; window

#### The File Menu

&Ctrl;N File Import from File

  Imports a list of channels from an external file. Currently only files in the OPML (Outline Processor Markup Language) format are supported

File Quit

  Quits the application. If Videocatcher is running in the notification area, it will quit there as well &kmyapplication;

#### The Channel Menu

F5 Channel Refresh Channel

  Refreshes the currently selected channel. This means &kmyapplication; will check whether there are any new episodes available in the channel

&Ctrl;L Channel Refresh All Channels

  Refreshes all channels. This means &kmyapplication; will check whether there are any new episodes available in any of the channels

Insert Channel Add Channel

  Adds a new channel. This will ask for an URL which has to be copied and pasted into the box. Currently &kmyapplication; supports RSS, ATOM and RDF urls.

&Alt;Delete Channel Remove Channel

  Removes the currently selected channel. &kmyapplication; will ask whether or not the downloaded episodes of this channel should be deleted together with the channel. If you select to keep the episodes you should delete them manually later at some point.

#### The Episode Menu

Episode Download Episode

  Begins downloading the currently selected episode. Episodes have to be downloaded in order to be played properly. It is sometimes also possible to stream an episode with the stream command. However, this depends on the type of media the channel is using for the episodes as well as the external player used.

Episode Cancel Download

  Cancels the download of the currently selected episode. This is only possible if a download is currently in progress.

Episode Play Episode

  Plays the currently selected episode with an external player. This is only possible if the episode has already been downloaded. When the button is clicked the default player for the downloaded filetype is used to play back the downloaded media. It is also possible to hold down the button and get a menu of all players which can play the downloaded media.

Episode Delete Episode

  Adds a new channel. This will ask for an URL which has to be copied and pasted into the box. Currently &kmyapplication; supports RSS, ATOM and RDF URLs.

Episode Stream Episode

  Lets the external play back the episode directly, without downloading it first. Whether the streaming works depends on the type of media the channel is using as well as the external player used. In case the external player does not start, please try to configure the player in the settings.

#### The Help Menu

&help.menu.documentation;

## Credits and License

&kmyapplication;

Program copyright © 2010 Jonas Emanuel Müller zanoi AT zanoi.net

Program copyright © 2010 Omar Plummer rkoder AT gmail.com

Documentation copyright © 2010 Jonas Emanuel Müller zanoi AT zanoi.net

&underFDL;

&underGPL;

## Installation

### How to obtain &kmyapplication;

You can obtain &kmyapplication; from its official website at

### Requirements

&kmyapplication; requires the installation of the qt4-sql-sqlite package, which should be available at or in your package management system.

&documentation.index;