Iain Samuel McLean Elder's dotfiles for Ubuntu 20.04.
Based on Victoria Drake's dotfiles, and slowly evolving into its own thing.
The program installer scripts assume the existence of sudo and may invoke it to do things that require root on the desktop, such as installing apt packages.
The scripts are tested in an Ubuntu container that lacks a non-root login and sudo.
We fix the missing sudo by installing it before running a script to prepare the Docker environment.
This same technique is used in each Github Actions workflow.
To test a script locally in a prepared Docker environment, use the test_local.bash script.
./test_local.bash scripts/install_programs.bashRun test_local.bash without arguments to prepare the Docker environment and start an interactive shell for experimenting.
./test_local.bashTo test the transition to Ubuntu 22, use test_local_22.bash in the same way.
Each installer script is tested with a CI workflow.
Each workflow prepares the Ubuntu container as in the development environment, runs the installer, and then runs the installer again to test idempotency.
A workflow for each installer can be generated automatically from a template.
To generate the workflow for all installers, use the generate_ci.bash script.
./generate_ci.bashYou should regenerate the workflows after either changing the template or adding a new installer script.
Push the result to Github to run the workflow using Github Actions.
git add .github/workflow
git commit
git pushSometimes I forget to set a name for the new workflow when I copy from an existing one. See docs to fix a duplicate workflow name. This check should be automated, but it's quicker just to fix it when it is noticed.
Many of the installers make an API call to GitHub Releases.
In 2023, I added so many such installers that CI for GitHub-distributed programs would intermittently fail.
When I stumbled across deb-get, which needed to solve the same problem, I discovered the solution.
The GitHub REST API limits unauthenticated requests to 60 per hour per IP address.
It limits authenticated requests to 5000 per hour per user.
To authenicate as a user, include a personal access token in the request.
Many of the installers use curl to call the GitHub API, and I don't want to rewrite them all to handle the authentication explicitly. Instead I hook into the top level curl command with a function that injects the authentication details via a .netrc file. Dino Chisea's article "Do you usecurl? Stop using -u. Please use curl -n and .netrc" taught me how to do this.
pipx upgrade-all --skip taskcat
TODO: more things
AWS Session Manager Plugin
curl "https://s3.amazonaws.com/session-manager-downloads/plugin/latest/ubuntu_64bit/session-manager-plugin.deb" -o "session-manager-plugin.deb"
sudo dpkg -i session-manager-plugin.debaws-gate
https://github.com/xen0l/aws-gate/
pipx install aws-gate
Docker non-root stuff with newgrp and all that
youtube-dl:
pipx install youtube-dl
apt install ffmpeg
sox and mplayer:
https://www.unixmen.com/record-voice-ubuntu/
Zoom (these steps might not work):
wget 'https://zoom.us/client/latest/zoom_amd64.deb'
sudo apt install ./zoom_amd64.deb
DBeaver:
sudo add-apt-repository ppa:serge-rider/dbeaver-ce
Git diff-so-fancy
Install:
add-apt-repository -y ppa:aos1/diff-so-fancy
apt update
apt install -y diff-so-fancy
Config:
https://github.com/so-fancy/diff-so-fancy
git config --global color.ui true
git config --global color.diff-highlight.oldNormal "red bold"
git config --global color.diff-highlight.oldHighlight "red bold 52"
git config --global color.diff-highlight.newNormal "green bold"
git config --global color.diff-highlight.newHighlight "green bold 22"
git config --global color.diff.meta "11"
git config --global color.diff.frag "magenta bold"
git config --global color.diff.commit "yellow bold"
git config --global color.diff.old "red bold"
git config --global color.diff.new "green bold"
git config --global color.diff.whitespace "red reverse"
AWS Amplify:
Depends on Node.js 10, which is in the Ubuntu repo.
https://github.com/aws-amplify/amplify-cli
sudo apt install nodejs
sudo apt install npm
Then to finish setting up npm, allowing packages to be installed as non-root:
https://github.com/sindresorhus/guides/blob/master/npm-global-without-sudo.md
mkdir "${HOME}/.npm-packages"
npm config set prefix "${HOME}/.npm-packages"
npm install -g @aws-amplify/cli
Microsoft Teams for Linux:
https://www.microsoft.com/en-us/microsoft-teams/download-app#allDevicesSection
Clustergit
cd ~/Repos
git clone git@github.com:mnagel/clustergit.git
ln ~/Repos/clustergit/clustergit ~/.local/bin/clustergit
Follow these instructions when prompted by the installer script.
Enter a passsword for secure boot. You don't need to save this in 1 Password. You just need to remember it for the coming reboot.
Restart Ubuntu.
Choose "Enrol MOK".
Choose "Key 0".
Enter the password for secure boot again.
Restart again.
Wait for Ubuntu to boot.
Set up Virtualbox with a virtual machine and launch.
Confirm that Virtualbox can launch a virtual machine.
For PSI exam software.
Download the Extension Pack linked here:
https://www.virtualbox.org/wiki/Downloads
Start VirtualBox.
Add the extension pack (File > Preferences > Extensions > Add new package).
Follow the instructions to install it.
Use VBoxManage to check available webcams.
$ VBoxManage list webcams
Video Input Devices: 2
.1 "Integrated Camera: Integrated C"
/dev/video0
.2 "Integrated Camera: Integrated C"
/dev/video1
https://www.virtualbox.org/manual/ch01.html#intro-installing
https://www.virtualbox.org/manual/ch09.html#webcam-passthrough
https://scribles.net/using-webcam-in-virtualbox-guest-os-on-windows-host/
Like macOS Time Machine.
https://rastersoft.com/programas/cronopete.html
Microsoft Teams Preview for Linux is sadly quite flaky.
Teams calls on the web version work only in Chrome.
https://linuxize.com/post/how-to-install-google-chrome-web-browser-on-ubuntu-20-04/
wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb
sudo apt install ./google-chrome-stable_current_amd64.deb
cat /etc/apt/sources.list.d/google-chrome.list
To avoid Archive Manager’s Parsing Filters is Unsupported Message.
sudo apt install unrarsudo add-apt-repository ppa:ng-hong-quan/ppa
sudo apt update
sudo apt install cobanghttps://openrazer.github.io/#download
sudo add-apt-repository ppa:openrazer/stable
sudo apt update
sudo apt install openrazer-metahttps://launchpad.net/~audio-recorder/+archive/ubuntu/ppa
sudo add-apt-repository ppa:audio-recorder/ppa
sudo apt-get -y update
sudo apt-get install --reinstall audio-recorder
https://github.com/RocketChat/Rocket.Chat.Electron/releases
Download and install the latest .deb package.
Install and run in one terminal:
pipx install mitmproxy
mitmproxy
Running generates a certificate. Test it first with curl.
curl --proxy 127.0.0.1:8080 --cacert ~/.mitmproxy/mitmproxy-ca-cert.pem https://example.com/
If that works then install it globally:
sudo mv ~/.mitmproxy/mitmproxy-ca-cert.pem /usr/local/share/ca-certificates/mitmproxy.crt
sudo update-ca-certificates
Install certificate in Firefox as well because it does not use the the OS root certificates.
https://linuxconfig.org/how-to-install-steam-on-ubuntu-20-04-focal-fossa-linux
sudo add-apt-repository multiverse
sudo apt update
sudo apt install steamInstall these extensions for Visual Studio Code:
- Cfn-Nag Linter
- CloudFormation Linter
- AWS CloudFormation Resource Provider Schema Linter
Paxmod is a Firefox add-on for multiple tab rows and dynamic, site-dependent tab colors.
Needs Firefox Developer version to work.
https://www.maartenbaert.be/simplescreenrecorder/
It's in the Ubuntu repo, but it might be out of date. If so:
sudo apt-add-repository ppa:maarten-baert/simplescreenrecorder
sudo apt-get update
sudo apt-get install simplescreenrecorderTo compress a recording (half the audio channels, audio samples, video height and video width) and use a common format:
ffmpeg -i simplescreenrecorder-*.mkv -ar 24000 -ac 1 -vf:scale=960:540 output.mkv