---
name: "msynctool"
section: "1"
platform: "linux"
package: "multisync-tools"
version: "0.92.0~svn355-2"
release: "Debian 6.0 (Squeeze)"
platforms: ["linux"]
url: "https://new.carta.tech/msynctool"
---

# msynctool(1)

Command line interface for OpenSync

## NAME

msynctool - Command line interface for OpenSync

## SYNTAX

msynctool *option* \[*arguments*\] \[*option*\]\
 msynctool --sync SYNC\_GROUP

## DESCRIPTION

Command line interface for OpenSync \
 You can use this tool to synchronize your devices and applications using the OpenSync framework from the command line.\

- \- First you have to create a SYNC\_GROUP:

  -

  msynctool --addgroup evo2-sync

- \- Now you have to add the members to this group. (2 at least)

  **Note: The first argument to the --addmember command is the group to which you want to add a member, the second argument is the name of the plugin to add.**

-

  msynctool --addmember evo2-sync evo2-sync

-

  msynctool --addmember evo2-sync file-sync

- \- The next thing you have to do is to configure the plugins.

  -

  msynctool --configure evo2-sync 1\
   (configures the first group member)

-

  msynctool --configure evo2-sync 2\
   (configures the second group member)

- \- Now your group is ready for usage!

  -

  msynctool --sync evo2-sync

## OPTIONS

- **--listgroups**

  Lists all groups

- **--listplugins**

  Lists all plugins

- **--listobjects**

  Lists all objtypes that the engine understands

-

  objtypes: *contact*, *data*, *event*, *note*, *todo*

- **--showformats** *objtype*

  Lists all formats that a objtype can have

- **--showgroup** *groupname*

  Lists all members of the group

- **--sync** *groupname*

  Sync all members in a group

- **--filter-objtype** *objtype*

  Filter out objtype

-

  For example, the following syncs only contacts:

-

  msynctool --sync evo2-sync --filter-objtype event --filter-objtype note --filter-objtype todo

**Note: if you use "--filter-objtype data" it syncs nothing !?**

- **--slow-sync** *objtype*

  Perform a slow-sync of all members in the group

- **\[--wait\]**

  Don't immediately start to sync, but wait for a client to initialize the sync

- **\[--multi\]**

  Repeat to wait for sync alerts

- **--addgroup** *groupname*

  Add a new group

- **--delgroup** *groupname*

  Delete the given group

- **--addmember** *groupname* *plugintype*

  Add a member to the group

- **--configure** *groupname* *memberid*

  Configure a member. memberid as returned by **--showgroup**

- **\[--manual\]**

  Make manual engine iterations. Only for debugging

- **\[--configdir\]**

  Set a different configdir than ~/.opensync

- **\[--conflict 1-9/d/i/n\]**

  Resolve all conflicts as side *1-9* wins, *d*uplicate, *i*gnore, or keep *n*ewer

## ENVIRONMENT VARIABLES

- **OSYNC\_TRACE**

  When you want to provide trace files please turn on tracing like this:

-

  export OSYNC\_TRACE=/path/to/log/dir

-

  When you run some opensync commands now, opensync will generate a couple of Thread\*.log files in this directory.

-

  You can exclude sensitive data in the trace files with:

-

  export OSYNC\_PRIVACY=1

## SEE ALSO

[**convcard**(1)](/convcard/1.md),**file-sync.conf**(5)

## AUTHORS

This manual page was written for the Debian GNU/Linux project by Matthias Jahn \<jahn.matthias@freenet.de\>. But it may be used by other distributions.

msynctool was written by Armin Bauer and the OpenSync project