Giter VIP home page Giter VIP logo

freebsd-dsbmixer's Introduction

DSBMixer - a tabbed Qt mixer application for FreeBSD

About

DSBMixer is a tabbed Qt mixer for FreeBSD. For each installed mixer device, DSBMixer opens a tab. It allows you to configure various sound settings, such as amplification, recording sources, or the default audio device. If built with devd support, tabs are created/removed automatically when a (USB) sound card was added to/removed from the system.

Main window

Installation

Building from Source

Getting the Source Code

# git clone https://github.com/mrclksr/DSBMixer.git
# git clone https://github.com/mrclksr/dsbcfg.git

Building and Installation

# cd DSBMixer && qmake
# make && make install

or if you don’t want devd support:

# make -DWITHOUT_DEVD && make install

Installing via pkg(8)

# pkg install dsbmixer

Installing from the FreeBSD Ports

# cd /usr/ports/audio/dsbmixer
# make install distclean

Usage

The Main Window

The main window consists of zero or more tabs, one for each installed sound card. You can switch between tabs by pressing Alt+n (n = 1, 2, …​, 9. n = 0 for the last tab). The master volume (Vol) of the active tab is indicated by the tray icon.

Main window
Figure 1. Main window

Uni-Channel View

By default, DSBMixer uses a single slider for each mixer device. Its value is the mean of both channels. If you increase the value by n, each channel is increase by a number ≤ n, such that its value is ≤ 100.

Example 1. Increasing left and right channel values

left channel = 97, right channel = 98. After increasing the value by 3, left channel is 100, and right channel is 100.

Example 2. Increasing left and right channel values

left channel = 42, right channel = 12. After increasing the value by 3, left channel is 45, and right channel is 15

Example 3. Increasing left and right channel values

left channel = 100, right channel = 12. After increasing the value by 3, left channel remains 100, and right channel is 15

Decreasing the channel value works accordingly.

Left and Right Channel View

Open the Preferences window under FilePreferences, and enable Show left and right channel in the View tab, and click Ok.

mainwin lr
Figure 2. Left and Right Channel View

This view allows you to separately change the left and right channel. If you check the lock symbol between them, both channel values are equally increased (decreased) if one of them is increased (decreased). That is, their difference is constant.

Adding and Removing Recording Sources

Mixer devices capable of recording are indicated by a microphone icon and a checkbox above the slider. The checkbox lets you add (remove) the mixer device to (from) the set of recording sources.

ℹ️

Usually, you can not remove all recording sources. There must be at least one.

The Tray Icon

The tray icon indicates the master volume (Vol) of the active device tab. The icon shows four states

  • muted

  • low

  • medium

  • high

Hovering over the tray icon will open a tool tip which shows the current master volume in percent. If not configured to show the left and right channel separately, the displayed volume is the mean of both channels. The master volume can be increased/decreased by scrolling up/down on the tray icon. If possible, both channel volumes are equally increase/decreased.

tray slider
Figure 3. Changing the master volume via tray icon

Left-clicking on the tray icon will show/hide the main window.

Right-clicking will show the tray icon’s context menu.

tray menu
Figure 4. Tray icon context menu

If you click on one of the listed devices, it will become the active device. That is, scrolling on the tray icon will change this device’s master volume. The active device is greyed out in the menu. The asterisk (*) marks the default device.

Tray Icon Theme

You can change the icon theme for the tray icon under FilePreferencesView

The Preferences Window

You can open the Preferences by FilePreferences

Default Device Tab

The Default device tab allows you to set the default audio device. This is the device where applications send their audio data to if not configured otherwise. If you press the Test sound button, the command besides is executed. By default, this sends random bytes from /dev/random to the selected sound card which produces some nasty white noise. If you can hear it, press Ok to make the selected sound card the default.

💡

You can change the test command to something that plays an audio file. Clicking on Ok makes this the default test command.

prefs default
Figure 5. Changing the default audio device
ℹ️

Audio applications must be restarted to use the new default device.

💡

When the default audio device was changed either through DSBMixer or other means, DSBMixer can restart sound daemons like sndiod and pulseaudio for you.

restart
Figure 6. Restarting the pulseaudio daemon via DSBMixer

The Advanced Settings Tab

The Advanced tab allows you to configure various sound settings.

prefs advanced
Figure 7. Advanced sound settings
Amplification

Lower values mean more amplification, but can produce sound clipping when chosen too low. Higher values mean finer volume control.

Sample rate converter quality

Higher values mean better sample rate conversion, but more memory and CPU usage.

Max. auto VCHANS

Defines the max. number of virtual playback and recording channels that can be created. Virtual channels allow programs to use more playback and recording channels than the physical hardware provides.

Latency (0 low, 10 high)

Higher values mean better sample rate conversion, but more memory and CPU usage.

Bypass mixer

Enable this to allow applications to use their own existing mixer logic to control their own channel volume.

Command-line

Usage

dsbmixer [-i]

Options

-i

Start DSBMixer as tray icon

Development

Contributing Translations

Available Translations

  • French

  • German

Instructions

Let’s say you want to add translations for Russian, you can proceed as follows:

  1. Create a fork of this repo, and clone it:

    % git clone url-of-your-fork
  2. Install devel/qt5-linguist and devel/qt5-linguisttools

  3. cd to your-forked-dsbmixer-dir

  4. Add locale/$${PROGRAM}_ru.ts to TRANSLATIONS in dsbmixer.pro.

  5. Execute lupdate dsbmixer.pro

  6. Run linguist locale/dsbmixer_ru.ts

  7. Add the file to the repo: git add locale/dsbmixer_ru.ts

  8. Commit: git commit -am 'Add Russian translations.'

  9. Send a pull request.

Configuring the Look and Behavior of Qt5 Applications

If you are not using KDE or GNOME, there are two ways to control the appearance of Qt5 applications:

qt5ct and the Kvantum Theme Engine

qt5ct

qt5ct is a tool that allows you to configure themes, fonts, and icons of Qt5 applications. It can be installed via pkg

# pkg install qt5ct

or via the FreeBSD ports:

# cd /usr/ports/misc/qt5ct
# make install

In order to make Qt5 applications use qt5ct, add the line export QT_QPA_PLATFORMTHEME=qt5ct to one of the following files, depending on how you start your X session:

Table 1. Session Files
X Session Start Method File

SliM, startx, xinit

~/.xinitrc

GDM, LightDM, LXDM, SDDM

~/.xprofile

WDM, XDM

~/.xsession

Alternatively, you can add the line to your window manager’s startup script, or, if you are using a Bourne shell compatible login shell, to your ~/.profile.

After loggin out and in again, proceed with the next section.

Kvantum

Kvantum is a SVG-based theme engine for Qt, KDE and LXQt. Install it via pkg:

# pkg install Kvantum-qt5

or via the FreeBSD ports:

# cd /usr/ports/x11-themes/Kvantum
# make install distclean

Start qt5ct and choose kvantum under AppeareanceStyle, and press Ok.

💡

You can use Kvantum directly without qt5ct by setting QT_STYLE_OVERRIDE=kvantum. Note, however, that the Kvantum Manager lacks the ability to change fonts and the icon theme.

Now you can start kvantummanager to set, install and configure themes.

💡

You can download Kvantum themes from KDE Store. Unpack them, and use the Kvantum Manager to install new themes.

Qt5-style-plugins

Qt5-style-plugins is a theme engine which allows using GTK-2 themes with Qt5 applications. Install it via pkg

# pkg install qt5-style-plugins

or via the FreeBSD ports

# cd /usr/ports/x11-themes/qt5-style-plugins
# make install distclean

In order to make Qt5 applications use qt5-style-plugins, add the line export QT_QPA_PLATFORMTHEME=gtk2 to one of the following files, depending on how you start your X session:

Table 2. Session Files
X Session Start Method File

SliM, startx, xinit

~/.xinitrc

GDM, LightDM, LXDM, SDDM

~/.xprofile

WDM, XDM

~/.xsession

Alternatively, you can add the line to your window manager’s startup script, or, if you are using a Bourne shell compatible login shell, to your ~/.profile.

After loggin out and in again, your Qt5 applications should look like your GTK applications.

freebsd-dsbmixer's People

Contributors

mrclksr avatar bittin avatar bsdlme avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.