Skip to content

iainelder/dotfiles

 
 

Repository files navigation

Dotfiles for Ubuntu 💜

Iain Samuel McLean Elder's dotfiles for Ubuntu 20.04.

Based on Victoria Drake's dotfiles, and slowly evolving into its own thing.

Devopment environment for Github actions

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.bash

Run test_local.bash without arguments to prepare the Docker environment and start an interactive shell for experimenting.

./test_local.bash

To test the transition to Ubuntu 22, use test_local_22.bash in the same way.

Continuous integration (CI) with Github Actions

A generic CI workflow tests each installer. It prepares the Ubuntu container as in the development environment, runs the installer, and then runs the installer again to test idempotency.

A helper workflow is scheduled once a day to test all installers.

Another helper workflow detects changes and tests any changed installers.

A generic workflow detects prepares the Ubuntu container as in the development environment, runs the installer, and then runs the installer again to test idempotency.

Duplicate workflow names

Sometimes 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.

GitHub API limit

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.

To upgrade after installing

pipx upgrade-all --skip taskcat

TODO: more things

To be added to install.sh

AWS Session Manager Plugin

https://docs.aws.amazon.com/systems-manager/latest/userguide/session-manager-working-with-install-plugin.html

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.deb

aws-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

so-fancy/diff-so-fancy#383

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 [email protected]:mnagel/clustergit.git
ln ~/Repos/clustergit/clustergit ~/.local/bin/clustergit

Virtualbox

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.

VirtualBox Webcam Passthrough

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/

Cronopete

Like macOS Time Machine.

https://rastersoft.com/programas/cronopete.html

Chrome

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

Unrar

To avoid Archive Manager’s Parsing Filters is Unsupported Message.

sudo apt install unrar

Cobang QR Reader

sudo add-apt-repository ppa:ng-hong-quan/ppa
sudo apt update
sudo apt install cobang

OpenRazer

https://openrazer.github.io/#download

sudo add-apt-repository ppa:openrazer/stable
sudo apt update
sudo apt install openrazer-meta

Audio Recorder

https://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

RocketChat

https://github.com/RocketChat/Rocket.Chat.Electron/releases

Download and install the latest .deb package.

mitmproxy

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.

Steam

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 steam

VS Code Extensions

Install these extensions for Visual Studio Code:

  • Cfn-Nag Linter
  • CloudFormation Linter
  • AWS CloudFormation Resource Provider Schema Linter

Paxmod

Paxmod is a Firefox add-on for multiple tab rows and dynamic, site-dependent tab colors.

Needs Firefox Developer version to work.

Simple Screen Recorder

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 simplescreenrecorder

To 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

Packages

No packages published

Languages

  • Shell 98.6%
  • Python 1.4%