Skip to content

morgant/xsndiomenu

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

20 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

xsndiomenu

by Morgan Aldridge morgant@makkintosshu.com

OVERVIEW

A simple menu utility to view & control sndio devices & state under OpenBSD. It is a wrapper around OpenBSD's dmesg(8), sndioctl(1), and sysctl(8) powered by xmenu.

It is intended for, but not limited to, use with the MLVWM window manager, specifically the mlvwmrc configurations, as a "Menu Extra" swallowed into the menu bar.

NOTE: This is currently a standalone X11 application and does not integrate with the system tray.

FEATURES

  • Lists all audio devices by hardware description, including:
    • Denotes which is the active audio server device
    • Supports switching active audio server device
  • For input & output:
    • Shows level (volume)
      • Supports setting level to min/max
      • Supports increasing/decreasing by 10%
    • Shows mute status
      • Supports toggling mute
  • For input, denotes whether audio recording is enabled in the kernel

Example Screenshot

Screenshot of xsndiomenu showing three audio devices (the second being the active server), output level (100%) and mute option, and input level (100%; recording disabled in the kernel) and mute option

PREREQUISITES

INSTALLATION

make install

MLVWM Menu Extra

Install the Menu Extra in your ~/.mlvwm/MenuExtras/ directory by running:

make install-mlvwmrc-menuextra

Next, edit your ~/.mlvwm/MenuBar configuration file to add the following line in the appropriate "Menu Extras" section:

Read .mlvwm/MenuExtras/xsndiomenu

Finally, restart mlvwm.

USAGE

You can manually execute xsndiomenu in any way you prefer, which will show the menu at your cursor.

If installed as an MLVWM MenuExtra, you can click the icon in your menu bar.

SIMILAR UTILITIES

You might want to check out these similar projects for controlling OpenBSD's sndiod(8) from X11:

  • sndiokeys
  • tray-app (specifically /usr/local/libexec/tray-app/sound; for use with a system tray application)

CHANGE LOG

See CHANGELOG.md for detailed version history.

LICENSE

Mark James' FamFamFam Silk Icons licensed under the Creative Commons Attribution 2.5 License.

Released under the MIT license.