| Name | mine JSON |
| Version |
4.2.3
JSON |
| download |
| home_page | https://pypi.org/project/mine |
| Summary | Share application state across computers using Dropbox. |
| upload_time | 2023-10-23 23:51:45 |
| maintainer | |
| docs_url | None |
| author | Jace Browning |
| requires_python | >=3.10,<4.0 |
| license | MIT |
| keywords |
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
|
# 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.
[](https://github.com/jacebrowning/mine/actions)
[](https://codecov.io/gh/jacebrowning/mine)
[](https://pypi.org/project/mine)
[](https://pypistats.org/packages/mine)
## Setup
### Requirements
- Python 3.10+
### Installation
Install `mine` with [pipx](https://pipxproject.github.io/pipx/installation/) (or pip):
```sh
$ pipx install mine
```
or directly from the source code:
```sh
$ git clone https://github.com/jacebrowning/mine.git
$ cd mine
$ python setup.py install
```
### Configuration
Create a `mine.yml` in your Dropbox:
```yaml
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:
```sh
$ mine
```
To close applications on remote computers and start them locally:
```sh
$ mine switch
```
To close applications running locally:
```sh
$ mine close
```
To close applications locally and start them on another computer:
```sh
$ mine switch <name>
```
To delete conflicted files in your Dropbox:
```sh
$ mine clean
```
Raw data
{
"_id": null,
"home_page": "https://pypi.org/project/mine",
"name": "mine",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.10,<4.0",
"maintainer_email": "",
"keywords": "",
"author": "Jace Browning",
"author_email": "jacebrowning@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/80/49/0133092ac45c9e7a48020e08b86e12cb22ec542080f8fa7c5c529207964a/mine-4.2.3.tar.gz",
"platform": null,
"description": "# Overview\n\nThis program lets you synchronize application data using Dropbox.\n\nIt 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:\n\n- iTunes\n- iPhoto\n- etc.\n\nwhile others periodically write snapshot data:\n\n- Eclipse\n- Xcode\n- etc.\n\nand some just don't make sense to keep running on all your computers:\n\n- Slack\n- HipChat\n- etc.\n\n[](https://github.com/jacebrowning/mine/actions)\n[](https://codecov.io/gh/jacebrowning/mine)\n[](https://pypi.org/project/mine)\n[](https://pypistats.org/packages/mine)\n\n## Setup\n\n### Requirements\n\n- Python 3.10+\n\n### Installation\n\nInstall `mine` with [pipx](https://pipxproject.github.io/pipx/installation/) (or pip):\n\n```sh\n$ pipx install mine\n```\n\nor directly from the source code:\n\n```sh\n$ git clone https://github.com/jacebrowning/mine.git\n$ cd mine\n$ python setup.py install\n```\n\n### Configuration\n\nCreate a `mine.yml` in your Dropbox:\n\n```yaml\nconfig:\n computers:\n - name: My iMac\n hostname: My-iMac.local\n address: 00:11:22:33:44:55\n - name: My MacBook Air\n hostname: My-MacBook-Air.local\n address: AA:BB:CC:DD:EE:FF\n applications:\n - name: iTunes\n properties:\n auto_queue: false\n single_instance: true\n versions:\n mac: iTunes.app\n windows: iTunes.exe\n linux: null\n - name: Slack\n properties:\n auto_queue: true\n single_instance: false\n versions:\n mac: Slack.app\n windows: null\n linux: null\n```\n\nInclude the applications you would like `mine` to manage. Computers are added automatically when `mine` is run.\n\nThe `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.\n\n## Usage\n\nTo synchronize the current computer's state:\n\n```sh\n$ mine\n```\n\nTo close applications on remote computers and start them locally:\n\n```sh\n$ mine switch\n```\n\nTo close applications running locally:\n\n```sh\n$ mine close\n```\n\nTo close applications locally and start them on another computer:\n\n```sh\n$ mine switch <name>\n```\n\nTo delete conflicted files in your Dropbox:\n\n```sh\n$ mine clean\n```\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Share application state across computers using Dropbox.",
"version": "4.2.3",
"project_urls": {
"Documentation": "https://mine.readthedocs.io",
"Homepage": "https://pypi.org/project/mine",
"Repository": "https://github.com/jacebrowning/mine"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "2fa5baf93ce774a78c9f75bc617537458ed7953e945f4d6ca5723b55f82938bb",
"md5": "caf8e45d514a4e6426d91d1bdc7c524d",
"sha256": "96361fb90ed47ffc48973e2089b1383e7a62ce50868008d9b6e42036593d6a3c"
},
"downloads": -1,
"filename": "mine-4.2.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "caf8e45d514a4e6426d91d1bdc7c524d",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10,<4.0",
"size": 26794,
"upload_time": "2023-10-23T23:51:43",
"upload_time_iso_8601": "2023-10-23T23:51:43.189710Z",
"url": "https://files.pythonhosted.org/packages/2f/a5/baf93ce774a78c9f75bc617537458ed7953e945f4d6ca5723b55f82938bb/mine-4.2.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "80490133092ac45c9e7a48020e08b86e12cb22ec542080f8fa7c5c529207964a",
"md5": "1829f001352c5eaceecd18066186d4c7",
"sha256": "719f79def5dff29011d623539f93f31c04101b98b8287deab155e98cef51395d"
},
"downloads": -1,
"filename": "mine-4.2.3.tar.gz",
"has_sig": false,
"md5_digest": "1829f001352c5eaceecd18066186d4c7",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10,<4.0",
"size": 20642,
"upload_time": "2023-10-23T23:51:45",
"upload_time_iso_8601": "2023-10-23T23:51:45.508697Z",
"url": "https://files.pythonhosted.org/packages/80/49/0133092ac45c9e7a48020e08b86e12cb22ec542080f8fa7c5c529207964a/mine-4.2.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-10-23 23:51:45",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "jacebrowning",
"github_project": "mine",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"lcname": "mine"
}
