{"id":19024952,"url":"https://github.com/gko/listbox","last_synced_at":"2025-08-03T03:08:34.634Z","repository":{"id":14991380,"uuid":"77405888","full_name":"gko/listbox","owner":"gko","description":"💬 listbox element for bash","archived":false,"fork":false,"pushed_at":"2022-06-15T17:55:39.000Z","size":30,"stargazers_count":46,"open_issues_count":4,"forks_count":2,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-04-23T12:13:47.766Z","etag":null,"topics":["bash","bashrc","list","listbox","listbox-element","zsh","zshrc"],"latest_commit_sha":null,"homepage":null,"language":"Shell","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/gko.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":"2016-12-26T20:40:02.000Z","updated_at":"2023-12-31T07:37:02.000Z","dependencies_parsed_at":"2022-09-09T19:10:05.684Z","dependency_job_id":null,"html_url":"https://github.com/gko/listbox","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gko%2Flistbox","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gko%2Flistbox/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gko%2Flistbox/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gko%2Flistbox/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gko","download_url":"https://codeload.github.com/gko/listbox/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250430595,"owners_count":21429324,"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":["bash","bashrc","list","listbox","listbox-element","zsh","zshrc"],"created_at":"2024-11-08T20:39:39.878Z","updated_at":"2025-04-23T12:14:03.861Z","avatar_url":"https://github.com/gko.png","language":"Shell","readme":"# Listbox\n\n💬 listbox element for bash\n\n![demo](https://github.com/gko/listbox/raw/master/demo.gif)\n\nSimple bash listbox to choose from options\n\n## Installation\n\n### Manually\n\n```bash\ngit clone https://github.com/gko/listbox\n```\n\nthen in .bashrc or .zshrc:\n\n```bash\nsource ./listbox/listbox.sh\n```\n\n### With [Fig](https://fig.io)\n\nFig adds apps, shortcuts, and autocomplete to your existing terminal.\n\nInstall `listbox` in just one click.\n\n\u003ca href=\"https://fig.io/plugins/other/listbox_gko\" target=\"_blank\"\u003e\u003cimg src=\"https://fig.io/badges/install-with-fig.svg\" /\u003e\u003c/a\u003e\n\n### With [antigen](https://github.com/zsh-users/antigen)\n\nIn your .zshrc\n\n```sh\nantigen bundle gko/listbox\n```\n\n### With [oh-my-zsh](https://github.com/robbyrussell/oh-my-zsh)\n\n```sh\ngit clone https://github.com/gko/listbox.git ~/.oh-my-zsh/custom/plugins/listbox\n\n```\n\nthen in your .zshrc\n\n```bash\nplugins=(\n  ...\n  listbox\n  ...\n)\n```\n\n## Usage\n\n```bash\nUsage: listbox [options]\nExample:\n  listbox -t title -o \"option 1|option 2|option 3\" -r resultVariable -a '\u003e'\nOptions:\n  -h, --help                         help\n  -t, --title                        list title\n  -o, --options \"option 1|option 2\"  listbox options\n  -r, --result \u003cvar\u003e                 result variable\n  -a, --arrow \u003csymbol\u003e               selected option symbol\n```\n\n### General usage\n\n```bash\nsource ./listbox.sh\nlistbox -t Title -o \"option 1|option 2|option 3\" -r result\necho \"user chose: $result\"\n```\n\noutput:\n\n```bash\n  Title\n  -----\n  option 1\n\u003e option 2\n  option 3\n  \nuser chose: option 2\n```\n\n### Specify arrow symbol\n\n```bash\nlistbox -t Title -o \"option 1|option 2|option 3\" -a '→'\n```\n\noutput:\n\n```bash\n  Title\n  ---\n→ option 1\n  option 2\n  option 3\n  \noption 1\n```\n\n### Pipe directly to variable\n\n```bash\nresult=$(listbox -t Title -o \"option 1|option 2|option 3\" | tee /dev/tty | tail -n 1)\necho \"user chose: $result\"\n```\n\noutput:\n\n```bash\n  Title\n  ---\n  option 1\n\u003e option 2\n  option 3\n  \nuser chose: option 2\n```\n\n## Like it?\n\n:star: this repo\n\n## License\n\n[MIT](http://opensource.org/licenses/MIT)\n\nCopyright (c) 2012-2016 Konstantin Gorodinskiy\n","funding_links":[],"categories":["Plugins"],"sub_categories":["ZSH on Windows","Zinit (née zplugin)"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgko%2Flistbox","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgko%2Flistbox","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgko%2Flistbox/lists"}