Skip to main content


Project description

…for applications that haven’t learned to share.

Build Status
Coverage Status
Scrutinizer Code Quality
PyPI Version
PyPI Downloads


This program lets you synchronize application data using Dropbox.

It automatically starts and stops programs that would otherwise fight over data in a shared folder and ensures only one instance is running. Many applications work fine when their data is stored in Dropbox, but some programs overwrite databases:

  • iTunes
  • iPhoto
  • etc.

while others periodically write snapshot data:

  • Eclipse
  • Xcode
  • etc.

and some just don’t make sense to keep running on all your computers:

  • Slack
  • HipChat
  • etc.



  • Python 3.3+


Install mine with pip:

$ pip install mine

or directly from the source code:

$ git clone
$ cd mine
$ python install


Create a mine.yml in your Dropbox:

  - name: My iMac
    hostname: My-iMac.local
    address: 00:11:22:33:44:55
  - name: My MacBook Air
    hostname: My-MacBook-Air.local
    address: AA:BB:CC:DD:EE:FF
  - name: iTunes
      auto_queue: false
      single_instance: true
      windows: iTunes.exe
      linux: null
  - name: Slack
      auto_queue: true
      single_instance: false
      windows: null
      linux: null

Include the applications you would like mine to manage. Computers are added automatically when mine is run.

The versions dictionary identifies the name of the executable on each platform. The properties.auto_queue setting indicates mine should attempt to launch the application automatically when switching computers. The properties.single_instance setting indicates the application must be closed on other computers before another instance can start.


To synchronize the current computer’s state:

$ mine

To close applications on remote computers and start them locally:

$ mine switch

To close applications running locally:

$ mine close

To close applications locally and start them on another computer:

$ mine switch <name>

To delete conflicted files in your Dropbox:

$ mine clean

Revision History

1.1 (unreleased)

  • Updated switch to close all locally running applications.

1.0 (2016/11/01)

  • Initial stable release.

0.6.1 (2016/09/23)

  • Added a delay to ensure all applications close.
  • Fixed cleanup of unused applications and computers.

0.6 (2016/07/02)

  • Added a close command to close all locally running applications.

0.5 (2016/05/16)

  • Added periodic checking to the daemon (regardless of file changes).

0.4.3 (2016/05/11)

  • Fixed __init__ warnings with YORM v0.8.1.

0.4.2 (2016/03/30)

  • Updated to YORM v0.7.2.

0.4.1 (2016/02/23)

  • Updated to YORM v0.6.

0.4 (2015/12/30)

  • Added file watching to update program state faster.

0.3 (2015/11/14)

  • Added automatic daemon restart using nohup.
  • Moved queued to setting properties.single_instance.
  • Added properties.auto_queue to filter active applications.

0.2.1 (2015/09/05)

  • Fixed daemon warning to run using nohup

0.2 (2015/08/27)

  • Added --daemon option to run continuously.
  • Added edit command to launch the settings file.

0.1.2 (2015/05/17)

  • Updated to YORM v0.4.

0.1.1 (2015/03/19)

  • Initial release.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
mine-1.1b1-py3-none-any.whl (30.0 kB) Copy SHA256 hash SHA256 Wheel py3
mine-1.1b1.tar.gz (23.4 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page