Overview

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.

Setup

Requirements

Python 3.7+

Installation

Install mine with pipx (or pip):

$ pipx install mine

or directly from the source code:

$ git clone https://github.com/jacebrowning/mine.git
$ cd mine
$ python setup.py install

Configuration

Create a mine.yml in your Dropbox:

config:
  computers:
    - 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
  applications:
    - name: iTunes
      properties:
        auto_queue: false
        single_instance: true
      versions:
        mac: iTunes.app
        windows: iTunes.exe
        linux: null
    - name: Slack
      properties:
        auto_queue: true
        single_instance: false
      versions:
        mac: Slack.app
        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.

Usage

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

Metadata

Release files for mine 2.0b1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mine 2.0b1
File	Size	Uploaded
mine-2.0b1.tar.gz	20.1 kB	Aug 15, 2022	Details

Built distribution (wheel)

Table of built distributions (wheels) for mine 2.0b1
File	Interpreter	ABI	Platform	Reset
mine-2.0b1-py3-none-any.whl 26.2 kB Aug 15, 2022	Python 3	none	any	Details

Total release size: 46.2 kB

Release files / mine-2.0b1.tar.gz

Download URL	mine-2.0b1.tar.gz
Size	20.1 kB
Tags	Source
SHA-256 checksum How to use checksums	`f5c5175f3b7a2383f17d73b4f33bdfb491c11b920521099a94bb4306b94c5a2e`
BLAKE2b-256 checksum How to use checksums	`f1164f79fc166319ad0b8402e24d7818faa60d0b4ed4e8bbd1358b86852c297a`
Upload date	Aug 15, 2022
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/1.1.14 CPython/3.9.9 Darwin/20.6.0`

Release files / mine-2.0b1-py3-none-any.whl

Download URL	mine-2.0b1-py3-none-any.whl
Size	26.2 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`30268b7756a836b95e27dc02bdfe6fe1fa9cbc05289afb280e0dcc5ce8f4b741`
BLAKE2b-256 checksum How to use checksums	`f8448b752b001a230cfbeccdb59e33acfb9fff585290dc17b5ab48cdb1f1c7f6`
Upload date	Aug 15, 2022
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/1.1.14 CPython/3.9.9 Darwin/20.6.0`