"Fossies" - the Fresh Open Source Software Archive

Member "mumble-1.3.2/README.static.osx" (9 Jul 2020, 4105 Bytes) of package /linux/misc/mumble-1.3.2.tar.gz:


As a special service "Fossies" has tried to format the requested text file into HTML format (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file.

    1          M U M B L E
    2 
    3  A voicechat utility for gamers
    4 
    5       http://mumble.info/
    6 
    7       #mumble on freenode
    8 
    9 
   10 What is Murmur?
   11 ===============
   12 
   13 Murmur is the server component of Mumble, an open-source voice chat utility.
   14 
   15 This package is a statically compiled version of Murmur for OS X.
   16 
   17 
   18 Running Murmur
   19 ==============
   20 
   21 In this build of Murmur, the binary is called 'murmurd'. To get Murmur
   22 up and running, simply execute the following command at your shell:
   23 
   24  $ ./murmurd -fg -ini murmur.ini
   25 
   26 This will spawn a foregrounded (Murmur will, by default, run in daemon mode,
   27 which means it will launch itself as a background process on your system).
   28 
   29 
   30 The First Run
   31 =============
   32 
   33 When Murmur runs for the first time, it performs a few special initialization
   34 steps, such as setting up its database, as well as generating a certificate
   35 for its initial server and a password for the SuperUser user.
   36 
   37 This password is important for setting up the Murmur server, so make a note
   38 of it. It is output by the Murmur server the first time it runs, and will
   39 look something like this:
   40 
   41   <W> HH:MM:DD 1 => Password for 'SuperUser' set to '<YourSuperUserPassword>'
   42 
   43 
   44 Initial User Setup
   45 ==================
   46 
   47 Murmur has the concept of a 'SuperUser', which is the initial administrative user
   48 used to configure your server.  Typically, this user will only be used for initial
   49 setup, and in recovery situations. A regular user, with some administrative privileges
   50 is usually set up as a first step.  To do this, follow the steps below:
   51 
   52  1. In your Mumble client, ensure that you have a certificate for your user.
   53     (A certificate is generated by Mumble by default, but you can create a new
   54      one if you wish -- or use an existing S/MIME email certificate if you wish.)
   55 
   56  2. Connect to your server with the user that you wish to grant administrative
   57     privileges to. (Your username will be stored on the server when you register
   58     yourself, so pick something you'd like to keep!)
   59 
   60  3. Once connected, right click your user name in the server view and choose
   61     'Register'.  This will register your user to the server (this makes the
   62     server remember you as a user -- but you still will not have administrative
   63     privileges).
   64 
   65  4. Once registered, you can disconnect from the server.  Now it is time to
   66     connect using the SuperUser account that the server created for you
   67     when you launched it the first time.
   68 
   69     Simply specify SuperUser as your username, and the password that Murmur
   70     gave you as the password.
   71 
   72  5. After connecting as the SuperUser, right click the 'Root'-channel and
   73     choose Edit.  In the Edit dialog, click the Groups tab.
   74 
   75     In the Groups dropdown, choose the admin group.
   76 
   77     Then, under Members three lists should appear, showing Members, Excluded
   78     Members and Inherited Members. We're only interested in Members. Expand
   79     the drop down below the member list and find the username of the user
   80     you registered in step 3.
   81 
   82     Click Add to add the user to the admin group.
   83 
   84  6. Your user is now an administrator.
   85 
   86 For more advanced setup and usage of Murmur, please visit the Mumble Wiki,
   87 at http://mumble.info/. Some pages of interest are available at:
   88 
   89    http://wiki.mumble.info/wiki/Running_Murmur
   90    http://wiki.mumble.info/wiki/ACL_and_Groups
   91    http://wiki.mumble.info/wiki/Murmurguide
   92 
   93 Additional Murmur Options
   94 =========================
   95 
   96 The above instructions use a very bare-bones approach to running Murmur.
   97 Several other command line options are available. These are listed below:
   98 
   99 murmurd [-supw <password>] [-ini <inifile>] [-fg] [v]
  100 
  101 -supw   Set new password for the user SuperUser, which is hardcoded to
  102         bypass ACLs. Keep this password safe. If you use this option,
  103         Murmur will set the password in the database and then exit.
  104 
  105 -ini    Use an ini file other than murmur.ini, use this to run several
  106         instances of Murmur from the same directory. Make sure each
  107         instance is using a separate database. (Specified in the ini file.)
  108 
  109 -fg     Run in the foreground, logging to standard output.
  110 
  111 -v      More verbose logging.