{"id":16736270,"url":"https://github.com/otsaloma/catapult","last_synced_at":"2025-04-09T18:16:59.272Z","repository":{"id":46717088,"uuid":"336624032","full_name":"otsaloma/catapult","owner":"otsaloma","description":"App launcher for Linux","archived":false,"fork":false,"pushed_at":"2025-01-07T21:05:50.000Z","size":279,"stargazers_count":73,"open_issues_count":5,"forks_count":4,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-04-09T18:16:54.871Z","etag":null,"topics":["gtk","launcher","python"],"latest_commit_sha":null,"homepage":"https://otsaloma.io/catapult","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/otsaloma.png","metadata":{"files":{"readme":"README.md","changelog":"NEWS.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS.md","dei":null,"publiccode":null,"codemeta":null},"funding":{"custom":"https://www.paypal.me/otsaloma"}},"created_at":"2021-02-06T19:56:14.000Z","updated_at":"2025-04-02T16:01:06.000Z","dependencies_parsed_at":"2023-02-08T04:15:17.433Z","dependency_job_id":"5b0f6e93-014c-4c0f-99b7-a75b53246e95","html_url":"https://github.com/otsaloma/catapult","commit_stats":{"total_commits":290,"total_committers":3,"mean_commits":96.66666666666667,"dds":0.01379310344827589,"last_synced_commit":"51bc2c77083d765d4f4e3224f8176ac8e0eaed9e"},"previous_names":[],"tags_count":21,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/otsaloma%2Fcatapult","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/otsaloma%2Fcatapult/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/otsaloma%2Fcatapult/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/otsaloma%2Fcatapult/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/otsaloma","download_url":"https://codeload.github.com/otsaloma/catapult/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248085323,"owners_count":21045139,"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":["gtk","launcher","python"],"created_at":"2024-10-13T00:08:52.117Z","updated_at":"2025-04-09T18:16:59.252Z","avatar_url":"https://github.com/otsaloma.png","language":"Python","funding_links":["https://www.paypal.me/otsaloma"],"categories":[],"sub_categories":[],"readme":"Catapult Launcher\n=================\n\n[![Plugins](https://img.shields.io/badge/community-plugins-blueviolet)](https://github.com/topics/catapult-plugin)\n[![Themes](https://img.shields.io/badge/community-themes-blueviolet)](https://github.com/topics/catapult-theme)\n\nCatapult is an app launcher for Linux. It allows you to easily launch\napps, open files and do basic calculations with a keyboard-driven user\ninterface. Custom plugins and themes can be loaded dynamically.\n\nCatapult is Free Software released under the GNU General Public License\n(GPL), see the file [`COPYING`](COPYING) for details. Small parts of the\ncode have been adapted from [Ulauncher][], likewise GPL. These are\nindicated file-wise in the license headers of individual files.\n\n[Ulauncher]: https://github.com/Ulauncher/Ulauncher\n\n## Installing\n\n### Packages\n\n* [Arch Linux](https://aur.archlinux.org/packages/catapult)\n\n### Source\n\nCatapult requires the following.\n\n| Dependency   | Version |\n| :----------- | :------ |\n| Python       | ≥ 3.8   |\n| PyGObject    |         |\n| GLib         |         |\n| GTK          | ≥ 4.0   |\n| Pango        |         |\n| libqalculate |         |\n\nOn Debian/Ubuntu you can install these with the following command.\n\n    sudo apt install gettext \\\n                     gir1.2-glib-2.0 \\\n                     gir1.2-gtk-4.0 \\\n                     gir1.2-pango-1.0 \\\n                     libglib2.0-bin \\\n                     python3 \\\n                     python3-dev \\\n                     python3-gi \\\n                     qalc\n\nThen, to install Catapult, run commands\n\n    make PREFIX=/usr/local build\n    sudo make PREFIX=/usr/local install\n\n## Documentation\n\n### Keybinding to Activate Catapult\n\nCatapult cannot do a global activation keybinding for you, instead you\nneed to do it yourself in your desktop/distro settings. Catapult is a\nsingle-instance app, so executing `catapult` will start a new instance\nif not yet running or else activate the existing instance. So, that is\nthe command you can bind to your key of choice.\n\n* [GNOME](https://help.gnome.org/users/gnome-help/stable/keyboard-shortcuts-set.html.en)\n\n### Window Position on Screen\n\nCatapult cannot position its own window on your screen, which means that\nit will be positioned wherever your window manager defaults to or\nconsiders appropriate. You can configure your window manager to center\nall new windows by default, which should center the Catapult window too\n(at least horizontally, vertically the window height changes along with\nthe search results).\n\n* GNOME: `gsettings set org.gnome.mutter center-new-windows true`\n\n### Starting Automatically\n\nIf you did a keybinding as above running command `catapult`, you\nshouldn't need to pre-start Catapult in the background, it will simply\nstart the first time you need it. If, however, you find the initial\nstartup slow (maybe indexing a lot of files), you can use tools provided\nby your desktop/distro to set Catapult to start automatically already\nwhen you log in to your desktop. To start in the background, use command\n`catapult --hide`.\n\n* [GNOME](https://help.gnome.org/users/gnome-help/stable/shell-apps-auto-start.html.en)\n* [Ubuntu](https://help.ubuntu.com/stable/ubuntu-help/startup-applications.html.en)\n\n### Customizing the Theme\n\nYou can override parts of the theme by editing\n`~/.config/catapult/user.css`, a file which is created the first time\nyou start Catapult. You can edit the file while Catapult is running and\nuse `:reload-theme` in Catapult to apply the changes.\n\nFor example, to use the GNOME default font (Cantarell) for everything,\nyou can use\n\n```css\n.catapult-input-entry {\n  font-family: \"Cantarell\", sans-serif;\n}\n\n.catapult-search-result-title {\n  font-family: \"Cantarell\", sans-serif;\n}\n\n.catapult-search-result-description {\n  font-family: \"Cantarell\", sans-serif;\n}\n```\n\nOr, to use Ubuntu orange as the selection color, try\n\n```css\n@define-color selected-bg-color #e95420;\n```\n\n### Developers\n\n* [Writing Plugins](https://github.com/otsaloma/catapult/blob/master/doc/plugins.md)\n* [Writing Themes](https://github.com/otsaloma/catapult/blob/master/doc/themes.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fotsaloma%2Fcatapult","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fotsaloma%2Fcatapult","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fotsaloma%2Fcatapult/lists"}