# Kolibri Linux desktop app integration plugin
This is a Kolibri plugin which generates Linux desktop launchers and icons for Kolibri channels. These files are created automatically in `$KOLIBRI_HOME/content/xdg/share`. This plugin is intended to be used inside a Kolibri desktop application such as <https://flathub.org/apps/details/org.learningequality.Kolibri>.
## Usage
Install the plugin from pypi:
```
pip install kolibri-app-desktop-xdg-plugin
```
Enable the plugin in Kolibri and generate launchers:
```
kolibri plugin enable kolibri_app_desktop_xdg_plugin
kolibri manage app_desktop_xdg_update_launchers
```
Additional desktop launchers will be generated automatically when channels are added or removed. For these launchers to appear on your desktop, you will need to add their location to the `XDG_DATA_DIRS` environment variable. To do this in most Linux distributions, create a file named `/usr/lib/systemd/user-environment-generators/61-kolibri-app-desktop-xdg-plugin` with the following contents, then log out and log in again:
```
#!/bin/bash
XDG_DATA_DIRS="$HOME/.kolibri/content/xdg/share:${XDG_DATA_DIRS:-/usr/local/share:/usr/share}"
echo "XDG_DATA_DIRS=$XDG_DATA_DIRS"
```
You can substitute the path to Kolibri's home directory for `$HOME/.kolibri`.
Raw data
{
"_id": null,
"home_page": "https://github.com/endlessm/kolibri-app-desktop-xdg-plugin",
"name": "kolibri-app-desktop-xdg-plugin",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "kolibri",
"author": "Dylan McCall",
"author_email": "dylan@endlessos.org",
"download_url": "",
"platform": null,
"description": "# Kolibri Linux desktop app integration plugin\n\nThis is a Kolibri plugin which generates Linux desktop launchers and icons for Kolibri channels. These files are created automatically in `$KOLIBRI_HOME/content/xdg/share`. This plugin is intended to be used inside a Kolibri desktop application such as <https://flathub.org/apps/details/org.learningequality.Kolibri>.\n\n## Usage\n\nInstall the plugin from pypi:\n\n```\npip install kolibri-app-desktop-xdg-plugin\n```\n\nEnable the plugin in Kolibri and generate launchers:\n\n```\nkolibri plugin enable kolibri_app_desktop_xdg_plugin\nkolibri manage app_desktop_xdg_update_launchers\n```\n\nAdditional desktop launchers will be generated automatically when channels are added or removed. For these launchers to appear on your desktop, you will need to add their location to the `XDG_DATA_DIRS` environment variable. To do this in most Linux distributions, create a file named `/usr/lib/systemd/user-environment-generators/61-kolibri-app-desktop-xdg-plugin` with the following contents, then log out and log in again:\n\n```\n#!/bin/bash\nXDG_DATA_DIRS=\"$HOME/.kolibri/content/xdg/share:${XDG_DATA_DIRS:-/usr/local/share:/usr/share}\"\necho \"XDG_DATA_DIRS=$XDG_DATA_DIRS\"\n```\n\nYou can substitute the path to Kolibri's home directory for `$HOME/.kolibri`.\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Kolibri plugin for Linux desktop app integration",
"version": "1.2.0",
"project_urls": {
"Homepage": "https://github.com/endlessm/kolibri-app-desktop-xdg-plugin"
},
"split_keywords": [
"kolibri"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "4401a40f3823fc367731e5cd7a90306b0cc3af080b1e13f59fd66efb3ff7bec4",
"md5": "8271f7b08ddb748b7f1af41c761f89ab",
"sha256": "d689e7cdcdad49a2897fa1ce9069ff9d57e375c7918a4e5b27bb6fbe4d3e5859"
},
"downloads": -1,
"filename": "kolibri_app_desktop_xdg_plugin-1.2.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "8271f7b08ddb748b7f1af41c761f89ab",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 11081,
"upload_time": "2023-12-07T23:18:22",
"upload_time_iso_8601": "2023-12-07T23:18:22.201546Z",
"url": "https://files.pythonhosted.org/packages/44/01/a40f3823fc367731e5cd7a90306b0cc3af080b1e13f59fd66efb3ff7bec4/kolibri_app_desktop_xdg_plugin-1.2.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-12-07 23:18:22",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "endlessm",
"github_project": "kolibri-app-desktop-xdg-plugin",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "kolibri",
"specs": [
[
">=",
"0.14.6"
]
]
},
{
"name": "Pillow",
"specs": [
[
">=",
"8.1.2"
]
]
}
],
"lcname": "kolibri-app-desktop-xdg-plugin"
}
JSON
