{"id":13831426,"url":"https://github.com/f/atom-term2","last_synced_at":"2025-12-17T07:54:23.356Z","repository":{"id":16951373,"uuid":"19713566","full_name":"f/atom-term2","owner":"f","description":"THIS PROJECT IS NO LONGER MAINTAINED. PLEASE USE ATOM TERM3 PACKAGE","archived":false,"fork":false,"pushed_at":"2017-02-16T06:40:32.000Z","size":97,"stargazers_count":294,"open_issues_count":0,"forks_count":62,"subscribers_count":10,"default_branch":"master","last_synced_at":"2025-05-19T21:06:08.136Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"CoffeeScript","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/f.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-05-12T20:09:49.000Z","updated_at":"2024-06-02T02:46:20.000Z","dependencies_parsed_at":"2022-08-04T12:30:12.958Z","dependency_job_id":null,"html_url":"https://github.com/f/atom-term2","commit_stats":null,"previous_names":[],"tags_count":51,"template":false,"template_full_name":null,"purl":"pkg:github/f/atom-term2","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/f%2Fatom-term2","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/f%2Fatom-term2/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/f%2Fatom-term2/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/f%2Fatom-term2/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/f","download_url":"https://codeload.github.com/f/atom-term2/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/f%2Fatom-term2/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":27779778,"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","status":"online","status_checked_at":"2025-12-17T02:00:08.291Z","response_time":55,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":[],"created_at":"2024-08-04T10:01:27.726Z","updated_at":"2025-12-17T07:54:23.341Z","avatar_url":"https://github.com/f.png","language":"CoffeeScript","funding_links":[],"categories":["CoffeeScript"],"sub_categories":[],"readme":"# Atom Term 2\n\n## ☢️ THIS PROJECT IS NO LONGER MAINTAINED. USE [TERM3](http://atom.io/packages/term3) ☢️\n\nRun shell sessions within Atom Editor using `term2` package.\nRun **Vim, Emacs, Htop, etc.** in Atom.\nIt's based on `pty.js` as shell spawner, and `term.js` as xterm, with the power\nof Atom Package environment.\n\n_It's a fork and rebuilt version of \"[Term](http://atom.io/packages/term)\" package._\n\n## What about this fork ?!\n\nThis fork adds a 'ShellOverride' configuration option which allows to override\nthe shell Term2 is using (your default shell).\n\nIf your default shell is zsh you see that it's not yet fully compatible with\nTerm2 (scrolling might not work):\nsetting ShellOverride to i.e. 'bash' let you use Term2 with another (working)\nshell without messing up with your default shell configuration.\n\nThe fork was focused on this option in the first place but evolved a lot since.\n\nTo install **Term2** easily into your Atom:\n\n```console\n$ apm install term2\n```\n\n![Vim, Emacs and HTop](https://dl.dropboxusercontent.com/u/20947008/webbox/atom/atom-term3.png)\n\n## Key Bindings and Events\n\n| key binding | event | action |\n| ----------- | ----- | ------ |\n| `ctrl + alt + t` | `term2:open` | Opens new terminal tab pane |\n| `ctrl + alt + up`| `term2:open-split-up` | Opens new terminal tab pane in up split |\n| `ctrl + alt + right`| `term2:open-split-right` | Opens new terminal tab pane in right split |\n| `ctrl + alt + down`| `term2:open-split-down` | Opens new terminal tab pane in down split |\n| `ctrl + alt + left`| `term2:open-split-left` | Opens new terminal tab pane in left split |\n| `ctrl + k, t, t` | `term2:open` | Opens new terminal tab pane |\n| `ctrl + k, t, up`| `term2:open-split-up` | Opens new terminal tab pane in up split |\n| `ctrl + k, t, right`| `term2:open-split-right` | Opens new terminal tab pane in right split |\n| `ctrl + k, t, down`| `term2:open-split-down` | Opens new terminal tab pane in down split |\n| `ctrl + k, t, left`| `term2:open-split-left` | Opens new terminal tab pane in left split |\n| `cmd + k, t, t` | `term2:open` | Opens new terminal tab pane |\n| `cmd + k, t, up`| `term2:open-split-up` | Opens new terminal tab pane in up split |\n| `cmd + k, t, right`| `term2:open-split-right` | Opens new terminal tab pane in right split |\n| `cmd + k, t, down`| `term2:open-split-down` | Opens new terminal tab pane in down split |\n| `cmd + k, t, left`| `term2:open-split-left` | Opens new terminal tab pane in left split |\n| `ctrl + insert` | `term2:copy` | Copy text (if `ctrl + c` is not working) |\n| `shift + insert` | `term2:paste` | Paste text (if `ctrl + v` is not working) |\n\n## Customize Title\n\nYou can customize Title with using some variables. These are the current variables you can use:\n\n| title variable | value |\n| -------------- | ----- |\n| `bashName` | Current Shell's name, (e.g. bash, zsh) |\n| `hostName` | OS's host name |\n| `platform` | Platform name, (e.g. darwin, linux) |\n| `home` | Home path of current user |\n\nDefault version of **title template** is\n\n```\nTerminal ({{ bashName }})\n```\n\n## Additional Features\n\n  - **Run a defined command automatically** when shell session starts.\n  - You can customize font-family or font-size (default to Atom settings values)\n  - You can define **Terminal Colors** in `config.cson`.\n  - Turn on or off **blinking cursor**\n  - Change **scrollback** limit\n  - Start shell sessions with additional parameters.\n  - You can **pipe the text and paths** to the Terminal sessions.\n  - Paste from clipboard\n\n### Note about colors\n\nCurrently, you will need to adjust the colors in `config.cson`\n(then you should be able to edit them in the package settings view).\n\nYou can add something like (please note the 2 examples of color format):\n\n```cson\nterm2:\n  colors:\n    normalBlack: #000\n    normalRed:\n      red: 255\n      blue: 0\n      green: 0\n      alpha: 1\n    normalGreen: ...\n    normalYellow: ...\n    normalBlue: ...\n    normalPurple: ...\n    normalCyan: ...\n    normalWhite: ...\n    brightBlack: ...\n    brightRed: ...\n    brightGreen: ...\n    brightYellow: ...\n    brightBlue: ...\n    brightPurple: ...\n    brightCyan: ...\n    brightWhite: ...\n    background: ...\n    foreground: ...\n```\n\n- **Colors are not taken from the Atom theme.**\n- alpha channel are not used for now.\n- _The background color is for now the only exception and is not used.\nThe background is transparent so you benefit of Atom app background color._\n\n## FAQ\n\n### Why some commands do not work like in my previous terminal ?\n\nIt's [a known `$PATH` issue](https://github.com/webBoxio/atom-term2/issues/50).\nYou are probably an OS X user (if not, let us know).\nGUI app doesn't get `/etc/paths` (and might come from `/usr/local/bin`).\nThere is some workaround for OS X 10.9-, but OS X 10.10+ doesn't execute\n`/etc/launchd.conf` anymore.\nSo, in order to get the right PATH in atom-term2 context, you have this\nsolutions:\n\n- In your `.(bash|zsh|*)rc`, add\n\n  ```bash\n  export PATH=$(cat /etc/paths | xargs | tr \" \" :)\n  # or just hardcode your path like this\n  export PATH=/usr/local/bin:/usr/bin:/bin:/usr/local/sbin:/usr/sbin:/sbin\n  ```\n\n- You can automatically call a command when you open a terminal to `login` by\nediting your Atom config:\n\n  ```cson\n  term2:\n    autoRunCommand: 'login -f `whoami`'\n  ```\n\n---\n\n## [Contributors](https://github.com/webBoxio/atom-term2/graphs/contributors)\n\n## [License](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ff%2Fatom-term2","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ff%2Fatom-term2","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ff%2Fatom-term2/lists"}