{"id":13467146,"url":"https://github.com/j0ru/kickoff","last_synced_at":"2025-03-26T01:30:21.485Z","repository":{"id":37442695,"uuid":"323364029","full_name":"j0ru/kickoff","owner":"j0ru","description":"Minimalistic program launcher","archived":false,"fork":false,"pushed_at":"2025-03-16T11:14:56.000Z","size":983,"stargazers_count":424,"open_issues_count":11,"forks_count":11,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-03-17T17:23:18.756Z","etag":null,"topics":["launcher","rust","wayland"],"latest_commit_sha":null,"homepage":"","language":"Rust","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/j0ru.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-12-21T14:45:53.000Z","updated_at":"2025-03-17T07:06:11.000Z","dependencies_parsed_at":"2024-02-19T07:35:09.009Z","dependency_job_id":"3a023798-a460-453d-9f0c-56ce11ea082c","html_url":"https://github.com/j0ru/kickoff","commit_stats":{"total_commits":208,"total_committers":7,"mean_commits":"29.714285714285715","dds":0.1923076923076923,"last_synced_commit":"37a29d84239388c14f82d8b508b580dc8a635b76"},"previous_names":[],"tags_count":26,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/j0ru%2Fkickoff","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/j0ru%2Fkickoff/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/j0ru%2Fkickoff/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/j0ru%2Fkickoff/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/j0ru","download_url":"https://codeload.github.com/j0ru/kickoff/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245571648,"owners_count":20637372,"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":["launcher","rust","wayland"],"created_at":"2024-07-31T15:00:53.569Z","updated_at":"2025-03-26T01:30:21.157Z","avatar_url":"https://github.com/j0ru.png","language":"Rust","readme":"\u003ch1 align=\"center\"\u003e\n  \u003cimg src=\"assets/logo.svg\" width=\"300\" height=\"300\" alt=\"logo\"\u003e\n\u003c/h1\u003e\n\nKickoff is heavily inspired by rofi, but not without changes made.\nLike many programs, kickoff was born from an itch that no existing program seemed to relieve and my desire to learn a lower-level programming language.\n\n[![AUR version](https://img.shields.io/aur/version/kickoff?label=kickoff\u0026logo=arch-linux\u0026style=for-the-badge)](https://aur.archlinux.org/packages/kickoff/)\n[![Crates Version](https://img.shields.io/crates/v/kickoff?style=for-the-badge)](https://crates.io/crates/kickoff)\n\n![screenshot](assets/screenshot.png)\n\n## Install\n\n#### Arch Linux\nUse your favorite AUR manager, i.e. [blinky](https://github.com/cherti/blinky/):\n\n```bash\nblinky -S kickoff\n```\n\n#### Cargo\n\n```bash\ncargo install kickoff\n```\n\n## Features\n\n- Wayland native (only wlroots based compositors though)\n- Fuzzy search\n- Fast and snappy\n- Remembers often used applications\n- Argument support for launched programs\n- Paste support\n- Custom Input via stdin\n\n## How does it search\n\nAll programs found in $PATH are included in the search results.\nThis can include your additions to $PATH as long as they\nare done before you launch kickoff or the program that launches kickoff\n(i.e. your window manager)\n\nThis list is then combined with your previous searches and sorted by the amount of usage\nand how well it fits the query.\n\n## Configuration\n\nA default configuration will be placed at `$XDG_CONFIG_HOME/kickoff/config.toml`\nor can be found [here](https://github.com/j0ru/kickoff/blob/main/assets/default_config.toml).\n\n## Script integration\n\nIf you want to adapt kickoff for your use case, i.e. selecting an entry from a password manager,\nyou can use one of the `--from-*` options. If any of those options is defined, the default behavior of reading from `$PATH` is disabled as well as\nsaving the history. The latter can easily be reactivated by setting `--history \u003csome path\u003e`.\n\n|Option|Argument|Usage|\n|------|--------|-----|\n|`--from-stdin`|None| Reads a list of items from stdin |\n|`--from-file`|Path| Reads a list of items from a file |\n|`--from-path`|None| Walks all `$PATH` directories and adds all executables as selectable items |\n|`--stdout`|None| Prints the selected result to stdout instead of trying to execute it |\n\nThese can also be combined, for example, if you want to add custom commands to your usual list of programs.\n```bash\necho 'Big kitty = kitty -o \"font_size=20\"' | kickoff --from-stdin --from-path --history \".cache/kickoff/custom_history.csv\"\n```\n\n### Input Format\n\nReading from file or stdin follows a very simple format,\nspaces around the equals sign can be dropped:\n```\nSmall kitty = kitty -o \"font_size=5\"\nBig kitty = kitty -o \"font_size=20\"\n^=======^   ^=====================^\n    |                  |\nDisplayed Name         |\n                       |\n              Executed Command\n```\n\n### Magic Words\n\nWhen reading from a file or stdin, you can use magic words to influence the generated items.\nCurrently, there is only one, but more might be added someday:\n\n|Word|Argument|Usage|Default|\n|----|--------|-----|-------|\n|%base_score| number | Sets the base score for all following entries, can be overwritten later | 0 |\n\nIn this example, `Small kitty` has a base score of 0, while the others have a score of 5.\n```\nSmall kitty = kitty -o \"font_size=5\"\n%base_score = 5\nBig kitty = kitty -o \"font_size=20\"\nMedium kitty = kitty -o \"font_size=12\"\n```\n","funding_links":[],"categories":["Applications","Launchers","Launcher"],"sub_categories":["System tools","Sway Specific"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fj0ru%2Fkickoff","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fj0ru%2Fkickoff","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fj0ru%2Fkickoff/lists"}