https://github.com/shochdoerfer/krunner-gitlab
KRunner GitLab Backend
https://github.com/shochdoerfer/krunner-gitlab
gitlab kde krunner plasma
Last synced: 10 months ago
JSON representation
KRunner GitLab Backend
- Host: GitHub
- URL: https://github.com/shochdoerfer/krunner-gitlab
- Owner: shochdoerfer
- License: apache-2.0
- Created: 2019-01-05T14:40:50.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2019-01-14T21:32:52.000Z (over 7 years ago)
- Last Synced: 2025-07-27T04:57:24.923Z (10 months ago)
- Topics: gitlab, kde, krunner, plasma
- Language: Go
- Size: 7.81 KB
- Stars: 15
- Watchers: 1
- Forks: 0
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# KRunner GitLab backend
This package provides a [KRunner](http://blog.davidedmundson.co.uk/blog/cross-process-runners/) backend which will use a GitLab instance as a search backend. Currently only project names are searched for, this might change in the future.
## Installation
Clone this repository
```
git clone https://github.com/shochdoerfer/krunner-gitlab
```
Build the go application
```
cd
go install
```
Register the runner in KDE by storing a file called `krunner-gitlab.desktop` in `$HOME/.local/share/kservices5` and then restart the rkunner process.
```
[Desktop Entry]
Name=GitLab
Comment=GitLab KRunner
X-KDE-ServiceTypes=Plasma/Runner
Type=Service
Icon=internet-web-browser
X-KDE-PluginInfo-Author=Stephan Hochdörfer
X-KDE-PluginInfo-Email=S.Hochdoerfer@bitExpert.de
X-KDE-PluginInfo-Name=krunner-gitlab
X-KDE-PluginInfo-Version=1.0
X-KDE-PluginInfo-License=Apache-2.0
X-KDE-PluginInfo-EnabledByDefault=true
X-Plasma-API=DBus
X-Plasma-DBusRunner-Service=de.hochdoerfer.gitlab
X-Plasma-DBusRunner-Path=/krunner
```
To configure krunner-gitlab with the url and the access token for your own GitLab instance, create a file `$HOME/.krunner-gitlab.yaml` like this:
```
url: https://your-gitlab-server/api/v4
token: your-token
```
It is important to note that the url needs to point to the GitLab API url!
## Run the application
Run `krunner-gitlab` in your `go/bin` directory. Invoke KRunner and start searching for GitLab projects.
## License
KRunner GitLab is released under the Apache 2.0 license.