{"id":15441878,"url":"https://github.com/mudler/golauncher","last_synced_at":"2025-04-19T18:25:15.580Z","repository":{"id":57649076,"uuid":"443878956","full_name":"mudler/golauncher","owner":"mudler","description":":rocket: Highly extensible, customizable application launcher and window switcher written in less than 300 lines of Golang and fyne","archived":false,"fork":false,"pushed_at":"2022-01-13T17:47:00.000Z","size":659,"stargazers_count":68,"open_issues_count":1,"forks_count":6,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-12-25T16:40:26.053Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mudler.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-01-02T22:00:01.000Z","updated_at":"2024-12-21T15:29:55.000Z","dependencies_parsed_at":"2022-09-26T20:30:41.697Z","dependency_job_id":null,"html_url":"https://github.com/mudler/golauncher","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mudler%2Fgolauncher","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mudler%2Fgolauncher/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mudler%2Fgolauncher/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mudler%2Fgolauncher/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mudler","download_url":"https://codeload.github.com/mudler/golauncher/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":231397901,"owners_count":18370772,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-01T19:23:55.127Z","updated_at":"2024-12-26T19:07:09.005Z","avatar_url":"https://github.com/mudler.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003e\n  \u003cbr\u003e\n\t\u003cimg src=\"https://user-images.githubusercontent.com/2420543/147978379-b9097fd4-89d9-4119-bef6-459fa4554d7d.png\" width=128\n         alt=\"logo\"\u003e\u003cbr\u003e\n    golauncher\n\n\u003cbr\u003e\n\u003c/h1\u003e\n\n\u003ch3 align=\"center\"\u003eA go application launcher \u003c/h3\u003e\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://opensource.org/licenses/\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/licence-MIT-brightgreen\"\n         alt=\"license\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/mudler/golauncher/issues\"\u003e\u003cimg src=\"https://img.shields.io/github/issues/mudler/golauncher\"\u003e\u003c/a\u003e\n  \u003cimg src=\"https://img.shields.io/badge/made%20with-Go-blue\"\u003e\n  \u003cimg src=\"https://goreportcard.com/badge/github.com/mudler/golauncher\" alt=\"go report card\" /\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n\t \u003cbr\u003e\n      A simple, highly extensible, customizable application launcher and window switcher written in less than 300 lines of Golang and fyne \u003cbr\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003e\n  \u003cbr\u003e\n\t\u003cimg src=\"https://user-images.githubusercontent.com/2420543/148819424-721a57e9-ecd0-4d74-84df-2b09aaad83b1.png\" \n         alt=\"screenshot\"\u003e\u003cbr\u003e\n\t\u003cimg src=\"https://user-images.githubusercontent.com/2420543/148819473-f5eb2edf-4ed2-4a4c-b494-43303ddd2d1f.png\" \n         alt=\"screenshot\"\u003e\u003cbr\u003e\n\u003c/h1\u003e\n\ngolauncher is a simple, highly extensible application launcher written in Golang. Its written using [fyne](https://github.com/fyne-io/fyne) in less than 300 lines of Go (actually, most of them are just layouts!). \n\nWorks on i3, Xfce, GNOME, Plasma, fynedesk, ...\n\n# :ledger: Features\n\nThe basic plugin set adds the following functionalities to golauncher:\n\n- Window fuzzy search\n- Program fuzzy search\n- Opening URLs\n- Taking screenshot\n- Process kill\n- ..... add yours!\n\n# :computer: Installation\n\nDownload the [release](https://github.com/mudler/golauncher/releases), extract the tarball in your system and run `make install`.\n\nAs it does use `fyne`, does not depend on GTK or either QT installed on your system.\n\n## :construction_worker: Build from source\n\nYou can also build golauncher locally with `go build`. \n\nNote: plugins are standalone binaries and not part of golauncher, you need to install them separately, or if you are developing, use `--plugin-dir` to point to a specific plugin directory.\n\n# :runner: Run\n\nOnce you have `golauncher` installed you can either run it from the terminal with `golauncher`, or either start it from the application menu.\n\n```\nGLOBAL OPTIONS:\n   --theme value        [$THEME]\n   --plugin-dir value   [$PLUGIN_DIR]\n```\n\nGolauncher takes optionally a theme with `--theme` and an additional directory to scan for plugins (`--plugin-dir`).\n\nThe plugin directory must contains binary prefixed with `golauncher-` in order to be loaded.\n\n# :pencil2: Extensible\n\ngolauncher is extensible from the bottom up, and indeed the core does provide no functionalities besides the GUI displaying.\n\n## :gear: Building from source\n\nTo build `golauncher` run:\n\n```\n$ git clone https://github.com/mudler/golauncher\n$ cd golauncher\n$ make build\n```\n\nNote that plugins are shipping core functionalities of `golauncher` are built separately, in order to build the default plugin set:\n\n```\n$ make -C plugins/ build\n```\n\nThis will build the default set of plugins, to try them out you can either run `make test` or:\n\n```\n$ mkdir plugin-build\n$ make DESTDIR=$PWD/plugin-build -C plugins install\n$ golauncher --plugin-dir plugin-build/usr/local/bin/ \n```\n\n## :gear: Writing extensions\n\nExtensions can be written in any language. `golauncher` reads binaries starting with `golauncher-` prefix inside  `$PATH` and automatically invokes them while the user is submitting inputs to retrieve results to be displayed to the user. Optionally, golauncher takes a `PLUGIN_DIR` environment variable (or `--plugin-dir` as args) to specify an additional plugin directory to use.\n\nAll the current functionalities of golauncher are split into separate plugins. \n\nPlugins can be written in any language. For examples on how to extend golauncher, see the [plugin](https://github.com/mudler/golauncher/tree/master/plugins) folder in this repository and the [wiki page](https://github.com/mudler/golauncher/wiki/Create-a-plugin)\n\n\n# :art: Themes\n\nGolauncher supports custom themes, you can find examples inside the [themes](https://github.com/mudler/golauncher/tree/master/themes) folder.\n\nTo run golauncher with a theme, run:\n\n```\n$ THEME=/home/mudler/.golauncher/monokai.yaml golauncher\nor\n$ golauncher --theme /home/mudler/.golauncher/monokai.yaml\n```\n\nCheck also the [gallery in the wiki](https://github.com/mudler/golauncher/wiki/Themes-gallery)\n\n# License\n\nMIT License\n\nCopyright (c) 2022 Ettore Di Giacinto\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmudler%2Fgolauncher","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmudler%2Fgolauncher","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmudler%2Fgolauncher/lists"}