### Zephyr
* [[Using Zephyr|doc/zephyr]] <br />
-A guide on using Zephyr today with BarnOwl (and GNU Screen). Aimed at newcomers to Zephyr, and a pretty good reference. See also [the Barnowl wiki](http://barnowl.mit.edu/).
+A guide on using Zephyr today with BarnOwl (and GNU Screen). Aimed at newcomers to Zephyr, and a pretty good reference. See also [the BarnOwl wiki](http://barnowl.mit.edu/).
* [[Using SZS (the SMS to Zephyr Relay)|doc/szs]] <br />
Send and receive text messages through Zephyr.
A guide to using MATLAB on Athena.
* [Inessential Zephyr](http://stuff.mit.edu/afs/sipb/project/doc/izephyr/html/izephyr.html) ([DVI](http://stuff.mit.edu/afs/sipb/project/doc/izephyr/izephyr.dvi))([PDF](http://stuff.mit.edu/afs/sipb/project/doc/izephyr/izephyr.pdf)) <br />
-A guide to using the Athena instant-messenging system, Zephyr. Less relevant now that most people use Barnowl, try [this](http://sipb-www.scripts.mit.edu/doc/wiki/UsingZephyr) instead
+A guide to using the Athena instant-messenging system, Zephyr. Less relevant now that most people use BarnOwl, try [this](http://sipb-www.scripts.mit.edu/doc/wiki/UsingZephyr) instead
* [Inessential Bitmaps](http://stuff.mit.edu/afs/sipb.mit.edu/project/doc/ibitmap/ibitmap.html) ([DVI](http://stuff.mit.edu/afs/sipb/project/doc/current/ibitmap.dvi)) <br />
A guide to drawing and displaying XBM bitmaps and other graphics.
-[[!meta title="Random Zsigs for Barnowl"]]
+[[!meta title="Random Zsigs for BarnOwl"]]
-## Random Zsigs for Barnowl
+## Random Zsigs for BarnOwl
Note: There's a lot of background information in here which can be bypassed.
-First off, if you haven't already, take a look at Barnowl's internal documentation. Try the following two commands.
+First off, if you haven't already, take a look at BarnOwl's internal documentation. Try the following two commands.
:help
:show quickstart
-(Also viewable outside of Barnowl, in the form of messier-to-read source code, at [/help.c - barnowl - Trac](http://barnowl.mit.edu/browser/help.c) and the "intro" file at [/docs/intro.txt - barnowl - Trac](http://barnowl.mit.edu/browser/doc/intro.txt),
+(Also viewable outside of BarnOwl, in the form of messier-to-read source code, at [/help.c - BarnOwl - Trac](http://barnowl.mit.edu/browser/help.c) and the "intro" file at [/docs/intro.txt - BarnOwl - Trac](http://barnowl.mit.edu/browser/doc/intro.txt),
### Intro to Zsigs
A "zsig" appears after your username (your Athena account name) in Zephyr (see [[Using Zephyr (a.k.a. Zephyr for Dummies)|doc/zephyr]] if you don't know what Zephyr is).
2013 / personal / jdoe 22:16 (Jane L Doe)
...hey I'm talking here.
-Most people keep it that way, since people may not immediately know who you are by your username. Some people opt to remove the middle initial or leave it at an interesting quote. To do so, in Barnowl simply type in
+Most people keep it that way, since people may not immediately know who you are by your username. Some people opt to remove the middle initial or leave it at an interesting quote. To do so, in BarnOwl simply type in
:set zsig "This is a very interestin' quote."
-(Barnowl accepts either single or double quotes to enclose your zsig, allowing you to use the other type of quote inside your zsig. Experiment, Barnowl tells you what it interpreted your command as by showing as confirmation
+(BarnOwl accepts either single or double quotes to enclose your zsig, allowing you to use the other type of quote inside your zsig. Experiment, BarnOwl tells you what it interpreted your command as by showing as confirmation
zsig = 'This is a very interestin' quote.'
### Random Zsig Generator
But what if you want to set up a random zsig generator?
-In outline, we use some bash magic that prints a zsig out to `stdout`, then set up Barnowl to run that bit of bash magic. Barnowl has something already which will automagically take that `stdout` and pipe it into your zsig.
+In outline, we use some bash magic that prints a zsig out to `stdout`, then set up BarnOwl to run that bit of bash magic. BarnOwl has something already which will automagically take that `stdout` and pipe it into your zsig.
-#### Steps Outside of Barnowl: Creating the zsigs file
+#### Steps Outside of BarnOwl: Creating the zsigs file
Connect to Athena if you haven't already.
1. Create a file of zsigs. In this article we'll call the file `.zsigs`
The second line should be one of the zsigs from your list. Run it multiple times if you want to check for randomness.
-#### Setting Up Barnowl: Using the zsigproc variable
+#### Setting Up BarnOwl: Using the zsigproc variable
##### Background
-Open up Barnowl now.
+Open up BarnOwl now.
kusername@dr-wily:~$ add barnowl; barnowl
-Using the command `:show variables` inside of Barnowl we see descriptions of the variables of interest to us:
+Using the command `:show variables` inside of BarnOwl we see descriptions of the variables of interest to us:
zsig - zephyr signature (default: '')
zsigproc - name of a program to run that will generate zsigs (default: '<null>')
##### The Steps
-1. Use the `:startup` command in Barnowl to write to the "~/.owl/startup" file (or wherever you decided to put the your startup settings file for Barnowl). (Alternatively, edit the "~/.owl/startup" file directly). As mentioned in the detailed documentation, the variable `zsig` takes precedence over `zsigproc`. Make sure that `zsig` is empty. Then set `zsigproc` to run our bit of bash magic.
+1. Use the `:startup` command in BarnOwl to write to the "~/.owl/startup" file (or wherever you decided to put the your startup settings file for BarnOwl). (Alternatively, edit the "~/.owl/startup" file directly). As mentioned in the detailed documentation, the variable `zsig` takes precedence over `zsigproc`. Make sure that `zsig` is empty. Then set `zsigproc` to run our bit of bash magic.
:startup set zsig ''
:startup set zsigproc 'shuf -n1 ~/.zsigs'
-2. Force Barnowl to reload the startup configuration file
+2. Force BarnOwl to reload the startup configuration file
:source "~/.owl/startup"
## Zephyr to SMS
-To send zephyrs to a phone address as an Athena user, use your favorite zephyr client (see [Using Zephyr](http://sipb.mit.edu/doc/zephyr/) if you're not sure what this means) to zwrite `daemon/webzephyr.mit.edu` with a class of `szs` and an instance of `1234567890@servicemail.foo`; for instance, in Barnowl,
+To send zephyrs to a phone address as an Athena user, use your favorite zephyr client (see [Using Zephyr](http://sipb.mit.edu/doc/zephyr/) if you're not sure what this means) to zwrite `daemon/webzephyr.mit.edu` with a class of `szs` and an instance of `1234567890@servicemail.foo`; for instance, in BarnOwl,
----> zwrite daemon/webzephyr.mit.edu -c szs -i 1234567890@servicemail.foo
Hi imaginary friend, how are you doing? I'm sending you a text message through Zephyr.
Messages over 140 chars will get **cut off** between the phone and Zephyr. The cell phone user will get an `invalidpducontent` error, although the first part of his/her message will get through to Zephyr. On the other hand, messages *from* Zephyr to cellphones can be as long as you like.
-Also, hitting "`r`" in Barnowl to reply to a zephyrgram someone sent as a text message **does not work**. You'll have to hit `[Ctrl-R]` and typing out your friend's email address. (Afterward, you can scroll back to the last one you sent to your friend and hit "`r`", which will work).
+Also, hitting "`r`" in BarnOwl to reply to a zephyrgram someone sent as a text message **does not work**. You'll have to hit `[Ctrl-R]` and typing out your friend's email address. (Afterward, you can scroll back to the last one you sent to your friend and hit "`r`", which will work).
### Personals
When sending a zephyr from a phone, simply text a message to `kusername@szs.mit.edu` where `kusername` is the person's Athena username.
Zephyr replies to daemon/webzephyr.mit.edu -c szs -i 1234567890@servicemail.foo )
### Filtering
-As it turns out, for the same reasons that make replying to text messages such a pain, messages sent to Zephyr will appear in your personals (and can be viewed in Barnowl with the shortcut `[Alt-p]`) but messages you send in reply will not show up. This can make it annoying to carry on a conversation. To get text messages sent through Zephyr to show up in your personals (in Barnowl), you can edit your personal filter. To get your changes to persist across Barnowl sessions, you should directly edit your startup configuration file. This, by default, is the `startup` file in the `~/.owl` folder (where "~" stands for your home folder, so the full path should be something like `/mit/kusername/.owl/startup`).
+As it turns out, for the same reasons that make replying to text messages such a pain, messages sent to Zephyr will appear in your personals (and can be viewed in BarnOwl with the shortcut `[Alt-p]`) but messages you send in reply will not show up. This can make it annoying to carry on a conversation. To get text messages sent through Zephyr to show up in your personals (in BarnOwl), you can edit your personal filter. To get your changes to persist across BarnOwl sessions, you should directly edit your startup configuration file. This, by default, is the `startup` file in the `~/.owl` folder (where "~" stands for your home folder, so the full path should be something like `/mit/kusername/.owl/startup`).
So open up the "startup" file in your favorite text editor. If you're not sure which, try double-clicking the "startup" file, which should open it up in `gedit`. Or, if you're in a dialup ssh session, try `nano`.
Now find the line that starts with `filter personal` and edit it.
-Barnowl is picky about formatting, so here are some examples.
+BarnOwl is picky about formatting, so here are some examples.
This includes all your SMS <-> Zephyr messages in your personals and also colors your personal messages green.
filter personal -c green ( class ^szs$ ) or ( isprivate ^true$ and ( not type ^zephyr$ or ( class ^message$ ) ) )
isprivate ^true$ and ( not type ^zephyr$ or ( class ^message ) )
-Now to reload your Barnowl configuration, in Barnowl, run
+Now to reload your BarnOwl configuration, in BarnOwl, run
:source ~/.owl/startup
-Therefore you could have multiple startup files if you wish. However, do note that if you don't specify (overwrite) a filter in `startup2`, it will remain in its `startup` state. In other words, there is no original Barnowl filter configuration that your filters will revert to.
+Therefore you could have multiple startup files if you wish. However, do note that if you don't specify (overwrite) a filter in `startup2`, it will remain in its `startup` state. In other words, there is no original BarnOwl filter configuration that your filters will revert to.
### Screen
-If you are going to regularly send and receive text messages using the Barnowl client for Zephyr, you will probably want a Barnowl instance running 24/7 so that whoever texts you won't encounter a `user not subscribed` error and so that your text message conversations don't disappear each time you quit Barnowl.
+If you are going to regularly send and receive text messages using the BarnOwl client for Zephyr, you will probably want a BarnOwl instance running 24/7 so that whoever texts you won't encounter a `user not subscribed` error and so that your text message conversations don't disappear each time you quit BarnOwl.
-A good way to do this is to use screen and run it on the SIPB dialup machine, which allows you to run a Barnowl session within screen on the SIPB dialup machine that's theoretically up 24/7 (sadly outages do occur). See [Using Screen](http://sipb-www.scripts.mit.edu/doc/wiki/UsingScreen) for more information; the basic idea is to `ssh` to `kusername@linux.mit.edu` and run `add kchen; owl-screen`, and in the future after `ssh`-ing to `kusername@linux.mit.edu` run `screen -dr`.
+A good way to do this is to use screen and run it on the SIPB dialup machine, which allows you to run a BarnOwl session within screen on the SIPB dialup machine that's theoretically up 24/7 (sadly outages do occur). See [Using Screen](http://sipb-www.scripts.mit.edu/doc/wiki/UsingScreen) for more information; the basic idea is to `ssh` to `kusername@linux.mit.edu` and run `add kchen; owl-screen`, and in the future after `ssh`-ing to `kusername@linux.mit.edu` run `screen -dr`.
[[!meta title="Traditional Zephyr (archaic)"]]
-For information on using Barnowl, see [[Using Zephyr|doc/zephyr]].
+For information on using BarnOwl, see [[Using Zephyr|doc/zephyr]].
When you log into Athena, you may occasionally see a white box pop up
with text on it. This is Zephyr in its traditional form.
Here are some of the primary clients used at MIT. There's also a listing of [other Zephyr clients](http://zephyr.1ts.org/wiki/ZephyrClients), but their use is generally not recommended.
-### Barnowl
+### BarnOwl
-[Barnowl](http://barnowl.mit.edu/) is a command-line Zephyr client that supports advanced filtering and customisation. It is probably the most commonly used client, but requires some effort to get started. To use Barnowl effectively, you should connect to an [Athena dialup](http://web.mit.edu/dialup/www/ssh.html) and run Barnowl along with a program to renew your Kerberos tickets. The Athena command `athrun sipb owl-screen` will set this up for you.
+[BarnOwl](http://barnowl.mit.edu/) is a command-line Zephyr client that supports advanced filtering and customisation. It is probably the most commonly used client, but requires some effort to get started. To use BarnOwl effectively, you should connect to an [Athena dialup](http://web.mit.edu/dialup/www/ssh.html) and run BarnOwl along with a program to renew your Kerberos tickets. The Athena command `athrun sipb owl-screen` will set this up for you.
-In addition to primarily supporting Zephyr, Barnowl also lets you connect to [AIM](http://aim.com) and and [XMPP](http://xmpp.org/) (Google Talk, Facebook, etc.) networks.
+In addition to primarily supporting Zephyr, BarnOwl also lets you connect to [AIM](http://aim.com) and and [XMPP](http://xmpp.org/) (Google Talk, Facebook, etc.) networks.
-See [Getting Started with Barnowl](http://barnowl.mit.edu/wiki/GettingStarted) for more information.
+See [Getting Started with BarnOwl](http://barnowl.mit.edu/wiki/GettingStarted) for more information.
### Roost
-There are a lot of projects: Scripts, Barnowl, Straversity, smiopp and cyclist all have different things to work on. Skim through, see what catches your fancy.
+There are a lot of projects: Scripts, BarnOwl, Straversity, smiopp and cyclist all have different things to work on. Skim through, see what catches your fancy.
[Scripts](http://scripts.mit.edu)
=================================
with [Scripts](http://scripts.mit.edu/), subscribe here to see what
the Scripts team does behind the scenes. *High traffic.*
-* **<barnowl,\*,\*>** — Discussion of [Barnowl](http://barnowl.mit.edu/), a zephyr client written and maintained by SIPB members.
+* **<barnowl,\*,\*>** — Discussion of [BarnOwl](http://barnowl.mit.edu/), a zephyr client written and maintained by SIPB members.
* **<debathena,\*,\*>** — Discussion of [Debathena](http://debathena.mit.edu/), a project designed to bring the functionality of Athena to your Debian or Ubuntu system. Debathena is also the basis of the next official version of Athena. *High traffic.*
within screen on Linerva with automatically-renewing tickets.
We should write scripts to set them up so that that all they
have to do is enter a command or click an icon, type their kerberos
-password, and then know how to use Barnowl.
+password, and then know how to use BarnOwl.
_Contact: afarrell_
## A zephyr log viewer
-Many SIPB-affiliated people use the [Zephyr](http://zephyr.1ts.org/) messaging system, and the [Barnowl](http://barnowl.mit.edu/) client for it in particular. Barnowl has a number of very nice features that make it easy to follow large amounts of zephyr traffic: search, color coding, auto-narrowing, etc. Barnowl can also store logs of zephyrs sent and received for future reference, but the logs are saved separated by class in a way that's quite annoying to navigate sometimes. A Barnowl-like interface (perhaps implemented as a Barnowl plugin) for viewing zephyr logs would be a great thing to have.
+Many SIPB-affiliated people use the [Zephyr](http://zephyr.1ts.org/) messaging system, and the [BarnOwl](http://barnowl.mit.edu/) client for it in particular. BarnOwl has a number of very nice features that make it easy to follow large amounts of zephyr traffic: search, color coding, auto-narrowing, etc. BarnOwl can also store logs of zephyrs sent and received for future reference, but the logs are saved separated by class in a way that's quite annoying to navigate sometimes. A BarnOwl-like interface (perhaps implemented as a BarnOwl plugin) for viewing zephyr logs would be a great thing to have.
_Contact: oremanj_
sipb-www / wiki.git / commitdiff
