{"id":13484699,"url":"https://github.com/ZhiyuanLck/vim-float-terminal","last_synced_at":"2025-03-27T16:31:11.121Z","repository":{"id":216992597,"uuid":"313009392","full_name":"ZhiyuanLck/vim-float-terminal","owner":"ZhiyuanLck","description":"Simple vim terminal in popup window with a termline.","archived":false,"fork":false,"pushed_at":"2021-01-08T13:03:43.000Z","size":95,"stargazers_count":28,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-10-30T18:42:47.558Z","etag":null,"topics":["terminal","vim"],"latest_commit_sha":null,"homepage":"","language":"Python","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/ZhiyuanLck.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-11-15T10:47:21.000Z","updated_at":"2024-10-22T03:55:10.000Z","dependencies_parsed_at":null,"dependency_job_id":"300106c3-3d8d-43e7-8a6d-bf0fbe261b22","html_url":"https://github.com/ZhiyuanLck/vim-float-terminal","commit_stats":null,"previous_names":["zhiyuanlck/vim-float-terminal"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ZhiyuanLck%2Fvim-float-terminal","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ZhiyuanLck%2Fvim-float-terminal/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ZhiyuanLck%2Fvim-float-terminal/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ZhiyuanLck%2Fvim-float-terminal/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ZhiyuanLck","download_url":"https://codeload.github.com/ZhiyuanLck/vim-float-terminal/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245882339,"owners_count":20687869,"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":["terminal","vim"],"created_at":"2024-07-31T17:01:30.362Z","updated_at":"2025-03-27T16:31:11.115Z","avatar_url":"https://github.com/ZhiyuanLck.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"# Fterm\n\nSimple vim terminal in popup window with a **termline**.\n\n## Screenshots\n\n![buffer][1]\n\n## Overview\n\n- Create/toggle/kill terminal in popup window handily.\n- Termline support just like tabline.\n- Blocked mapping only for fterm.\n\n## Installation\n\n- Requirement: `+python3`, `+popup`, `+terminal`\n- Best experience: include patch \u003e= 8.2.1997\n- Support for nvim: **not yet**\n\nFor vim-plug:\n\n```vim\nPlug 'ZhiyuanLck/vim-float-terminal'\n```\n\n## Usage\n\nAll commands are derived from command `:Fterm`\n\n```\nusage: Fterm [-h] {new,toggle,kill,select,settitle,move,quit} ...\n\npositional arguments:\n  {new,toggle,kill,select,settitle,move}\n  new        create a new terminal\n  toggle     toggle a terminal to show or hidden\n  kill       kill a terminal\n  settitle   set the title of current terminal\n  move       move the place of terminal on termline\n```\n\nAll subcommands have separate options, see more details via `:h fterm-commands`.\n\n## Global Variables\n\n- Check normal global options by `:h fterm-options`.\n- Check mapping options by `:h fterm-mappings`.\n\n## Mappings\n\nFterm sets the default mappings for you. You can change them by mapping\nvariables like `g:fterm_map_xxx`. There is a little difference when you change\nthe mapping of selecting terminal, see more details by `:h g:fterm_map_select`.\n\nYou can also disable all default mappings by `let g:fterm_disable_map = 1`,\nand then customize your own mapping through `g:fterm_custom_map`, which make\nit possible to define **blocked mapping** that takes effect only in fterm. See\nmore details by `:h g:fterm_custom_map`.\n\n## Quick quit\n\nYou can quit the terminal quickly by command `FtermQuit` which is mapped to the key specified by `g:fterm_map_quit` (by default `q`). The keymap is disabled when certain pattern is matched in command to start the terminal. This work is done by vim built-in function `match()`. The default pattern list is\n\n```vim\nlet g:fterm_noquit=[\n      \\ '\\v(\\w|/)*bash$',\n      \\ '\\v(\\w|/)*zsh$',\n      \\ '\\v(\\w|/)*ksh$',\n      \\ '\\v(\\w|/)*csh$',\n      \\ '\\v(\\w|/)*tcsh$'\n      \\ ]\n```\n\n## Highlights\n\nYou can customize highlights by `g:fterm_highlights`. See all default\nhighlights by `:h g:fterm_highlights`.\n\n## Edit file from terminal\n\nWhen in float terminal, you can use `fterm` to open a file in vim.\n\n## Support for [asyncrun.vim](https://github.com/skywind3000/asyncrun.vim)\n\n```vim\nlet g:asyncrun_runner = get(g:, 'asyncrun_runner', {})\nlet g:asyncrun_runner.fterm = function('fterm#async_runner')\n```\n\n## Known issues\n\n1. Cursor position wrong in terminal popup with finished job. Fixed in [patch 8.2.1990](https://github.com/vim/vim/commit/6a07644db30cb5f3d0c6dc5eb2c348b6289da553).\n\n2. Patch 8.2.1990 cause new problem: window changes when using bufload() while in a terminal popup. Fixed in [patch 8.2.1997](https://github.com/vim/vim/commit/8adc8d9b73121b647476a33d91d31d25e1c2d987). This issue will **cause the plugin to not work properly**.\n\n## Reference\n[vim-floaterm](https://github.com/voldikss/vim-floaterm)\n\n  [1]: https://github.com/ZhiyuanLck/images/blob/master/fterm/fterm.gif\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FZhiyuanLck%2Fvim-float-terminal","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FZhiyuanLck%2Fvim-float-terminal","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FZhiyuanLck%2Fvim-float-terminal/lists"}