Skip to main content

Share application state across computers using Dropbox.

Project description

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.

Build Status Coverage Status Scrutinizer Code Quality PyPI Version

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

Project details


Download files

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

Source Distribution

mine-3.0.1.tar.gz (20.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mine-3.0.1-py3-none-any.whl (26.1 kB view details)

Uploaded Python 3

File details

Details for the file mine-3.0.1.tar.gz.

File metadata

  • Download URL: mine-3.0.1.tar.gz
  • Upload date:
  • Size: 20.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.4.1 CPython/3.10.9 Darwin/22.4.0

File hashes

Hashes for mine-3.0.1.tar.gz
Algorithm Hash digest
SHA256 cf1be25718b7278e8ba13c021ce0037db79ac304c9c32c5edc93e620f758cf83
MD5 bf2231e943e6c832643be049e0524b34
BLAKE2b-256 c2679076db44bee37fe6e2b2a69d1d2fcf76d91406327c30deb070c2d85cbcb4

See more details on using hashes here.

File details

Details for the file mine-3.0.1-py3-none-any.whl.

File metadata

  • Download URL: mine-3.0.1-py3-none-any.whl
  • Upload date:
  • Size: 26.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.4.1 CPython/3.10.9 Darwin/22.4.0

File hashes

Hashes for mine-3.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 3512f0c59dc6fdf88137771f432a435dfc6fbd07cbbd1ec19a9d6aabd2963164
MD5 eb85f28bc5fe8f36eebadfe34b4e0332
BLAKE2b-256 4bd9cd3b891ae63d7d8186f6139bb898831f0101f946d287f3e7e93bb56a98e4

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page