Add Godot Provider launcher plugin. (#141)

* Add Godot Provider launcher plugin. * Add 'nohup' as a dependency in plugin.toml
2026-07-29 00:26:28 -04:00
parent 4ec9cae852
commit 9faf3b9c25
6 changed files with 296 additions and 0 deletions
@@ -0,0 +1,43 @@
+# Godot Provider
+
+![Godot Provider thumbnail](thumbnail.webp)
+
+Godot Provider integrates all projects within the project manager with the 
+Noctalia launcher so you can open a project quickly without leaving the shell.
+
+## Plugin
+
+| Field | Value |
+| --- | --- |
+| ID | `ramosdetrigo/godot-provider` |
+| Entry | Launcher provider: `provider` |
+| Launcher Prefix | `/gd` |
+
+## Requirements
+
+Install [Godot](https://godotengine.org/) and ensure `godot` is available on
+`PATH` as `godot`. Alternatively, you can set the path to the godot binary in
+the plugin's settings. The `nohup` command is required to launch Godot.
+
+## Usage
+
+Open the Noctalia launcher and type `/gd` to list local Godot projects.
+Continue typing to filter projects by name, then select one to open it with
+`godot`.
+
+## Settings
+
+- `sort_by` — Sort projects by last used or most opened projects in the launcher.
+- `projects_path` — The path to Godot's projets.cfg file.
+- `godot_command` — The shell command to open godot.
+
+## Notes
+
+Projects are read from Godot's projects.cfg file, typically at
+`~/.local/share/godot/projets.cfg`. The list is cached for the launcher session
+and refreshed when you clear the query.
+
+The `sort_by` setting sorts by writing the project's ids in a json inside the plugins' 
+[`pluginDataDir`](https://docs.noctalia.dev/v5/plugins/development/runtime-api/?section=filesystem#filesystem).
+
+Small parts of the code were taken or based upon the [zed-provider](https://github.com/noctalia-dev/community-plugins/tree/main/zed-provider) plugin.