Skip to content

Commit cfe5742

Browse files
author
Alexia Michelle
committed
feat: Add goldendog installation guide for Intel Macbooks, including an audio workaround, in English and Spanish.
1 parent 6ac6836 commit cfe5742

2 files changed

Lines changed: 92 additions & 0 deletions

File tree

Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,46 @@
1+
---
2+
sidebar_position: 4
3+
---
4+
5+
# Installing goldendog on a macbook
6+
7+
This guide is aimed at Intel Macbooks.
8+
9+
The installation process is similar to installing goldendog on any Intel/AMD machines. After installation, some users report that the audio speakers of the Macbook produce no sound.
10+
11+
## Audio Workaround
12+
13+
A workaround to get the audio working on goldendog installed on Apple Macbook Intel hardware is the following:
14+
15+
1. Open the terminal and type:
16+
```bash
17+
sudo apt update
18+
sudo apt install linux-headers-amd64 # installs goldendog/trixie metapackage for the linux headers
19+
sudo apt install dkms # installs dkms
20+
```
21+
22+
2. Clone the audio driver repository:
23+
```bash
24+
git clone https://github.com/leifliddy/macbook12-audio-driver
25+
cd macbook12-audio-driver
26+
```
27+
28+
3. Obtain the kernel number:
29+
```bash
30+
uname -r
31+
```
32+
33+
4. If the kernel is `6.12.57`, run the installation script:
34+
```bash
35+
sudo bash install.cirrus.driver.sh -k 6.12.57
36+
```
37+
*(Note: Replace `6.12.57` with your actual kernel version obtained in the previous step.)*
38+
39+
The new driver should be compiled and audio should play normally.
40+
41+
## Verification
42+
43+
To verify that the driver is loaded:
44+
```bash
45+
sudo lsmod | grep -ia cirrus
46+
```
Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,46 @@
1+
---
2+
sidebar_position: 4
3+
---
4+
5+
# Instalando goldendog en una macbook
6+
7+
Esta guía está dirigida a las macbooks Intel.
8+
9+
El proceso de instalación es similar a la instalación de goldendog en cualquier máquina Intel/AMD. Después de la instalación, algunos usuarios informan que los altavoces de la macbook no producen sonido.
10+
11+
## Solución para el Audio
12+
13+
Una solución para que el audio funcione en goldendog instalado en hardware Intel de Apple macbook es la siguiente:
14+
15+
1. Abra la terminal y escriba:
16+
```bash
17+
sudo apt update
18+
sudo apt install linux-headers-amd64 # instala el metapaquete goldendog/trixie para las cabeceras de linux
19+
sudo apt install dkms # instala dkms
20+
```
21+
22+
2. Clone el repositorio del controlador de audio:
23+
```bash
24+
git clone https://github.com/leifliddy/macbook12-audio-driver
25+
cd macbook12-audio-driver
26+
```
27+
28+
3. Obtenga el número del kernel:
29+
```bash
30+
uname -r
31+
```
32+
33+
4. Si el kernel es `6.12.57`, ejecute el script de instalación:
34+
```bash
35+
sudo bash install.cirrus.driver.sh -k 6.12.57
36+
```
37+
*(Nota: Reemplace `6.12.57` con su versión real del kernel obtenida en el paso anterior.)*
38+
39+
El nuevo controlador debería compilarse y el audio debería reproducirse con normalidad.
40+
41+
## Verificación
42+
43+
Para verificar que el controlador esté cargado:
44+
```bash
45+
sudo lsmod | grep -ia cirrus
46+
```

0 commit comments

Comments
 (0)