MutagenMon

Cross-platform GUI for mutagen.io file synchronizer: monitor sessions status in tray, restart hanging sessions, resolve conflicts

Features

• MutagenMon starts sessions specified in file mutagen/mutagen-create.bat and monitors their status
• MutagenMon will restart a session if it freezes and cannot connect for some time
• MutagenMon shows an icon in tray based on current sessions status (if multiple sessions are being monitored, worst status of all sessions is shown:

Watching for changes (all ok)

Files updated (this icon is shown for one second when some files are updated in mutagen session)

Syncing (reconciling, staging, applying changes or saving archive)

Scanning files

Conflicts detected (but no problems or errors)

Problems detected

Waiting for mutagen daemon to respond

Mutagen stopping

Mutagen not running (restarting)

Mutagen not running (disabled)

Mutagen cannot connect (restarting)

Mutagen cannot connect (disabled)

• Click on MutagenMon icon in tray to see detailed status of each individual session:

• If there are conflicts, you can investigate them, resolve visually using winmerge (on Windows) or other software - or choose winning side at once. Time and size of both files is shown. File with latest timestamp is selected automatically for resolution:

• MutagenMon can automatically resolve conflicts if you specify paths, where Alpha or Beta versions should always win. You will get desktop notification if conflict is resolved automatically.

Operating system support

MutagenMon can work on Windows, Linux or Mac (currently tested only on Windows)

Installation on Windows

1. Download and unzip MutagenMon release
2. Download mutagen.io release and put mutagen binary into mutagen folder of MutagenMon
3. If you want to use visual diff and merge, download and install winmerge or alternative program, which can take two different files as two parameters.
4. Add your sessions to mutagen/mutagen-create.bat file in MutagenMon folder
5. Edit configuration file at mutagen/config/mutagenmon_config.json
6. Run mutagenmon

Installation from sources

1. Install python3
2. Install wxpython: pip install wxpython
3. Download and unzip MutagenMon release
4. Download mutagen.io release and put mutagen binary into mutagen folder of MutagenMon
5. If you want to use visual diff and merge, download and install winmerge or alternative program, which can take two different files as two parameters.
6. Add your sessions to mutagen/mutagen-create.bat file in MutagenMon folder
7. Edit configuration file at mutagen/config/mutagenmon_config.json
8. Run mutagenmon

Limitations

• Requires that session names are unique
• Works only with local and ssh mutagen transports

Issue on mutagen: mutagen-io/mutagen#173