{"id":26999807,"url":"https://github.com/littlewhi/shit-terminal.nvim","last_synced_at":"2026-02-22T20:32:08.084Z","repository":{"id":284558420,"uuid":"955324461","full_name":"littlewhi/shit-terminal.nvim","owner":"littlewhi","description":"open-nvim-terminal","archived":false,"fork":false,"pushed_at":"2025-04-03T13:40:14.000Z","size":8,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-03T14:37:33.990Z","etag":null,"topics":["lua","nvim-plugin","terminal"],"latest_commit_sha":null,"homepage":"","language":"Lua","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/littlewhi.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":"2025-03-26T13:16:30.000Z","updated_at":"2025-04-03T13:40:18.000Z","dependencies_parsed_at":"2025-03-26T14:39:44.747Z","dependency_job_id":"1de9623a-7d5c-4fc6-864d-2659d970a853","html_url":"https://github.com/littlewhi/shit-terminal.nvim","commit_stats":null,"previous_names":["littlewhi/shit-terminal.nvim"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/littlewhi/shit-terminal.nvim","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/littlewhi%2Fshit-terminal.nvim","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/littlewhi%2Fshit-terminal.nvim/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/littlewhi%2Fshit-terminal.nvim/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/littlewhi%2Fshit-terminal.nvim/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/littlewhi","download_url":"https://codeload.github.com/littlewhi/shit-terminal.nvim/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/littlewhi%2Fshit-terminal.nvim/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29725949,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-22T20:09:16.275Z","status":"ssl_error","status_checked_at":"2026-02-22T20:09:13.750Z","response_time":110,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["lua","nvim-plugin","terminal"],"created_at":"2025-04-04T03:17:51.786Z","updated_at":"2026-02-22T20:32:08.058Z","avatar_url":"https://github.com/littlewhi.png","language":"Lua","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Intro\nThis is a very basic plugin for opening terminal below in nvim.\nBecause it is so basic that it is real shit.\n\n# Install\nLike any other nvim plugin\n\n# Usage\nAfter the installment, it needs to use the setup() to begin.\n`require(shit-terminal).setup({})`\n\n# config\nThe default config like this:\n```lua\n{\n\thigh = 0.25,  -- the terminal buffer window height, which is the percentage of current window\n\tshells = { \"bash\", \"fish\", \"zsh\" }, -- the available shells, which are for complete in commandline\n\tdefault_shell = \"bash\", -- the default shell\n\tenable_map = true, -- whether using default map keys\n\tleader = \"\u003cLeader\u003evi\" -- the default startup keys in terminal mode\n}\n```\n\n# map\ndefault map:\nThe \u003cshit_leader\u003e is the leader in config.\n```\n# return back to normal mode from terminal mode\ntmode   \t\u003cshit_leader\u003e\u003cESC\u003e -\u003e \u003cC-\\\u003e\u003cC-N\u003e\ntmode   \t\u003cshit_leader\u003em -\u003e \u003cC-\\\u003e\u003cC-N\u003e\n\n# open terminal and run default shell below current window\nvmode nmode \u003cC-E\u003e -\u003e \u003ccmd\u003eOpenShitTermDef\u003cCR\u003e\n\n# return back to original window from terminal window in terminal mode\ntmode \t\t\u003cshit_leader\u003eq -\u003e \u003ccmd\u003eq\u003cCR\u003e\n```\n\n# command\n```\n# open terminal and run default shell below current window\nOpenShitTermDef\n\n# open terminal by the argument below current window\nOpenShitTerm \u003cshellname\u003e \u003cheight_percentage\u003e\n```\n\n# note\nWhen we open a terminal window, only if we press the i, a, I, A... character we go into terminal mode. When we don't press one of these keys, we are in the normal mode which means we can run the nvim command as we want and remember that the tmode keysmap ara not useful.  And in tmode, the normal command of nvim are not useful, you need `\u003cC-\\\u003e\u003cC-N\u003e` to go back to normal mode or `\u003cC-\\\u003e\u003cC-O\u003e` to execute normal mode command. Please to loop up `:h terminal-emulator`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flittlewhi%2Fshit-terminal.nvim","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flittlewhi%2Fshit-terminal.nvim","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flittlewhi%2Fshit-terminal.nvim/lists"}