{"id":22366735,"url":"https://github.com/vaeth/runtitle","last_synced_at":"2026-04-25T16:33:50.693Z","repository":{"id":3195189,"uuid":"4228206","full_name":"vaeth/runtitle","owner":"vaeth","description":"Scripts to run commands and set the hard status line (windows title)","archived":false,"fork":false,"pushed_at":"2021-06-13T11:17:07.000Z","size":16,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-26T15:54:21.923Z","etag":null,"topics":["repeat","terminal","titlebar"],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vaeth.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2012-05-04T19:12:13.000Z","updated_at":"2023-09-08T03:25:12.000Z","dependencies_parsed_at":"2022-09-10T22:10:37.551Z","dependency_job_id":null,"html_url":"https://github.com/vaeth/runtitle","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/vaeth/runtitle","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vaeth%2Fruntitle","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vaeth%2Fruntitle/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vaeth%2Fruntitle/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vaeth%2Fruntitle/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vaeth","download_url":"https://codeload.github.com/vaeth/runtitle/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vaeth%2Fruntitle/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32269459,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-25T09:15:33.318Z","status":"ssl_error","status_checked_at":"2026-04-25T09:15:31.997Z","response_time":59,"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":["repeat","terminal","titlebar"],"created_at":"2024-12-04T18:15:27.573Z","updated_at":"2026-04-25T16:33:50.675Z","avatar_url":"https://github.com/vaeth.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# runtitle\n\nScripts to run commands and set the hard status line (windows title)\n\n(C) Martin Väth (martin at mvath.de).\nThis project is under the BSD license 2.0 (“3-clause BSD license”).\nSPDX-License-Identifier: BSD-3-Clause\n\n## Installation\n\nFor installation, copy the content of `bin/` in your `$PATH`.\nTo obtain support for __zsh completion__ (also for other programs using\n`title`), you can copy the content of `zsh/` into a directory of your\nzsh's `$fpath`.\n\nFor Gentoo, there is an ebuild in the mv overlay (available over layman).\n\n## Description\n\nThis project contains two simple scripts:\n\n- `runner`\n\n   Runs a command, setting the title and ringing the bell if command fails.\n   There are options to repeat the command (a number of times or if it fails).\n   Use `runner -h` to obtain a description.\n\n- `title`\n\n  Sets the hard status line if the terminal supports it.\n  Use `title -h` to obtain a description.\n\nIf you do not give a text to `title`, nothing is printed\n(pass an empty text if you want to clear the status line).\n\nYou can source `title` into a POSIX shell with\n```\nTitleInit() {\n. title \"$@\"\n}\n```\nThen the function `TitleInit` can be used with the same meaning as `title`,\n(but can be used repeatedly without restarting `title`).\nMoreover, after `TitleInit` the function `Title` can be used (also repeatedly)\nto set the title according to the options of `TitleInit`.\nAlso, there are functions `TitlePlain` and `TitleVerbose` which act\ncorrespondingly to `title -p` or `title -P`, respectively.\nIf you only want to define `Title`, `TitlePlain`, `TitleVerbose`, and\n`TitleInit` by sourcing, use option `-q` in the call to `TitleInit`.\nThe function `TitleInit` may override variable names of the form\n`titleinit_`*`_`.\n\nThe following function `Title` will define `Title`, `TitlePlain`,\n`TitleVerbose`, and `TitleInit` appropriately at its first call\n(if `title` is in the `$PATH`) and then act as `Title`:\n```\nTitle() {\nTitle() {\n:\n}\ncommand -v title \u003e/dev/null 2\u003e\u00261 || return 0\nTitleInit() {\n. title \"$@\"\n}\nTitleInit [options to title] -- \"$@\"\n}\n```\nIn the file `bin/runner` you find an example how this can be combined with\nsetting a `trap` so that a sane title is \"restored\" at program exit.\n\nIf you write a program using `Title`, I recommend to equip this program\nwith an option with an argument which is passed to `TitleInit`, and where\nthe option argument `-` means that the title script is not used.\nSince version 2.3 you can get a proper __zsh completion__ for such an option\nfor your program by using the provided autoloaded function `_title_opt`;\nsee `zsh/_runner` for a sample usage of that function.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvaeth%2Fruntitle","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvaeth%2Fruntitle","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvaeth%2Fruntitle/lists"}