From 23f0e1561767dd8a396188e317bae5920d171ea8 Mon Sep 17 00:00:00 2001 From: erdgeist Date: Sun, 16 Aug 2015 16:38:25 +0200 Subject: Initial import of my nikola website --- stories/projects/vchat-client.rst | 267 ++++++++++++++++++++++++++++++++++++++ 1 file changed, 267 insertions(+) create mode 100644 stories/projects/vchat-client.rst (limited to 'stories/projects/vchat-client.rst') diff --git a/stories/projects/vchat-client.rst b/stories/projects/vchat-client.rst new file mode 100644 index 0000000..f540f04 --- /dev/null +++ b/stories/projects/vchat-client.rst @@ -0,0 +1,267 @@ +.. link: +.. description: is a curses based chat client for the arcane vchat protocol. +.. tags: project +.. date: 2014/02/01 19:10:08 +.. title: vchat-client +.. slug: ../arts/software/vchat-client/index + +Newbies Guide to vchat via 'Buntclient' +======================================= + +1. Get the Source, Luke +----------------------- + +Make sure, you got a shell and the tool called cvs. +cd to a directory the source shall reside in. + +Type:: + + $ cvs -d:pserver:anoncvs@cvs.erdgeist.org:/home/cvsroot login + $ cvs -z3 -d:pserver:anoncvs@cvs.erdgeist.org:/home/cvsroot co vchat-client + +(press return at password prompt) + + +2. Do the verpile +----------------- + +Enter the vchat-client/ directory. +Type:: + + $ make + +If that fails due to some readline fuckups, try again with:: + + $ make OLDREADLINE=-DOLDREADLINE + +If you are administrator of your computer and want to install +vchat-client permanently, type:: + + $ make install + +You may also run the binary from its compile location. + + +3. Get protected +---------------- + +Run the script vchat-keygen, located in the vchat-client/ directory. +Follow its instructions. + + +4. Home sweet Home +------------------ + +Create a .vchat/ directory in your homedir. :: + + $ cd + $ mkdir .vchat/ + +Copy your key to the .vchat/ directory:: + + $ cp ~/.vchat.key ~/.vchat/key + +Whenever your signed cert arrives from vchat at vchat.berlin.ccc dot de, +copy it to the .vchat/ directory as well:: + + $ cp ~/.vchat.cert ~/.vchat/cert + +In order to modify the look of your client, you may copy one of +the sample-xxx.fmt files to the .vchat/ directory:: + + $ cd vchat-client/ + $ cp sample-erdgeist.fmt ~/.vchat/formats + +If you want to set the chat server to vchat.berlin.ccc.de now, +type:: + + $ echo host=vchat.berlin.ccc.de >> ~/.vchat/config + +If you want to ignore SSL-warnings due to missing CA-files, type:: + + $ echo ignssl=1 >> ~/.vchat/config + +If you don't want to ignore SSL-warnings, get the root-certificates from: + + http://www.cacert.org/certs/class3.txt + and + http://www.cacert.org/certs/root.txt + +and copy them into your openssl-certs directory. For example:: + + # cp root.txt /etc/ssl/certs/ + # cp class3.txt /etc/ssl/certs/ + # cd /etc/ssl/certs + # ln -s root.txt `openssl x509 -in root.txt -hash | head -n 1`.0 + # ln -s class3.txt `openssl x509 -in class3.txt -hash | head -n 1`.0 + +Now you can type:: + + $ echo ignssl=0 >> ~/.vchat/config + + +If you want a seperate private message window, type:: + + $ echo messages=10 >> ~/.vchat/config + +If you want to have no topic line, like in the oldschool client, +do not choose a private message window an type:: + + $ echo usetopicbar=0 >> ~/.vchat/config + +5. First bunt +------------- + +Check, whether you REALLY got a signed cert. + +[.... +If you did not get a reply from vchat at vchat.berlin.ccc dot de within +3 days, this might either be due to you not being known to the +certificate masters, or simply because of the verpeil. You may, +after 3 days, contact me at erdgeist at erdgeist dot org. If I don't +reply, too, reconsider your lifestyle. +....] + +Start the client:: + + $ vchat-client + +or :: + + $ vchat-client/vchat-client + +Enter the passphrase to your private key, if you added one. + +Look around. If the Umlautz are broken, try to trouble shoot here: +https://freepad.erdgeist.org/p/fT9OoDoLMx + +Try to feel comfortable with the new look of your vchat- +environment. Close your mouth. Try playing around with the +following commands: + +If you did not enable the seperate private message window, +ignore this part: + +[ STARTIGNORE + +Press Ctrl-G and Ctrl-T several times. +Press Ctrl-X, then send yourself a private message, watch, what +happens +Press Ctrl-C ONCE!!! +Press Ctrl-R and watch the asteriks at the very right of your +screen, this one indicates, which window to scroll back + +ENDIGNORE] + +Press Ctrl-B Ctrl-F, if you collected some text in your +message window. This should scroll back and forth. +A red console bar should indicate, that you scrolled up. + +Press Ctrl-L to redraw and reset scroll indices. + +Play around with the completion: + +Hitting at start of line will complete to :: + + .m + +if you hit more often, you will cycle through this list, +sorted by the last time you exchanges PMs with. + +Hitting when you already typed some letters but no space +yet will expand to all nicks in your current channel. You may +cycle through this list, too. + +Hitting tab anywhere else expands to all nicks in all channels. + +Most other readline hotkeys (Ctrl-U, Ctrl-K, Ctrl-W, Ctrl-A...) +will work as expected. + + +6. Commandoe +------------ + +In addition to the server commands (.h, .m, .a, .s ...) the +client brings its own set of commands, which will be triggered +IRC-style by /COMMAND. These may be abbrevated to the lowest +unambigous substring. + +Try /HELP for a first glimpse. +The status window may be forced off by hitting Ctrl-X. + +/HELP KEYS should give you a short summary of available hot +key commands. + +Some client commands are wrappers around server commands:: + + /ME == .a + /MSG == .m + /M == .m + /QUIT == .x + +The other commands are used to enable client side filtering +and highlighting. + +Try:: + + /HELP FILTERS + /HELP FLT + /HELP FILTERS + +Highlight yourself:: + + /FLT 6 + +if you don't see anything getting highlighted, you probably +have a mac. If you got this far despite of that problem, you +will surely find a way to enable colors in your terminal. + +Remove the filter rule:: + + /rmflt 1 + +Zoom in all channel leaves:: + + /flt + left channel + +List your filter rules:: + + /lsflt + +Remove all filters:: + + /clflt + +Ignore all server leave and join messages:: + + /flt - ((left|joined|entered) (the )?(channel|chat)) + +Reenable those lines:: + + /rmflt ((left|joined|entered) (the )?(channel|chat)) + +Note: zoom overrides ignore. + +Be careful about setting your filters, as these are treated +as regular expressions, which easily may lead to time +consuming evaluations. Avoid brackets. + + +7. Fiiiiiiiiieschas +------------------- + +As I am still young *cough cough* I am _STILL_ willing to +implement features of all stupidity grades. Contact me +with /m erdgeist at any time. + + +8. You help +----------- + +Since you will probably start fiddeling around with your +.vchat/formats file, I'd appreciate getting YOUR format, +too, as this may be helpful for others to make their own. +Just send them to erdgeist at erdgeist dot org. Bug reports, +feature request that are to long for the chat and diffs +implementing some features are welcome at this address, +too. -- cgit v1.2.3