mirror of
				https://github.com/kevinveenbirkenbach/cli-gnome-extension-manager.git
				synced 2025-10-31 11:59:01 +00:00 
			
		
		
		
	Update README.md
This commit is contained in:
		
							
								
								
									
										71
									
								
								README.md
									
									
									
									
									
								
							
							
						
						
									
										71
									
								
								README.md
									
									
									
									
									
								
							| @@ -1,2 +1,69 @@ | ||||
| # cli-gnome-extension-manager | ||||
| Bash script to install, activate and deactivate gnome extensions via CLI | ||||
| # CLI GNOME Extension Manager 🚀 | ||||
|  | ||||
| [](./LICENSE) [](https://www.gnu.org/software/bash/) [](https://github.com/kevinveenbirkenbach/cli-gnome-extension-manager/stargazers) | ||||
|  | ||||
| Manage your GNOME extensions easily from the command line with **CLI GNOME Extension Manager**. This Bash script lets you install, update, enable, and disable GNOME extensions directly from your terminal. | ||||
|  | ||||
| ## Features ✨ | ||||
|  | ||||
| - **Install & Update**: Clone extension repositories and update them if already installed. | ||||
| - **Compile**: Automatically compile the extension if a Makefile is provided. | ||||
| - **Activate/Deactivate**: Enable or disable GNOME extensions easily using the CLI. | ||||
| - **Automation-Friendly**: Perfect for power users and automation scripts. | ||||
|  | ||||
| ## Requirements 🔧 | ||||
|  | ||||
| - **GNOME Shell** (version 3.36+) | ||||
| - **Bash** (version 4.x+) | ||||
| - **Git** (for cloning repositories) | ||||
| - **Make** (optional, for compiling extensions) | ||||
| - **gnome-extensions** CLI tool | ||||
|  | ||||
| ## Installation 📦 | ||||
|  | ||||
| You can install **CLI GNOME Extension Manager** using [Kevin's Package Manager](https://github.com/kevinveenbirkenbach/pkgmgr): | ||||
|  | ||||
| ```bash | ||||
| pkgmgr install goexma | ||||
| ``` | ||||
|  | ||||
| Alternatively, clone this repository: | ||||
|  | ||||
| ```bash | ||||
| git clone https://github.com/kevinveenbirkenbach/cli-gnome-extension-manager.git | ||||
| cd cli-gnome-extension-manager | ||||
| ``` | ||||
|  | ||||
| ## Usage ⚙️ | ||||
|  | ||||
| To **install and enable** an extension, run: | ||||
|  | ||||
| ```bash | ||||
| goexma enable <extension_name> <extension_repository_path> | ||||
| ``` | ||||
|  | ||||
| To **disable** an extension, run: | ||||
|  | ||||
| ```bash | ||||
| goexma disable <extension_name> | ||||
| ``` | ||||
|  | ||||
| The script will: | ||||
| - Clone the repository if the extension isn't installed. | ||||
| - Pull updates if the extension is already a Git repository. | ||||
| - Compile the extension if a Makefile is present. | ||||
| - Enable or disable the extension using `gnome-extensions`. | ||||
|  | ||||
| ## License 📜 | ||||
|  | ||||
| This project is licensed under the GNU Affero General Public License v3.0. See the [LICENSE](./LICENSE) file for details. | ||||
|  | ||||
| ## Author 👨💻 | ||||
|  | ||||
| **Kevin Veen-Birkenbach**   | ||||
| - 📧 [kevin@veen.world](mailto:kevin@veen.world)   | ||||
| - 🌐 [https://www.veen.world/](https://www.veen.world/) | ||||
|  | ||||
| --- | ||||
|  | ||||
| Feel free to contribute, open issues, or suggest improvements. Enjoy managing your GNOME extensions effortlessly! 🌟 | ||||
|   | ||||
		Reference in New Issue
	
	Block a user