Install per the manufacturer's instructions, then checkout the top tips at their community forum.

First installation notes from my AMD Ryzen 7040 Series Framework (32GB DDR5-5600, 1TB NVMe) Ubuntu 22.04 LTS:

sudo apt update && sudo apt upgrade -y
sudo apt install vim git
sudo apt install exuberant-ctags cscope moreutils

Now that you have vim and git, get your dotfiles:

git clone ssh://dblume@dlma.com/~/git/dotfiles.git
cd dotfiles
./setup.sh

Now that you can barely tolerate your terminal, get the rest:

sudo apt install tmux entr
tmux
sudo apt install curl jq tree expect gnuplot httpie visidata ripgrep at
sudo apt install python3-pip
python3 -m pip install matplotlib

Install Google Chrome.

Copy over the .ssh, .localrc, .gitconfig.local, .history files from the old computer. Export gpg keys from the old computer:

gpg -a --export david@dlma.com > david-dlma.com-public-gpg.key
gpg -a --export-secret-keys david@dlma.com > david-dlma.com-secret-gpg.key  # passphrase in secure

Once you've got them on the new computer,

gpg --import david-dlma.com-public-gpg.key
gpg --import david-dlma.com-secret-gpg.key
gpg --edit-key david@dlma.com
...
gpg> trust
Your decision? 5 (Ultimate trust)

Desktop Background: chinesemoon
User pic: magicavoxel_avatar_for_circular_apertures.png

Via an answer to "chrome does not save my passwords":

Sometimes a couple of login files get corrupt, and stop google-chrome from saving the passwords. To fix it, close google-chrome. Terminal to the following directory and remove the two files, Login Data and Login Data-journal.

cd ~/.config/google-chrome/Default
rm 'Login Data'
rm 'Login Data-journal'

Seems like I'm going to be preferring pixlr (online) or Krita (local).

After installing Krita, add a desktop launcher to make it more GNOME/rofi/drun friendly. Extract the .desktop from the appimage to $HOME/.local/share/applications or manually make a .desktop file in $HOME/.local/share/applications.

I put the krita appimage in /usr/local/bin, the .desktop in $HOME/.local/share/applications, and a 256×256 .png in /usr/share/pixmaps. The .png is untested.

First install the Powerline Font:

git clone --filter=blob:none -b master --single-branch https://github.com/powerline/fonts.git
cd fonts
./install.sh "DejaVu Sans"

Then your terminal emulator can use it.

The i3 Window Manager.

gnome-terminal won't distinguish between C-i and Tab, so install a terminal emulator that can, like Alacritty, and set TERMINAL in .bashrc for i3-sensible-terminal to use.

.config/i3/config

font pango:DejaVu Sans Mono 16
 
# bindsym all the jkl; to hjkl
 
exec --no-startup-id xss-lock --transfer-sleep-lock -- i3lock --color 101030 --nofork

Enable touchpad tap to click in i3.
xinput to find the name of the Touchpad (the id can change)
xinput list-props “PIXA3854:00 093A:0274 Touchpad” to see properties

.xsessionrc

xinput set-prop "PIXA3854:00 093A:0274 Touchpad" "libinput Tapping Enabled" 1
xinput set-prop "PIXA3854:00 093A:0274 Touchpad" "libinput Natural Scrolling Enabled" 1
xinput set-prop "PIXA3854:00 093A:0274 Touchpad" "libinput Tapping Drag Lock Enabled" 1
xinput set-prop "PIXA3854:00 093A:0274 Touchpad" "libinput Scrolling Pixel Distance" 40

From HiDPI -> X Resources: (96dpi * 1.5 = 144dpi)

.Xresources

Xft.dpi: 144

Enable Brightness Keys, Media keys, background image:

sudo apt install brightnessctl playerctl feh
sudo usermod -a -G video ${USER}
# Logout and log back in

Enable screenshots with maim and xclip

sudo apt install maim xclip

I have the ridiculously tiny font problem where a commenter suggests “set the DPI in your xorg.conf”. HOWTO set DPI in Xorg.

The tiny Wi-Fi connection dialog is Dunst which has its own config reddit thread.

I thought the media keys (Function keys) weren't working. I added “blacklist hid_sensor_hub” to framework-als-blacklist.conf for the brightness keys. (But I should undo that change and see if they still work now. Make sure the “fn” key wasn't in the other mode.)

  sudo vim /etc/modprobe.d/framework-als-blacklist.conf

Test with

pactl set-sink-volume @DEFAULT_SINK@ +10%
pactl get-sink-volume @DEFAULT_SINK@
speaker-test -t wav -c 6

Get rid of the Gnome Terminal Window bar:

$ gsettings set org.gnome.Terminal.Legacy.Settings headerbar false

Get rid of the menubar:

“Right Click for context menu” → Preferences → General → Show menubar by default in new terminals

Or, try this to get rid of the menubar

.config/gtk-3.0/settings.ini

gtk-decoration-layout=:menu

GUI: “Advanced Network Configuration”

  nm-connection-editor &

CLI:

  nmtui

A note on battery life. Frame.work batteries work best at charges between 80% and 30%. I went into BIOS (pressing F2 on start up) and set maximum charge to 90%.

Suspend worked out of the box. See This PSA from frame.work: Linux Suspend and AMD Reminder. Per that PSA and [TRACKING] Linux Battery Life tuning, I ran amd_s2idle.py. It ended with:

🚦 RTC driver `rtc_cmos` configured to use ACPI alarm
Explanations for your system
🚦 rtc_cmos is not configured to use ACPI alarm
	Some problems can occur during wakeup cycles if the HPET RTC emulation is used to
	wake systems. This can manifest in unexpected wakeups or high power consumption.

For more information on this failure see:
	https://github.com/systemd/systemd/issues/24279

So per the third link above, I added a kernel boot parameter by editing /etc/default/grub like so:

/etc/default/grub

...
GRUB_CMDLINE_LINUX_DEFAULT="quiet splash rtc_cmos.use_acpi_alarm=1"
...

And then I ran sudo update-grub per the file's instructions.

Enable suspend-then-hibernate. To hibernate, you need swap to be as big as RAM, then update GRUB. (32GiB in my case.) You may also have to disable Secure Boot.

I had a 2GiB /swapfile, and this is how I resized it:

~$ sudo swapoff /swapfile 
~$ sudo dd if=/dev/zero of=/swapfile count=32K bs=1M
...
~$ sudo mkswap /swapfile 
~$ sudo swapon /swapfile

Then it became time to update the kernel boot params again with the UUID of the volume with the swapfile, and the physical offset of the swapfile.

$ blkid
/dev/nvme0n1p2: UUID="de9f6aca-85a1-461b-b8b8-15f44441f64d" BLOCK_SIZE="4096" TYPE="ext4" PARTUUID="121db783-104a-4138-b7c2-c0451ab10454"
 
$ sudo filefrag -v /swapfile | head
Filesystem type is: ef53
File size of /swapfile is 34359738368 (8388608 blocks of 4096 bytes)
 ext:     logical_offset:        physical_offset: length:   expected: flags:
   0:        0..    2047:    1257472..   1259519:   2048:            

That means, in my case, I add this to /etc/default/grub's GRUB_CMDLINE_LINUX_DEFAULT.

resume=UUID=de9f6aca-85a1-461b-b8b8-15f44441f64d resume_offset=1257472

Don't forget to sudo update-grub.

Then I enabled this line in

/etc/systemd/logind.conf

HandleLidSwitch=suspend-then-hibernate

Everything is still commented out in /etc/systemd/sleep.conf (Also see suspend drains battery). May need to turn some of those lines on.

You can use xprop to learn the Window Class (the second value) for assigning apps to workspaces

assign[class="Rhythmbox"] $workspace10

If you keep accidentally typing Ctrl+Shift+C in Chrome, you can disable it with shortkeys extension:

Install shortkeys and set (and save) the following:

• Keyboard shortcut: ctrl+shift+c
• Behavior: Run JavaScript
• Javascript code to run: document.execCommand('copy')

Enable tap and drag lock:

gsettings set org.gnome.desktop.peripherals.touchpad tap-and-drag-lock true

Resolution: 2256 x 1504
Zoom: 125%

Terminal Font: 16pt
Chrome Zoom: 110%

Maximize To Workspace With History.

Using the fingerprint reader doesn't unlock keyring. Just use password.

How to change 2-finger touchpad scroll speed on Ubuntu 22.04. If you really want this, may have to compile libinput-config locally.