{"id":20418321,"url":"https://github.com/katsutedev/settings-repository","last_synced_at":"2025-04-12T17:26:13.119Z","repository":{"id":45509791,"uuid":"513246334","full_name":"KatsuteDev/Settings-Repository","owner":"KatsuteDev","description":"Sync VSCode settings, extensions, keybindings, and more to a repository","archived":false,"fork":false,"pushed_at":"2025-04-10T01:02:17.000Z","size":1617,"stargazers_count":8,"open_issues_count":2,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-10T01:43:15.240Z","etag":null,"topics":["extension","git","nodejs","repository","settings-json","settings-repo","settings-repository","settings-storage","settings-sync","sync-settings","ts","typescript","visual-studio-code","visual-studio-code-extension","visual-studio-code-settings","visual-studio-code-snippets","vscode","vscode-extension","vscode-sync","zip"],"latest_commit_sha":null,"homepage":"https://marketplace.visualstudio.com/items?itemName=katsute.settings-repository","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/KatsuteDev.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"custom":["katsute.dev"]}},"created_at":"2022-07-12T18:09:57.000Z","updated_at":"2025-04-08T01:34:55.000Z","dependencies_parsed_at":"2024-01-15T19:05:50.316Z","dependency_job_id":"43903b7c-27b6-47c6-bdf1-7d8a9b7eb1b2","html_url":"https://github.com/KatsuteDev/Settings-Repository","commit_stats":null,"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KatsuteDev%2FSettings-Repository","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KatsuteDev%2FSettings-Repository/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KatsuteDev%2FSettings-Repository/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KatsuteDev%2FSettings-Repository/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/KatsuteDev","download_url":"https://codeload.github.com/KatsuteDev/Settings-Repository/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248603581,"owners_count":21131825,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["extension","git","nodejs","repository","settings-json","settings-repo","settings-repository","settings-storage","settings-sync","sync-settings","ts","typescript","visual-studio-code","visual-studio-code-extension","visual-studio-code-settings","visual-studio-code-snippets","vscode","vscode-extension","vscode-sync","zip"],"created_at":"2024-11-15T06:31:35.330Z","updated_at":"2025-04-12T17:26:13.093Z","avatar_url":"https://github.com/KatsuteDev.png","language":"TypeScript","funding_links":["katsute.dev"],"categories":[],"sub_categories":[],"readme":"\u003cdiv id=\"top\" align=\"center\"\u003e\n    \u003cbr\u003e\n    \u003ca href=\"https://github.com/KatsuteDev/Settings-Repository#readme\"\u003e\n        \u003cimg src=\"https://raw.githubusercontent.com/KatsuteDev/Settings-Repository/main/assets/icon.png\" alt=\"icon\" width=\"100\" height=\"100\"\u003e\n    \u003c/a\u003e\n    \u003ch3\u003eSettings Repository\u003c/h3\u003e\n    \u003ch4\u003eSync VSCode settings to a repository\u003c/h4\u003e\n    \u003ca href=\"https://marketplace.visualstudio.com/items?itemName=katsute.settings-repository\"\u003e\u003cimg src=\"https://img.shields.io/visual-studio-marketplace/stars/katsute.settings-repository?style=for-the-badge\u0026logo=visualstudiocode\u0026labelColor=252526\u0026color=0098FF\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://marketplace.visualstudio.com/items?itemName=katsute.settings-repository\"\u003e\u003cimg src=\"https://img.shields.io/visual-studio-marketplace/i/katsute.settings-repository?style=for-the-badge\u0026logo=visualstudiocode\u0026labelColor=252526\u0026color=0098FF\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://marketplace.visualstudio.com/items?itemName=katsute.settings-repository\"\u003e\u003cimg src=\"https://img.shields.io/visual-studio-marketplace/d/katsute.settings-repository?style=for-the-badge\u0026logo=visualstudiocode\u0026labelColor=252526\u0026color=0098FF\"\u003e\u003c/a\u003e\n\u003c/div\u003e\n\n\u003cbr\u003e\n\nSync VSCode settings, extensions, keybindings, and more to a git repository.\n\n## Installation\n\n\u003e ⚠️ This extension is not compatible with remote distributions of VSCode (ex: Codespaces). Pull your settings from VSCode on desktop then use the [**Settings Sync**](https://code.visualstudio.com/docs/editor/settings-sync) that is included with VSCode.\n\nThis extension requires [git](https://git-scm.com/downloads) to be installed.\n\n#### VSCode Marketplace (recommended)\n\n 1. Install from `katsute.settings-repository` in the extension marketplace in Visual Studio Code or install from the [Visual Studio Marketplace](https://marketplace.visualstudio.com/items?itemName=katsute.settings-repository).\n\n#### Manual\n\n 1. Install the latest release from the [releases](https://github.com/KatsuteDev/Settings-Repository/releases) tab.\n 2. Open Visual Studio Code in the folder with the extension.\n 3. Right click the extension and select **Install Extension VSIX**.\n\n## \u0026nbsp;\n\nRun `Settings Repository: Choose Settings Repository` and select `Repository` to setup and authenticate with a repository, make sure you have your access token ready.\n\nFor classic tokens, make sure you have [**repo**] selected.\n\nFor fine grained tokens, make sure you have [**Read** and **Write** access to code] enabled.\n\nBy default this extension will use the `main` branch, if you are using a different branch make sure it has already been created before you push.\n\nLogging information is located in the lower panel under `Output \u003e Settings Repository`.\n\n\u003cdiv align=\"right\"\u003e\u003ca href=\"#top\"\u003e\u003ccode\u003e▲\u003c/code\u003e\u003c/a\u003e\u003c/div\u003e\n\n## Features\n\n#### Extension Sync\n\nSync all of the extensions that you use, including disabled ones.\nCurrently the enabled/disabled state of extensions can not be toggled (see [microsoft/vscode#15466](https://github.com/microsoft/vscode/issues/15466#issuecomment-724147661)), extensions will be enabled/disabled based on the local settings.\n\n#### Settings Sync\n\nSync your settings and snippets wherever you use VSCode.\n\n#### Keybindings Sync\n\nSync keybindings between Windows and Mac, automatically swaps between \u003ckbd\u003ectrl\u003c/kbd\u003e and \u003ckbd\u003e⌘\u003c/kbd\u003e.\n\n#### Locale Sync\n\nSync the language that VSCode uses. Requires a restart to see changes.\n\n#### Repository Sync\n\nUse any git repository to backup your settings. For private repositories make sure your token is scoped correctly. Branch must already exist.\n\n#### Import / Export to ZIP\n\nShare copies of your settings without needing a repository.\nUse `Settings Repository: Export Settings` to export settings to a zip file and use `Settings Repository: Import Settings` to import settings from a zip file.\n\n\u003cdiv align=\"right\"\u003e\u003ca href=\"#top\"\u003e\u003ccode\u003e▲\u003c/code\u003e\u003c/a\u003e\u003c/div\u003e\n\n## Commands\n\n| Command | Description |\n|---|---|\n|\u003ckbd\u003eSettings Repository: Options\u003c/kbd\u003e|Menu to access commands for this extension. Can be accessed by clicking `Settings Repository` on the statusbar.|\n|\u003ckbd\u003eSettings Repository: Choose Settings Repository\u003c/kbd\u003e|Menu to access repository options and commands.|\n|\u003ckbd\u003eSettings Repository: Authenticate\u003c/kbd\u003e|Update git authentication.|\n|\u003ckbd\u003eSettings Repository: Overwrite Local\u003c/kbd\u003e|Overwrite local settings with ones from the git repository.|\n|\u003ckbd\u003eSettings Repository: Overwrite Remote\u003c/kbd\u003e|Overwrite settings on the git repository with ones stored locally.\n|\u003ckbd\u003eSettings Repository: Import Settings\u003c/kbd\u003e|Import settings from a zip file.|\n|\u003ckbd\u003eSettings Repository: Export Settings\u003c/kbd\u003e|Export settings to a zip file.|\n\n\u003cdiv align=\"right\"\u003e\u003ca href=\"#top\"\u003e\u003ccode\u003e▲\u003c/code\u003e\u003c/a\u003e\u003c/div\u003e\n\n## Configuration\n\n| Name | Type | Description |\n|---|:-:|---|\n|`settings-repository.repository`|`string`|The git repository to sync settings with.|\n|`settings-repository.branch`|`string`|The branch to sync settings with. Branch must already exist.|\n|`settings-repository.autoSync`|`boolean`|Automatically sync settings when VSCode closes.|\n|`settings-repository.includeHostnameInCommitMessage`|`boolean`|Include hostname in the commit message.|\n\n\u003cdiv align=\"right\"\u003e\u003ca href=\"#top\"\u003e\u003ccode\u003e▲\u003c/code\u003e\u003c/a\u003e\u003c/div\u003e\n\n## \u0026nbsp;\n\nThis extension is released under the [GNU General Public License (GPL) v2.0](https://github.com/KatsuteDev/Settings-Repository/blob/main/LICENSE).","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkatsutedev%2Fsettings-repository","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkatsutedev%2Fsettings-repository","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkatsutedev%2Fsettings-repository/lists"}