{"id":21167756,"url":"https://github.com/nicolodiamante/gitio","last_synced_at":"2025-06-15T16:10:59.712Z","repository":{"id":156096584,"uuid":"362819894","full_name":"nicolodiamante/gitio","owner":"nicolodiamante","description":"Make URL shortening effortless with the Zsh Plugin for GitHub.","archived":false,"fork":false,"pushed_at":"2024-01-20T13:48:07.000Z","size":19,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-13T14:43:36.048Z","etag":null,"topics":["git-io","gitio","ohmyzsh","ohmyzsh-plugin","plugin","plugin-extension","shorten-urls","url","url-shortener","url-shortener-microservice","url-shortner","vanity-address","vanity-url","zsh"],"latest_commit_sha":null,"homepage":"https://git.io/zsh-gitio","language":"Shell","has_issues":true,"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/nicolodiamante.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-04-29T13:04:44.000Z","updated_at":"2024-05-20T13:25:58.000Z","dependencies_parsed_at":null,"dependency_job_id":"9e7acf05-ea2e-4338-88dc-aebfe2b2ab6a","html_url":"https://github.com/nicolodiamante/gitio","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/nicolodiamante/gitio","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nicolodiamante%2Fgitio","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nicolodiamante%2Fgitio/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nicolodiamante%2Fgitio/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nicolodiamante%2Fgitio/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nicolodiamante","download_url":"https://codeload.github.com/nicolodiamante/gitio/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nicolodiamante%2Fgitio/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260006136,"owners_count":22944869,"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":["git-io","gitio","ohmyzsh","ohmyzsh-plugin","plugin","plugin-extension","shorten-urls","url","url-shortener","url-shortener-microservice","url-shortner","vanity-address","vanity-url","zsh"],"created_at":"2024-11-20T15:01:44.363Z","updated_at":"2025-06-15T16:10:59.663Z","avatar_url":"https://github.com/nicolodiamante.png","language":"Shell","funding_links":[],"categories":["Plugins"],"sub_categories":["ZSH on Windows"],"readme":"\u003cp align=\"center\"\u003e\n  \u003cpicture\u003e\n    \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://github.com/nicolodiamante/gitio/assets/48920263/c79c27f6-6cb5-4e59-87cc-b2e48f17e6e1\" draggable=\"false\" ondragstart=\"return false;\" alt=\"gitio\" title=\"gitio\" /\u003e\n    \u003cimg src=\"https://github.com/nicolodiamante/gitio/assets/48920263/d170b145-00de-4aa9-a812-a108ab6335b7\" draggable=\"false\" ondragstart=\"return false; \"alt=\"gitio\" title=\"gitio\" /\u003e\n  \u003c/picture\u003e\n\u003c/p\u003e\n\nGit URLs can become cumbersome due to the long file names, leading to lengthy and often messy URLs that can be difficult to read. This can be particularly problematic when sharing URLs via email or social media. To address this issue, this plugin has been developed to use curl to shorten URLs, inspired by a similar service offered by GitHub called [Git.io][gitio]. The use of shortened URLs can not only improve readability but also make sharing URLs more convenient and efficient. This plugin allows users to enjoy the benefits of short and catchy Git URLs.\n\u003cbr\u003e\u003cbr\u003e\n\n\u003e Note: This script utilises Git.io for URL shortening. Please be advised that as of January 2022, Git.io has announced that it is no longer accepting new links for shortening. Any links already shortened via Git.io will continue to operate as usual and stay accessible.\n\n\u003cbr\u003e\n\n## Getting Started\n\nDownload the repository via curl:\n\n```shell\nzsh -c \"$(curl -fsSL https://raw.githubusercontent.com/nicolodiamante/gitio/HEAD/bootstrap.zsh)\"\n```\n\nAlternatively, you can clone the repository manually:\n\n```shell\ngit clone https://github.com/nicolodiamante/gitio.git ~/gitio\n```\n\nOnce you have downloaded the repository, navigate to the root directory of the repository, and then execute the installation script using the following command:\n\n```shell\nsource utils/install.sh\n```\n\nThe script is designed to search for the zshrc file and append the complete path to the gitio/script directory to the fpath variable. By doing this, the script ensures that the script directory is added to the list of paths that Zsh searches for when looking for executable scripts.\n\n```shell\nfpath=(~/gitio/script $fpath)\nautoload -Uz gitio\n```\n\n\u003cbr\u003e\n\n### Install via [Oh My Zsh][ohmyzsh]\n\n```shell\ngit clone https://github.com/nicolodiamante/gitio.git $ZSH_CUSTOM/plugins/gitio\n```\n\n- Add to your zshrc plugins array `plugins=(... gitio)`\n- Restart the shell to activate\n  \u003cbr\u003e\u003cbr\u003e\n\n## How to use gitio\n\n- `gitio` when lanced into a Git repository, the plugin will look for the URL in the config file located in the .git directory.\n\n- `gitio [URL]` shortens the URL but does not provide a vanity name for the shortened URL, resulting in no control over the output.\n\n- `gitio [URL] [vanity-name]` it allows users to provide a vanity name for the shortened URL. In a Git repository instead of having to type out the entire URL, users can simply enter the username/repo and the plugin will handle the rest.\n\n- `gitio --retrieve [URL]` fetch the full URL from the abbreviated URL.\n\n- `gitio --open [URL]` designed to exclusively function with GitHub URLs, will automatically launch the default browser to access the shortened URL.\n\nFor full gitio options, see `gitio --help`.\n\u003cbr\u003e\u003cbr\u003e\n\n## Notes\n\n### Resources\n\n- [The GitHub Blog][git-blog]\n\n### Contribution\n\nAny suggestions or feedback you may have for improvement are welcome. If you encounter any issues or bugs, please report them to the [issues page][issues].\n\u003cbr\u003e\u003cbr\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cpicture\u003e\n    \u003cimg src=\"https://github.com/nicolodiamante/gitio/assets/48920263/c9f2c99f-3541-4cf8-9c79-54497c71881e\" draggable=\"false\" ondragstart=\"return false;\" /\u003e\u003c/\u003e\n  \u003c/picture\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://nicolodiamante.com\" target=\"_blank\"\u003e\n    \u003cimg src=\"https://github.com/nicolodiamante/gitio/assets/48920263/c83cf018-57af-4ef8-a99a-517425445425\" draggable=\"false\" ondragstart=\"return false;\" alt=\"Nicol\u0026#242; Diamante Portfolio\" title=\"Nicol\u0026#242; Diamante\" width=\"17px\" /\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cpicture\u003e\n    \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://github.com/nicolodiamante/gitio/assets/48920263/3c178be9-75f4-4647-b593-7c42f57dd09b\" draggable=\"false\" ondragstart=\"return false;\" alt=\"MIT License\" title=\"MIT License\" /\u003e\n    \u003cimg src=\"https://github.com/nicolodiamante/gitio/assets/48920263/c02dde9b-3635-4953-87e9-da2078e779a2\" draggable=\"false\" ondragstart=\"return false; \"alt=\"MIT License\" title=\"MIT License\" width=\"95px\" /\u003e\n  \u003c/picture\u003e\n\u003c/p\u003e\n\n\u003c!-- Link labels: --\u003e\n\n[gitio]: https://git.io\n[ohmyzsh]: https://github.com/robbyrussell/oh-my-zsh/\n[git-blog]: https://github.blog/2011-11-10-git-io-github-url-shortener/\n[issues]: https://github.com/nicolodiamante/gitio/issues\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnicolodiamante%2Fgitio","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnicolodiamante%2Fgitio","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnicolodiamante%2Fgitio/lists"}