Man Linux: Main Page and Category List

NAME

       MuseekControl - Command-Line control Python Script for Museekd

DESCRIPTION

       MuseekControl is command-line Python script that connects to museekd(1)
       and initiates many different commands.  Chat  Room  watching,  one-time
       chat  messages,  browsing  shares,  searching,  viewing  User  info and
       setting tickers are just some of the many commands available.

       Only one museek option will work at a time. If two are  set,  the  last
       one will be used.

       Setting  the  interface  and password on the command-line is a security
       risk. Since interface and password settings are  saved  to  the  config
       file  when  set,  you  should  set  them, exit museekcontrol, and rerun
       museekcontrol without the password options on the commandline..LP

       Before running, you will need a working museekd(1)  and  need  to  know
       your  museekd  interface  and  interface password. Configure those with
       musetup(1).

SYNOPSIS

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

OPTIONS

       Museekcontrol accepts the following options:

       -c <filename>, --config <filename>
              Use a different config file.  v SEARCHING:

       --gs, --gsearch <query>
              Globally search for query & show results

       --rs, --rsearch <query>
              Room search for query & show results

       --bs, --bsearch <query>
              Buddy search for query & show results

       CHAT ROOMS:

       -r, --rooms
              Show list of rooms

       --roomlist
              Refresh list of rooms

       --joined
              Show list of Joined rooms

       --roominfo <room>
              Show users in a Joined room

       --roomsinfo
              Show users for all Joined rooms

       --sroom <room>
              Show chat log for room

       --srooms
              Show chat log for all rooms

       -j, --join <room>
              Join a room

       -l, --leave <room>
              Leave a room

       --chat <room>
              Use with --message

       -m, --message <message>
              Say message in room (Use with --chat)

       TICKERS:

       --tickers <room>
              Show tickers in room

       --alltickers
              Show tickers in all rooms

       --setticker <room>
              Pick a room to set the ticker in. (Use with --message)

       --settempticker <room>
              Pick a room for a temporary ticker (Use with --message)

       --setdefaultticker
              Set the default ticker for all room (Use with --message)

       -m, --message <message>
              Set the ticker to this.

       PRIVATE CHAT:

       --sprivate <user>
              Show Private Chat log for a user

       --sprivates
              Show Private Chat logs for all users

       --pm, --private <user>
              Say message in PM (Use with --message)

       -m, --message <message>
              Say message in PM (Use with --pm)

       USERS:

       --buddy --unbuddy <user>
              Add/Remove user from Buddies list

       --ignore --unignore <user>
              Add/Remove user from Ignore list

       --ban --unban <user>
              Add/Remove user from Banned list

       --trust --distrust <user>
              Add/Remove user from Trusted list

       --comment <string>
              Comment for the user in list

       USERINFO:

       --info <user>
              Show a user’s info  (Saves image to <user>.img if available)

       --minfo
              Monitor all User Info

       --ip <user>
              Get a user’s IP and Port
                      BROWSING:

       -b. --browse <user>
              Get a user’s shares and show them

       --mb, --mbrowse
              Monitor browsing

                      TRANSFERS:

       -t, --transfers
              Display all current uploads and downloads and exit.

       --mt, --mtransfers
              Monitor transfers

       --download slsk://user/path
              Add file or dir to the download queue

       --upload slsk://user/path
              Attempt to upload file to user

       --abortup slsk://user/path
              Abort Upload

       --abortdown slsk://user/path
              Abort Download

       --removeup slsk://user/path
              Remove Upload from queue

       --removedown slsk://user/path
              Remove Download from queue

       --retryup slsk://user/path
              Retry Upload (for remote uploads)

       --retrydown slsk://user/path
              Retry Download

       -i, --interface <host:port | /socket.path>
              Choose a different interface (saved to config file)

       -p, --password <interface-password>
              Choose a different password (saved to config file)

       -v, --version
              Display Version and exit.

       -h, --help
              Display Help and exit.

EXAMPLE

       To run this program the standard way type:

       museekcontrol

       Alternativly you use a different config file with:

       museekcontrol --config museekcontrol.config

       To set the interface password:

       museekcontrol --password 1234567890

       To listen to all joined Chat Rooms:

       museekcontrol --srooms

       To Search Globally for "crazy pumpkin rabbits":

       museekcontrol --gsearch "crazy pumpkin rabbits"

FILES

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

AUTHORS

       daelstorm <daelstorm@gmail.com>

       Hyriand <hyriand@thegraveyard.org>

SEE ALSO

       mucous(1) mulog(1) murmur(1) muscan(1) muscand(1) museekd(1)  museeq(1)
       musetup(1) musetup-gtk(1)