{"id":26804818,"url":"https://github.com/throughnothing/vimchat","last_synced_at":"2025-10-04T11:45:48.048Z","repository":{"id":66719049,"uuid":"1637063","full_name":"throughnothing/vimchat","owner":"throughnothing","description":"XMPP Chat for vim","archived":false,"fork":false,"pushed_at":"2011-08-04T05:15:28.000Z","size":217,"stargazers_count":14,"open_issues_count":1,"forks_count":17,"subscribers_count":1,"default_branch":"master","last_synced_at":"2023-04-14T01:26:40.960Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"VimL","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/throughnothing.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":"2011-04-19T19:06:35.000Z","updated_at":"2021-10-24T20:06:06.000Z","dependencies_parsed_at":"2023-02-20T09:50:21.454Z","dependency_job_id":null,"html_url":"https://github.com/throughnothing/vimchat","commit_stats":null,"previous_names":[],"tags_count":null,"template":null,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/throughnothing%2Fvimchat","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/throughnothing%2Fvimchat/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/throughnothing%2Fvimchat/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/throughnothing%2Fvimchat/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/throughnothing","download_url":"https://codeload.github.com/throughnothing/vimchat/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246252551,"owners_count":20747766,"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":"2025-03-29T22:27:14.720Z","updated_at":"2025-10-04T11:45:43.003Z","avatar_url":"https://github.com/throughnothing.png","language":"VimL","funding_links":[],"categories":[],"sub_categories":[],"readme":"# About\n\nVimchat is a vim plugin that allows you to do instant messaging from within the vim text editor. Note that this only works with vim, not gvim.\n\n[Screenshot 1](http://ironcamel.com/files/vimchat1.png) [Screenshot 2](http://ironcamel.com/files/vimchat2.png)\n\n# Features\n\nVimchat allows you to easily connect to jabber servers such as Google Talk. It is also possible to connect to other services such as IRC, AIM, ICQ, and MSN. You just need to set up jabber transports.\n\nVimchat supports encryption via OTR (off the record).\n\nVimchat can use status icons in the system tray which will blink when you receive new messages. You simply need to put any icon you would like to use at ~/.vimchat/icon[\\_status].gif. \nThe default icon is ~/.vimchat/icon.gif. To use a different icon for e.g. the away status put an icon at ~/.vimchat/icon\\_away.gif\n\n# Requirements\n\n* linux or Mac OS X\n* vim \u003e= 7.3.254\n* python-xmpp\n\nSuggested libraries:\n\n* python-gtk2\n* python-notify\n* python-dns\n* growl (for OSX only)\n\nThis works on linux and Mac (tested with MacVim, but required a recompile against newer python libraries). You must have python support in vim, and you must have xmpppy installed (the python-xmpp package in most distros). The python-notify package is not necessary, but if it is installed, you will get pretty libnotify alerts for new messages. It also throws some warning messages if you do not have python-dns installed (though it will still work without it). The python-gtk2 package is needed if you want a status icon in your system tray that blinks when new messages arrive.\n\nIf you are running ubuntu linux, here is a command you can run to install all the dependencies:\n\n    sudo apt-get install vim-gtk python-xmpp python-notify python-dns python-gtk2\n\n# Installation\n\n    chmod +x install.sh\n    ./install.sh\n    This should have created a file at ~/.vimchat/config. Edit this file and add at least one account entry to it. \n\n# Usage\n\nTo start using vimchat just start vim and type :VimChat. You should see a window on the left with a list of all your buddies. Type B a couple times to refresh/toggle this list. Hit enter on someone's name to open a chat buffer. Type i (or a or o) to open a send buffer. Type a message and hit enter. \n\n# Buddy List\n\nThe buddy list can be toggled by typing B in normal mode from a vimchat buffer. Toggling the buddy list also refreshes it. If you are not currently in a vimchat buffer, you can open it with the :VimChatBuddyList command.\n\nThe buddy list is comprised of folds, and unfolding any buddy will show items like status, away message, and the groups that he or she belongs to.\n\nOnce in the buddy list, you can scroll through your buddies and hit enter when your cursor is on the buddy you want to chat with.\n\nPressing \\l while on a buddy entry in the buddy list will bring up the log files (if any) for that user. \n\n# Chat Buffers\n\nWhen you enter into insert mode from a chat window (for example by typing i), it will pop up a send buffer. In the send buffer you simply type your message and hit enter. Multiple lines can also be sent by typing the lines, then selecting what you want to send in visual mode and pressing enter.\n\nTyping \\l will bring up a new tab containing log files for the current user. \n\n# Growl Integration\n\nFirst install the growl notification system: http://growl.info/\n\nThen download the growl SDK from: http://growl.info/downloads_developers.php\n\nFinally navigate into the Bindings/python folder and run: \n    sudo python setup.py install\n\n# Options\n\n__Optional ~/.vimrc Variables:__\n\n* let g:vimchat\\_buddylistwidth = width of buddy list, default is 30\n* let g:vimchat\\_logpath = path to store log files, default is ~/.vimchat/logs\n* let g:vimchat\\_logchats = (0 or 1) default is 1 -- 0 will not log,\n* let g:vimchat\\_otr = (0 or 1) default is 0 -- enable otr or not\n* let g:vimchat\\_logotr = (0 or 1) default is 1 -- log otr convos or not\n* let g:vimchat\\_statusicon = (0 or 1) default is 1 -- use a gtk status icon? \n* let g:vimchat\\_blinktimeout = timeout in seconds, default is -1\n* let g:vimchat\\_buddylistmaxwidth = max width of buddy list window, default ''\n* let g:vimchat\\_timestampformat = format of the message timestamp, default \"[%H:%M]\" \n* let g:vimchat\\_showPresenceNotification = notification if buddy changed status, comma-separated list of states, default \"\"\n\n# Hacking\n\n* Keep all lines to 80 characters wide or less\n* All python code should follow pep8 guidelines\n* All new features should update documentation in the README\n\n\n# Contributors \n\n* Philipp [philsmd](https://github.com/philsmd)\n* Michael Dillon [michaelcdillon](https://github.com/michaelcdillon)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthroughnothing%2Fvimchat","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthroughnothing%2Fvimchat","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthroughnothing%2Fvimchat/lists"}