1MUSEEKCONTROL(1)              Museek Daemon Plus              MUSEEKCONTROL(1)
2
3
4

NAME

6       MuseekControl - Command-Line control Python Script for Museekd
7

DESCRIPTION

9       MuseekControl is command-line Python script that connects to museekd(1)
10       and initiates many different commands.  Chat  Room  watching,  one-time
11       chat  messages,  browsing shares, searching, viewing User info and set‐
12       ting tickers are just some of the many commands available.
13
14       Only one museek option will work at a time. If two are  set,  the  last
15       one will be used.
16
17       Setting  the  interface  and password on the command-line is a security
18       risk. Since interface and password settings are  saved  to  the  config
19       file  when  set,  you  should  set  them, exit museekcontrol, and rerun
20       museekcontrol without the password options on the commandline..LP
21
22       Before running, you will need a working museekd(1)  and  need  to  know
23       your  museekd  interface  and  interface password. Configure those with
24       musetup(1).
25

SYNOPSIS

27       museekcontrol  [-c   |--config  <config-filename>]  [--gs  |  --gsearch
28       <query>]  [--rs  |  --rsearch <query>] [--bs | --bsearch <query>] [-r |
29       --rooms]  [--roomlist]  [--joined]  [--roominfo  <room>]  [--roomsinfo]
30       [--sroom  <room>] [--srooms] [--sprivate <user>] [--sprivates] [--tick‐
31       ers <room>] [--alltickers] [-j | --join <room>] [-l |  --leave  <room>]
32       [-m  |  --message  <message>] [--chat <room>] [--pm | --private <user>]
33       [--setticker  <room>]  [--settempticker  <room>]   [--setdefaultticker]
34       [--buddy  |  --unbuddy  <user>] [--ignore | --unignore <user>] [--ban |
35       --unban  <user>] [--trust |  --distrust  <user>]  [--comment  <string>]
36       [--info  <user>] [--minfo] [--ip <user>] [-b | --browse <user>] [--mb |
37       --mbrowse]  [-t  |  --transfers]  [--mt  |  --mtransfers]   [--download
38       slsk://user/path]      [--upload      slsk://user/path]      [--abortup
39       slsk://user/path]    [--abortdown     slsk://user/path]     [--removeup
40       slsk://user/path]     [--removedown     slsk://user/path]    [--retryup
41       slsk://user/path] [--retrydown   slsk://user/path]  [-i  |  --interface
42       <host:port  | /socket.path> [-p | --password <inteface-password>] [-v |
43       --version] [-h | --help]
44

OPTIONS

46       Museekcontrol accepts the following options:
47
48       -c <filename>, --config <filename>
49              Use a different config file.  v SEARCHING:
50
51       --gs, --gsearch <query>
52              Globally search for query & show results
53
54       --rs, --rsearch <query>
55              Room search for query & show results
56
57       --bs, --bsearch <query>
58              Buddy search for query & show results
59
60       CHAT ROOMS:
61
62       -r, --rooms
63              Show list of rooms
64
65       --roomlist
66              Refresh list of rooms
67
68       --joined
69              Show list of Joined rooms
70
71       --roominfo <room>
72              Show users in a Joined room
73
74       --roomsinfo
75              Show users for all Joined rooms
76
77       --sroom <room>
78              Show chat log for room
79
80       --srooms
81              Show chat log for all rooms
82
83       -j, --join <room>
84              Join a room
85
86       -l, --leave <room>
87              Leave a room
88
89       --chat <room>
90              Use with --message
91
92       -m, --message <message>
93              Say message in room (Use with --chat)
94
95       TICKERS:
96
97       --tickers <room>
98              Show tickers in room
99
100       --alltickers
101              Show tickers in all rooms
102
103       --setticker <room>
104              Pick a room to set the ticker in. (Use with --message)
105
106       --settempticker <room>
107              Pick a room for a temporary ticker (Use with --message)
108
109       --setdefaultticker
110              Set the default ticker for all room (Use with --message)
111
112       -m, --message <message>
113              Set the ticker to this.
114
115       PRIVATE CHAT:
116
117       --sprivate <user>
118              Show Private Chat log for a user
119
120       --sprivates
121              Show Private Chat logs for all users
122
123       --pm, --private <user>
124              Say message in PM (Use with --message)
125
126       -m, --message <message>
127              Say message in PM (Use with --pm)
128
129       USERS:
130
131       --buddy --unbuddy <user>
132              Add/Remove user from Buddies list
133
134       --ignore --unignore <user>
135              Add/Remove user from Ignore list
136
137       --ban --unban <user>
138              Add/Remove user from Banned list
139
140       --trust --distrust <user>
141              Add/Remove user from Trusted list
142
143       --comment <string>
144              Comment for the user in list
145
146       USERINFO:
147
148       --info <user>
149              Show a user's info  (Saves image to <user>.img if available)
150
151       --minfo
152              Monitor all User Info
153
154       --ip <user>
155              Get a user's IP and Port
156                      BROWSING:
157
158       -b. --browse <user>
159              Get a user's shares and show them
160
161       --mb, --mbrowse
162              Monitor browsing
163
164                      TRANSFERS:
165
166       -t, --transfers
167              Display all current uploads and downloads and exit.
168
169       --mt, --mtransfers
170              Monitor transfers
171
172       --download slsk://user/path
173              Add file or dir to the download queue
174
175       --upload slsk://user/path
176              Attempt to upload file to user
177
178       --abortup slsk://user/path
179              Abort Upload
180
181       --abortdown slsk://user/path
182              Abort Download
183
184       --removeup slsk://user/path
185              Remove Upload from queue
186
187       --removedown slsk://user/path
188              Remove Download from queue
189
190       --retryup slsk://user/path
191              Retry Upload (for remote uploads)
192
193       --retrydown slsk://user/path
194              Retry Download
195
196
197
198       -i, --interface <host:port | /socket.path>
199              Choose a different interface (saved to config file)
200
201       -p, --password <interface-password>
202              Choose a different password (saved to config file)
203
204       -v, --version
205              Display Version and exit.
206
207       -h, --help
208              Display Help and exit.
209
210

EXAMPLE

212       To run this program the standard way type:
213
214       museekcontrol
215
216       Alternativly you use a different config file with:
217
218       museekcontrol --config museekcontrol.config
219
220       To set the interface password:
221
222       museekcontrol --password 1234567890
223
224       To listen to all joined Chat Rooms:
225
226       museekcontrol --srooms
227
228       To Search Globally for "crazy pumpkin rabbits":
229
230       museekcontrol --gsearch "crazy pumpkin rabbits"
231

FILES

233        ~/.museekd/museekcontrol.config
234              The default location for the museekcontrol config file.
235

AUTHORS

237       daelstorm <daelstorm@gmail.com>
238
239       Hyriand <hyriand@thegraveyard.org>
240

SEE ALSO

242       mucous(1) mulog(1) murmur(1) muscan(1) muscand(1) museekd(1)  museeq(1)
243       musetup(1) musetup-gtk(1)
244
245
246
247daelstorm                       Release 0.1.13                MUSEEKCONTROL(1)