Differences

This shows you the differences between two versions of the page.

--- user-guide:pluginmanager [2024/05/27 16:18] – created timob
+++ user-guide:pluginmanager [2025/10/15 08:37] (current) – [Usage from commandline] Tim
@@ Line 14: / Line 14: @@
 On the last tab "Repositories" different sources for plugins can be added or selected, for further info see [[dev-guide:plugins|here]]).
+===== Deleting/ Deactivating plugins =====
+. The parameter file: GroIMP can load options as parameters from either: the default file (in ~/.grogra.de-platform/groimp.properties) or from a file given when starting groimp: "java -jar core.jar -t "path/to/perfs.properties".
+The preference file is loaded when groimp starts and its content is used instead of java preferences when an option is queried in groimp. The option name follow the complete name of its registry path (I will provide a list of all option and their paths in the wiki). But for example the option useJRT can be defined as :
+/de/grogra/options/rgg/javaimport/useJRT=true
+. The plugin manager is accessible from the GUI under "Help>Plugin manager". Its goal is to help install/ remove/ update groimp plugins. So users can get small fixes in plugins without having to re download /reinstall a whole new groimp version.
+And (maybe?) if users create new plugins and decide to share them, It could make them available for all other users.
+From the plugin manager GUI, you can "install", "update", "disable", "remove" plugins.
+install will try to download it from the given source then dump it in the selected path (selected in the options/ by default ~/.grogra.de-platform/plugins).
+update: each plugin display its available versions. By selecting a different version you can upgrade/downgrade a plugin. This will download the new version from the given source, extract it under the plugin path, and remove the old version.
+disable is more usefull for me to debug. It set some groimp option to load the given plugin as disabled. They are then not usable from groimp. But they are not removed. It adds the option under the currently used property file (either one passed with "-t" or the default one).
+remove simply delete the plugin. It removes it from the computer (so be careful). For groimp instances where the installation path is not writable (usually on windows if you don't run groimp in admin) then, there is an option in groimp to "blacklist" plugin instead of deleting them. It adds their path to a file under (~/.grogra.de-plaftorm/blacklist). Blacklisted plugins are not loaded in groimp so a new version can be installed. (blacklist and disable are different: one is loaded but disabled the other is not loaded).
+The list of available plugin is provided by the "repositories" that you can see under the plugin manager "repositories".
+You can add your repositories that contains plugin metadata as (a JSON that contains the plugins data or a local directory in which some groimp plugin exist).
+All of these actions are doable from groim commands. Thus, accessible from the api, cli, and in headless with the command parameter.
@@ Line 28: / Line 42: @@
+===== Usage from commandline =====
+it is possilbe to install plugins without opening GroIMP by using the following commands:
+<code>
+#install
+java -jar core.jar --headless -- -cmd /pluginmanager/commands/installCMD=de.grogra.gltf;de.grogra.cli
+#uninstall
+java -jar core.jar --headless -- -cmd /pluginmanager/commands/uninstallCMD=de.grogra.gltf;de.grogra.cli
+#disable
+java -jar core.jar --headless -- -cmd /pluginmanager/commands/disableCMD=de.grogra.gltf;de.grogra.cli
+</code>
+====== Grogra.de mirror ======
+The main plugin manager repository, as well as most of the released plugins, are hosted on gitlab.com.
+If you for any reason cant access gitlab.com a mirror is provided at: https://plugins.grogra.de/
+To enable this mirror in the plugin manager, go to the "Repositories" tab and add a new repository (press the "Add a repository" button).
+Set the new repository to "https://plugins.grogra.de/plugins.json"  and active it. At this point you might also deactivate the "grogra.gitlab.io" repository, but this step is not necessary.
+{{ :user-guide:plugin_manager_with_grogra_mirror.png?direct |}}