~whynothugo/autovdirsyncer

Wrapper to daemonise vdirsyncer.
Update email address
cca755f7 — Hugo Osvaldo Barrera 2 years ago
Don't run service if vdirsyncer is not configured
a282a247 — Hugo Osvaldo Barrera 2 years ago
Don't say vdirsyncer was successful if it wasn't

clone

read-only
https://git.sr.ht/~whynothugo/autovdirsyncer
read/write
git@git.sr.ht:~whynothugo/autovdirsyncer

You can also use your local clone with git send-email.

#autovdirsyncer

autovdirsyncer is a wrapper to daemonise vdirsyncer.

It monitors your vdir collections and runs vdirsyncer:

  • After two seconds if a file is changed. ("active" runs)
  • Every fifteen minutes if no file has changed. ("passive" runs)

Active runs will be postponed by two seconds if you keep editing files. This is so that, if multiple events are happening at once (e.g.: you're copying a bunch of files), synchronisation will happen only after you're done.

Feel free to join the IRC channel: #pimutils on irc.libera.chat.

#Caveats

  • If you alter files continuously within two second intervals, vdirsyncer will not run. It'll run after the continuous editing happens. This should not be an issue for usual / desktop usage.
  • If you run vdirsyncer sync manually, another sync may be triggered due to our change detection. This is generally fine due to atomicity, but may result in pointless double-runs.

#Installation

There's an AUR package for ArchLinux users.

For other platforms, you can build autovdirsyncer using:

make

And install using:

sudo make install

#Usage

Finally, enable this to run as a service for your user with:

systemctl --user enable --now autovdirsyncer

systemd is not required, and you may use the service manager of your choice to run this.

Keep in mind that the binary is not in your $PATH my default, but in /usr/lib/autovdirsyncer, since it's not intended to be run interactively.

#Licence

autovdirsyncer is licensed under the ISC licence. See LICENCE for details.