envy24control(1)

💖 envy24control — the manual page, but make it make sense 💖

okay bestie, gather round, because today we're talking about envy24control, which is a GUI control tool for Envy24 (ice1712) based soundcards, under ALSA. that's the whole name section, you're welcome, periodt. 👑

✨ SYNOPSIS ✨

envy24control [-c card-number] [-D control-name] [-o 0-num DACs max 8]
[-i 0-num ADCs max 8] [-p 0-8] [-s 0-2] [-f <profiles file name>] [-v]
[<profile number>|<profile name>] [-m midi-channel] [-M] [-w
window-width] [-t 0-9]

like yes, it's a lot of little flags, but every single one of them is your friend. 🫶

🌸 DESCRIPTION 🌸

so envy24control lets you control the digital mixer, the channel gains and other hardware settings for sound cards that are based on the ice1712 chipset — that's the Midiman Delta series, and the Terratec EWS and EWX series, iykyk.

and as if that wasn't already iconic, it ALSO displays a level meter for every input and output channel. it's giving "I do it all and I do it cute." ✨

🎀 INVOKING 🎀

envy24control [-c card-number] [-D control-name] [-o 0-num DACs max 8]
[-i 0-num ADCs max 8] [-p 0-8] [-s 0-2] [-f <profiles file name>] [-v]
[<profile number>|<profile name>] [-m midi-channel] [-M] [-w
window-width] [-t 0-9]

if you don't hand it a control-name, then it just goes ahead and uses the first sound card. simple as that, no drama. 💅

🔥 Options 🔥

• -c card-number — use the card that card-number points at, instead of just grabbing the first card. lowkey this is exactly the same as saying -Dhw:n, where n is that card number. two paths, one destination, we love a shortcut. 💖
• -D control-name — use the card that control-name points at instead of the first card. normally this looks like hw:n, where n is the sound card number (and it's zero-based, so the first one is 0, not 1 — don't come for me, that's just how it is). you only need this if you have more than one Envy24-based card, or if your Envy24 card is not configured as the first card in your ALSA driver setup. multiple soundcards? main character problems, bestie. 😭
• -o outputs — limit how many analog line outputs get displayed. the default is however many DACs the driver specification says, and the maximum is 8. heads up: you can only reduce the number of analog output lines from whatever's actually available — you can't manifest extra ones, sorry. 🙈
• -i inputs — limit how many analog line inputs get displayed. default is the number of ADCs in the driver specification, max is 8 again. same deal as above: the analog input lines can only be reduced from the available number of input lines. the vibes can expand, the channel count cannot. 💀
• -p pcm outputs — limit how many PCM outputs get displayed. default is 8.
• -s spdif inputs/outputs — limit how many SPDIF inputs/outputs get displayed. default is 2. cute and cozy.
• -f name and path of the profiles file name. — this is where envy24control reads from and writes to the alsactl settings. if you don't give it one, it uses DEFAULT_PROFILERC — or, for restore, if DEFAULT_PROFILERC doesn't exist, it falls back to SYS_PROFILERC. yes the option description really is written like that, we keep the lore intact. 🍓
• -v — view the spdif playback channels in the mixer. but listen, bestie: it is NOT possible to manage anything here — no muting, no volume levels, none of it. it's only to view the levelmeters. the default is no view of spdif playback channels in the mixer. it's giving "look, don't touch." 👀
• -m midi-channel — use MIDI controller values to control the Faders in the mixer view. the app will react to controllers on channel midi-channel, and it sends controllers on this channel whenever you move the GUI sliders. so it goes both ways, it's a whole conversation. 🦋
• -M — use an enhanced mapping from midi controller values to db sliders. glow up for your mappings, fr fr.
• -w window-width — set the initial width of the envy24control window. if you use a window-width in the range 0-20, that's approx the number of mixer channels visible. anything >20 gets interpreted as screen pixels instead. two units in one flag, iconic behavior honestly. ✨
• -t tall-equal mixer heights — -t 1 enlarges the channel mixers to the same height as the digital mixer. with values >1 the height of all mixers is increased in stages. -t 0 is the default, and that one's set for minimum window height. short king default, tall king when you ask. 👑

🌈 SEE ALSO 🌈

alsamixer(1), amixer(1), gamix(1)

go read those too, they're the rest of the friend group. 🫶

💜 AUTHOR 💜

envy24control is by Jaroslav Kysela <perex@perex.cz>

this document is by James Tappin <james@xena.uklinux.net>

updated by Dirk Kalis <dirk.kalis@t-online.de>

and the options -w and -t were added by Alan Horstmann <gineera@aspect135.co.uk>

and that's the whole page, bestie — no cap, that's every last flag and footnote. this iconic little writeup is dated 30 July 2005, and it lives in the envy24control(1) manual. slay, go mix something. 💅🎀✨