PortValhalla/ManuSurface/ManuSurfaceSetup.md

# ManuSurface Setup
The steps described here allow the creation of a linux system on a Surface Book 2.

  - Rename host
  - Install Brave
  - Install Bitwarden
  - Install Xournal++
  - Install codium:  
    ```bash
    wget -qO - https://gitlab.com/paulcarroty/vscodium-deb-rpm-repo/raw/master/pub.gpg \
        | gpg --dearmor \
        | sudo dd of=/usr/share/keyrings/vscodium-archive-keyring.gpg

    echo 'deb [ signed-by=/usr/share/keyrings/vscodium-archive-keyring.gpg ] https://download.vscodium.com/debs vscodium main'
        | sudo tee /etc/apt/sources.list.d/vscodium.list

    sudo apt update
    sudo apt install codium
    ```
  - Generate SSH-key
  - Install `linux-surface`  
    See: <https://github.com/linux-surface/linux-surface/wiki/Installation-and-Setup>
    - ```bash
      wget -qO - https://raw.githubusercontent.com/linux-surface/linux-surface/master/pkg/keys/surface.asc \
          | gpg --dearmor | sudo dd of=/etc/apt/trusted.gpg.d/linux-surface.gpg
      ```
    - ```bash
      echo "deb [arch=amd64] https://pkg.surfacelinux.com/debian release main" \
          | sudo tee /etc/apt/sources.list.d/linux-surface.list
      ```
    - ```bash
      sudo apt update
      ```
    - ```bash
      sudo apt install linux-image-surface linux-headers-surface iptsd libwacom-surface
      ```
    - ```bash
      sudo systemctl enable iptsd
      ```
  - Enable Secure Boot  
    As seen here: <https://wiki.archlinux.org/title/Unified_Extensible_Firmware_Interface/Secure_Boot#Set_up_shim>
    - Implement Secure Boot
      - Copy signed Bootloader to UEFI partition:  
        ```bash
        wget https://blog.hansenpartnership.com/wp-uploads/2013/HashTool.efi
        wget https://blog.hansenpartnership.com/wp-uploads/2013/PreLoader.efi
        cp {HashTool,PreLoader}.efi /boot/efi/EFI/systemd/
        cp /boot/efi/EFI/systemd/systemd-bootx64.efi /boot/efi/EFI/systemd/loader.efi
        ```
      - Add boot entry  
        ```bash
        efibootmgr --unicode --disk /dev/nvme0n1 --part 0 --create --label "PreLoader" --loader /EFI/systemd/PreLoader.efi
        ```
      - Add fallbacks  
        ```bash
        cp ./HashTool.efi /boot/efi/EFI/BOOT/
        cp /boot/efi/EFI/systemd/systemd-bootx64.efi /boot/efi/EFI/BOOT/loader.efi
        cp ./PreLoader.efi /boot/efi/EFI/BOOT/BOOTx64.EFI
        ```
      - Ensure support for Microsoft infected devices  
        ```bash
        mkdir -p /boot/efi/EFI/Microsoft/Boot
        cp ./PreLoader.efi /boot/efi/EFI/Microsoft/Boot/bootmgfw.efi
        cp ./HashTool.efi /boot/efi/EFI/Microsoft/Boot/
        cp /boot/efi/EFI/systemd/systemd-bootx64.efi /boot/efi/EFI/Microsoft/Boot/loader.efi
        ```
  - Install `tea`
    ```bash
    wget https://dl.gitea.io/tea/0.9.0/tea-0.9.0-linux-amd64 -O tea
    sudo install tea /usr/local/bin
    rm tea
    ```

## Enhancement
  - Install `Gnome Extension Manager`
    - Install Extensions `Clipboard Indicator`
  - Sync NextCloud
    ```bash
    sudo -v ; curl https://rclone.org/install.sh | sudo bash
    rclone config # add remote
    cp ./rclone@.service ~/.config/systemd/user/
    systemctl --user daemon-reload
    systemctl --user enable rclone@nextcloud:Nextcloud
    systemctl --user start rclone@nextcloud:Nextcloud
    ```
  - Install `oh-my-posh`  
    ```bash
    sudo wget https://github.com/JanDeDobbeleer/oh-my-posh/releases/latest/download/posh-linux-amd64 -O /usr/local/bin/oh-my-posh
    sudo chmod +x /usr/local/bin/oh-my-posh
    echo 'eval "$(oh-my-posh init bash --config ~/Nextcloud/.omp/manuel.omp.json)"' >> ~/.bashrc
    ```
  - Install `logo-ls`  
    ```bash
    sudo wget https://github.com/Yash-Handa/logo-ls/releases/download/v1.3.7/logo-ls_amd64.deb -O logo-ls.deb
    sudo dpkg -i logo-ls.deb
    {
        echo "alias ls='logo-ls -D'"
        echo "alias ll='logo-ls -al'"
    } >> ~/.bashrc
    ```

## Post-Install
  - Add SSH-key to GitHub/Gitea websites
  - Add Caskaydia Cove Nerd Font Regular to /usr/share/font/opentype

## Configuration
  - Desktop
    - Desktop Options
      - Super Key Action: Applications
  - Power
    - Power Saving Options
      - Disable "Automatic Screen Brightness"
    - Suspend & Power Button
      - Power Button Behavior: "Suspend"
      - Enable "Show Battery Percentage"
  - Mouse & Touchpad
    - Touchpad Scroll & Zoom Options
      - Enable "Natural Scrolling"
  - Date & Time
    - Time Format: 24-hour
  - OS Upgrade & Recovery
    - Update Recovery Partition