{"id":21074820,"url":"https://github.com/dawsbot/swim","last_synced_at":"2025-07-12T09:37:11.135Z","repository":{"id":53181469,"uuid":"42786079","full_name":"dawsbot/swim","owner":"dawsbot","description":"🏊‍♀️  Switch between multiple vimrc files","archived":false,"fork":false,"pushed_at":"2021-12-02T11:02:09.000Z","size":4647,"stargazers_count":84,"open_issues_count":1,"forks_count":14,"subscribers_count":5,"default_branch":"master","last_synced_at":"2024-05-02T05:38:04.754Z","etag":null,"topics":["bash","bash-script","shell","shell-script","vim","vimrc","vimrc-files"],"latest_commit_sha":null,"homepage":"","language":"Shell","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/dawsbot.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-09-19T19:08:22.000Z","updated_at":"2024-03-14T17:47:02.000Z","dependencies_parsed_at":"2022-09-10T06:30:15.704Z","dependency_job_id":null,"html_url":"https://github.com/dawsbot/swim","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dawsbot%2Fswim","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dawsbot%2Fswim/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dawsbot%2Fswim/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dawsbot%2Fswim/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dawsbot","download_url":"https://codeload.github.com/dawsbot/swim/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225411503,"owners_count":17470246,"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":["bash","bash-script","shell","shell-script","vim","vimrc","vimrc-files"],"created_at":"2024-11-19T19:18:11.649Z","updated_at":"2024-11-19T19:18:12.408Z","avatar_url":"https://github.com/dawsbot.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"media/GreatWave.jpg\" alt=\"swim logo\" width = \"400\" /\u003e\n  \u003cbr\u003e\n  \u003cbr\u003e\n  \u003cp align = \"center\"\u003e\n    \u003cb\u003esw\u003c/b\u003eitch v\u003cb\u003eim\u003c/b\u003erc files instantly\n    \u003cbr\u003e\u003cbr\u003e\n\n    \n  \u003c/p\u003e\n\u003c/p\u003e\n\u003cbr\u003e\n    \n![](https://img.shields.io/badge/version-0.4.0-brightgreen.svg)\n![](https://img.shields.io/badge/license-MIT-blue.svg)\n\n## Demo\n![demo fig](media/demo.gif)\n\n\u003cbr\u003e\n\n## Why\nTrying out and switching vimrc's shouldn't be hard. It shouldn't require several ```mv```'s combined with a ```wget```. Most importantly, it shouldn't stop you from always having the perfect vim configuration so you can be efficient. \n\u003cbr\u003e\n\u003cp align=\"center\"\u003e\n  \u003cb\u003e\u003ccode\u003eswim add\u003c/code\u003e vimrc's directly from the internet\u003c/b\u003e\n\u003c/p\u003e\nor locally and alias your vimrc's with names that are easy to remember. Swim entirely replaces the need for per-directory vimrc's, headers, and external vimrc configs.\n\n\u003cbr\u003e\n\n## Install\nBackup your files **before** swimming\n\n```shell\ncurl -s https://raw.githubusercontent.com/dawsonbotsford/swim/master/install | bash\n```\n\n\u003cbr\u003e\n\n## Examples\n\n```shell\n  swim add ~/dotfiles/myVimrc favorite    #Add new swim alias\n  swim ls                                 #Show available swim aliases\n  swim add https://raw.githubusercontent.com/dawsonbotsford/swim/master/exampleVimrcs/vimrcWikia.vim example\n  swim with favorite         #Set alias favorite as primary .vimrc\n  swim with main             #Set alias main as primary .vimrc\n\n```\n\n\u003cbr\u003e\n\n## Update\n\n```shell\nswim update       #Update to the newest version of swim\n```\n\n\u003cbr\u003e\n\n## Available Commands\n\n```shell\nswim add \u003cURLToRaw or pathToFile\u003e  \u003calias\u003e   #Add a swim alias\nswim with \u003calias\u003e                            #Change active vimrc file\nswim ls                                      #List aliased vimrc files\nswim active                                  #Show currently aliased vimrc\nswim vim \u003calias\u003e                             #Edit the vimrc stored at alias\n\nswim mv \u003calias1\u003e \u003calias2\u003e                    #Rename alias (like Linux mv)\nswim rm \u003calias\u003e                              #Delete an alias entirely\nswim update                                  #Download newest version\nswim version                                 #Print version\nswim help                                    #Print this message\n```\n\n\u003cbr\u003e\n\n## FAQ\n\n* Where does swim store my vimrc files?\n  * swim stores your vimrc files in ```~/.swim```. You can edit the vimrc files with ```swim vim \u003calias\u003e``` or edit them manually from their file location.\n\n\u003cbr\u003e\n\n*  Can I set a custom executable location?\n  * Yes, the default install location of the `swim` executable is `/usr/local/bin`, but if you would like a custom location, simply set the environmental variable named `usrDir`. \n  * Example: `export usrDir=\"/usr/sbin\"`\n(That only needs to be set for when you perform the swim install. So no need to set this in your bashrc or zshrc)\n\n\u003cbr\u003e\n\n* Does swim support emacs?\n  * No, but pull requests are always welcome :)\n\n\u003cbr\u003e\n\n* Can I call swim within vim?\n  * It may be possible to hack together a several command ```:! ``` solution at the moment, but there is not a supported method.\n  \n\u003cbr\u003e\n\n#### Requirements\n\n* node.js and npm (to auto-install [chalk-cli](https://github.com/chalk/chalk-cli))\n\n\u003cbr\u003e\n\n## Changelog\n\n* **0.4.0**: Custom executable install location\n* **0.3.2-prelaunch**: Prelaunch Beta Testing\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdawsbot%2Fswim","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdawsbot%2Fswim","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdawsbot%2Fswim/lists"}