ctrl+shift+p filters: :st2 :st3 :win :osx :linux
Browse

Sync Settings

by mfuentesg ST2/ST3

Sync Settings - The cross-platform solution to keep Sublime Text configuration synchronized

Details

Installs

  • Total 24K
  • Win 11K
  • OS X 8K
  • Linux 5K
Dec 6 Dec 5 Dec 4 Dec 3 Dec 2 Dec 1 Nov 30 Nov 29 Nov 28 Nov 27 Nov 26 Nov 25 Nov 24 Nov 23 Nov 22 Nov 21 Nov 20 Nov 19 Nov 18 Nov 17 Nov 16 Nov 15 Nov 14 Nov 13 Nov 12 Nov 11 Nov 10 Nov 9 Nov 8 Nov 7 Nov 6 Nov 5 Nov 4 Nov 3 Nov 2 Nov 1 Oct 31 Oct 30 Oct 29 Oct 28 Oct 27 Oct 26 Oct 25 Oct 24 Oct 23 Oct 22
Windows 13 4 19 17 20 3 5 11 11 10 9 5 8 9 7 12 16 15 16 10 7 14 8 15 14 15 12 6 14 6 11 8 11 9 7 12 13 9 23 5 9 4 15 5 10 16
OS X 8 5 13 6 9 1 5 8 7 15 11 4 7 10 4 10 8 3 11 7 4 6 9 20 10 6 5 4 13 13 9 14 13 8 13 10 7 7 14 9 5 3 7 3 8 8
Linux 9 10 5 2 2 5 2 6 8 4 1 7 8 4 6 6 8 7 7 6 4 10 10 7 8 6 5 5 10 3 5 10 7 6 3 9 7 7 5 4 3 0 4 3 11 9

Readme

Source
raw.​githubusercontent.​com

Sync Settings

SyncSettings license SyncSettings release Build Status Coverage

Become a backer Become a sponsor

With Sync Settings, you are able to synchronize your Sublime Text settings among multiple devices, and keep them updated.

Being powered by GitHub-Gists, Sync Settings provides you a reliable cross-platform solution to keep your backups secure.

Please, follow the steps below to getting started with Sync Settings.

Sync Settings works on Windows, Linux, macOS and Sublime Text 3.

Getting Started

  1. Run Package Control: Install Package command, and looks for Sync Settings
  2. Run Sync Settings: Edit User Settings
  3. if Do you already have a gist?
    1. Copy gist id and put it in config file (https://gist.github.com/<username>/<gist id>) (gist_id property)
    2. Run Sync Settings: Download command to retrieve your backup.
  4. else
    1. Create an access token here with gist scope checked.
    2. Put the token in the config file (access_token property)
    3. Run Sync Settings: Create and Upload command

Options

By default this plugin operates over Sublime Text packages folder (i.e /Users/marcelo/Library/Application Support/Sublime Text 3/Packages/User), which means, excluded_files and included_files will looks for files inside that folder.

name type description
access_token string Brings write permission to Sync Settings, over your gists (edit, delete and create). (This option is not required, if you only want to download your backups)
gist_id string Identifier of your backup on gist.github.com.
auto_upgrade boolean If is true, your settings will be synced with the latest settings on gist.github.com when Sublime Text startup
http_proxy string An HTTP proxy server to use for requests.
https_proxy string An HTTPS proxy server to use for requests.
excluded_files []string In simple words, this option is a black list. Which means, every file that match with the defined pattern, will be ignored on sync.
included_files []string In simple words, this option is a white list. Which means, every file that match with the defined pattern, will be included on sync, even if it was included on excluded_files option.

Note: excluded_files and included_files are patterns defined as unix shell style.

Commands

command description
Sync Settings: Create and Upload Creates a new backup on gist.github.com from your local files
Sync Settings: Delete and Create Deletes the remote reference of your gist and then, creates a new backup from your local files to gist.github.com
Sync Settings: Upload Upload a backup from your local files to gist.github.com
Sync Settings: Download Retrieves the latest version of your backup, using as reference the gist_id property defined in your settings file.
Sync Settings: Delete Deletes the remote version of your gist, using as reference the gist_id property defined in your settings file. (This action is irreversible)
Sync Settings: Show Logs Open a new view, with Sync Settings log file
Sync Settings: Edit User Settings Open a new view, with Sync Settings user settings.

Contributors

Thank you for contribute to this project:

Issues

If you are experimenting an error, or an unusual behavior. Please let me know, creating a new issue appending the logs provided by the Sync Settings: Show logs command.

Development

You are welcome to contribute to this project, whenever you want.

Install dependencies

This project uses pipenv as environment and package manager, follow the instructions below and start contribute.

$ pipenv --python 3.7
$ pip install -r requirements.txt

Run tests

$ pip install nose
$ nosetests tests

License

Sync Settings is licensed under the MIT license.

All of the source code, is under the license:

Copyright (c) since 2015, Marcelo Fuentes <marceloe.fuentes@gmail.com>.

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

Help me keep making awesome stuff

Contribute with me, supporting this project through

Become a backer

Become a backer