{"id":13496030,"url":"https://github.com/tmux-plugins/tmux-open","last_synced_at":"2025-03-28T17:34:43.613Z","repository":{"id":19251896,"uuid":"22487487","full_name":"tmux-plugins/tmux-open","owner":"tmux-plugins","description":"Tmux key bindings for quick opening of a highlighted file or url","archived":false,"fork":false,"pushed_at":"2024-06-18T05:59:11.000Z","size":93,"stargazers_count":622,"open_issues_count":26,"forks_count":63,"subscribers_count":10,"default_branch":"master","last_synced_at":"2024-08-01T19:57:33.919Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","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/tmux-plugins.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2014-07-31T22:32:01.000Z","updated_at":"2024-07-25T13:07:35.000Z","dependencies_parsed_at":"2024-01-07T11:11:50.877Z","dependency_job_id":"7604ec06-3d48-4e8c-a908-2667d87e4cac","html_url":"https://github.com/tmux-plugins/tmux-open","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/tmux-plugins%2Ftmux-open","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tmux-plugins%2Ftmux-open/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tmux-plugins%2Ftmux-open/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tmux-plugins%2Ftmux-open/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tmux-plugins","download_url":"https://codeload.github.com/tmux-plugins/tmux-open/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":222402890,"owners_count":16978761,"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-07-31T19:01:40.972Z","updated_at":"2024-10-31T11:30:38.583Z","avatar_url":"https://github.com/tmux-plugins.png","language":"Shell","funding_links":[],"categories":["Shell","CLI","Plugins"],"sub_categories":[],"readme":"# Tmux open\n\nPlugin for opening highlighted selection directly from Tmux copy mode.\n\nTested and working on Linux, OSX and Cygwin.\n\n### Key bindings\n\nIn tmux copy mode:\n\n- `o` - \"open\" a highlighted selection with the system default program. `open`\n    for OS X or `xdg-open` for Linux.\n- `Ctrl-o` - open a highlighted selection with the `$EDITOR`\n- `Shift-s` - search the highlighted selection directly inside a search engine (defaults to google).\n\n### Examples\n\nIn copy mode:\n\n- highlight `file.pdf` and press `o` - file will open in the default PDF viewer.\n- highlight `file.doc` and press `o` - file will open in system default `.doc`\n  file viewer.\n- highlight `http://example.com` and press `o` - link will be opened in the\n  default browser.\n- highlight `file.txt` and press `Ctrl-o` - file will open in `$EDITOR`.\n- highlight `TypeError: 'undefined' is not a function` and press `Shift-s` - the text snipped will be searched directly inside google by default\n\n### Screencast\n\n[![screencast screenshot](/video/screencast_img.png)](http://vimeo.com/102455265)\n\n### Installation with [Tmux Plugin Manager](https://github.com/tmux-plugins/tpm) (recommended)\n\nAdd plugin to the list of TPM plugins in `.tmux.conf`:\n\n    set -g @plugin 'tmux-plugins/tmux-open'\n\nHit `prefix + I` to fetch the plugin and source it. You should now be able to\nuse the plugin.\n\n### Manual Installation\n\nClone the repo:\n\n    $ git clone https://github.com/tmux-plugins/tmux-open ~/clone/path\n\nAdd this line to the bottom of `.tmux.conf`:\n\n    run-shell ~/clone/path/open.tmux\n\nReload TMUX environment:\n\n    # type this in terminal\n    $ tmux source-file ~/.tmux.conf\n\nYou should now be able to use the plugin.\n\n### Configuration\n\n\u003e How can I change the default \"o\" key binding to something else? For example,\n\u003e key \"x\"?\n\nPut `set -g @open 'x'` in `tmux.conf`.\n\n\u003e How can I change the default \"Ctrl-o\" key binding to \"Ctrl-x\"?\n\nPut `set -g @open-editor 'C-x'` in `tmux.conf`.\n\n\u003e How can I change the default search engine to \"duckduckgo\" or any other one?\n\nPut `set -g @open-S 'https://www.duckduckgo.com/?q='` in `tmux.conf`\n\n\u003e How can I use multiple search engines?\n\nPut:\n\n```\nset -g @open-B 'https://www.bing.com/search?q='\nset -g @open-S 'https://www.google.com/search?q='\n```\n\nin `tmux.conf`\n\n### Other goodies\n\n`tmux-open` works great with:\n\n- [tmux-copycat](https://github.com/tmux-plugins/tmux-copycat) - a plugin for\n  regex searches in tmux and fast match selection\n- [tmux-yank](https://github.com/tmux-plugins/tmux-yank) - enables copying\n  highlighted text to system clipboard\n\n### License\n\n[MIT](LICENSE.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftmux-plugins%2Ftmux-open","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftmux-plugins%2Ftmux-open","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftmux-plugins%2Ftmux-open/lists"}