# O manual do &kaffeine;

## O reprodutor multimídia &kaffeine;

### A janela inicial

Assim como outros reprodutores multimídia, o &kaffeine; suporta uma grande gama de formatos de audio e vídeo, bem como a reprodução de áudio e video de mídias DVD e &CD;. Adicionalmente, suporta reprodução ao vivo de sinal de TV digital, se o seu computador possuir um dispositivo de TV digital conectado a ele.

Quando o &kaffeine; é iniciado, é apresentada uma tela contendo as principais funções no meio, sendo possível navegar para outras funções seja pela barra de menu ou pelo menu lateral:

A janela inicial A janela inicial

### Reproduzir um arquivo

A reprodução de um arquivo de vídeo ou áudio é tão simples quanto pressionar o botão Reproduzir arquivo. Será solicitado o arquivo que, uma vez selecionado, será reproduzido. Como o &kaffeine; utiliza a biblioteca LibVLC internamente, todos os formatos de arquivo suportados pelo VLC são suportados. Também é suportado abrir uma lista de arquivos para criar e gerenciar listas de reprodução.

Reproduzir um arquivo Reproduzir um arquivo

### A janela de listas de reprodução

&kaffeine; supporta multiplas listas de reprodução. Escolha a lista ativa através do seletor Lista de reprodução na barra lateral esquerda. Você pode facilmente arrastar alguns arquivos ou diretórios do navegador de arquivos e soltar na lista de reprodução para adicionar ou removê-los na janela do reprodutor, de forma a criar uma nova lista de reprodução. Para alterar o nome da lista de reprodução, edite-o e confirme com a tecla Enter.

Janela de listas de reprodução Janela de listas de reprodução

Você pode encontrar todas as funções relacionadas a listas de reprodução no itemLista de reprodução da barra de menu de contexto (pressionando a lista de reprodução com o botão direito).

## Reprodução de TV digital

### Configurações para TV Digital

Enquanto as funcionalidades básicas são suficientemente úteis para interessados em uma interface simplista e poderosa de um reprodutor multimídia, a melhor funcionalidade no &kaffeine; é no seu uso como uma interface gráfica &GUI; para assistir e gravar programas de TV digital.

Desde a versão 2.0 do &kaffeine; o suporte a TV digital utiliza a biblioteca libdvbv5 e foi extendido para suportar padrões mais modernos de TV digital, como DVB-T2 e ISDB-T, este último utilizado no Sistema Brasileiro de Televisão Digital (SBTVD). Estender seu suporte para novos padrões agora é mais simples. Além dico, comoutiliza a API DVB versão 5 do &Linux; o &kaffeine; suporta dispositivos capazes de implementar múltiplos padrões de TV no mesmo produto.

Ajustar as configurações de TV no &kaffeine; é tão simples como abrir o item Televisão da barra de menu e selecionar a opção Configurar televisão. Uma janela será aberta para solicitar os parâmetros a serem utilizados:

Configuração de TV - Opções gerais Configuração de TV - Opções Gerais

#### Configurações gerais para TV digital

O menu Opções Gerais permite ajustar as configurações que são independentes do dispositivo.

A Pasta de gravações configura a localização onde as gravações dos programas de TV serão armazenados.

A pasta do deslocamento de tempo é utilizada em conjunto com o botão de pausa () da tela do reprodutor de media. Quando o botão é pressionado, um arquivo com deslocamento de tempo é armazenado na localização apontada por esta opção do menu.

As opções Margem inicial e Margem final são utilizadas para configurar algo como uma margem de segurança nas gravações, de forma a previnir a perda do início ou do final do programa, visto que as marcações de tempo do guia de programação podem não ser precisas. Assim, as gravações na realidade iniciam alguns minutos antes do Início do programa, definido no Guia de programação. O valor exato de antecedência na gravação é definido pela Margem inicial. O &kaffeine; estende o horário final da gravação conforme o valor definido na Margem final.

A opção Estilo de nome para gravações é utilizada para definir como o &kaffeine; irá denominar um programa gravado. Diversas macros podem ser utilizadas para definir dinamicamente o nome da gravação:

- `%title` - Título do programa, conforme visto nos menus Guia de programação e na Agenda de gravações;

- `%day, %month, %year, %hour, %min, %sec` - Campos da marcação de tempo que representam o horário em que o &kaffeine; iniciará a gravação do programa;

- `%channel` - Nome do canal que está transmitiondo o programa.

A opção Ação após concluir gravação é utilizada para configurar um comando opcional a ser executado quando o &kaffeine; termina de gravar um programa.

Pressionando a opção Atualizar arquivo de busca pela Internet faz com que o &kaffeine; cheque se um novo arquivo com nova definição de canais está disponível no Site do KDE.

O &kaffeine; usa um arquivo chamado scanfile.dvb para armazenar a lista de canais de TV digital conhecidos por cidade e país. Este arquivo é mantido em sincronia com a árvore de desenvolvimento do dtv-scan-tables, mantido pela comunidade LinuxTV. Para mais detalhes, favor ver a página wiki do dtv-scan-tables.

Quando o botã́o é pressionado, &kaffeine; irá descarregar a última versão do arquivo com definições de canais e armazenar dentro da área local específica do usuário, substituindo quaisquer conteúdos de uma versão anterior.

Favor notar que, para usar as novas definições, é necessário fechar o diálogo de configuração de TV e reabrir.

A opção Editar arquivo de busca permite editar o arquivo, o que pode ser útil para adicionar um novo conjunto de canais, enquanto o arquivo da Internet não é atualizado. Se você necessitar usar essa opção, favor considerar enviar uma atualização para a árvore dtv-scan-tables , de forma que outros possam também beneficiarem-se das novas definições de canal.

A opção Usar a codificação ISO 8859-1 ao invés de ISO 6937 permite selecionar a codificação padrão a ser utilizada em mensagens no stream MPEG-TS que não definam explicitamente uma codificação. Se não selecionado, o padrão é utilizar a codificação definida na norma ISO-6937. Caso selecionado, o padrão é utilizar a norma ISO 8859-1. No Brasil, essa normalmente deve ser selecionada.

A opção Criar arquivo de informações para acompanhar gravações EPG habilita a gravação de arquivos auxiliares contendo o conteúdo do guia de programação para gravações realizadas por meio do Guia de programação.

#### Configurando origens para TV digital

Configuração de dispositivos de TV Configuração de TV

As abas de Dispositivo possuem configurações por dispositivo. Geralmente, selecionando o país e a cidade na caixa de seleção Origem (ou selecionando busca automática) é suficiente para dispositivos de TV não satelitais. O mesmo ocorre em dispositivos que suportem múltiplos padrões de TV. Nestes dispositivos, é necessário configurar a Origem para cada padrão de TV:

Configuração de canais Configuração de canais

A opção Tempo de espera do sintonizador especifica a quantidade de tempo que a busca de canais irá esperar para obter sintonia. Usualmente, o padrão é suficiente para a maior parte dos dispositivos, mas se o dispositivo levar muito tempo para travar no canal, este valor pode ser aumentado.

O Nome especifica o nome associado com a origem que irá aparecer no item Televisão da barra de menu e a opção Canais, para o painel de ajustes.

##### Dispositivos para Satélite

A configuração para dispositivos satelitais (DVB-S e DVB-S2) são mais complexas, pois diferentes arranjos no sistema satelital são possíveis. Além nisso, nestes sistemas, é usual que o dispositivo alimente com energia um amplificador localizado no prato do satélite - chamado LNBf - por meio de uma tensão DC.

Além disso, como sistemas satelitais utilizam banda larga e aceitam sinais de diferente polaridades, é comum o uso de um protocolo - chamado DiSEqC - de forma a selecionar a faixa de canais a ser recebidas.

O primeiro passo é ensinar o &kaffeine; a respeito da configuração dos satélites via a caixa de seleção Configuração:

Definições para dispositivos de satélite Configuração de dispositivos para Satélite

Os seguintes são possíveis:

- `Chave DiSEqC` - O cabeamento da antena está conectado a uma chave DiSEqC ou o LNBf requer comandos DiSEqC para selecionar a faixa de canais. Esta é a configuração mais comum. Permite utilizar até 4 satelites conectados ao mesmo tempo, cada um com o seu próprio prato. Fara cada satélite, é necessário ajustar a configuração do LNBf que aponta para o respectivo satélite.

- `Rotor USALS` - O cabeamento da antena está conectado a um prato único com um rotor USALS, controlado via DiSEqC. Múltiplos satélites podem ser configurados, pois o rotor irá alterar a posição do prato quando um satélite diferente é escolhido. Você precisará especificar a posição do prato (latitude, longitude).

- `Rotor de posições` - O cabeamento da antena está conectado a um prato único com um rotor com um conjunto pré-fixado de posições, controlado via DiSEqC. Múltiplos satélites podem ser configurados, pois o rotor irá alterar a posição do prato quando um satélite diferente é escolhido. Você precisará especificar a posição do prato (latitude, longitude).

- `Disabilitar DiSEqC` - O cabeamento da antena está conectado a um prato sem nenhum elemento que suporte DiSEqC. Esta configuração é tipicamente utilizada em configurações de LNBf multiponto (bandstacked), onde todos os canail estão presentes ao mesmo tempo nos sinais vindo no cabeamento da antena.

Em um sistema satelital típico, o LNBf utiliza a voltagem recebida para energizá-lo para selecionar entre polarização vertical ou circular anti horária, para voltagem mais baixa (13V) ou para polarização horizontal ou circular horária. No entanto, devido a perdas no cabeamento, algumas vezes o LNBf não entende a voltagem mais alta, e vários canais não irão sintonizar ou sintonizarão de forma errada. Então, alguns dispositivos oferecem a opção de aumentar a tensão para valores maiores (14V ou 19V). Esta configuração é habilitada por meio da opção Use voltagem mais alta no LNBf. Três valores são possíveis:

- `tri-state` - Não envia comandos para o dispositivo ajustar o nível de voltagem. Este é o padrão.

- `não selecionado` - Usa valores normais (13V/18V) para a tensão DC. Apenas selecione em dispositivos que aceitem ajustar a tensão.

- `selecionado` - Usa valores mais altos (14V/19V) para a tensão DC. Apenas selecione em dispositivos que aceitem ajustar a tensão.

##### Configurações sem rotor

Quando as opções `Chave DiSEqC` ou `Desabilitar DiSEqC` são utilizadas, o primeiro passo é configurar o satélite que será usado como origem do sinal, por meio da caixa de seleção à direita. Com uma chave DiSEqC, é possível selecionar até 4 origens, cada uma com seu próprio LNBf. Apos configurar a(s) origem(ns), para cada satélite, pressione o botão correspondente de configurações do LNBf para abrir uma janela que permitirá selecionar o tipo do LNBf que está no prato correspondente a origem do sinal:

Definições de LNBf Configuração de LNBf

##### Configurações com rotor

Quando um rotor é utilizado, existe apenas um único LNBf que é compartilhado por múltiplos satélites. Assim, o próximo passo é selecionar o tipo de LNBf por meio do diálogo Configurações do LNBf.

Para rotor USALS, o posicionamento é feito por meio da posição do satélite (latitude, longitude). Assim, apenas selecione os satélites que serão utilizados por meio da caixa de seleção e pressionar o botão Satélite.

Para rotor de posições, o posicionamento é feito por meio de uma posição numerada pré-configurada. Assim, apenas selecione a posição do satélite na caixa de seleção numérica à esquerda e o satélite por meio da caixa de seleção à direita e pressione o botão Adicionar Satélite.

Se um satélite for adicionado por engano, selecione o satélite e pressione o botão Remover Satélite para removê-lo.

#### Configurações de canal para TV digital

Após pressionar o botão Ok, a próxima etapa é realizar a busca por canais de TV digital, utilizando o item Televisão da barra de menu, e selecionar a opção Canais para abrir o painel de ajustes:

Iniciar busca Iniciar busca

Se mais de um padrão for suportado, a caixa de seleção Origem irá permitir que seja selecionado aquele que será utilizado na busca de canais. Não esqueça de conectar o dispositivo no cabo de antena correspondente ao padrão que será utilizado.

Quando o &kaffeine; identifica um canal, ele interpreta uma tabela do MPEG-TS chamada Network Information Table (NIT), que contém informações relativas aos canais utilizando outros parâmetros de sintonia transmitidos pelo provedor. Em certas redes, é possível que tais parâmetros estejam armazenados em mais de uma tabela NIT (referidas como outras redes). Isto é mais comum em alguns sistemas de TV a cabo e satelitais. Selecionando procurar transponders de outras redes, o &kaffeine; é instruído a esperar e processar todas as outras tabelas NIT, o que poderá fazê-lo encontrar mais canais, com o custo de levar muito tempo a mais para completar o processo de busca por canais.

A operação de busca de canais é iniciada pressionando o botão Iniciar busca. Uma vez concluída a operação, os canais descobertos aparecerão no lado direito da imagem. Esses canais podem ser copiados para o lado esquerdo pressionando o botão Adicionar filtrado. É possível verificar os parâmetros de sintonia dos canais do lado esquerdo, pressionando o botão Editar. Alguns parâmetros podem ser ajustados na janela que aparecerá.

Editar canal Editar canal

Uma vez que os canais de TV sejam armazenados, assistí-los é tão simples quanto pressionar o botão TV digital na tela principal:

### Assistindo TV

Assistindo TV Assistindo TV

O &kaffeine; também permite pressionar o botão para pausar uma transmissão. Com esta ação, o &kaffeine; irá gravar o programa. Quando o botão for novamente pressionado, o programa será novamente exibido à partir do instante em que foi pausado. Isto é conhecido como deslocamento de tempo (time shift). Existe também o botão que permite que seja realizada uma gravação instantânea do programa no disco.

### Guia de Programação

Canais de TV digital geralmente transmitem uma lista com as atrações atuais e futuras. Isto é chamado de Guia de Programação Eletrônica - EPG. Os dados do EPG são capturados quando o conteúdo de um canal é visualizado. Para ver as informações do EPG, abra o item Televisão da barra de menu e selecione a opção Guia de Programação:

Guia de programação Guia de programação

Em alguns países, o EPG está disponível em múltiplas linguagens. Por padrão, o &kaffeine; mostra quaisquer linguagens no EPG. Se múltiplas linguagens estão disponíveis para uma dada entrada no EPG, e nenhuma seleção de conteúdo de linguagem foi selecionada, o título, sub-título e a descrição serão precedidos por um código de linguagem de três letras, conforme a especificação ISO 639-2.

A opção Idioma do guia permite filtrar apenas uma linguagem. Se habilitada, o mesmo filtro será aplicato também no On Screen Display - OSD e em todos os novos agendamentos para gravação. Não afetará agendamentos pré-existentes.

Além de pressionando o botão de gravação quando houver uma exibição ao vivo, o &kaffeine; permite iniciar a gravação de um programa pressionando o botão Gravar programa na janela do Guia de programação.

### Agenda de gravações

Para ver quais programas estão agendados para gravação, abra o item Televisão da barra de menu e selecione a opção Agenda de gravações:

Agenda de gravações Agenda de gravações

Pressionando o botão Novo também é possível para definir diretamente o horário e a duração do programa a ser gravado. Neste caso, não serão utilizadas as definições do guia de programação (EPG).

Selecionando um programa existente e pressionando o botão Editar é possível alterar o horário de início e a duração de uma gravação. É possível também programar para repetir a gravação diariamente ou semanalmente.

Selecionando um programa existente e pressionando o botão Remover será removido o programa da agenda de programações.

## A barra de menu do &kaffeine;

### O Menu Arquivo

&Ctrl;O Arquivo Abrir...

- Abre o diálogo de arquivo e permite selecionar um arquivo local para ser reproduzido.

&Ctrl;U File Abrir URL...

- Abre um diálogo para entrada de texto, de forma a permitir a entrada de uma &URL; apontando para um arquivo externo de audio/vídeo suportado.

Arquivo Abrir Recente

- Oferece uma lista lateral com os arquivos mais recentes. Possui também uma opção Limpar Lista que permite limpá-la.

Arquivo Reproduzir &CD; de áudio

- Seleciona a reprodução de um &CD; de áudio que deve já estar inserido no dispositivo reprodutor de &CD;.

Arquivo Reproduzir &CD; de vídeo

- Seleciona a reprodução de um Vídeo &CD; (VCD) que deve já estar inserido no dispositivo reprodutor de &CD;.

Arquivo Reproduzir &DVD;

- Seleciona a reprodução de um &DVD; que deve já estar inserido no dispositivo reprodutor de &DVD;.

Arquivo Reproduzir pasta de &DVD;

- Abre o diálogo de arquivo e permite selecionar um diretório com o conteúdo de um &DVD; para reproduzir. Este diretório deve conter os arquivos brutos conforme encontrados em um &DVD;.

&Ctrl;Q Arquivo Sair

- Encerra o &kaffeine;.

### O Menu Reproduzir

PgUp Reproduzir Anterior

- Se forem selecionados duas ou mais faixas em uma seleção, irá selecionar a faixa anterior.

Espaço Reproduzir Reproduzir/Pausar

- e . Com uma caixa de verificação para reproduzir uma faixa ou pausar o que está sendo assistido. Em um programa de televisão em reproducção, irá gravá-lo. Isto é conhecido como deslocamento de tempo (time shifting).

&Backspace; Reproduzir Parar

- Interrompe uma faixa que esteja sendo assistida.

PgDn Reproduzir Próximo

- Se forem selecionados duas ou mais faixas em uma seleção, irá selecionar a próxima faixa.

F Reproduzir Modo de tela cheia/Sair do modo de tela cheia

- e . Altera para modo de tela cheia.

. Reproduzir Modo Mínimo/Sair do Modo Mínimo

- e . Alterna o modo mínimo. Um modo &GUI; na qual a janela possui apenas menus contextuais e atalhos de teclado.

Reproduzir Legenda

- Apresenta uma lista lateral com opções relacionadas com legendas na(s) faixa(s).

  Reproduzir Legendas desligado/`Nome da legenda`

- Selecione a legenda disponível da lista lateral. A lista de legendas irá variar, conforme o conteúdo do faixa ou canal que está sendo reproduzido.

Reproduzir Legenda Adicionar arquivo de legenda

- Esta opção é para adicionar legenda de um arquivo local por meio de uma caixa de diálogos de arquivo.

Reproduzir Áudio

- Oferece uma lista lateral com opções relacionadas à(s) trilhas(s) de áudio disponíveis no conteúdo reproduzido.

  Reproduzir Áudio Dispositivo de Áudio

- Oferece uma lista lateral com os dispositivos de áudio disponíveis. Disponível apenas se mais de um dispositivo de áudio tiver sido detectado quando o &kaffeine; foi iniciado.

Reproduzir Áudio Aumentar Volume

- Aumenta volume de som. O volume também pode ser aumentado posicionando o mouse em cima da região de reprodução de media e girando a roda do mouse para cima.

Reproduzir Áudio Reduzir Volume

- Diminui volume de som. O volume também pode ser reduzindo posicionando o mouse em cima da região de reprodução de media e girando a roda do mouse para baixo.

Reproduzir Áudio Mudo

- e . Alterna entre silenciar o volume do áudio ou retornar ao volume anterior.

Reproduzir Vídeo

- Oferece uma lista lateral com opções relacionadas a trilha(s) de vídeo.

  Reproduzir Vídeo Desentrelaçar

- Apresenta uma caixa de seleção para ligar ou desligar desentrelaçamento. É o processo de converter um vídeo entrelaçado, tais como video gravado para televisores analógicos e monitores que não suportam modo progressivo (por exemplo, monitores 1080i). Veja este artigo da Wikipedia para maiores detalhes.

Reproduzir Vídeo Relação de Aspecto

- Oferece uma lista lateral com as relações de aspecto, além da opção Automático. A relação de aspecto de uma imagem corresponde a proporção entre sua altura e seu comprimento.

Reproduzir Vídeo Tamanho do vídeo

- Oferece uma lista lateral com os tamanhos de vídeo disponíveis. Permite alterar a percentagem de ampliação da imagem, aém das opções Automático e Tamanho Original.

&Ctrl;J Reproduzir Ir para posição

- Oferece um campo incremental para ajuste do ponto no tempo na qual deseja-se reproduzir a faixa; com horas, minutos e segundos.

Reproduzir Saltar

- Oferece uma lista lateral com quatro opções pré-definidas para saltos temporais. Com as seguintes opções:

  &Shift;← Reproduzir Saltar Voltar 60 segundos

- recua 60 segundos.

← Reproduzir Saltar Voltar 15s

- recua 15 segundos.

→ Reproduzir Saltar Avançar 15s

- avança 15 segundos.

&Shift;→ Reproduzir Saltar Avançar 60s

- avança 60 segundos.

Reproduzir Menu do &DVD;

- Iniciar o menu gráfico original do &DVD;. O menu é explorado utilizando as teclas de cursor e o mouse. Veja este artigo da Wikipedia para maiores detalhes.

Reproduzir Título

- O conteúdo de um &DVD; é dividido em títulos para facilitar a navegação. Por este menu, é possível ir diretamente para um título.

Reproduzir Capítulo

- O conteúdo de um &DVD; é dividido em capítulos para facilitar a navegação. Por este menu, é possível ir diretamente para um capítulo.

Reproduzir Ângulo

- Uma variação dos capítulos: é possível que existam várias versões de certas cenas (chamado de ângulos). Por este menu, é possível ir diretamente para um ângulo.

### O menu de listas de reprodução

Lista de reprodução Repetir

- Uma caixa de verificação para permitir repetir indefinidadmente a reprodução de arquivo(s) que estão em uma lista de reprodução.

Lista de reprodução Aleatório

- Uma caixa de verificação para reproduzir arquivos de uma lista de reprodução em ordem aleatória até que todos os arquivos sejam reproduzidos.

Lista de reprodução Apagar

- Apaga todas as entradas de uma lista de reprodução.

Lista de reprodução Novo

- Cria uma nova lista de reprodução.

Lista de reprodução Renomear

- Troca o nome da lista de reprodução corrente.

Lista de reprodução Remover

- Remove a lista de reprodução corrente.

&Ctrl;S Lista de reprodução Salvar

- Armazena a lista de reprodução corrente.

&Ctrl;&Shift;S Lista de reprodução Savar como...

- Savar a lista de reprodução atual com um novo nome.

### O Menu Televisão

C Televisão Canais

- Um painel de configuração irá aparecer, permitindo configurar os canais correspondentes a sua área. Veja a seção Configurações de canal para TV digital para maiores detalhes.

G Televisão Guia de Programação

- Uma janela irá aparecer para gerenciar o guia de programação. Veja a seção Guia de Programação para maiores detalhes.

O Televisão Mensagem na tela

- Mostra na janela de reprodução algumas informações sobrepostas (OSD) durante três segundos contendo informações do guia de programação à respeito do programa atual e do próximo programa. Um click duplo irá mostrar mais informações sobre o programa atual. Um novo click irá fazer com que estas informações desapareçam. Veja o artigo Wikipedia para maiores detalhes.

R Televisão Agenda de gravações

- Uma janela irá aparecer para gerenciar o(s) programa(s) agendados para gravação. Veja a seção Agenda de gravações para maiores detalhes.

Televisão Gravação Instantânea

- Com uma caixa de verificação para selecionar esta opção. Inicia imediatamente a gravação de um programa que esteja sendo reproduzido.

Televisão Configurar Televisão...

- Uma janela irá aparecer para permitir ajustar os parâmetros e gerenciar o(s) dispositivo(s) de TV digital. Veja a seção Configurações para TV Digital para maiores detalhes.

### O Menu Configurações

De forma a simplificar o uso do &kaffeine;, este menu contém apenas duas opções:

Configurações Configurar Atalhos...

- Permite habilitar, desabilitar e modificar as teclas de atalho. Para maiores informações, veja a seçãoUsando e modificando teclas de atalho.

Configurações Configurar o &kaffeine;...

- Abre o painel de configurações.

### O Menu de Ajuda

O &kaffeine; possui os itens comuns do &kde; de Ajuda. Para maiores informações, leia as seções sobre o Menu Ajuda dos Fundamentos do &kde;.

## Copyright e licença

Copyright do programa 2007-2018, Autores do &kaffeine;.

Copyright da documentação: 2003-2005, Jürgen Kofler kaffeine@gmx.net, Christophe Thommeret hftom@free.fr, Mauro Carvalho Chehab mchehab+kde@kernel.org

Tradução de Mauro Carvalho Chehabmchehab@infradead.org

&underFDL; &underGPL;
&documentation.index;