Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/oae/gnome-shell-extensions-sync
Syncs gnome shell keybindings, tweaks settings and extensions with their configuration across all gnome installations
https://github.com/oae/gnome-shell-extensions-sync
extensions-sync gist gitlab gjs gnome gnome-installations gnome-shell-extension rollupjs syncs-gnome typescript
Last synced: about 2 months ago
JSON representation
Syncs gnome shell keybindings, tweaks settings and extensions with their configuration across all gnome installations
- Host: GitHub
- URL: https://github.com/oae/gnome-shell-extensions-sync
- Owner: oae
- License: gpl-2.0
- Archived: true
- Created: 2018-09-27T19:52:47.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2023-06-16T08:40:14.000Z (over 1 year ago)
- Last Synced: 2024-08-07T23:47:14.479Z (5 months ago)
- Topics: extensions-sync, gist, gitlab, gjs, gnome, gnome-installations, gnome-shell-extension, rollupjs, syncs-gnome, typescript
- Language: TypeScript
- Homepage: https://extensions.gnome.org/extension/1486/extensions-sync/
- Size: 553 KB
- Stars: 296
- Watchers: 10
- Forks: 19
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-starred - oae/gnome-shell-extensions-sync - Syncs gnome shell keybindings, tweaks settings and extensions with their configuration across all gnome installations (typescript)
README
# Extensions Sync
[](#)
[](#)
[](https://github.com/oae/gnome-shell-extensions-sync/blob/master/LICENSE)
[](https://github.com/oae/gnome-shell-extensions-sync/releases/latest)
[](https://github.com/oae/gnome-shell-extensions-sync/compare)
Syncs gnome shell keybindings, tweaks settings and extensions with their configuration across all gnome installations
| Provider | Synced Data | Other Settings |
|:------------------------------------:|:------------------------------------:|:------------------------------------:|
|  |  |  |
## Installation
### From [Git](https://github.com/oae/gnome-shell-extensions-sync)
```bash
git clone https://github.com/oae/gnome-shell-extensions-sync.git
cd ./gnome-shell-extensions-sync
yarn install
yarn build
ln -s "$PWD/dist" "$HOME/.local/share/gnome-shell/extensions/[email protected]"
```
### From [Ego](https://extensions.gnome.org)
You can install it from [**here**](https://extensions.gnome.org/extension/1486/extensions-sync/)
## Usage
- You can select the data types that are going to be saved in the settings.
## For Github
1. Create a new gist from [here](https://gist.github.com/) I suggest you make it secret. You will need the gist id for this. You can find it in the url after username. For example on gist url `https://gist.github.com/username/f545156c0083f7eaefa44ab69df4ec37`, gist id will be `f545156c0083f7eaefa44ab69df4ec37`. [Guide](https://docs.github.com/en/get-started/writing-on-github/editing-and-sharing-content-with-gists/creating-gists)
2. Create a new token from [here](https://github.com/settings/tokens/new). Only **gist permission** is needed since we edit the gists. [Guide](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token)
3. Open extension settings, select the `Github` provider and fill gist id from first step and user token from second step.
## For Gitlab
1. Create a new snippet from [here](https://gitlab.com/-/snippets/new) I suggest you make it private. You will need the snippet id for this. You can find it in the url. For example on snippet url `https://gitlab.com/-/snippets/324234234`, snippet id will be `324234234`. [Guide](https://docs.gitlab.com/ee/user/snippets.html#create-snippets)
2. Create a new token from [here](https://gitlab.com/-/profile/personal_access_tokens). Only **api scope** is needed. [Guide](https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html#create-a-personal-access-token)
3. Open extension settings, select the `Gitlab` provider and fill snippet id from first step and user token from second step.
## For Local
1. Select a file that has read/write permission by your active user. (default backup file is in `~/.config/extensions-sync.json`)
## Cli Usage
You can trigger upload download operations using busctl.
```sh
busctl --user call org.gnome.Shell /io/elhan/ExtensionsSync io.elhan.ExtensionsSync save # uploads to server
busctl --user call org.gnome.Shell /io/elhan/ExtensionsSync io.elhan.ExtensionsSync read # downloads to pc
```
## Development
- This extension is written in Typescript and uses rollup to compile it into javascript.
- To start development, you need nodejs installed on your system;
- Clone the project
```sh
git clone https://github.com/oae/gnome-shell-extensions-sync.git
cd ./gnome-shell-extensions-sync
```
- Install dependencies and build it
```sh
yarn install
yarn build
ln -s "$PWD/dist" "$HOME/.local/share/gnome-shell/extensions/[email protected]"
```
- During development you can use `yarn watch` command to keep generated code up-to-date.