{"id":13811904,"url":"https://github.com/apaszke/termtile","last_synced_at":"2025-04-06T01:05:47.833Z","repository":{"id":36409464,"uuid":"40714401","full_name":"apaszke/termtile","owner":"apaszke","description":"Terminal window manager for OS X","archived":false,"fork":false,"pushed_at":"2015-10-01T08:02:35.000Z","size":695,"stargazers_count":1283,"open_issues_count":5,"forks_count":30,"subscribers_count":28,"default_branch":"master","last_synced_at":"2025-03-30T00:04:57.575Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"AppleScript","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/apaszke.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":"2015-08-14T12:43:14.000Z","updated_at":"2024-12-06T21:11:09.000Z","dependencies_parsed_at":"2022-09-26T22:21:40.478Z","dependency_job_id":null,"html_url":"https://github.com/apaszke/termtile","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apaszke%2Ftermtile","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apaszke%2Ftermtile/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apaszke%2Ftermtile/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apaszke%2Ftermtile/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/apaszke","download_url":"https://codeload.github.com/apaszke/termtile/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247419859,"owners_count":20936012,"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-08-04T04:00:39.248Z","updated_at":"2025-04-06T01:05:47.814Z","avatar_url":"https://github.com/apaszke.png","language":"AppleScript","funding_links":[],"categories":["AppleScript","Tools"],"sub_categories":["sh (macOS)"],"readme":"termtile\n=============\n\ntermtile is a set of scripts, which set you free from your mouse and touchpad.\nDon't distract yourself and manage all your terminal windows with a handful of commands.\n\n**Now with multi-screen support!**\n\nAll scripts are written in AppleScript, so they are unfortunately limited to OS X at the moment.\n\n![Gif demo](http://apaszke.github.io/termtile/assets/img/main_demo.gif)\n\n*(Tip: enable Command key option in Preferences \u003e Profiles \u003e Window, so you'll see\nthe keyboard shortcut which jumps to a particular window)*\n\nInstallation\n-----------\n\nJust paste the following lines into Your terminal:\n\n```bash\ngit clone https://github.com/apaszke/termtile\ncd termtile; ./install.sh\n```\n\nYou can delete the cloned repository afterwards.\n\nAliases\n-------\n\n`install.sh` can configure all the aliases for you.\n\n**Don't worry about the conflicts**. There are three ways of dealing with them already implemented:\n\n0. If you're already using `ll` then the defaults can be changed:\n  * `ll` -\u003e `fl`\n  * `rr` -\u003e `fr`\n0. You can specify a prefix for all commands.\n0. If you already have a conflicting command and you deny to overwrite it, the script will ask you for another name, so you can choose it for each alias separately (prefix will still be applied).\n\nDefault aliases:\n* `ll` - fill left half of the screen\n* `rr` - fill right half\n* `up` - fill upper half\n* `down` - fill lower half\n* `ul` - fill upper-left quarter\n* `ur` - fill upper-right quarter\n* `dl` - fill lower-left quarter\n* `dr` - fill lower-right quarter\n* `big` - make the window bigger\n* `cen` - center the window\n* `max` - maximize the window\n* `sn` - move to the next display\n* `fs` - toggles terminal app fullscreen\n\nYou can always customize them on your own. They always look like this:\n\n```bash\nalias ll='osascript ~/.termtile/tile.scpt left'\n#             ^              ^              ^\n#         osascript    path to script     args\n```\n\nThey are also very convenient in conjunction with other commands e.g.\n\n```bash\nalias vim='big \u0026\u0026 cen \u0026\u0026 vim'\n```\n\nIncluded scripts\n----------------\n\nCurrently there are three scripts:\n\n**tile.applescript**\n\nDistributes windows across 2 x 2 grid (affects only the last active window).\nAccepted arguments:\n\n\u003cimg src=\"http://apaszke.github.io/termtile/assets/img/tile_args.svg\" alt=\"Quater arguments\"\u003e\n\n**center.applescript**\n\nCenters the window.\n\n**resize.applescript**\n\nMakes the window comfortably sized for tasks requiring more space (eg. vim).\nDefault size is 1000x600, but it can be changed with the arguments (first is width, second is height).\n\n**maximize.applescript**\n\nMaximizes the window.\n\n**changeScreen.applescript**\n\nMoves the window to another screen. Currently only supports\nmoving to the next display on a list.\n\n**fullscreen.applescript**\n\nToggles fullscreen for the terminal app.\n\nTroubleshooting\n---------------\n\nIf you're using any scripts, which can affect your dock settings, then it might mess up\nthe values termtile reads. If it starts working in a wierd way after you change the dock position\nor size please try to reboot your machine.\n\n\nContributing\n------------\n\n0. If you have any suggestions feel free to file an issue.\n0. Pull requests are very welcome, but consider creating an issue first,\nso we can decide together if it's worth spending time on it :blush:\n\nLicense\n-------\n\nLicensed under MIT license. Copyright (c) 2015 Adam Paszke\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapaszke%2Ftermtile","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fapaszke%2Ftermtile","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapaszke%2Ftermtile/lists"}