fixed it once?

Run it
again.

Name: Runbook
Author: MHD

Markdown notes with shell cells you can run. Write the fix down once, then press play next time.

Free · MIT licence · x86-64

runbook. Shell ready

~/Runbooks

Welcome.md

fix-audio.md

renew-tls.md

new-laptop.md

Fix audio after a kernel update

Restart the user audio stack, then check which sink came back.

systemctl --user restart pipewire

pactl get-default-sink

alsa_output.pci-0000_00_1f.3.analog-stereo

// how it works

A real terminal, inside your notes.

A cd or an export still holds in the next cell.

cd ~/Runbooks

exit 0

pwd

exit 0

/home/you/Runbooks

Type a sudo password or a [Y/n] straight into the output.

sudo apt upgrade

exit 0

[sudo] password for you: ••••••••
Do you want to continue? [Y/n] y
0 upgraded, 0 newly installed.

Runbooks are .md files in a folder, ready for git.

git log --oneline -2

exit 0

a1b2c3d Fix audio after a kernel update9f8e7d6 Renew the TLS certificate

Free, for x86-64: Ubuntu 24.04 or newer, Debian, and other distributions.

Ubuntu and Debian Recommended

.deb package

Then install it from your Downloads folder:

sudo apt install ./runbook-amd64.deb

Other Linux

.AppImage, no install needed

Make it executable, then run it:

chmod +x runbook-*.AppImage && ./runbook-*.AppImage