File: README

package info (click to toggle)
lopster 1.2.2-4
  • links: PTS
  • area: main
  • in suites: etch, etch-m68k
  • size: 3,588 kB
  • ctags: 4,156
  • sloc: ansic: 56,739; sh: 350; makefile: 125
file content (223 lines) | stat: -rw-r--r-- 9,514 bytes parent folder | download | duplicates (3)
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
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
Hi out there! This document is not up to date!

*======================================================================*
**  GENERAL                                                           **
*======================================================================*

There a key binding for some actions

  o ALT-q	switch a global page left (eg. from library to chat)
  o ALT-w	switch a global page right (eg. from chat to library)
  o ALT-a	switch a page left in sub notebook
  o ALT-s	switch a page right in sub notebook

  o STRG-[1-9]	switch to global page no [1-9]
  o ALT-[1-9]	switch to chat page no [1-9]

*======================================================================*
**  THE SERVERS                                                       **
*======================================================================*

* General
-----------------------
If you want to connect to a server you have to add it to the *Selected Server*
list. To do this you may specify one manually or via the Napigator list.
Since lopster 0.9.8 there is the ability to connect to a server directly listed 
in the napigator list, but it is recommended to add the server to the selected
server list first.

* The Napigator List
-----------------------
The Napigator server list is a list of napster servers that are registered
on napigator. To view this list just do a right click and select *Refresh List*

* Meta Servers
-----------------------
A Meta Server is a server that internally selects a napster server address
and returns it to the client. The original Windows Napster client uses
server.napster.com:8875 as Meta Server to connect to the Napster network.
Lopster no longer supports official napster as they changed their protocol
and policy.

*======================================================================*
**  THE CHAT                                                          **
*======================================================================*

Lopster has got a powerful chat interface....

* The options popup (use the wide button above the chat window)
* ======================================================================

  o FIELD: Show join messages
    Here you can specify the verbose level of the channel joins.
    Joins of your friends are shown always
    * None: No channel joins are shown
    * All:  All channel joins are shown

  o FIELD: Show part messages
    Here you can specify the verbose level of the channel joins.
    Parts of your friends are shown always
    * None:         No channel parts are shown
    * Recent Users: Only users are shown that interacted in chat within a
                    specified time. You can setup this time period.
    * All:          All channel parts are shown.

  o FIELD: Timestamps
    Specify the format of the timestamp shown in the chat window for every
    message

  o CHECKBUTTON: Do not show any messages from ignored users
    if this button is activated not only private messages are ignored
    but also public messages and emotes.

  o CHECKBUTTON: parse colors in outgoing messages
    if activated, all outgoing messages are scanned for color codes.
    The following codes are supported (all with a beginning %)

    Foreground colors:
     %k		(dark black)	BLACK
     %r		(dark red)
     %g		(dark green)
     %y		(dark yellow)	BROWN
     %b		(dark blue)
     %m or %p	(dark purple)
     %c		(dark cyan)
     %w		(dark white)    LIGHT GRAY
     %K		(light black)   DARK GRAY
     %R		(light red)
     %Y		(light yellow)
     %B		(light blue)
     %M or %P	(light purple)
     %C		(light cyan)
     %W		(light white)	WHITE
    Background colors:
     %0		(dark black)	BLACK
     %1		(dark red)
     %2		(dark green)
     %3		(dark yellow)	BROWN
     %4		(dark blue)
     %5		(dark purple)
     %6		(dark cyan)
     %7		(dark white)    LIGHT GRAY
    Others stuff:
     %n         reset fore and backcolor

    (see next section for examples)

  o CHECKBUTTON and ENTRY: afk message
    If this button is activated every incoming privated message is automatically
    answered with the given text (if you have specified one) and the time you
    are AFK. The incoming messages are all stored in one single "Away log" window
    or are displayed in the current chat page (configurable in the preferences)
    (see command: /afk)

* The text entry field
* ======================================================================

  Here you can give commands and write public messages for the current channel
  To list all available commands use the command /help

  If no command is given, Lopster sends
  * a public message if in a channel page
  * a private message if in a private page
  * a message to all Moderators+ if you are in Operator page (MOD+ only)
  * a message to all users if you are in Global page (Admin+ only)

  Any chat message you send will be color parsed, if color parsing is activated.
  To use colors, you have to insert codes:

    o %<color>       // see above
      Example: This is a %Rlight red, %gnormal green, %Blight blue %ntext
      
  There are some key shotcuts for the text entry field:

    o TAB	if the line starts with a slash /, the following command will be
		completed if possible and if not possible, then another TAB will
                show all potential commands.
		if the line does not start with a slash, the text is completed to
		a username in the current channel. This also works if you prepend
		an @. If the username is the first word in the line then a ':' is
                appended.

*======================================================================*
**  THE LIBRARY                                                       **
*======================================================================*

In the Library the files are stored you want to share with the other users.

* General
--------------------
The library is automatically saved on exit to the specified filename in the
Library page. This list will be loaded on next startup. Share status is not
saved at the moment.

Adding files
--------------------
To add files to the Library, simply add a folder to the Shared Files in
Preferences->Shares and press the OK button. The shared list will be refreshed 
automatically.

* Removing files
--------------------
To remove files, remove a directory from the folder list in the preferences.
Another way to remove files is to select a file or a directory in the Library
and to select the *Remove* entry in the popup menu (right click).

* Saving, loading, deleting shared lists
--------------------
 o To save the shared list, simply enter a filename in the entry field below the list
   and press the *save* button. The list is saved to the location ~/.lopster/share/
 o To load a saved list, press the button *Files* with with the blue arrow below the
   tab. There you can select it. With this button you can also delete a saved list or
   add a list to the current Library.


*======================================================================*
**  THE SEARCH                                                        **
*======================================================================*

The search page has got two sections: the Search Fields and the Search Result
List.

* The Search fields
----------------------------
The search fields are detachable with the little button |^|
The fields have three sections:
 o the basic search parameters
   Here you can specify where you want to search: on napster, in your library,
   in the browsed users (hotlist), in the search results.
   You also can specify the filetype: mp3, video, audio, etc.
   There is a difference in search on napster and searching somewhere else:
   - If you search on napster for type X, then the results are files, the
     server thinks they are of type X. And the server thinks, what the client
     tell it to think: If you share video files as type mp3, then the server
     thinks they are mp3s (no matter what suffix the files have).
     At the moment the only client that seems to share videos as videos is
     Lopster. That means: If you want to search for videos then it is best
     to search for type "any" (and increase the filesize). If you searched for
     type video, then the results would be only from lopster users.
   - If you search in Lopster internally then the results are files, Lopster
     thinks they are of type X.
     In preferences you have to specify which suffixes Lopster should
     recognize as which type.
   The max results entry is quite useless, as most opennap servers limit
   the results to 100 or something. So setting a higher value has no effect.
 o the advanced search parameters
 o the search history list

*======================================================================*
**  THE HOTLIST                                                       **
*======================================================================*

*======================================================================*
**  THE TRANSFERS                                                     **
*======================================================================*

*======================================================================*
**  THE EXTERNAL HANDLER                                              **
*======================================================================*

There are several events that are passed to the external handler:
* IM <user> <message>
* UPLOAD <user> <file>
* DL_FINISHED <user> file>