Operação com a Linha de Comandos
Quando são fornecidos parâmetros na linha de comandos, o KAlarm não mostra a lista de alarmes agendados, tal como foi descrito acima em Usar o KAlarm. As opções da linha de comandos específicas do KAlarm poderão ser usadas para efectuar as seguintes operações:
escalonar um novo alarme
controlar o servidor de alarmes
controlar o modo de apresentação do KAlarm
obter ajuda
As opções adicionais da linha de comandos são oferecidas em primeiro lugar para permitir aos outros programas interagirem com o KAlarm. Elas estão descritas no capítulo do Guia do Programador do KAlarm.
A linha de comandos só poderá conter as opções que se apliquem a uma operação do KAlarm. Se quiser efectuar várias operações, terá de invocar o KAlarm várias vezes com um conjunto único de opções de cada vez.
As seguintes opções são utilizar para escalonar um novo alarme:
| Opção | Descrição |
|---|---|
-a, --ack-confirm | Pede uma confirmação quando a mensagem de alarme for recebida. |
-A, --attach | Indica o nome ou o URL de um ficheiro que deverá ser anexado à mensagem de e-mail. Esta opção poderá ser repetida tantas vezes quantas as necessárias. O --mail terá de ser fornecido com esta opção. |
--auto-close | Fecha automaticamente a janela do alarme, depois de terminar o período indicado com a opção --late-cancel. A opção --late-cancel deverá ser indicada com esta opção. |
-b, --beep | Toca uma campainha audível quando a mensagem for apresentada. O --speak, o --play e o --play-repeat não poderão ser indicados com esta opção. |
--bcc | Envia uma cópia invisível para si próprio. O --mail necessita ser indicado com esta opção. |
-c, --color, --colour | Indica a cor de fundo da mensagem com o nome da cor no Qt™ ou com o código hexadecimal 0xRRGGBB. |
-C, --colorfg, --colourfg | Indica a cor do texto da mensagem com o nome da cor no Qt™ ou com o código hexadecimal 0xRRGGBB. |
-d, --disable | Desactiva o alarme. Não irá disparar até que tenha sido activado manualmente. |
-e, --exec | Indica um comando a executar. Se for fornecida, esta opção deverá ser a última opção da linha de comandos do KAlarm. Todos os parâmetros subsequentes e as opções são interpretados como formando a linha de comandos a executar. O --file e o --mail não podem ser indicados com esta opção. O --ack-confirm, o --beep, o --color e o --colorfg são ignorados com esta opção. |
-f, --file | Indica o nome ou o URL de um ficheiro de texto ou de imagem cujo conteúdo irá formar a mensagem de alarme. O --exec e o --mail não poderão ser indicados e a mensagem não deverá estar presente com esta mensagem. |
-F, --from-id | Usa a identidade do KMail indicada como remetente da mensagem de e-mail. O --mail deverá ser indicado com esta opção. |
-i, --interval | Indica o intervalo entre repetições do alarme. As horas/minutos são indicados no formato nHnM, em que o n é um número, isto é 3H30M. Os outros períodos de tempo são indicado no formato nX, em que o n é um número e o X é uma das seguintes letras: Y ('years' - anos), M ('months' - meses), W ('weeks' - semanas), D ('days' - dias). Se a opção --recurrence for também indicada, o Y (anos) e M (meses) não são permitidos. A opção é obrigatória se for usada a --until ou a --repeat. |
-k, --korganizer | Mostra o alarme como um evento no calendário activo do KOrganizer. |
-l, --late-cancel | Cancela o alarme se não puder ser despoletado dentro do período indicado, a seguir à hora exacta. O período é indicado no mesmo formato que está descrito para a opção --reminder. O valor por omissão do período é 1 minuto. |
-L, --login | Dispara o alarme sempre que você se liga, após a autenticação. O --interval, o --repeat e o --until não podem ser fornecidos com esta opção. |
-m, --mail | Envia uma mensagem de e-mail para o endereço indicado. Esta opção pode ser repetida tantas vezes quantas as necessárias. O --exec e o --file não podem ser indicados com esta opção. O --ack-confirm, o --beep, o --color e o --colorfg são ignorados com esta opção. |
-p, --play | Indica o nome ou o URL de um ficheiro de áudio a ser tocado logo que a mensagem de alarme seja apresentada. O --play-repeat, o --beep e o --speak não podem ser indicados com esta opção. |
-P, --play-repeat | Indica o nome ou o URL de um ficheiro de áudio a ser tocado repetidamente enquanto a mensagem de alarme estiver visível. O --play, o --beep e o --speak não podem ser indicados com esta opção. |
--recurrence | Indica o alarme a repetir. Especifique a repetição com a sintaxe do iCalendar (definida no RFC2445), isto é “FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO”. O --until não pode ser indicado com esta opção. |
-r, --repeat | Indica o número de vezes que o alarme deverá ser despoletado ou, se for indicada uma recorrência com a opção --recurrence, o número de vezes que o alarme deverá ser despoletado de cada vez que o --recurrence o activar (isto é uma repetição dentro de uma recorrência). Se a opção --recurrence não estiver presente, indique -1 para repetir o alarme indefinidamente. O --interval deverá ser indicado, ainda que o --until não o possa ser, com esta opção. |
-R, --reminder | Mostra um alarme de chamada de atenção no período de tempo antes do alarme principal e de cada uma das suas repetições (se houverem). As horas/minutos são indicados no formato nHnM, em que o n é um número, isto é 3H30M. Os outros períodos de tempo são indicado no formato nX, em que o n é um número e o X é uma das seguintes letras: W ('weeks' - semanas), D ('days' - dias). Esta opção não pode ser usada com o --exec, o --mail ou o --reminder-once. |
--reminder-once | Mostra um alarme de chamada de atenção apenas uma vez, logo que o período de tempo indicado antes da primeira ocorrência do alarme tenha sido atingido. Não será mostrada qualquer chamada de atenção antes das recorrências subsequentes (se existirem). Esta opção não poderá ser indicada com a --exec, --mail ou a --reminder. |
-s, --speak | Fala a mensagem quando esta for apresentada. Esta opção necessita de ter o KTTSD instalado e configurado com um sintetizador de fala compatível. O --beep, o --play e o --play-repeat não poderão ser indicados com esta opção. |
-S, --subject | A linha do assunto da mensagem de e-mail. O --mail deverá ser indicado com esta opção. |
-t, --time | Despoleta o alarme na data ou na data/hora indicadas. Indique uma data sem hora no formato aaaa-mm-dd [FH]; por outro lado, indique uma data e hora com [[[aaaa-]mm-]dd-]hh:mm [FH] Se não tiver sido escolhido nenhum fuso-horário, assume-se o fuso-horário do sistema local. Se estiver presente um indicador de fuso-horário FH, poderá ser o nome de um fuso-horário de sistema (isto é Europa/Londres), UTC - representando o fuso-horário UTC ou Clock para usar o relógio do computador local e ignorar os fusos-horários. |
-v, --volume | Define o volume do áudio para tocar o ficheiro de áudio. Esta opção só poderá ser usada quando o --play ou o --play-repeat forem também usados. |
-u, --until | Repete o alarme até à data ou data/hora indicadas. Indique uma data sem hora no mesmo formato que é usado no --time. Repare que, se o --time for usado, o fuso-horário será extraído do seu valor e não se poderá incluir nenhum fuso-horário no valor de --until. O --interval deverá ser usado, enquanto que o --repeat e o --recurrence não poderão ser usados, com esta opção. |
mensagem | O texto da mensagem a mostrar ou, se o --mail for indicado, o corpo da mensagem de e-mail. |
Tanto deverá ser usado um texto de mensagem, o --file ou o --exec; excepto nos casos acima indicados, todas as opções são opcionais.
Aqui estão dois exemplos alternativos que mostram uma mensagem em várias linhas com um fundo vermelho às 22 horas, no dia 27 deste mês:
%kalarm-cred-t27-22:00"Lembre-se de\nPARAR"%kalarm-c0xFF0000-t27-22:00"Lembre-se de \nPARAR"
