Linux [wiki.dlma]

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Linux ======

Install per [[https://guides.frame.work/Guide/Ubuntu+22.04+LTS+Installation+on+the+Framework+Laptop+13/109|the manufacturer's instructions]] (for a Framework Laptop 13 DIY Edition (AMD Ryzen™ 7040 Series)), then checkout the top tips at [[https://community.frame.work/t/responded-ubuntu-22-04-on-the-framework-laptop/14238|their community forum]].

===== First Things =====

First installation notes from my AMD Ryzen 7040 Series Framework (32GB DDR5-5600, 1TB NVMe) [[https://guides.frame.work/Guide/Ubuntu+22.04+LTS+Installation+on+the+Framework+Laptop+13/109|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 [[https://github.com/dblume/dotfiles|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 [[https://www.google.com/chrome/|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 =====

Desktop Background: [[http://gallery.dlma.com/index.php/miscellaneous/chinesemoon|chinesemoon]]
User pic: [[https://dlma.com/avatars/magicavoxel_avatar_for_circular_apertures.png|magicavoxel_avatar_for_circular_apertures.png]]

===== Google Chrome Passwords and Autofill =====

Via an [[https://unix.stackexchange.com/a/606531|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'


===== Image/Photo Editors =====

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

^ App ^ Online ^ Notes ^
| -> **[[https://pixlr.com/|pixlr]]** | Online | Good  image editor. Pretty intuitive. No arrows. |
| [[https://www.photopea.com/|Photopea]] | Online | Has arrows. Width is limited to a narrow max. |
| [[https://excalidraw.com/|Excalidraw]] | Online | Pretty great diagram drawing tools. Not a photo editor, but making a note here. |
| [[https://app.diagrams.net/|app.diagrams.net / draw.io]] | Online | Quick charts, UML templates |
| **-> [[https://krita.org/en/|Krita]]** | Local | Promising image editor. Arrows in vector layer. Draw line then change properties. |
| [[https://www.gimp.org/|Gimp]] | Local | The huge standard. GNU Photoshop. More than I usually need. |
| [[https://www.pinta-project.com/|Pinta]] | Local | Inspired by an old version of Paint.NET. Installed, but unsure. Arrows are easy. |
| [[https://pixieditor.net/|Pixie]] | Local | Another DotNET image editor. |


After installing Krita, add a desktop launcher to make it more GNOME/rofi/drun friendly. [[https://amanabt.github.io/blog/tech/2022/03/11/installing-krita-from-appimage-ubuntu-20_04.html|Extract the .desktop from the appimage]] to $HOME/.local/share/applications or manually make a [[https://github.com/davatorium/rofi/issues/326#issuecomment-174301525|.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 256x256 .png in ''/usr/share/pixmaps''. The .png is untested.

===== DejaVu Sans for Powerline Font =====

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.

===== i3 =====

The [[https://i3wm.org/|i3 Window Manager]]. (Eventually consider [[https://swaywm.org/|Sway]], a tiling Wayland compositor and a drop-in replacement for i3, with no tearing problems.)

==== Install Alacritty ====

gnome-terminal won't distinguish between C-i and Tab, so [[https://www.how2shout.com/linux/how-to-install-alacritty-terminal-on-ubuntu-22-04-lts/|install a terminal emulator that can, like Alacritty]], and set TERMINAL in .bashrc for i3-sensible-terminal to use.


==== Configuration ====

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

[[https://major.io/p/tray-icons-in-i3/|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

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

From [[https://wiki.archlinux.org/title/HiDPI#X_Resources|HiDPI -> X Resources]]: (96dpi * 1.5 = 144dpi)
<file bash .Xresources>
Xft.dpi: 144
</file>

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 [[https://www.reddit.com/r/linuxmasterrace/comments/4usryc/i3_ui_and_text_ridiculously_tiny_on_fresh_arch/|ridiculously tiny font]] problem where a commenter suggests "set the DPI in your xorg.conf". [[https://linuxreviews.org/HOWTO_set_DPI_in_Xorg|HOWTO set DPI in Xorg]].

The tiny Wi-Fi connection dialog is [[https://wiki.archlinux.org/title/Dunst|Dunst]] which has its own config [[https://www.reddit.com/r/i3wm/comments/b1s18p/how_do_you_change_the_default_font_size_of/|reddit thread]].

I thought the media keys (Function keys) weren't working. I added "blacklist hid_sensor_hub" to [[https://community.frame.work/t/solved-guide-12th-gen-not-sending-xf86monbrightnessup-down/20605|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.)

<file bash>
  sudo vim /etc/modprobe.d/framework-als-blacklist.conf
</file>
Test with

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

==== Terminal Configuration ====

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

<file bash .config/gtk-3.0/settings.ini>
gtk-decoration-layout=:menu
</file>

==== Wi-Fi and Network Management ====

GUI: "Advanced Network Configuration"

    nm-connection-editor &

CLI:

    nmtui

==== Suspend and Hibernation ====

A note on battery life. Frame.work batteries work best at charges between 80% and 30%. I went into BIOS ([[https://knowledgebase.frame.work/how-do-i-enter-the-bios-on-the-framework-laptop-HydmWf5Ad|pressing F2 on start up]]) and set maximum charge to 90%.

Suspend worked out of the box. See This PSA from frame.work: [[https://www.reddit.com/r/framework/comments/19bf3ki/linux_suspend_and_amd_reminder/|Linux Suspend and AMD Reminder]]. Per that PSA and [[https://community.frame.work/t/tracking-linux-battery-life-tuning/6665/536|[TRACKING] Linux Battery Life tuning]], I ran [[https://gitlab.freedesktop.org/drm/amd/-/blob/master/scripts/amd_s2idle.py?ref_type=heads|amd_s2idle.py]]. It ended with:
<code>
🚦 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
</code>
So per the third link above, I [[https://askubuntu.com/questions/19486/how-do-i-add-a-kernel-boot-parameter|added a kernel boot parameter]] by editing /etc/default/grub like so:
<file bash /etc/default/grub>
...
GRUB_CMDLINE_LINUX_DEFAULT="quiet splash rtc_cmos.use_acpi_alarm=1"
...
</file>
And then I ran ''sudo update-grub'' per the file's instructions.

Enable suspend-then-hibernate. To hibernate, [[https://community.frame.work/t/hibernation-using-it/6060/11|you need swap to be as big as RAM, then update GRUB]]. (32GiB in my case.) You may also have to [[https://community.frame.work/t/battery-drain-on-suspend-sleep-with-linux/42395/4?u=david_blume|disable Secure Boot]].

I had a 2GiB /swapfile, and this is how I resized it:
<code bash>
~$ sudo swapoff /swapfile 
~$ sudo dd if=/dev/zero of=/swapfile count=32K bs=1M
...
~$ sudo mkswap /swapfile 
~$ sudo swapon /swapfile
</code>
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.
<code bash>
$ 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:            
</code>
That means, in my case, I add this to ''/etc/default/grub'''s ''GRUB_CMDLINE_LINUX_DEFAULT''.
<code>
resume=UUID=de9f6aca-85a1-461b-b8b8-15f44441f64d resume_offset=1257472
</code>
Don't forget to ''sudo update-grub''.

Then I enabled this line in 
<file bash /etc/systemd/logind.conf>   
HandleLidSwitch=suspend-then-hibernate
</file>

Everything is still commented out in ''/etc/systemd/sleep.conf'' (Also see [[https://community.frame.work/t/tracking-suspend-on-linux-drains-a-lot-of-battery-compared-to-other-laptop/24737/60|suspend drains battery]]). May need to turn some of those lines on.

==== Future Config Tips ====

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, [[https://askubuntu.com/questions/604434/chrome-disable-or-change-keyboard-shortcut-ctrlshiftc-developer-tools-console|you can disable it with shortkeys extension]]:

Install [[https://chrome.google.com/webstore/detail/shortkeys-custom-keyboard/logpjaacgmcbpdkdchjiaagddngobkck|shortkeys]] and set (and save) the following:
  * Keyboard shortcut: ctrl+shift+c
  * Behavior: Run JavaScript
  * Javascript code to run: ''document.execCommand('copy')''

===== Gnome (Desktop Env) =====

Enable tap and drag lock:

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

==== Screen Resolution and Zoom ====

Resolution: 2256 x 1504
Zoom: 125%

Terminal Font: 16pt
Chrome Zoom: 110%

==== Keyboard Shortcuts ====

^ Keys ^ Action ^
| Ctrl+Alt <- or -> | Change workspaces |

==== Other Questions ====

[[https://extensions.gnome.org/extension/2857/maximize-to-workspace-with-history/|Maximize To Workspace With History]].

==== Unsatisfactorily Resolved ====

[[https://community.frame.work/t/fingerprint-keyring/19230/2|Using the fingerprint reader doesn't unlock keyring]]. Just use password.

[[https://askubuntu.com/questions/1413750/how-to-change-2-finger-touchpad-scroll-speed-on-ubuntu-22-04|How to change 2-finger touchpad scroll speed on Ubuntu 22.04]]. If you really want this, may have to compile libinput-config locally.

====== Framework BIOS Upgrade ======

[[https://knowledgebase.frame.work/en_us/framework-laptop-13-bios-and-driver-releases-amd-ryzen-7040-series-r1rXGVL16|Framework Laptop 13 BIOS and Driver Releases (AMD Ryzen™ 7040 Series)]]

[[https://knowledgebase.frame.work/en_us/framework-laptop-13-bios-and-driver-releases-amd-ryzen-7040-series-r1rXGVL16#:~:text=a%20charger%20attached.-,Linux/LVFS,-Please%20note%20that|LVFS updating]] boils down to: **Plug in the laptop**, then run:

<code bash>
fwupdmgr refresh --force
fwupdmgr get-updates
fwupdmgr update
</code>

====== Distro Upgrade ======

Software Updater: "Not enough free disk space"
Thread at Slack. First try "sudo apt-get autoremove --purge", and if that doesn't work, then to see the installed kernels:

<code>
$ dpkg --list | egrep "^ii +(linux-image|linux-headers)"
ii  linux-headers-5.11.0-46-generic            5.11.0-46.51~20.04.1                amd64        Linux kernel headers for version 5.11.0 on 64 bit x86 SMP
ii  linux-headers-5.13.0-52-generic            5.13.0-52.59~20.04.1                amd64        Linux kernel headers for version 5.13.0 on 64 bit x86 SMP
ii  linux-headers-5.15.0-58-generic            5.15.0-58.64~20.04.1                amd64        Linux kernel headers for version 5.15.0 on 64 bit x86 SMP
ii  linux-headers-5.15.0-60-generic            5.15.0-60.66~20.04.1                amd64        Linux kernel headers for version 5.15.0 on 64 bit x86 SMP
ii  linux-headers-5.4.0-42                     5.4.0-42.46                         all          Header files related to Linux kernel version 5.4.0
ii  linux-headers-5.4.0-42-generic             5.4.0-42.46                         amd64        Linux kernel headers for version 5.4.0 on 64 bit x86 SMP
ii  linux-headers-5.8.0-63-generic             5.8.0-63.71~20.04.1                 amd64        Linux kernel headers for version 5.8.0 on 64 bit x86 SMP
ii  linux-headers-generic-hwe-20.04            5.15.0.60.66~20.04.26               amd64        Generic Linux kernel headers
ii  linux-image-5.15.0-58-generic              5.15.0-58.64~20.04.1                amd64        Signed kernel image generic
ii  linux-image-5.15.0-60-generic              5.15.0-60.66~20.04.1                amd64        Signed kernel image generic
ii  linux-image-generic-hwe-20.04              5.15.0.60.66~20.04.26               amd64        Generic Linux kernel image
</code>

And then choose the old ones (comparing with what's on /boot) to manually remove...

<code>
df -h /boot
ls -l /boot
# Install aptitude to see why it was installed... (Output wordy, says whether manually installed, dependencies)
aptitude why -v linux-headers-5.11.0-46-generic
 
sudo apt purge linux-headers-5.11.0-46-generic  # picked a few old looking ones
</code>