# Gnome Schedule User Guide V2.2

## Introduzione

Gnome Schedule è uno strumento grafico che permette con facilità la pianificazione di operazioni, senza l'intervento della persona, a un'ora specificata o periodicamente. Queste operazioni, conosciute anche come lavori, possono essere sia un comando con i relativi parametri che un file script con istruzioni multiple.

You can use Gnome Schedule to program repetitive tasks in your daily work that can be automated. You can also run a heavy task at night while you are sleeping, for example, backing up your documents.

### Come funziona Gnome Schedule?

Gnome Schedule uses cron and at to program job executions. These are two system services commonly used by Linux-like systems. Gnome Schedule provides a single graphical interface to configure both and present jobs in a way easy to understand for everyone.

### Informazioni su cron e at

Cron

If you were to configure cron manually to execute a command, for example every Tuesday, you would have to use the command `crontab` in this way:

    $ crontab -e
    * * * * 2 <command> --parameters  #comments

Vedere `man cron` e `man crontab` per maggiori informazioni su cron

At

If you were to configure at manually to execute a command, for example tomorrow at this time, you would have to use the command `at` in this way:

    $ at tomorrow
    at> <command_1> --parameters
    at> <command_2> --parameters
    at> Ctrl + D

Vedere `man at` per maggiori informazioni su at

## Per iniziare

### Per avviare Gnome Schedule

You can start Gnome Schedule in the following ways:

Menù Applicazioni

- Scegliere Strumenti di sistema Pianifica.

Linea di comando

- To start Gnome Schedule from a command line, type the following command, then press Return:

  `gnome-schedule`

### Quando si avvia Gnome Schedule

When you start Gnome Schedule, the main window is displayed:

#### Main Window

Shows Gnome Schedule main window. Contains title bar, tool bar, and task list.

La finestra principale di Gnome Schedule contiene i seguenti elementi:

The tool bar.

- The tool bar contains buttons that give you access to every function in the application.

Elenco operazioni pianificate.

- L'elenco delle operazioni mostra informazioni sulle operazioni pianificate e sui lavori pendenti. Per ogni operazione sono dettagliate le seguenti informazioni:

  Task:

- Describes the type of the task: "Recurrent", when the task runs repeatedly or "Once", when the task is done only once.

Description:

- Shows a brief description of the task.

Date and Time:

- Mostra quando l'operazione pianificata verrà eseguita.

Command preview:

- Mostra il comando che verrà eseguito.

You can read a brief description of some of the objects and icons on the Gnome Schedule interface, by pointing them with the mouse and waiting for a few seconds.

## Aggiungere una nuova operazione pianificata

### Choosing the type of task to add

You can add a new scheduled task by pressing the New button in the main window tool bar.

Apparirà La seguente finestra di dialogo che permette di scegliere il tipo di operazione che si vuole pianificare:

#### Finestra di dialogo selezione tipo di operazione

Mostra Gnome Schedule la finestra di dialogo per la selezione del tipo di operazione.

- by pressing the first button you will be able to schedule a task that will be executed periodically.

- by pressing the second button you will be able to schedule a task that will only be executed once.

- by pressing the third button you will be able to create a task from a template. Templates usage is explained in myapp-templates.

### Aggiungere una operazione pianificata da eseguire ricorrentemente

Scegliendo questa opzione, verrà mostrata la seguente finestra di dialogo:

#### Finestra «Crea una nuova operazione pianificata»

Mostra Gnome Schedule la finestra «Crea una nuova operazione pianificata».

Descrizione

- Permette di aggiungere una breve descrizione dell'operazione.

Comando

- Enter here the command or script that will be periodically executed by this task.

Time & Date

Basic

- Lets you select the frequency for task execution among a list of common intervals.

Advanced

- Lets you create custom time expressions in case you need more flexibility.

Preview

Lets the user check if the selected frequency is correct.

### Aggiungere un'operazione pianificata che verrà eseguita una volta sola

Scegliendo questa opzione verrà mostrata la seguente finestra di dialogo:

#### Finestra «Crea una nuova operazione pianificata»

Mostra Gnome Schedule la finestra «Crea una nuova operazione pianificata»

## Modificare un'operazione pianificata

You can modify a scheduled task by selecting it from the Task list with one click and by pressing the Edit button from the main window tool bar. Then, the Edit a Scheduled Task window will be opened showing the task properties.

Now, you will be able to modify any field you want. When you have finished you can press Apply button to save the changes or Cancel button to omit them.

You can edit a task faster by simply double-clicking on it in the task list.

## Eliminare un'operazione pianificata

You can delete a scheduled task by selecting it from the Task list with one click and by pressing the Delete button in the main window tool bar. Next, you will be asked for confirmation. By answering Yes, the scheduled task will be removed from the Task list.

Non-recurrent tasks disapear automatically from the list when they are done.

## Manually Running Scheduled Task

You can trigger a scheduled task by selecting it from the Task list with one click and by pressing the Run task button in the main window tool bar.

The task will be executed and its output will be displayed in a terminal window, letting you check if the task is correctly set.

## Using Templates

Gnome Schedule lets you save tasks as templates in order to reuse it later. This way, you will be able to create new scheduled tasks faster.

To manage templates press the Template button on the main window tool bar. A new window will show you a list of available templates. From this window you can create, modify, delete and use templates.

### Template manager window

Shows the "Manage templates" window

You can have common tasks saved as templates. So, you will not have to write the same stuff again and again!

## Utilizzare Gnome Schedule come utente root

Quando si usa Gnome Schedule come superutente, si possono vedere, modificare o aggiungere operazioni pianificate di altri utenti.

You can change the user by pressing the Change User button in the main window tool bar. Then, a dialog window will be shown. Choose the desired user from the drop-down list and press OK button. Now the main window will show the scheduled tasks of the selected user.

Please, keep in mind that this option is only available for system administrators.

## Using Gnome Schedule to launch graphical applications

You can use Gnome Schedule to launch a graphical application automatically, but there are some information you would consider before:

### About DISPLAY environment variable

When you run a graphical application from the command line you must first set the environment variable DISPLAY. This variable is used to tell your graphical application what X server to use. Normally you will want to use the one installed on your own computer. In that case you need to set the DISPLAY variable in this way:

`DISPLAY=:0.0`

where :0.0 means use screen 0 of X server 0 in this computer.

If you want display the application in a remote screen you can specify the IP address of the remote X server:

`DISPLAY=192.168.0.25:0.0`

### Setting DISPLAY variable for tasks that will launch once

When you are creating or modifying a task, you can define the DISPLAY variable in the script text box. Make the definition at the begining of the script.

### Setting DISPLAY variable for tasks that will launch recurrently

Gnome Schedule does not support yet setting environment variables for recurrent tasks, but it will do soon. In the meantime, you can manually create a script that first defines DISPLAY variable and then calls the graphical application. Finally, you can create a recurrent task to launch the script.

### About X server

The X server is part of the X Window System. It is in charge of drawing windows on the screen and processing the user input from a keyboard or any other peripheral.

If you need more information about X server or the X Window System you can read its entry in the Wikipedia.

## Informazioni su Gnome Schedule

### Autori

Gnome Schedule è stato scritto da Philip Van Hoof (pvanhoof@gnome.org), Kristof Vansant (de_lupus at pandora dot be) e Gaute Hope (eg@gaute.vetsj.com). Per trovare maggiori informazioni circa Gnome Schedule, visitare la pagina web di Gnome Schedule.

### Segnalare errori

Per segnalare un errore o inviare un suggerimento riguardo a questa applicazione o questo manuale, seguire le indicazioni in questo documento.

### Licenza

Questo programma è distribuito secondo i termini della GNU General Public license come pubblicata dalla Free Software Foundation; sia la versione 2 di questa licenza, che (secondo la proprio scelta) ogni altre versione successiva. Una copia di questa licenza può essere trovata a questo collegamento, oppure nel file COPYING incluso con il codice sorgente di questo programma.