DebianSystem/README.md

# Before starting

Shell lines starting with `$` means that the command is run as user.
Shell lines starting with `#` means that the command is run as root.
No starting character means that the command is run as user.
Words in between "<...>" and in uppercase letters means that you have to replace them with the correct value.

# System configuration

## Add user to group sudo

```
$ su -
```

```
# usermod -aG sudo <USERNAME>
# apt install sudo
```

## Install nvidia driver

```
sudo apt install linux-headers-generic
sudo apt install nvidia-driver nvidia-kernel-dkms
```

## Apt packages

Install packages with the following command.
```
sudo apt install <PACKAGES>
```

```
## Apps
firefox-esr
milkytracker
hardinfo2
gparted
logisim

## Utilities
git
gcc
g++
make
cmake
pkg-config
fastfetch
cava
ccls
```

## Flatpak

Install and configure flatpak.
```
sudo apt install flatpak
flatpak remote-add --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo
```

Install packages with the following command.
```
sudo flatpak install flathub <PACKAGES>
```

```
com.github.tchx84.Flatseal
com.jetpackduba.Gitnuro
com.obsproject.Studio
com.obsproject.Studio.Plugin.PipeWireAudioCapture
com.usebottles.bottles
org.prismlauncher.PrismLauncher
org.onlyoffice.desktopeditors
org.kicad.KiCad
org.freecad.FreeCAD
org.mapeditor.Tiled
org.kde.krita
```

## Install Gnome Desktop

Install desktop.
```
sudo apt install gnome
```

Remove useless packages.
```
sudo apt remove --purge gnome-tour gnome-software evolution libreoffice-* zutty malcontent
sudo apt autoremove --purge
```

Install complementary packaages.
```
sudo apt install gnome-shell-extensions
```

## Install Codium

Add repository gpg key.
```
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
```

Add repository.
```
echo -e 'Types: deb\nURIs: https://download.vscodium.com/debs\nSuites: vscodium\nComponents: main\nArchitectures: amd64 arm64\nSigned-by: /usr/share/keyrings/vscodium-archive-keyring.gpg' \
| sudo tee /etc/apt/sources.list.d/vscodium.sources
```

Install via aptitude.
```
sudo apt update
sudo apt install codium
```

## Install Reaper

[Download Reaper](https://www.reaper.fm/download.php).

Go to download folder and extract.
```
cd $HOME/<DOWNLOADS FOLDER>
tar -xf reaper*
```

Run installer.
```
./reaper_linux_x86_64/install-reaper.sh
```

Then when prompted enter in order :
```
I
1
Y
Y
Y
<PASSWORD>
```

## Install Steam

[Download Steam](https://store.steampowered.com/about/).

Go to your download folder and install the package.
```
cd $HOME/<DOWNLOADS FOLDER>
sudo apt install ./steam_lastest.deb
```

## Install Discord and Vencord

[Download discord](https://discord.com/).

Go to your download folder and install the package.
```
cd $HOME/<DOWNLOADS FOLDER>
sudo apt install ./Discord.deb
```

Run Discord and connect your account.

To install vencord run the following command.
```
sh -c "$(curl -sS https://vencord.dev/install.sh)"
```

Then when prompted enter in order :
```
[Enter]
[Enter]
[Enter]
```

## Install Signal

Add repository gpg key.
```
curl https://updates.signal.org/desktop/apt/keys.asc | gpg --dearmor > signal-desktop-keyring.gpg
cat signal-desktop-keyring.gpg | sudo tee /usr/share/keyrings/signal-desktop-keyring.gpg > /dev/null
rm signal-desktop-keyring.gpg
```

Add repository.
```
curl -o signal-desktop.sources https://updates.signal.org/static/desktop/apt/signal-desktop.sources
cat signal-desktop.sources | sudo tee /etc/apt/sources.list.d/signal-desktop.sources > /dev/null
rm signal-desktop.sources
```

Install signal.
```
sudo apt update
sudo apt install signal-desktop
```

## Install wine

Add repository gpg key.
```
wget -O - https://dl.winehq.org/wine-builds/winehq.key | sudo gpg --dearmor -o /etc/apt/keyrings/winehq-archive.key -
```

Enable 32-bit repository.
```
sudo dpkg --add-architecture i386
```

Add the sources file.
```
sudo wget -NP /etc/apt/sources.list.d/ https://dl.winehq.org/wine-builds/debian/dists/trixie/winehq-trixie.sources
```

Install winehq stable.
```
sudo apt update
sudo apt install --install-recommends winehq-stable
```

# User configuration

## Configure Gnome

In settings set Style to Dark, and add [backgrounds](backgrounds/).

Install extensions.
 - [Blur my Shell](https://extensions.gnome.org/extension/3193/blur-my-shell/)
 - [Custom command toggle](https://extensions.gnome.org/extension/7012/custom-command-toggle/)
 - [Desktop Cube](https://extensions.gnome.org/extension/4648/desktop-cube/)
 - [Keep pinned apps in AppGrid](https://extensions.gnome.org/extension/7660/keep-pinned-apps-in-appgrid/)
 - [Launch New Instances](https://extensions.gnome.org/extension/600/launch-new-instance/)
 - [Logo Menu](https://extensions.gnome.org/extension/4451/logo-menu/)
 - [Open Bar](https://extensions.gnome.org/extension/6580/open-bar/)
 - [TopHat](https://extensions.gnome.org/extension/5219/tophat/)

### Configure extensions

#### Open Bar

Import settings from [this file](user-config/OpenBarSettings).

#### TopHat

In "General" tab, set position to "center", refresh speed to "fast".
In "CPU" tab, set "Show as" to "Both meter and value", disable "sort cores by usage".
In "Memory" tab, set "Show as" to "Numeric value", enable "Show usage in GB".
In "Disk" tab, disable "Show the filesystem monitor".
In "Network" tab, disable "Show the network monitor".

#### Logo Menu

In "Icon" tab, select colorized Debian icon, set "Icon size" to 24.
In "Other options", remove "Software center" text, enable "Mask software center option".

#### Desktop Cube

In "General" tab, set "Paralax effect" to 3/4.
In "Desktop" tab, disable "Clic and slide bar to rotate cube".

#### Custom command toggle

Set "Button name" to "Blur my Shell".
Set "Icon" to "view-mirror-symbolic".

Set "Toggle ON Command" to "dconf write /org/gnome/shell/extensions/blur-my-shell/applications/blur true"
Set "Toggle OFF Command" to "dconf write /org/gnome/shell/extensions/blur-my-shell/applications/blur false"
Set "Check Status Command" to "dconf read /org/gnome/shell/extensions/blur-my-shell/applications/blur"
Set "Check Status Search Term" to "true"

Enable "Check Command Exit Code".
Disable "Show Indicator Icon".

Enable "Keep Toggle State Synced".

#### Blur my Shell

In "Pipelines" tab, set Default rounded corner effect radius to 16.
In "Top Bar" tab, disable "Overpass background".
In "Overview" tab, set "Sigma" to 20.
In "Applications" tab, enable "Applications blur", set "Blur type" to "Static" and set "Pipeline" to "Default Rounded".
Disable "Target window opaque", enable "Blur in overview" and enable "Enable all by default".
Set Blacklist to these values :
```
Minecraft*
cs2
steam_app*
2D_Engine
milkytracker
REAPER
krita
Aseprite
tiled
```

## Create user bin directories

```
mkdir -p $HOME/.local/bin
echo "export PATH=$HOME/.local/bin:\$PATH" >> ~/.bashrc
```

## Configure VSCodium

Copy settings to user folder.
```
cp user-config/vscodium-settings.jsonc $HOME/.config/VSCodium/User/settings.json
```

### Extensions

 - Bash IDE : "mads-hartmann.bash-ide-vscode"
 - [C/C++](http://marketplace.visualstudio.com/_apis/public/gallery/publishers/ms-vscode/vsextensions/cpptools/1.24.4/vspackage?targetPlatform=linux-x64) : "ms-vscode.cpptools"
 - CLI Launcher Theme : "rockuen.cli-launcher-theme"
 - CMake : "twxs.cmake"
 - HTML CSS Support : "ecmel.vscode-html-css"
 - [Teleplot](https://marketplace.visualstudio.com/_apis/public/gallery/publishers/alexnesnes/vsextensions/teleplot/1.1.4/vspackage) : "alexnesnes.teleplot"
 - Live Server : "yandeu.five-server"
 - PDF Viewer : "mathematic.vscode-pdf"
 - Pyrefly : "meta.pyrefly"

## Configure Reaper

[Download theme](https://stash.reaper.fm/26225/Fusion_SwissEdition.ReaperThemeZip).

Move theme to Reaper theme folder.
```
mv $HOME/<DOWNLOADS FOLDER>/Fusion_SwissEdition.ReaperThemeZip $HOME/.config/REAPER/ColorThemes/
```

## Install yabridge

See more on [Github](https://github.com/robbert-vdh/yabridge/tree/new-wine10-embedding)

Create and go into yabridge directory.
```
mkdir -p $HOME/.local/share/yabridge
cd $HOME/.local/share/yabridge
```

Clone yabridge repository.
```
git clone -b new-wine10-embedding https://github.com/robbert-vdh/yabridge.git yabridge-src
```

Install deps, you will need to install wine before.
```
sudo apt install meson wine-stable-dev gcc-multilib g++-multilib libxcb1-dev:i386 cargo
```

Build yabride loader.
```
meson setup build --buildtype=release --cross-file=cross-wine.conf --unity=on --unity-size=1000 -Dbitbridge=true
ninja -C build
```

Install yabridge loader.
```
cp build/libyabridge-*.so ..
cp build/yabridge-host* ..
```

Build yabridgectl.
```
cd tools/yabridgectl
cargo build
```

Install yabridgectl.
```
cp target/debug/yabridgectl $HOME/.local/bin/
```

Finish install by running :
```
yabridgectl sync
```

It is needed to install jackd2 for realtime memory management.
```
sudo apt install jackd2
```

## Install the pico-sdk and picotool

See more on [Poivron-Robotique](https://poivron-robotique.fr/Rpi-Pico-Installer-l-environnement-de-developpement-sur-Debian-11.html).

Install dependencies.
```
sudo apt install git make cmake gcc-arm-none-eabi gcc g++ libusb-1.0-0-dev
```

Create and go into pico-sdk directory.
```
mkdir -p $HOME/.local/share/pico-sdk
cd $HOME/.local/share/pico-sdk
```

Clone pico-sdk.
```
git clone -b master https://github.com/raspberrypi/pico-sdk.git --shallow-submodules .
git submodule update --init
```

Add env var.
```
echo "export PICO_SDK_PATH=$(pwd)" >> ~/.bashrc
source $HOME/.bashrc
```

Create and go into picotool directory.
```
mkdir -p $HOME/.local/share/picotool
cd $HOME/.local/share/picotool
```

Clone picotool.
```
git clone -b master https://github.com/raspberrypi/picotool.git .
```

Build picotool.
```
mkdir build
cd build
cmake -DCMAKE_INSTALL_PREFIX=~/.local ..
make -j$(nproc)
```

And install it.
```
make install
```

Add user to group dialout and add udev rules.
```
sudo usermod -aG dialout <USERNAME>
sudo usermod -aG plugdev <USERNAME>
sudo cp config/60-picotool.rules /etc/udev/rules.d/
sudo udevadm control --reload
```

## Install the fxSDK

See more on [Planet-Casio](https://www.planet-casio.com/Fr/forums/topic16614-16-giteapc-installer-et-mettre-a-jour-automatiquement-des-projets-gitea.html).

Install dependencies.
```
sudo apt install curl git python3 build-essential cmake pkg-config python3-pil libusb-1.0-0-dev libudev-dev libsdl2-dev libpng-dev libncurses-dev libudisks2-dev libglib2.0-dev
```

Download GiteaPC.
```
curl "https://git.planet-casio.com/Lephenixnoir/GiteaPC/raw/branch/master/install.sh" -o /tmp/giteapc-install.sh && bash /tmp/giteapc-install.sh
```

Then install all packages.
```
giteapc install Lephenixnoir/fxsdk Lephenixnoir/sh-elf-binutils Lephenixnoir/sh-elf-gcc
giteapc install Lephenixnoir/sh-elf-gdb
giteapc install Lephenixnoir/OpenLibm Vhex-Kernel-Core/fxlibc
giteapc install Lephenixnoir/sh-elf-gcc
giteapc install Lephenixnoir/gint
```

# To update everything

Apt.
```
sudo apt update
sudo apt upgrade
sudo apt autoremove --purge
sudo apt autoclean
```

Flatpak.
```
sudo flatpak update
```

FxSDK.
```
giteapc install -u
```

PicoSDK.
```
cd $HOME/.local/share/pico-sdk
git pull --update-shallow
git submodule update
```

Picotool.
```
cd $HOME/.local/share/picotool
git pull
mkdir -p build
cmake ..
make
cp picotool $HOME/.local/bin/
```

Yabridge.
```
cd $HOME/.local/yabridge/yabridge-src
git pull
meson setup build --reconfigure --buildtype=release --cross-file=cross-wine.conf --unity=on --unity-size=1000 -Dbitbridge=true
ninja -C build
cp build/libyabridge-*.so ..
cp build/yabridge-host* ..
cd tools/yabridgectl
cargo build
cp target/debug/yabridgectl $HOME/.local/bin/
```

For Reaper redo the installation process.