0.4.0 Jun 20, 2021
0.3.1 Apr 8, 2021
0.3.0 Dec 26, 2020

#10 in #mumble

MIT license

56KB
1.5K SLoC

mum

Mumble daemon with controller (think mpd(1)/mpc(1)) written in Rust.

Building

mumd and mumctl are available on crates.io and can be installed with

$ cargo install mumd
$ cargo install mumctl

They are also available on the AUR. Thirdly, we publish compiled binaries on Github.

Requirements

These are for Arch Linux. You might need other packages on other distributions and operating systems, or they might be named something different.

  • rust (stable 1.53)
  • alsa-lib
  • openssl
  • opus
  • libnotify (optional, needed in default configuration)

Windows is not currently supported but could be in the future. macOS should work. Other operating systems haven't been tested. The limiting factor on Windows is IPC communication which is (currently) done via the crate ipc-channel.

We only "guarantee" compilation on latest Rust stable. Open a ticket if this is an issue for you and we'll see what we can do.

Installation

  1. Build the binaries
  2. (wait)
  3. Copy/symlink to somewhere nice (or don't).
$ cargo build --release
$ ln -s $PWD/target/release/mumctl $HOME/.local/bin/
$ ln -s $PWD/target/release/mumd $HOME/.local/bin/

Optional features

mum contains optional features that are enabled by default. To compile without them, build with --no-default-features. Features can then be enabled with --features "FEATURES".

The following features can be specified:

| Name | Needed for | |--------------------+--------------------| | mumd/notifications | Notifications | | mumd/ogg | .ogg sound effects |

If you're using Cargo 1.51 or later you can specify features directly from the workspace root:

$ cargo build [--release] --no-default-features

Older versions need to build the packages separately:

$ cd mumd
$ cargo build --release --no-default-features
$ cd ../mumctl
$ cargo build --release --no-default-features  # technically unneeded
                                               # since no features exist

man-pages

Man-pages for mumd, mumctl and mumdrc (the configuration file) are included as both asciidoc txt-files and already formatted groff-files. They are generated with

$ asciidoctor -b manpage *.txt

Usage

This describes how to connect to a server and join different channels. See $ mumctl --help or documentation/*.txt for more information.

mumd

Start the daemon with mumd. Currently it attaches to the terminal, so if you want to run it in the background you can detach it with e.g. (zsh):

$ mumd &>/dev/null &|

Somewhere down the line we're aiming to have a --daemonize.

mumctl

Interfacing with the daemon is done through mumctl. Some examples:

$ mumctl connect 127.0.0.1 spock # connect to 127.0.0.1 with username 'spock'
$ mumctl channel list
ServerRoot
  -user1
  -user2
  -user2
  Channel2
  Channel3
$ mumctl channel connect Channel2

Known issues

The main hub for issues is our issue tracker. Additionally, there are some features that aren't present on the issue tracker:

Why?

Mostly because it's a fun way of learning a new language. Also:

  • Most mumble clients use a GUI. While GUIs aren't necessarily bad, there should at least exist alternatives where possible.
  • Memory, disk and CPU usage. We haven't found a reliable way of testing this yet (suggestions welcome).

Other projects

Dependencies

~4–15MB
~128K SLoC