From 35d490e7fbc8c64374ce2ceff6ef3edb2c8e85cf Mon Sep 17 00:00:00 2001
From: cho <jericho@fedora.email>
Date: Fri, 4 Aug 2023 11:27:06 +0700
Subject: [PATCH] update instructions and packages list

---
 instructions.org | 75 ++++++++++++++++++++++++++++++++++++++++++------
 packages.txt     |  4 +--
 2 files changed, 69 insertions(+), 10 deletions(-)

diff --git a/instructions.org b/instructions.org
index b2be094..ea389ec 100644
--- a/instructions.org
+++ b/instructions.org
@@ -2,7 +2,53 @@
 
 setting up the system and packages
 
-** make new user and add to wheel
+** installing fedora minimal with btrfs snapshots (snapper)
+
+this sections assumes that you know how to use sway (window manager), neovim (text editor), basic terminal shell commands, burn an iso to disk, as well as using the anaconda installer.
+
+get the os image (Fedora Everything) from here https://alt.fedoraproject.org/en/ and burn it to your usb/other.
+
+*** verifying the iso file
+1. Download the checksum file (from https://alt.fedoraproject.org/en/) into the same directory as the image you downloaded.
+
+2. Import Fedora's GPG key(s)
+
+#+BEGIN_SRC sh
+curl -O https://fedoraproject.org/fedora.gpg
+#+END_SRC
+
+3. Verify the CHECKSUM file is valid
+
+#+BEGIN_SRC sh
+gpgv --keyring ./fedora.gpg *-CHECKSUM
+#+END_SRC
+
+4. Verify the checksum matches
+
+#+BEGIN_SRC sh
+sha256sum -c *-CHECKSUM
+#+END_SRC
+
+*** installing fedora and setting up btrfs with snapshots
+
+differences/notes before continuing with the installation:
+
+1. some dependencies aren't available with 'fedora custom operating system'. before installing snapper make sure to install these packages:
+
+#+BEGIN_SRC sh
+sudo dnf install neovim sway firefox locate git bzip2
+#+END_SRC
+
+a) neovim is the text editor of my choice
+b) install a browser such as firefox to follow along guide
+c) locate, git, bzip2 are the missing dependencies not included in the guide.
+
+2. software selection will be 'fedora custom operating system'
+
+boot your fedora installer media and follow this guide, make sure to boot with EUFI mode:
+https://sysguides.com/install-fedora-38-with-snapshot-and-rollback-support/
+
+** how to make new user and add to wheel
 
 #+BEGIN_SRC sh
 # make a user and add to the wheel group
@@ -75,6 +121,9 @@ sudo dnf --repo=rpmfusion-nonfree-tainted install "*-firmware"
 
 ** installing dnf packages
 
+this will install programs, as well as (99% of) dependencies of shell scripts and configuration included within lf (file manager)
+the other dependency not included in packages.txt is `pup` (included in a section below)
+
 #+BEGIN_SRC sh
 sudo dnf install -y $(cat ~/.dots/packages.txt)
 #+END_SRC
@@ -93,12 +142,15 @@ echo "Defaults editor=/usr/bin/nvim" >/etc/sudoers.d/02-visudo-editor
 ** Make zsh the default shell for the user.
 
 #+BEGIN_SRC shell
+name=$USER
 chsh -s /bin/zsh "$name" >/dev/null 2>&1
 sudo -u "$name" mkdir -p "/home/$name/.cache/zsh/"
 sudo -u "$name" mkdir -p "/home/$name/.config/abook/"
 sudo -u "$name" mkdir -p "/home/$name/.config/mpd/playlists/"
 #+END_SRC
 
+at this point, you should logout and login again to set the variables.
+
 ** librewolf (browser)
 
 from https://librewolf.net/installation/fedora/
@@ -118,7 +170,7 @@ https://addons.mozilla.org/en-US/firefox/addon/multi-account-containers/
 first we need marked for markdown support
 
 #+BEGIN_SRC sh
-sudo npm -g marked
+sudo npm install -g marked
 #+END_SRC
 
 #+BEGIN_SRC sh
@@ -134,6 +186,7 @@ from https://github.com/horriblename/lf#installation
 
 #+BEGIN_SRC sh
 env CGO_ENABLED=0 go install -ldflags="-s -w" github.com/horriblename/lf@latest
+mkdir -p $HOME/.cache/lf
 #+END_SRC
 
 ** interception tools (keyboard input mappings)
@@ -175,6 +228,7 @@ sudo systemctl enable udevmon.service
 
 ** sway notifications
 
+from https://github.com/ErikReider/SwayNotificationCenter#fedora
 #+BEGIN_SRC sh
 dnf copr enable erikreider/SwayNotificationCenter
 dnf install SwayNotificationCenter
@@ -189,6 +243,7 @@ pip install autotiling==1.8
 
 ** sc-im (terminal spreadsheet)
 
+from https://github.com/andmarti1424/sc-im/wiki/Installing-on-Fedora-36--(packaged)
 #+BEGIN_SRC sh
 sudo dnf copr enable marcusmueller/sc-im
 sudo dnf install sc-im
@@ -281,6 +336,15 @@ sudo usermod -a -G vboxusers default
 #+END_SRC
 
 ** flatpak packages
+
+remember to set permissions, especially access to personal files according to what you want the software to have before launching them.
+
+*** flatseal
+
+#+BEGIN_SRC sh
+flatpak install -y com.github.tchx84.Flatseal
+#+END_SRC
+
 *** Unity
 
 #+BEGIN_SRC sh
@@ -302,12 +366,6 @@ flatpak install com.github.johnfactotum.Foliate
 flatpak install -y com.valvesoftware.Steam.Utility.gamescope com.usebottles.bottles org.freedesktop.Platform.VulkanLayer.MangoHud
 #+END_SRC
 
-*** flatseal
-
-#+BEGIN_SRC sh
-flatpak install -y com.github.tchx84.Flatseal
-#+END_SRC
-
 *** steam
 
 #+BEGIN_SRC sh
@@ -372,6 +430,7 @@ power_dpm_force_performance_level: high
 #+END_SRC
 
 * todos
+** TODO write dependencies and programs to separate files
 ** add packages
 *** TODO add simple-mtpfs
 dnf package unmaintained
diff --git a/packages.txt b/packages.txt
index 70f831a..154dab3 100644
--- a/packages.txt
+++ b/packages.txt
@@ -76,7 +76,6 @@ swaybg
 swayidle
 socat
 moreutils
-neomutt
 isync
 msmtp
 pass
@@ -109,7 +108,6 @@ GraphicsMagick
 microcode_ctl
 wget
 neofetch
-elinks
 dnf-utils
 steam-devices
 thunderbird
@@ -130,3 +128,5 @@ VirtualBox
 virtualbox-guest-additions
 @virtualization
 texlive-scheme-basic
+rofi
+kanshi