summaryrefslogtreecommitdiff
path: root/desktop-cronish.1.in
blob: 55c3180d4e9a0670fbbd632b97202719c0ca7fee (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
.\" Copyright 2013 Lars Wirzenius <liw@liw.fi>
.\"
.\" This program is free software: you can redistribute it and/or modify
.\" it under the terms of the GNU General Public License as published by
.\" the Free Software Foundation, either version 3 of the License, or
.\" (at your option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program.  If not, see <http://www.gnu.org/licenses/>.
.\"
.TH DESKTOP-CRONISH 1
.SH NAME
desktop-cronish \- run periodic jobs in a desktop session
.SH SYNOPSIS
.SH DESCRIPTION
.B desktop-cronish
runs periodic jobs in a desktop session.
It can be used to run
.BR offlineimap (1),
for example.
.SH OPTIONS
.SH EXAMPLE
To run
.BR offlineimap (1)
every minute,
and
.BR wotsap (1)
every week,
create the following file and call it foo.cronish:
.PP
.nf
.RS
offlineimap:
    interval: 60
    timeout: 120
    command: offlineimap -u quiet

wotsap:
    trigger-file: /home/liw/.wotsapdb
    trigger-age: 604800
    command: /home/liw/bin/update-wotsap
.RE
.fi
.PP
When you log into your desktop, open a terminal and run the following
command:
.PP
.nf
.RS
desktop-cronish foo.cronish
.RE
.fi
.PP
The command will run indefinitely, until you kill it with control-C.
.SH "SEE ALSO"
.BR fixme (1),
.BR fixme (7).