This page explains how to get the config files for using the T2 audio device, which allows use of the 3.5mm headphone port, the built in speakers, the built in mic and the headphones' mic.
Firstly, check whether you are using an updated
apple-bce version by running
sed -n "s/.*\(AppleT2.*\) -.*/\1/p" /proc/asound/cards. If the output is
N is a number), then this guide can be followed. If it's just
AppleT2, then either update the driver first or follow the older version of this guide.
If there is no output at all, follow the instructions on how to setup the BCE module.
Enable Pass-Through Kernel Parameters¶
cat /proc/cmdline and ensure that your kernel parameters contain
intel_iommu=on iommu=pt pcie_ports=compat.
If not present, you'll have to update your bootup kernel params:
intel_iommu=on iommu=pt pcie_ports=compat
- Apply your edits by running
sudo update-grubon ubuntu or
sudo grub-mkconfig -o /boot/grub/grub.cfgfor other distros
- Note that,
grub's command line interface names might differ on different distros, if the commands like
grub-xxxare not found, try
grub2-xxxalternatives instead. For example, it should be
sudo grub2-mkconfig ...instead of
sudo grub-mkconfig ...on Fedora 36.
- Note that,
- Reboot and ensure
cat /proc/cmdlinecontains those params
If you use systemd-boot you'll instead edit your boot conf files to add
intel_iommu=on iommu=pt pcie_ports=compat to the options line. The files to edit will have the
.conf extension and be in the loader/entries/ folder on your EFI partition. This will most likely be
Audio Configuration Files¶
Simply run the following to set up audio:
sudo git clone https://github.com/kekrby/t2-better-audio.git /tmp/t2-better-audio cd /tmp/t2-better-audio ./install.sh sudo rm -r /tmp/t2-better-audio
If your distro uses PulseAudio by default, consider switching to PipeWire with rtkit for the best possible experience. You can still use PulseAudio but the experience will not be as smooth as PipeWire, for example you might not be able to select the speakers as the output device when headphones are plugged in.
Switching to headphones automatically
If you want headphones to be switched to automatically when they are plugged in, you should set them as the default audio sink using the settings app of your DE,
Internal microphones DSP Configuration.¶
In order adjust the microphones signal automatically, we can use the following Pipewire filterchain config:
- Some people are unable to get audio input to work. You may have to use a separate microphone.
The "Audio Volume" dialog / Audio in System Settings allow users to "Raise maximum volume", allowing to go past 100%. This does not offer a great deal of flexibility, it might work for getting acceptable recordings however.
EasyEffects with PipeWire¶
EasyEffects is a tool to control and modify audio streams when using PipeWire. Compared to the KDE approach mentioned above using input plugins like "Autogain" offers a lot more fine grain control and higher volume boosts.
All of apple's fancy tuning of the speakers is done in macOS, but a similar configuration is currently available for only the MacBook Pro 16 inch 2019.
MacBook Pro 16" 2019¶
Currently we have an experimental DSP (Digital Signal Processing) config for MacBook Pro 16" 2019 with 6 speakers. Note that each model needs specific settings. Do not use it with other models as it could damage the speakers. Also do not expect same sound quality as in macOS.