Docker documentation should be on our website (administrator/hoster documentation) or our [mumble-docker] repository.
This repository /docs/ should only contain developer documentation and scoped to this source/main project.
---
PR #5838 commit 81bb8f7 removed the docker-compose.yml file in this repository.
The `murmur.ini` reference is outdated. It was moved and renamed to `umble-server-ini`
The `database` path is outdated ('murmur' name).
---
Replaces/Closes PR #6387 which intended to fix the documentation.
[mumble-docker]: https://github.com/mumble-voip/mumble-docker/
Since the whisper cache entry was computed while holding the read-lock,
it was possible for a user in that cache to get deleted while the voice
thread drops the read lock in order to upgrade it to a write lock. In
such a case, the cache entry would contain an invalid (stale) user
pointer, which can lead to crashes when using the cache later on.
By moving the cache entry computation into the block in which we already
hold a read lock, we turn computing the cache and adding it to the cache
store into an atomic operation. As soon as the cache entry is in the
store, deleting a user is no longer an issue as that will implicitly
clear all whisper caches (thereby preventing stale cache entries).
Additionally, the cache creation has been factored out into its own function (for improved readability)
Switch to using an unsigned integer as channel ID and rename member
variables to no longer include their type as part of the name (and make
names more meaningful in general).
Additionally, some Qt containers were replaced with std ones.
Currently translated at 100.0% (2156 of 2156 strings)
TRANSLATION: Update Catalan translation
Currently translated at 100.0% (2156 of 2156 strings)
TRANSLATION: Update Catalan translation
Currently translated at 100.0% (2156 of 2156 strings)
TRANSLATION: Update Catalan translation
Currently translated at 72.4% (1562 of 2156 strings)
TRANSLATION: Update Catalan translation
Currently translated at 49.8% (1075 of 2156 strings)
Co-authored-by: Hosted Weblate <hosted@weblate.org>
Co-authored-by: Paco Rivière <paco@riviere.cat>
Translate-URL: https://hosted.weblate.org/projects/mumble/mumble-client/ca/
Translation: Mumble/Mumble Client
Previously, there was no way to move users from channel to channel
using only the keyboard. For accessibility reasons, that was not ideal.
This commit adds a new action to the user context menu allowing
to move the selected user to your own channel (given enough
permissions).
While this is a decent workaround, the end goal will be to remove
this action and replace it with a dedicated dialog to choose
the channel a user will be moved to.
See #4642
This commit changes the menu items and some buttons to
conform to universal [1] standards. This means that:
* Labels are using title case (e.g. "Listen to channel" -> "Listen To Channel")
* Menu items are generally not including the menu title in
the action label (e.g. "Join Channel" -> "Join")
* ALL menu items have non-overlapping access keys (ALT + <access key>, denoted by underline)
* Ellipses ("...") are only used for actions that require further user input,
simply opening another window is not a reason for using an ellipsis.
[1] State of the art as documented by major vendors in the consumer
software industry. For example:
https://learn.microsoft.com/en-us/windows/win32/uxguide/cmd-menushttps://developer.apple.com/design/human-interface-guidelines/menushttps://develop.kde.org/hig/components/navigation/menubar/
This commit switches the global shortcut tree to a new
MultiColumnTreeWidget and makes it keyboard navigatable.
It also makes screen readers read actual column values.
Fixes#2293
This commit switches the search result tree to a new
MultiColumnTreeWidget and makes it keyboard navigatable.
It also makes screen readers read actual column values.
This commit switches the message notification type tree to a new
MultiColumnTreeWidget and makes it keyboard navigatable.
It also makes screen readers read actual column values.
Fixes#2972
This commit switches the plugin config tree to a new
MultiColumnTreeWidget and makes it keyboard navigatable.
It also makes screen readers read actual column values.
Previously, the accessibility of the inline slider was very
limited due to the cumbersome and lacking system Qt provides.
This commit gently tricks Qt into behaving like a nice
framework in regards to accessibility.
Fixes#6109
A lot of accessible names or descriptions were either missing,
wrong or misleading.
This commit tries to unify and improve all accessible names
and descriptions
Fixes#1337
In c73f967711 accessibility names and descriptions were added to Mumble
but they were placed in code.
This commit moves all those texts into the respective .ui file where
applicable. If the accessible name is changed or calculated at runtime,
it obviously needs to still be defined in the source code.
Qt offers a feature called buddy labels. With that certain
UI elements can have a label, which represents the UI element
in a textual way. This is very important for screen readers
as they otherwise might not read the correct for any given UI element.
Adding buddies is as simple as using the "Edit buddy" dialog
in the Qt editor.
This commit sweeps through (almost) all UI elements and
applies the correct buddies where applicable.
Some screen readers (notably Orca) are either not capable
of reading semantic values for slides, or Qt prevents them
from doing so.
Sadly, the raw value of a slider e.g. in case of the voice activity
threshsold 0-32767 is pretty much entirely useless for a screen
reader user.
This commit introduces the concept of a semantic slider, which
has a separate accessible text for providing more sensible values
as well as units while still being able to pass the raw slider value
to underlying code.
For screen readers such as Orca, it is a bit hacky as it prepends
the semantic value of the slider to the accessibleName. (Orca does
not read the provided value object) But other than
that, this should work very well for almost all circumstances.
This commit switches the label in the shortcut dialog from
"Add" to "Listening to input" when the button is pressed.
This is supposed to indicate to screen readers that
the dialog is now in a different state, which is actually
listening for new key presses.
The certificate wizard shows boxes with certificate info.
These boxes are created by using labels in a QGroupBox.
However, this information is not easily readable using a
screen reader (especially Orca).
This commit introduces the AccessibleGroupBox class
which aims to solve that by dynamically setting the
accessible description using layout information of
the labels inside the box.
Fixes#1337
Previously, none of the description text of the wizard pages were read
by screen readers. (especially Orca)
To fix this, this commit will focus the dialog itself when
the page changes. This makes the screen reader read the current
page information. It also implements a new function that
finds the next focusable child and sets that in the focus
chain of the wizard as well.
Previously, the TAB focus order and focus handling in
the connection dialog was barely working.
This commit adds a manual TAB order and focus policies to
improve navigation.
Previously, there was no way to know for sure, if the currently selected
user and channel tree was being filtered. (in a screen reader context)
This commit switches the accessibleName depending on the channel filter
state.
Previously, screen readers would just read out the string of any selected
item in the tree.
With this new commit, the accessibleText and accessibleDescription are
set such that it is clear whether an item is a channel or a user and
which properties are set for both.
Fixes#2292
When clicking the "Start" button in the voice recorder dialog,
some random element receives focus automatically. Some or all
screen readers start reading the disabled options.
This commit automatically focuses the "Stop" button in the voice
recorder dialog when "Start" is clicked.
For some or all screen readers the "Next >" and "Back <" buttons
in wizards read out the ">" and "<" symbols which is rather annoying.
This commit explicitly sets the accessible name attribute such that
the buttons are read without the symbols.
Some or all screen readers are not associating the large description text
for the radio buttons in the quality page of the AudioWizard.
This commit explicitly sets the label content as the accessibleDescription
for the radio buttons.
The autocomplete function for usernames introduced in 56f5f978c
overwrites the forward-TAB accessibility behaviour. This results in
screen reader users being stuck inside the chat bar having to shift-TAB
or "back TAB" out to reach other user interface modules.
This commit changes the TAB autocomplete behaviour requiring an explicit
"@" in the chatbar for it to trigger. Otherwise it behaves as normal TAB.
See #5811
Since the whisper cache entry was computed while holding the read-lock,
it was possible for a user in that cache to get deleted while the voice
thread drops the read lock in order to upgrade it to a write lock. In
such a case, the cache entry would contain an invalid (stale) user
pointer, which can lead to crashes when using the cache later on.
By moving the cache entry computation into the block in which we already
hold a read lock, we turn computing the cache and adding it to the cache
store into an atomic operation. As soon as the cache entry is in the
store, deleting a user is no longer an issue as that will implicitly
clear all whisper caches (thereby preventing stale cache entries).
The second call to pa_context_subscribe() was overriding the first, as a result we were only receiving sink events.
This caused hotplugging to fail with devices that don't have any output ports (e.g. USB microphones).
In b5a67c0 a refactor took place which removed some compiler warnings.
In WASAPI.cpp a STACKVAR was swapped for a static std::vector,
which led to some unforeseen consequences and total audio input
failure on some systems.
This commit removes the static modifier as it is not needed there
anyway.
Fixes#6356
In 6c565689 the HostAddress was refactored. A check for isV6 when
creating a QHostAddress was removed. However, the QHostAddress
determines the (IPv4 vs IPv6) distinction at construction time.
This resulted in some regressions both visually and functional.
This commit reintroduces the distinction.
Fixes#6349
In the 'Messages' settings, when disabling a single notification method
for a single message type, all check-boxes will disappear in that
column if 'All messages' was checked to begin with. This is because the
automatic unchecking of the 'All messages' check-box is treated as
if the user actually clicked it. Using a QSignalBlocker before unchecking
the 'All messages' fixes the issue
Fixes#6302