-
Notifications
You must be signed in to change notification settings - Fork 1
/
README
115 lines (84 loc) · 3.73 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
jj
jj is a simple FIFO and filesystem based Jabber/XMPP client. jj is inspired by
ii IRC client.
jj is more tool than traditional instant messanger client. It can be easily
extended with normal unix tools. It is perfect for bots and notifications.
Interaction with jj is done by writing and reading files from the server
directory which jj creates.
Quick getting started guide
Latest official jj version is 1. It can be downloaded here:
http://23.fi/jj/jj-1.tar.gz .
The development version can be cloned with git from jj's github page (
https://github.com/Petteri/jj ).
To compile jj you need loudmouth and glib development libraries. On Debian
install these packages:
libloudmouth1-dev
libglib2.0-dev
Then you can compile jj with make:
make
Now you should have jj executable. Start it with the line (replace server and
user stuff with your own):
./jj -s server.tld -j [email protected] -u user -p password -m User
It will create server.tld directory that will contain in file used to
communicate to jj and out file for the output. Commands recognize at this point
are:
/join [email protected]
/msg [email protected]
for every joined muc there will be a new directory in server.tld/mucs with its
own in and out files. Normal users will get a directory in server.tld directory
that works in the same way. After you have some mucs or users in server.tld you
can just write to in files and read the outfiles. Unix tool echo is nice way to
to write, example:
echo "/join [email protected]" > server.tld/in
Here is an example of the directory tree structure from connection to
server.tld.
server.tld
|-- in
|-- mucs
| |-- [email protected]
| | |-- in
| | `-- out
| |-- [email protected]
| | |-- in
| | `-- out
| |-- [email protected]
| | |-- in
| | `-- out
| `-- [email protected]
| |-- in
| `-- out
|-- out
|-- in
`-- out
Usage example
Multi-User Chat
Here is a small usage example that shows basic usage. First start up jj. Then
join some mucs and finally follow mucs output with tail.
./jj -s server.tld -j [email protected] -u user -p password -m User
echo "/join [email protected]" > server.tld/in
echo "/join [email protected]" > server.tld/in
echo "/join [email protected]" > server.tld/in
echo "/join [email protected]" > server.tld/in
cd server.tld/mucs
1-to-1 Chat
When chatting to only one person you should first initiate the chat by sending
first message to server in -file. After that you should use the directory
created for the user
./jj -s server.tld -j [email protected] -u user -p password -m User
echo "/msg [email protected] hello" > server.tld/in
tail -f server.tld/[email protected]/out
echo "Petteri are you getting the messages?" > server.tld/[email protected]/out
Source Code Repository and Issue tracker
jj's source code is hosted at Github. There is also an issue tracker which can
be used to report bugs.
You can also build debug version of jj with make debug, just remember to do
make clean first!
Contact the author & support
You can contact the author by sending email to petteri gmail com or sending
XMPP messages to petteri jabber ru. You can also support jj with Bitcoin
(Bitcoin address: 1CCC3pdE3iHQdBiiqgsbZNsghPzxYoEfxE ) if you wish.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
xmpp: petteri jabber ru
Last modified: Mon Jul 11 15:53:08 EEST 2011