Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/lu0/dotfiles_linuxmint

Linux Mint (cinnamon) post-installation setup.
https://github.com/lu0/dotfiles_linuxmint

bash development-environment dotfiles linux mint scripts workflow

Last synced: 2 months ago
JSON representation

Linux Mint (cinnamon) post-installation setup.

Host: GitHub
URL: https://github.com/lu0/dotfiles_linuxmint
Owner: lu0
License: gpl-3.0
Created: 2020-05-30T22:19:30.000Z (over 4 years ago)
Default Branch: master
Last Pushed: 2024-08-01T05:51:46.000Z (6 months ago)
Last Synced: 2024-08-01T07:36:19.222Z (6 months ago)
Topics: bash, development-environment, dotfiles, linux, mint, scripts, workflow
Language: CSS
Homepage:
Size: 107 MB
Stars: 10
Watchers: 1
Forks: 0
Open Issues: 5
Metadata Files:
- Readme: README-old.md
- License: LICENSE

Awesome Lists containing this project

README

# Dotfiles for Linux Mint
My Linux Mint (cinnamon) post-installation setup.

## Clone repo
```zsh
# Clone with submodules
git clone --recursive https://github.com/lu0/dotfiles_linuxMint ~/.dotfiles_linuxMint
cd ~/.dotfiles_linuxMint
```

## Install DCONF
I use it to edit system settings.
``` zsh
sudo apt-get install dconf-editor -y # System configuration tool
```

## Keybindings

Install dependencies needed by for window-control scripts
```sh
sudo apt-get install python3-pip
python3 -m pip install xdisplayinfo
```

Load keybindings I use.
```zsh
# Cinnamon
dconf load /org/cinnamon/desktop/keybindings/ < dconf-files/cinnamon-shortcuts.conf
```

## Terminal
Bash theme and profile.
![Terminal Preview](bash/terminal-preview.png)

```zsh
# Theme and fonts
sudo cp -r fonts/source-code-pro/OTF /usr/share/fonts/opentype/source-code-pro
mkdir ~/.myscripts && ln -srf bash/fancy-bash.sh ~/.myscripts/

# Profiles and settings
dconf load /com/gexperts/Tilix/ < dconf-files/tilix-terminal.conf

# Aliases and profile
ln -srf bash/bashrc ~/.bashrc
ln -srf bash/profile ~/.profile

# Script to create new Github repo and push from current directory
ln -srf scripts/git-create-repo.sh ~/.myscripts/github

sudo ln -srf bash/inputrc /etc/inputrc
```
Restart the terminal.

## Display manager
Use SDDM (plasma-like login-screen) instead of lightDM (default).
![SDDM Preview](cinnamon/sddm-themes/sddm-preview.png)
```zsh
# Install SDDM, theme and dependencies
./scripts/install-sddm.sh

# Background and user images
sudo ln -srf cinnamon/wallpaper.jpg /usr/share/backgrounds/wallpaper.jpg
sudo ln -srf cinnamon/mintLogo_alt.png ~/.face.icon
```
Reboot to apply.

## Custom Cinnamon Appearance
Themes and tweaks I use for the Cinnamon DE. Reboot after configuration.
![Preview while on desktop](cinnamon/custom-cinnamon.png)

### Disable shadows in window borders
```zsh
sudo ln -srf config/environment /etc/environment
```
You might need to logout and login to session after this.

### Icons and Themes
```zsh
# Papirus icons
./cinnamon/appearance/icons/install-papirus.sh
papirus-folders --color brown --theme Papirus-Dark

# Custom theme
cd cinnamon/appearance/
sudo unzip themes/Minimal_BrownAccents/Minimal_BrownAccents.zip -d /usr/share/themes
sudo ln -srf themes/Minimal_BrownAccents/cinnamon.css /usr/share/themes/Minimal_BrownAccents/cinnamon/cinnamon.css
sudo ln -srf themes/Minimal_BrownAccents/gtk.css /usr/share/themes/Minimal_BrownAccents/gtk-3.0/gtk.css
sudo ln -srf themes/Minimal_BrownAccents/metacity-theme-3.xml /usr/share/themes/Minimal_BrownAccents/metacity-1/metacity-theme-3.xml

sudo unzip themes/Minimal_RedAccents/Minimal_RedAccents.zip -d /usr/share/themes
sudo ln -srf themes/Minimal_RedAccents/cinnamon.css /usr/share/themes/Minimal_RedAccents/cinnamon/cinnamon.css
sudo ln -srf themes/Minimal_RedAccents/gtk.css /usr/share/themes/Minimal_RedAccents/gtk-3.0/gtk.css
sudo ln -srf themes/Minimal_RedAccents/metacity-theme-3.xml /usr/share/themes/Minimal_RedAccents/metacity-1/metacity-theme-3.xml
cd ../../

# Fonts
sudo cp -r fonts/source-code-pro/OTF /usr/share/fonts/opentype/source-code-pro
sudo cp -r fonts/karla /usr/share/fonts/opentype/karla
sudo cp -r fonts/webly-sleek /usr/share/fonts/truetype/webly-sleek-ui

# Apply changes
dconf load / < dconf-files/theme.conf

# Sound theme
sudo apt-get install sox -y
dconf load /org/cinnamon/ < dconf-files/system-sounds.conf # sound theme
```

### Blur wallpaper when desktop is "busy"
```zsh
# Wallpaper I use
sudo ln -srf cinnamon/wallpaper.jpg /usr/share/backgrounds/wallpaper.jpg
sudo ln -srf cinnamon/wallpaper-blur.png /usr/share/backgrounds/wallpaper-blur.png

# Dependencies and wallpaper
sudo apt-get install wmctrl graphicsmagick feh -y # blur wallpaper when busy
feh --bg-fill "/usr/share/backgrounds/wallpaper.jpg"

# Link script to a directory in HOME
mkdir -p ~/.myscripts
ln -srf cinnamon/feh-blur-wallpaper/feh-blur ~/.myscripts/feh-blur.sh

# Create startup entry
mkdir -p ~/.config/autostart
ln -srf config/autostart/blur-wallpaper.desktop ~/.config/autostart/
```

### Devilspie
Control newly opened windows, modify ```config/devilspie2/config-dp.lua``` to suit your needs, I use it to:
- Maximize windows
- Open applications on specific workspaces
- Set default geometry for some windows
```zsh
# Install devilspie
sudo apt-get install devilspie2 -y
sudo apt-get install luarocks -y
sudo luarocks install --server=http://luarocks.org/dev luash

# Install xdisplayinfo
pip3 install xdisplayinfo

# Link configuration
ln -srf config/devilspie2 ~/.config/devilspie2

# Create startup entry
mkdir -p ~/.config/autostart
ln -srf config/autostart/Devilspie.desktop ~/.config/autostart/
```

### Custom Spices
I use some applets I modified to fit into vertical panels.
```zsh
# Install applets and extensions
./cinnamon/install-spices.sh

# Left panel with the applets and workspaces I use
dconf load /org/cinnamon/ < dconf-files/panel.conf
```

### Custom Powermenu
![Preview while on desktop](https://github.com/lu0/rofi-blurry-powermenu/blob/master/preview.png)
Run custom powermenu with ```Super``` + ```Home```.
```bash
# Install dependencies
sudo apt update && sudo apt install -y rofi scrot imagemagick

# Install fonts
sudo cp rofi-blurry-powermenu/fonts/* /usr/share/fonts/ && fc-cache -f

# Link necessary files
sudo ln -srf rofi-blurry-powermenu/powermenu.sh /usr/bin/blurry-powermenu
```

## Install programs
Programs, apps and packages I use:
* Graphics
- Krita
- Inkscape
- Gimp
* Games
- Play On Linux
- Steam
* Internet
- Team Viewer
* Office Suite
- OnlyOffice
* Coding
- VS Code (with setup)
- NeoVim
* Sound & Video
- Audacity
- Sound converter
- Spotify
- Cheese (webcam)
- Droidcam (webcam)
- KDEnLive (video editor)
* Administration
- GParted
- System profiler
- Bluetooth Manager
- VirtualBox

```zsh
cd scripts
source install-programs.sh

# Enable custom startup apps
ln -srf startup_session.sh ~/.myscripts/
cd ../

# Create startup and dekstop entries
mkdir -p ~/.config/autostart
ln -srf config/autostart/mystartup-apps.desktop ~/.config/autostart/
sudo ln -srf config/autostart/droidcam.desktop /usr/share/applications/
sudo ln -srf config/autostart/windows.desktop /usr/share/applications/ # after 'installing' the w10 VM
ln -srf scripts/vm-windows.sh ~/.myscripts/

# Disable some default startup apps
ln -srf $HOME/.dotfiles_linuxMint/config/autostart/* $HOME/.config/autostart/
```

### Additional settings
Additional settings for some programs.
* Gnome screenshot: auto-save folder on `~/pictures/screenshots/`
* Cheese (webcam): Change default resolution to 720p
* Celluloid (video player): Hide playlist bar
* Hide bluetooth (blueberry) from panel
* Keep bluetooth on
* Disable sleep/hibernation
* Touchpad with edge scrolling
* Lock touchscreen orientation
* Nemo
- Keybindings
- Compact view
- Hide desktop icons
- Convert images to PDF from the context menu
```zsh
dconf load / < dconf-files/miscellaneous.conf

# Nemo file manager
mkdir -p ~/.gnome2/accels/
ln -srf config/nemo-keybindings ~/.gnome2/accels/nemo
dconf load /org/nemo/ < dconf-files/nemo-fileman.conf
ln -srf scripts/nemo/* ~/.local/share/nemo/scripts/
pkill nemo

# Rename gnome-screenshots periodically
sudo apt install inotify-tools
ln -srf scripts/screenshot-watcher.sh ~/.myscripts/
sudo ln -srf scripts/screenshot-rename.service /etc/systemd/system/
sudo ln -srf scripts/screenshot-rename.timer /etc/systemd/system/

systemctl daemon-reload
systemctl enable screenshot-rename.timer
systemctl start screenshot-rename.timer
systemctl status screenshot-rename.timer screenshot-rename.service
```

## Additional setup for Thinkpad X1Y3

### Vim and media keys
I use ```AltGr``` + ```H```,```J```,```K```,```L``` as arrow keys and ```U```,```I``` as Prior and Next keys; ```CapsLock``` is mapped to ```Escape``` and ```Shift```+```CapsLock``` to ```CapsLock```. Additionally, the Thinkpad X1Y3 does not have media keys, so I map ```Prior```, ```Next``` and ```↑``` to Previous track, Next track and Play/Pause.
```zsh
# Dependencies
sudo apt-get install xcape -y

# Config file
ln -srf scripts/customkeys-config.lst ~/.myscripts/.customkeys-config.lst

# Link script to a directory in HOME
mkdir -p ~/.myscripts
ln -srf scripts/apply-keymappings.sh ~/.myscripts/

# Create startup entry
mkdir -p ~/.config/autostart
ln -srf config/autostart/keymappings.desktop ~/.config/autostart/
```

### Touchpad drivers
Linux Mint 20 uses `libinput` instead of `Synaptics` by default, but `Synaptics` provides lots of config options for the touchpad, with Kinetic Scrolling being my favorite. Check the drivers you're using with:
```zsh
grep -i "Using input driver" /var/log/Xorg.0.log
```
`Synaptics` and `libinput` can coexist (`libinput` for keyboard+mouse and `synaptics` for the touchpad) by simply installing the package and restarting:
```zsh
sudo apt-get install xserver-xorg-input-synaptics
```

### TrackPoint and Logitech M570
Change DPI easily (using `libinput`).
```zsh
# Link dpi script to the PATH folder
mkdir -p ~/.myscripts && ln -srf scripts/dpi.sh ~/.myscripts/
ln -srf scripts/trackpoint.sh ~/.myscripts/

# Use easystroke to bind the script to your preferred mouse button
sudo apt-get install easystroke

# Copy (my) saved configuration
rm ~/.easystroke && ln -srf config/easystroke/ ~/.easystroke

# Change config
easystroke
```

### ThinkPad Compact USB Keyboard with TrackPoint
*Temporal rant/thought process, I might put this in a blog/gitrepo later*

So I bought a Thinkpad USB wired Keyboard (the first version that has the new "chiclet" keys layout).

The mic-mute key (`Fn+F4`) of this keyboard does not toggle the internal microphone, but the same key on the internal keyboard (Thinkpad X1Y3) does.

I ran `xev` to test if the X server detects the key, it detects all the other function keys, but not this.

Then I ran `acpi_listen`, it returns the following:
```sh
button/micmute MICMUTE 00000080 00000000 K
```
So the key is working at the BIOS level at least...

Okay, `xev` ignores the key, so I checked with `evtest` and found these keyboard devices:
```sh
No device specified, trying to scan all of /dev/input/event*
Available devices:
/dev/input/event3: AT Translated Set 2 keyboard
/dev/input/event7: Lenovo ThinkPad Compact USB Keyboard with TrackPoint
/dev/input/event8: Lenovo ThinkPad Compact USB Keyboard with TrackPoint
/dev/input/event12: ThinkPad Extra Buttons
Select the device event number [0-20]:
```

I selected `event12`, it seems to include all the hot keys of my internal keyboard, as the output when pressing the mic-mute key on my Thinkpad is:
```sh
Testing ... (interrupt to exit)
Event: time 1623859038.822635, type 4 (EV_MSC), code 4 (MSC_SCAN), value 1a
Event: time 1623859038.822635, type 1 (EV_KEY), code 190 (KEY_F20), value 1
```

Okay, so now I wanted to test this key but on my new external keyboard. Events `event7` and `event8` have the same name. When I select `event7`, I see the keycodes of "normal" keys (alphabet, tab, alt, etc) when pressing them, but the function keys are ignored.

Then I selected `event8` and it seems to show the trackpoint AND the function keys of the USB keyboard! The output when pressing the mic-mute key is:
```sh
Testing ... (interrupt to exit)
Event: time 1623860131.478684, type 4 (EV_MSC), code 4 (MSC_SCAN), value ffa000f1
Event: time 1623860131.478684, type 1 (EV_KEY), code 248 (KEY_MICMUTE), value 0
```

So the keycodes are different for the mic-mute key (they are the same on other function keys), what's most important, the keycode of the mic-mute key of the external keyboard is `248`. According to what I (barely) found on my research, this keycode is ignored by the X server.

The next step is to try to remap the key of the external keyboard to the keycode that my internal keyboard uses (`KEY_F20`), or to catch the acpi event and create a custom script to toogle the microphone on and off.

Most of the workarounds I found didn't work, I was about to give up, then I figured out the key (lol) was to connect to the acpid socket to catch the event.

This is the script I made, it simulates the keypress of the micmute button for the X server.
```zsh
#!/bin/bash
coproc acpi_listen
trap 'kill $COPROC_PID' EXIT

while read -u "${COPROC[0]}" -a event; do
[ "${event[0]}" = 'button/micmute' ] \
&& xdotool key XF86AudioMicMute
done
```
I gave it permissions (`chmod +x thinkpad-extkeyb-micmute.sh`), executed it:
```zsh
./thinkpad-extkeyb-micmute.sh
```
... tested the combination `Fn+F4` and .... It works!

Then I just created a [startup entry](./config/autostart/thinkpad-usbkeyb-micmute.desktop).
```zsh
# Link script
ln -srf scripts/thinkpad-usbkeyb-micmute.sh \
~/.myscripts/thinkpad-usbkeyb-micmute.sh

# Create startup entry
mkdir -p ~/.config/autostart
ln -srf config/autostart/thinkpad-usbkeyb-micmute.desktop ~/.config/autostart/
```

**The advantage of my solution over all of the workarounds is that we let the X server handle this action, which means we don't need to toggle the mic with alsa/pulseaudio, nor do we need to implement a hacky workaround to toggle the LED of the button.**

Most useful resources/discussions I found: [This](https://forum.manjaro.org/t/mic-mute-button-not-detected-in-asus-tuf-series/23618/7Forum) and [this](https://forums.fedoraforum.org/showthread.php?272870-Fedora-16-xev-ignores-mic-mute-key) and [THIS (rtfm)](https://wiki.archlinux.org/title/Acpid#Connect_to_acpid_socket).

### Battery Managment
Change battery thresholds.
```zsh
# Install TLP managment and dependencies
sudo add-apt-repository ppa:linrunner/tlp
sudo apt update
sudo apt install tlp tlp-rdw -y
sudo apt-get install acpi-call-dkms -y

# I keep charge between 50%-60%
sudo tlp start
sudo ln -srf config/tlp-battery.conf /etc/tlp.conf
sudo tlp start

# Check status
battery # If using the custom bash profile.
```

### Undervolting
[Undervolt](https://github.com/georgewhewell/undervolt) Intel CPU to decrease CPU temperatures.
```zsh
# Install dependencies
sudo pip3 install undervolt

# I Undervolt by 120mV
sudo undervolt --core -120 --cache -120

# Or set a temperature target of 70°C
sudo undervolt --temp 70
```
Run at startup
```zsh
sudo ln -srf scripts/undervolt.service /etc/systemd/system/
```
Check if script works, then enable it:
```zsh
systemctl start undervolt
systemctl enable undervolt
```

### Fingerprint login
The Thinkpad X1Y3 uses the 06cb:009a fingerprint reader, according to:
```zsh
lsusb | grep "Synaptics"
```
This device is not supported by the widely used [fprint](https://fprint.freedesktop.org/supported-devices.html), however, it supported by the new [python-validity](https://github.com/uunicorn/python-validity).

These are the steps to setup the fingerprint reader for the terminal and the Lock Screen.
```zsh
# Install python-validity
sudo add-apt-repository ppa:uunicorn/open-fprintd
sudo apt-get update
sudo apt install open-fprintd fprintd-clients python3-validity

# The above will reset my keymappings :C
apply-keymappings.sh # reapply my keymappings

# Scan fingerprints
fprintd-enroll # scan finger ~10 times
fprintd-verify # scan finger once

# Enable the fingerprint for authentication
# Select "Fingerprint authentication" with space bar
sudo pam-auth-update
```

**NOTE**: The Login Screen does not unlock the Keyring using biometrics (read [this](https://github.com/uunicorn/python-validity/issues/32) issue), it would ask for the sudo password anyway, so I disabled the fingerprint reader there ([SDDM](##-Display-manager) in my case). Open `/etc/pam.d/sddm` and paste the following after '`@include common-auth`':

```zsh
# @include common-auth # comment to disable the fingerprint reader
auth [success=1 default=ignore] pam_unix.so nullok_secure try_first_pass
auth requisite pam_deny.so
auth required pam_permit.so
auth optional pam_ecryptfs.so unwrap
auth optional pam_cap.so
# end of pam-auth-update config
```

Force a factory reset ONLY if you need to re-scan your fingerprints:
```zsh
sudo systemctl stop python3-validity
sudo python3 /usr/share/python-validity/playground/factory-reset.py
sudo systemctl start python3-validity
fprintd-enroll
fprintd-verify
```

### Prevent screen from locking when lid is closed
The settings-daemon for `lid-close` actions in [`miscellaneous.conf`](dconf-files/miscellaneous.conf) don't work in my machine... Here's a [workaround](https://forums.linuxmint.com/viewtopic.php?t=273378) to prevent hibernation and locking when lid is closed, this is specially useful when using multi-monitor setups.

Open `/etc/UPower/UPower.conf` and change `IgnoreLid=false` to `IgnoreLid=true`.
```sh
sudo nano /etc/UPower/UPower.conf
```
Open `/etc/systemd/logind.conf`, uncomment `HandleLidSwitch=hibernate` and change it to `HandleLidSwitch=ignore`
```sh
sudo nano /etc/systemd/logind.conf
```
Then reboot