box-linux-sync - A naïve Linux Client

An unofficial attempt to create a Linux synchronization client because does not provide one.


File synchronization is currently done using the WebDAV interface provided by There is also a Python API available but I haven’t started to mess with it.


  • Python 2.7 and up (may work on earlier versions, haven’t tested).
  • Davfs2. To install it use:
    • Debian, Ubuntu: apt-get install davfs2
    • Red Hat, SuSE, Fedora: yum install davfs2
    • Gentoo: emerge davfs2
    • ArchLinux: pacman -S davfs2


$ cd ~/path/of/your/choice
$ git clone git://

Installation via Pip is not currently available. Let’s wait for a proper release, OK?.


Check environment and setup box-sync and it’s dependencies:

$ cd ~/path/to/box-linux-sync/bin
$ ./box-sync check && ./box-sync setup

Edit ~/.noiselabs/box/box-sync.cfg to fit your preferences:

$ vim ~/.noiselabs/box/box-sync.cfg
; box-sync.cfg

; Path to your Box sync dir. Use a relative path to place this dir
; inside $HOME or an absolute path. Default: Box
box_dir = Box

; Wether to use a WebDAV filesystem to synchronize your local and
; remote files. Default: true
use_davfs = true

Start synchronization via Davfs:

$ ./box-sync start

Stop synchronization:

$ ./box-sync stop

Send box-sync into oblivion when you get tired of it.

This just removes box-sync configuration files and the repository, not your personal files (unless you have configured the box_sync dir to be inside ~/.noiselabs).

$ ./box-sync uninstall
$ rm ~/path/to/box-linux-sync


This application is licensed under the LGPLv3 License. See the LICENSE file for details.


Vítor Brandão - ~ ~

See also the list of contributors who participated in this project.

Indices and tables

Table Of Contents

This Page