phundrak
/
dotfiles
1
0
Fork 0
Code Issues Pull Requests Activity

[org files] Grammar

This commit is contained in:
Lucien Cartier-Tilet 2023-03-20 17:17:57 +01:00
parent f790423cca
commit 81cd095d08
Signed by: phundrak
GPG Key ID: BD7789E705CB8DCA
9 changed files with 244 additions and 239 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

47
org/config/bin.org
View File

@ -188,7 +188,7 @@ go. I even made it so that you can execute it as an executable file, like
The choice is given to the user which of them to use with options that will be The choice is given to the user which of them to use with options that will be
given to =cppnew=. given to =cppnew=.
First of all, if no arguments were passed, return an error. First, if no arguments were passed, return an error.
#+begin_src fish #+begin_src fish
if ! count $argv >/dev/null if ! count $argv >/dev/null
echo "Missing argument: PROJECT" && return -1 echo "Missing argument: PROJECT" && return -1
@ -280,7 +280,7 @@ analysis server as requested.
:HEADER-ARGS: :shebang "#!/usr/bin/env fish" :mkdirp yes :tangle ~/.local/bin/UpdateFlutter :HEADER-ARGS: :shebang "#!/usr/bin/env fish" :mkdirp yes :tangle ~/.local/bin/UpdateFlutter
:CUSTOM_ID: UpdateFlutter-1e8fbeb7 :CUSTOM_ID: UpdateFlutter-1e8fbeb7
:END: :END:
This is a simple utility to be ran when the ~flutter~ package is updated. This is a simple utility to run when the ~flutter~ package is updated.
#+BEGIN_SRC fish #+BEGIN_SRC fish
sudo chown -R :flutterusers /opt/flutter sudo chown -R :flutterusers /opt/flutter
sudo chmod -R g+w /opt/flutter sudo chmod -R g+w /opt/flutter
@ -406,10 +406,11 @@ fi
:HEADER-ARGS: :shebang "#!/usr/bin/env fish" :mkdirp yes :tangle ~/.local/bin/sshbind :HEADER-ARGS: :shebang "#!/usr/bin/env fish" :mkdirp yes :tangle ~/.local/bin/sshbind
:CUSTOM_ID: sshbind-756fabb1 :CUSTOM_ID: sshbind-756fabb1
:END: :END:
Something that I did not know for quite some time but that is actually crazy Something that I did not know for quite some time, but that is
useful about SSH is its ability to bind locally the port of a remote machine, actually crazy useful about SSH is its ability to bind locally the
and vice versa. The syntax is actually very simple, but I prefer a more port of a remote machine, and vice versa. The syntax is actually very
intuitive way of writing it. Its usage is ~sshbind PORT FROMHOST TOHOST~. simple, but I prefer a more intuitive way of writing it. Its usage is
~sshbind PORT FROMHOST TOHOST~.
#+BEGIN_SRC fish #+BEGIN_SRC fish
ssh -L $argv[1]:$argv[3]:$argv[1] $argv[2] -N ssh -L $argv[1]:$argv[3]:$argv[1] $argv[2] -N
#+END_SRC #+END_SRC
@ -448,7 +449,7 @@ end
#+end_src #+end_src
We can then read from the first member of ~argv~ which key the user We can then read from the first member of ~argv~ which key the user
pressed. Depending on it, we can chose what to execute. pressed. Depending on it, we can choose what to execute.
#+name: nsxiv-switch-statement #+name: nsxiv-switch-statement
#+begin_src fish #+begin_src fish
switch "$argv[1]" switch "$argv[1]"
@ -487,12 +488,12 @@ case "g"
gimp $FILES gimp $FILES
#+end_src #+end_src
Often, I use nsxiv to convert an image to a jpeg file, because my Often, I use nsxiv to convert an image to a JPEG file, because my
internet connection is not that great and jpeg screenshots are faster internet connection is not that great and JPEG screenshots are faster
to upload than png screenshots. So what I do is for each file to upload than PNG screenshots. So what I do is for each file
selected, I take the base name of the file (i.e. remove its selected, I take the base name of the file (i.e. remove its
extension), and then I use the ~convert~ command from ~imagemagik~ to extension), and then I use the ~convert~ command from ~imagemagik~ to
convert it from its original format to a jpg format --- ~imagemagik~ convert it from its original format to a JPG format --- ~imagemagik~
detects the formats based on the extension. detects the formats based on the extension.
#+name: nsxiv-jpeg #+name: nsxiv-jpeg
#+begin_src fish #+begin_src fish
@ -594,10 +595,9 @@ xinput set-prop $TPNAME "libinput Tapping Enabled" $NEWTPSTATUS
:HEADER-ARGS: :shebang "#!/usr/bin/env sh" :mkdirp yes :tangle ~/.local/bin/wacom-setup :HEADER-ARGS: :shebang "#!/usr/bin/env sh" :mkdirp yes :tangle ~/.local/bin/wacom-setup
:CUSTOM_ID: Wacom_setup-331fb024 :CUSTOM_ID: Wacom_setup-331fb024
:END: :END:
I made a small and quick utility to set up my Wacom tablet so it is I made a small and quick utility to set up my Wacom tablet to bind it
only bound to one screen. This is quite easy, we simply need to find to one screen when in Xorg. This is quite easy, we simply need to find
the Wacom stylus’ ID and assign it to the display we want. the Wacom stylus’ ID and assign it to the display we want.
#+begin_src sh #+begin_src sh
ID=$(xinput | grep -oPi "wacom.+stylus.+id=\K([0-9]+)") ID=$(xinput | grep -oPi "wacom.+stylus.+id=\K([0-9]+)")
SCREEN=$(xrandr -q --current | \ SCREEN=$(xrandr -q --current | \
@ -640,8 +640,8 @@ emacsclient -c -n -a emacs -e "(browse-url-mail \"$*\")"
:HEADER-ARGS: :shebang "#!/usr/bin/env fish" :mkdirp yes :tangle ~/.local/bin/mp42webm :HEADER-ARGS: :shebang "#!/usr/bin/env fish" :mkdirp yes :tangle ~/.local/bin/mp42webm
:CUSTOM_ID: mp42webm-aeacca58 :CUSTOM_ID: mp42webm-aeacca58
:END: :END:
This function allows me to convert easily an mp4 video to the webm format. This function allows me to convert easily a MP4 video to the webm
Nothing too fancy here. format. Nothing too fancy here.
#+BEGIN_SRC fish #+BEGIN_SRC fish
ffmpeg -i $argv[1] -c:v libvpx -crf 10 -b:v 1M -c:a libvorbis $argv[1].webm ffmpeg -i $argv[1] -c:v libvpx -crf 10 -b:v 1M -c:a libvorbis $argv[1].webm
#+END_SRC #+END_SRC
@ -692,13 +692,14 @@ Categories=Media
:HEADER-ARGS:EMACS-LISP: :exports none :tangle no :HEADER-ARGS:EMACS-LISP: :exports none :tangle no
:CUSTOM_ID: ytdl-a-youtube-dl-wrapper-03bd63e0 :CUSTOM_ID: ytdl-a-youtube-dl-wrapper-03bd63e0
:END: :END:
This script is a wrapper around ~youtube-dl~ which I use mainly for archiving This script is a wrapper around ~youtube-dl~ which I use mainly for
YouTube videos on my NAS (at the time I’m writing this, I have already 2.1TB archiving YouTube videos on my NAS (at the time I’m writing this, I
worth of videos archived). The principle behind this script is quite simple: I have already 2.1 TB worth of videos archived). The principle behind
want to avoid as much as possible to redownload any video already downloaded in this script is quite simple: I want to avoid as much as possible to
order to avoid pinging too much YouTube’s servers, 429 Too Many Requests errors redownload any video already downloaded in order to avoid pinging too
are really annoying, and it comes really early when you have only a couple of much YouTube’s servers, 429 Too Many Requests errors are really
new videos to download among the few 14k videos already downloaded. annoying, and it comes really early when you have only a couple of new
videos to download among the few 14k videos already downloaded.
Be aware this script was written for the Fish shell (3.1.0 and above), and makes Be aware this script was written for the Fish shell (3.1.0 and above), and makes
use of youtube-dl 2020.03.24 and above, [[https://github.com/jorgebucaran/fish-getopts][Fish getopts]] and [[https://github.com/BurntSushi/ripgrep][ripgrep]]. use of youtube-dl 2020.03.24 and above, [[https://github.com/jorgebucaran/fish-getopts][Fish getopts]] and [[https://github.com/BurntSushi/ripgrep][ripgrep]].

63
org/config/bootstrap.org
View File

@ -38,8 +38,8 @@ have a swap partition at least twice the size of your installed RAM. That is
because when this command will be run, the system will try to save the current because when this command will be run, the system will try to save the current
state of your machine, stored in your RAM, to the swap filesystem. If there is state of your machine, stored in your RAM, to the swap filesystem. If there is
not enough space, the command will fail, and you won’t be able to use this not enough space, the command will fail, and you won’t be able to use this
command. For instance, my current computer has 32GB of RAM, hence my SWAP command. For instance, my current computer has 32 GB of RAM, hence my SWAP
partition is 16GB large. partition is 16 GB large.
** Get the latest, fastest mirrors ** Get the latest, fastest mirrors
:PROPERTIES: :PROPERTIES:
@ -70,7 +70,7 @@ by default on Arch ISOs anymore, so I’ll need to install it.
pacman -S wget pacman -S wget
#+END_SRC #+END_SRC
Now, let’s grab the script. You can check it on [[https://github.com/matmoul/archfi][Github]]. Now, let’s grab the script. You can check it on [[https://github.com/matmoul/archfi][GitHub]].
#+BEGIN_SRC sh #+BEGIN_SRC sh
wget archfi.sf.net/archfi wget archfi.sf.net/archfi
# Or from matmoul.github.io/archfi if SourceForge is down # Or from matmoul.github.io/archfi if SourceForge is down
@ -80,7 +80,7 @@ sh archfi
Then, follow the instructions and install Arch Linux. Take the opportunity to Then, follow the instructions and install Arch Linux. Take the opportunity to
install as many packages as you need, mainly ~paru~ which I use as my package install as many packages as you need, mainly ~paru~ which I use as my package
manager (it is just a wrapper for ~pacman~) and AUR helper, and ~pacman-contrib~ manager (it is just a wrapper for ~pacman~) and AUR helper, and ~pacman-contrib~
which will help us installing some packages later. which will help us to install some packages later.
Once your system is installed, reboot and remove your installation media from Once your system is installed, reboot and remove your installation media from
your computer. your computer.
@ -90,9 +90,9 @@ your computer.
:HEADER-ARGS:fish: :tangle ~/.config/yadm/bootstrap :shebang "#!/usr/bin/fish" :exports code :mkdirp yes :HEADER-ARGS:fish: :tangle ~/.config/yadm/bootstrap :shebang "#!/usr/bin/fish" :exports code :mkdirp yes
:CUSTOM_ID: Execute_bootstrap-e37054ef :CUSTOM_ID: Execute_bootstrap-e37054ef
:END: :END:
The first thing I will do is add the [[https://aur.chaotic.cx/][Chaotic AUR]] repository so I can The first thing I will do is add the [[https://aur.chaotic.cx/][Chaotic AUR]] repository to get
get access to ~paru~ as well as some AUR packages without the need of an access to ~paru~ as well as some AUR packages without the need of an AUR
AUR helper (ironic considering ~paru~ is one). We can then install ~fish~, helper (ironic considering ~paru~ is one). We can then install ~fish~,
~git~, and ~paru~: ~git~, and ~paru~:
#+BEGIN_SRC sh #+BEGIN_SRC sh
sudo pacman -S fish git paru sudo pacman -S fish git paru
@ -221,7 +221,7 @@ sudo chown $USER:(id -g $USER) /mnt/{USB,CD,Android}
:PROPERTIES: :PROPERTIES:
:CUSTOM_ID: Execute_bootstrap-Set_user’s_shell_to_fish-1a794be2 :CUSTOM_ID: Execute_bootstrap-Set_user’s_shell_to_fish-1a794be2
:END: :END:
First of all, the bootstrap shell will set the user’s shell to fish. First, the bootstrap shell will set the user’s shell to fish.
#+BEGIN_SRC fish #+BEGIN_SRC fish
printf "\n# Set fish as the default shell ###############################################\n\n" printf "\n# Set fish as the default shell ###############################################\n\n"
whiptail --yesno "Set the current user’s default shell to fish?" 8 50 whiptail --yesno "Set the current user’s default shell to fish?" 8 50
@ -259,7 +259,7 @@ system packages.
| jmtpfs | FUSE filesystem for the MTP protocol | | jmtpfs | FUSE filesystem for the MTP protocol |
| kitty | My current terminal emulator, works with Xorg and Wayland | | kitty | My current terminal emulator, works with Xorg and Wayland |
| logrotate | Rotate system logs automatically | | logrotate | Rotate system logs automatically |
| man-pages | Linux man pages | | man-pages | Linux's man pages |
| man-db | Read the Linux man pages | | man-db | Read the Linux man pages |
| netctl | Profile based systemd network management | | netctl | Profile based systemd network management |
| network-manager-applet | System tray applet for NetworkManager | | network-manager-applet | System tray applet for NetworkManager |
@ -437,9 +437,9 @@ Let’s install some desktop applications too, shall we?
| rofi | A beautiful ~dmenu~ replacement | | rofi | A beautiful ~dmenu~ replacement |
All these packages will be installed with the command ~paru -S All these packages will be installed with the command ~paru -S
--skipreview --needed~ so it won’t nag me about the PKGBUILD when I --skipreview --needed~ to prevent it from nagging me about the PKGBUILD
want to install something from the AUR, and if something is already when I want to install something from the AUR, and if something is
installed it paru won’t try to reinstall it. already installed it paru won’t try to reinstall it.
#+name: gen-package-list #+name: gen-package-list
#+header: :wrap "src fish :exports none :tangle no" #+header: :wrap "src fish :exports none :tangle no"
@ -547,9 +547,9 @@ cd /home/phundrak/Documents/code/PKGBUILDs/sent && makepkg -si; cd ..
:PROPERTIES: :PROPERTIES:
:CUSTOM_ID: Execute_bootstrap-Tangle_configuration_files_from_Org_files-cc524361 :CUSTOM_ID: Execute_bootstrap-Tangle_configuration_files_from_Org_files-cc524361
:END: :END:
Before tangling our configuration files, we need to create some directories Before tangling our configuration files, we need to create some
first so our files can be properly tangled. Here’s the list of directories we directories first to make sure our files can be properly tangled.
need to create: Here’s the list of directories we need to create:
#+NAME: dirs-tangled-files #+NAME: dirs-tangled-files
| $HOME/.config/fish | | $HOME/.config/fish |
| $HOME/.config/gtk-2.0 | | $HOME/.config/gtk-2.0 |
@ -746,8 +746,8 @@ sudo timedatectl set-ntp true
:END: :END:
~acpilight~ is our utility managing the brightness of our screen. There ~acpilight~ is our utility managing the brightness of our screen. There
is actually no service to enable here, but we must ensure the user is is actually no service to enable here, but we must ensure the user is
part of the ~video~ group so we can modify the brightness of our screen part of the ~video~ group to enable the user modifying the brightness of
without using ~sudo~. our screen without using ~sudo~.
#+BEGIN_SRC fish #+BEGIN_SRC fish
sudo usermod -aG video $USER sudo usermod -aG video $USER
#+END_SRC #+END_SRC
@ -762,8 +762,8 @@ printf "\n# Enabling and starting Docker #######################################
sudo systemctl enable --now docker sudo systemctl enable --now docker
#+END_SRC #+END_SRC
Now, if we wish it, we can be added to the =docker= group so we won’t have to Now, if we wish it, we can add ourselves to the =docker= group to avoid
type =sudo= each time we call Docker or Docker Compose. typing =sudo= each time we call Docker or Docker Compose.
#+BEGIN_SRC fish #+BEGIN_SRC fish
read --prompt "echo 'Do you wish to be added to the `docker` group? (Y/n): ' " -l adddockergroup read --prompt "echo 'Do you wish to be added to the `docker` group? (Y/n): ' " -l adddockergroup
if test $adddockergroup = 'y' || test $adddockergroup = "Y" || test $adddockergroup = '' if test $adddockergroup = 'y' || test $adddockergroup = "Y" || test $adddockergroup = ''
@ -815,10 +815,11 @@ activate:
sudo systemctl enable --now nordvpnd sudo systemctl enable --now nordvpnd
#+END_SRC #+END_SRC
Let’s also set its default protocol to UDP. This will allow me to use any port Let’s also set its default protocol to UDP. This will allow me to use
while connected to any WiFi as long as the 443 port is available. Because yes, I any port while connected to any Wi-Fi as long as the 443 port is
do connect to a WiFi that blocks some important ports, such as the IMAP and SMTP available. Because yes, I do connect to a Wi-Fi that blocks some
ports. Thanks University of Paris 8 for being SO paranoid. important ports, such as the IMAP and SMTP ports. Thanks University of
Paris 8 for being SO paranoid.
#+BEGIN_SRC fish #+BEGIN_SRC fish
nordvpn s protocol tcp nordvpn s protocol tcp
#+END_SRC #+END_SRC
@ -840,9 +841,9 @@ Linux kernel since its version 5.6. And Windows’ since August 2021,
but I don’t really care about Windows. but I don’t really care about Windows.
*But*, WireGuard is less privacy-oriented than OpenVPN. So, if I ever *But*, WireGuard is less privacy-oriented than OpenVPN. So, if I ever
need to use my VPN for privacy reasons, I can simply revert back to need to use my VPN for privacy reasons, I can simply revert to the
the OpenVPN technology like shown with this command (not tangled in OpenVPN technology like shown with this command (not tangled in the
the bootstrap): bootstrap):
#+begin_src fish :tangle no #+begin_src fish :tangle no
nordvpn set technology OpenVPN nordvpn set technology OpenVPN
#+end_src #+end_src
@ -875,10 +876,10 @@ activate it right away:
systemctl --user enable --now pipewire-input-filter-chain.service systemctl --user enable --now pipewire-input-filter-chain.service
#+end_src #+end_src
Just make sure afterwards the microphone is redirected to the noise Just make sure afterwards the microphone is redirected to the
canceling source. The same source should be your input device where noise-canceling source. The same source should be your input device
you want to use your microphone. The only downside is this is ony a where you want to use your microphone. The only downside is this is
mono input, but it shouldn’t matter for most people. ony a mono input, but it shouldn’t matter for most people.
*** SSH server *** SSH server
:PROPERTIES: :PROPERTIES:
@ -995,7 +996,7 @@ order to improve the user experience.
:PROPERTIES: :PROPERTIES:
:CUSTOM_ID: Execute_bootstrap-Set_up_our_fish_shell-Install_=fisher=-3a44531b :CUSTOM_ID: Execute_bootstrap-Set_up_our_fish_shell-Install_=fisher=-3a44531b
:END: :END:
We will be using ~fisher~ as our extensions manager for Fish. Let’s install it. We will be using ~fisher~ as our extension manager for Fish. Let’s install it.
#+BEGIN_SRC fish #+BEGIN_SRC fish
printf "\n# Installing fisher ###########################################################\n\n" printf "\n# Installing fisher ###########################################################\n\n"
curl -sL https://git.io/fisher | source && fisher install jorgebucaran/fisher curl -sL https://git.io/fisher | source && fisher install jorgebucaran/fisher

26
org/config/desktop.org
View File

@ -37,9 +37,10 @@ first column the keychord following the leader key, on the second
column the EmacsLisp function to be called, and on the third the column the EmacsLisp function to be called, and on the third the
StumpWM command. If one of the ELisp or StumpWM case’s is empty, it StumpWM command. If one of the ELisp or StumpWM case’s is empty, it
means there is no equivalence. If it’s ~nil~, then it means it is a means there is no equivalence. If it’s ~nil~, then it means it is a
prefix key. The fourth column is for now reserved for Emacs’ which-key prefix key. The fourth column is for now reserved for Emacs’
so I can give it a better name. If its value is ~nil~, then it should which-key, so I can give it a better name. If its value is ~nil~, then
not show up. Hopefully this can be implemented someday in StumpWM. it should not show up. Hopefully this can be implemented someday in
StumpWM.
** Generating Code :noexport: ** Generating Code :noexport:
:PROPERTIES: :PROPERTIES:
@ -503,8 +504,9 @@ IconViewScale=-1
:HEADER-ARGS: :mkdirp yes :tangle ~/.config/gtk-3.0/settings.ini :HEADER-ARGS: :mkdirp yes :tangle ~/.config/gtk-3.0/settings.ini
:CUSTOM_ID: Theme-and-graphical-tweaks-GTK-Settings-GTK3-ojl7gbc0l9j0 :CUSTOM_ID: Theme-and-graphical-tweaks-GTK-Settings-GTK3-ojl7gbc0l9j0
:END: :END:
The following file helps me choosing the aspect of various GTK+ 3 software, The following file helps me to choose the aspect of various GTK+ 3
including their theme and icons. First, let’s declare the header: software, including their theme and icons. First, let’s declare the
header:
#+BEGIN_SRC conf-unix #+BEGIN_SRC conf-unix
[Settings] [Settings]
#+END_SRC #+END_SRC
@ -632,15 +634,15 @@ Sent from GNU/Emacs
:END: :END:
Some software I use are not packaged (yet) on my system. Therefore, in Some software I use are not packaged (yet) on my system. Therefore, in
order to make them available in ~rofi~, I need to write a ~.desktop~ file order to make them available in ~rofi~, I need to write a ~.desktop~ file
so I can launch them. to launch them.
** Emacs ** Emacs
:PROPERTIES: :PROPERTIES:
:CUSTOM_ID: -desktop-files-for-custom-applications-Emacs-6e9actg0m9j0 :CUSTOM_ID: -desktop-files-for-custom-applications-Emacs-6e9actg0m9j0
:END: :END:
Emacs does have a default ~.desktop~ file, but I want to override it so Emacs does have a default ~.desktop~ file, but I want to override it to
I can just “open with Emacs” from other software (such as Nemo) and it just “open with Emacs” from other software (such as Nemo) and it will
will instead open with ~emacsclient~. open with ~emacsclient~ instead of just =emacs=.
#+begin_src conf-desktop :tangle ~/.local/share/applications/emacs.desktop #+begin_src conf-desktop :tangle ~/.local/share/applications/emacs.desktop
[Desktop Entry] [Desktop Entry]
Name=Emacs Name=Emacs
@ -673,7 +675,7 @@ StartupWMClass=Gnus
Keywords=Text;Editor; Keywords=Text;Editor;
#+end_src #+end_src
Then I also have ~org-protocol.desktop~ so I can capture elements from Then I also have ~org-protocol.desktop~ that helps capture elements from
other software, mainly web pages from Firefox through the [[https://github.com/sprig/org-capture-extension][org-capture other software, mainly web pages from Firefox through the [[https://github.com/sprig/org-capture-extension][org-capture
extension]]. extension]].
#+begin_src conf-desktop :tangle ~/.local/share/applications/org-protocol.desktop #+begin_src conf-desktop :tangle ~/.local/share/applications/org-protocol.desktop
@ -730,8 +732,8 @@ Categories=Development
:CUSTOM_ID: -desktop-files-for-custom-applications-Minecraft-tds7ddh0m9j0 :CUSTOM_ID: -desktop-files-for-custom-applications-Minecraft-tds7ddh0m9j0
:END: :END:
Yup, I play Minecraft. And yes, it does have a default ~.desktop~ file, Yup, I play Minecraft. And yes, it does have a default ~.desktop~ file,
but this one overrides it so it launches automatically Minecraft with but this one overrides it to launch automatically Minecraft with
[[https://wiki.archlinux.org/title/PRIME][prime-run]] so my GPU is used. [[https://wiki.archlinux.org/title/PRIME][prime-run]], using my Nvidia GPU instead of my integrated GPU.
#+begin_src conf-desktop :tangle ~/.local/share/applications/minecraft-launcher.desktop #+begin_src conf-desktop :tangle ~/.local/share/applications/minecraft-launcher.desktop
[Desktop Entry] [Desktop Entry]
Type=Application Type=Application

165
org/config/emacs.org
View File

@ -173,7 +173,7 @@ preferred tastes —some may prefer 2 spaces tabs, some may prefer 4
spaces tabs, some deranged people prefer 8 spaces tabs, and some spaces tabs, some deranged people prefer 8 spaces tabs, and some
monsters prefer 3! monsters prefer 3!
But the thing is, once you indented your code and then you need But the thing is, once you indented your code, and then you need
alignment, tabs don’t work anymore! Or they may on *your* text editor alignment, tabs don’t work anymore! Or they may on *your* text editor
but not on your coworker’s! (He’s the one using 3 spaces tabs by the but not on your coworker’s! (He’s the one using 3 spaces tabs by the
way). way).
@ -306,7 +306,7 @@ your unsaved changes won’t be lost. Very polite!
:PROPERTIES: :PROPERTIES:
:CUSTOM_ID: Basic-configuration-Emacs-Behavior-Misc9j5jel6184j0 :CUSTOM_ID: Basic-configuration-Emacs-Behavior-Misc9j5jel6184j0
:END: :END:
Let’s raise Emacs undo memory to 10MB, and make Emacs auto-save our Let’s raise Emacs undo memory to 10 MB, and make Emacs auto-save our
files by default. files by default.
#+begin_src emacs-lisp #+begin_src emacs-lisp
(setq undo-limit 100000000 (setq undo-limit 100000000
@ -322,7 +322,7 @@ files by default.
:CUSTOM_ID: Basic-configuration-Personal-Informationi59jel6184j0 :CUSTOM_ID: Basic-configuration-Personal-Informationi59jel6184j0
:END: :END:
Emacs needs to know its master! For various reasons by the way, some Emacs needs to know its master! For various reasons by the way, some
packages rely of these variables to know who it is talking to or packages rely on these variables to know who it is talking to or
dealing with, such as ~mu4e~ which will guess who you are if you haven’t dealing with, such as ~mu4e~ which will guess who you are if you haven’t
set it up correctly. set it up correctly.
#+begin_src emacs-lisp #+begin_src emacs-lisp
@ -517,7 +517,7 @@ I also had to make the code simply work.
:CUSTOM_ID: Custom-Elisp-Dired-functions-phundrak-open-marked-filesdw2kel6184j0 :CUSTOM_ID: Custom-Elisp-Dired-functions-phundrak-open-marked-filesdw2kel6184j0
:END: :END:
This function allows the user to open all marked files from a dired This function allows the user to open all marked files from a dired
buffer as new Emacs buffers. buffer in new Emacs buffers.
#+begin_src emacs-lisp #+begin_src emacs-lisp
(defun phundrak/open-marked-files (&optional files) (defun phundrak/open-marked-files (&optional files)
"Open all marked FILES in Dired buffer as new Emacs buffers." "Open all marked FILES in Dired buffer as new Emacs buffers."
@ -556,16 +556,16 @@ b s~, which bring the user directly to the ~*Messages*~ buffer and the
:CUSTOM_ID: Custom-Elisp-Screenshots-l9bkib013aj0 :CUSTOM_ID: Custom-Elisp-Screenshots-l9bkib013aj0
:END: :END:
Since Emacs27, it is possible for Emacs to take screenshots of itself Since Emacs27, it is possible for Emacs to take screenshots of itself
in various formats. I’m mainly interested by the SVG and PNG format, in various formats. I’m mainly interested in the SVG and PNG format,
so I’ll only write functions for these. It isn’t really redundant with so I’ll only write functions for these. It isn’t really redundant with
the ~screenshot.el~ package used [[#Packages-Configuration-Applications-Screenshot96d1fl6184j0][here]] since these functions take a the ~screenshot.el~ package used [[#Packages-Configuration-Applications-Screenshot96d1fl6184j0][here]] since these functions take a
screenshot of Emacs as a whole rather than of a code snippet. screenshot of Emacs as a whole rather than of a code snippet.
First, we have a general function which is a slight modification of First, we have a general function which is a slight modification of
the function shared by Alphapapa in [[https://www.reddit.com/r/emacs/comments/idz35e/emacs_27_can_take_svg_screenshots_of_itself/g2c2c6y/][this Reddit comment]]. It has been the function shared by Alphapapa in [[https://www.reddit.com/r/emacs/comments/idz35e/emacs_27_can_take_svg_screenshots_of_itself/g2c2c6y/][this Reddit comment]]. I modified it
modified so it is possible to pass the function an argument for the to make it possible to pass as an argument the format the screenshot
format the screenshot will be taken as, and if ~type~ is ~nil~ the user will be taken as or ask the user which format they would like to save
can still chose it. it as.
#+begin_src emacs-lisp #+begin_src emacs-lisp
(defun self-screenshot (&optional type) (defun self-screenshot (&optional type)
"Save a screenshot of type TYPE of the current Emacs frame. "Save a screenshot of type TYPE of the current Emacs frame.
@ -628,9 +628,9 @@ focus the new window immediately.
:CUSTOM_ID: Custom-Elisp-Extend-add-to-list-eh2325605gj0 :CUSTOM_ID: Custom-Elisp-Extend-add-to-list-eh2325605gj0
:END: :END:
One function I find missing regarding ~add-to-list~ is ~add-all-to-list~ One function I find missing regarding ~add-to-list~ is ~add-all-to-list~
so I can add multiple elements to a list at once. Instead, with which enables the user to add multiple elements to a list at once.
vanilla Emacs, I have to repeatedly call ~add-to-list~. That’s not very Instead, with vanilla Emacs, I have to repeatedly call ~add-to-list~.
clean. Let’s declare this missing function: That’s not very clean. Let’s declare this missing function:
#+begin_src emacs-lisp #+begin_src emacs-lisp
(defun add-all-to-list (list-var elements &optional append compare-fn) (defun add-all-to-list (list-var elements &optional append compare-fn)
"Add ELEMENTS to the value of LIST-VAR if it isn’t there yet. "Add ELEMENTS to the value of LIST-VAR if it isn’t there yet.
@ -669,11 +669,11 @@ an absurd amount of Emacs packages.
:PROPERTIES: :PROPERTIES:
:CUSTOM_ID: Package-Management-Straightry3lel6184j0 :CUSTOM_ID: Package-Management-Straightry3lel6184j0
:END: :END:
For my package management, I prefer to use ~straight~ ([[https://github.com/raxod502/straight.el][Github]]). This is For my package management, I prefer to use ~straight~ ([[https://github.com/raxod502/straight.el][GitHub]]). This is
due to its capacity of integrating nicely with ~use-package~, which also due to its capacity of integrating nicely with ~use-package~, which also
supports ~general~ which I use for my keybindings (see below), but also supports ~general~ which I use for my keybindings (see below), but also
because with it I can specify where to retrieve packages that are not because with it, I can specify where to retrieve packages that are not
on MELPA or ELPA but on Github and other online Git repositories too. on MELPA or ELPA but on GitHub and other online Git repositories too.
First, let’s bootstrap straight. First, let’s bootstrap straight.
#+begin_src emacs-lisp #+begin_src emacs-lisp
(defvar bootstrap-version) (defvar bootstrap-version)
@ -702,7 +702,7 @@ stuff.
From time to time, I fork some packages either because I’m trying to From time to time, I fork some packages either because I’m trying to
implement something new in said package, or because the package is implement something new in said package, or because the package is
unmaintained and I want to continue developing it a bit more. Straight unmaintained, and I want to continue developing it a bit more. Straight
provides a nice feature for using forks of a package with its ~:fork~ provides a nice feature for using forks of a package with its ~:fork~
option. If set to ~t~, then straight will attempt to retrieve the option. If set to ~t~, then straight will attempt to retrieve the
package with the same name but with a different username on the same package with the same name but with a different username on the same
@ -716,11 +716,11 @@ host. This username is retrieved through the following variable:
The huge advantage of straight is it clones through git the packages The huge advantage of straight is it clones through git the packages
it installs. This means development can be done directly on the it installs. This means development can be done directly on the
downloaded package. However, Forge (a Magit extension for interacting downloaded package. However, Forge (a Magit extension for interacting
with websites such as Github, Gitlab, and such) interacts by default with websites such as GitHub, Gitlab, and such) interacts by default
with the forge described by the ~origin~ remote, which isn’t necessarily with the forge described by the =origin= remote, which isn’t necessarily
the one I want Forge to interact with by default. Therefore, all the one I want Forge to interact with by default. Therefore,
default remotes are named ~straight~ so it won’t collide with my regular =straight.el= will name all default remotes =straight= to avoid any name
development flow. collision with my regular development flow.
#+begin_src emacs-lisp #+begin_src emacs-lisp
(setq straight-vc-git-default-remote-name "straight") (setq straight-vc-git-default-remote-name "straight")
#+end_src #+end_src
@ -845,10 +845,10 @@ they are much more comfortable than Emacs’.
(evil-set-initial-state 'dashboard-mode 'normal)) (evil-set-initial-state 'dashboard-mode 'normal))
#+end_src #+end_src
I want to undefine some of the default keybinds of Evil because it I want to undefine some default keybinds of Evil because it does not
does not match my workflow. Namely, I use the space key and the comma match my workflow. Namely, I use the space key and the comma as
as leaders for my keybinds, and I’m way too used to Emacs’ ~C-t~, ~C-a~, leaders for my keybinds, and I’m way too used to Emacs’ ~C-t~, ~C-a~, ~C-e~,
~C-e~, and ~C-y~. and ~C-y~.
#+name: evil-undefine-keys #+name: evil-undefine-keys
#+begin_src emacs-lisp :tangle no #+begin_src emacs-lisp :tangle no
(evil-global-set-key 'motion "t" 'evil-next-visual-line) (evil-global-set-key 'motion "t" 'evil-next-visual-line)
@ -957,7 +957,7 @@ files with ~zstd~ when it is present on the system. Not only do we enjoy
much smaller files (according to DoomEmacs, we get something like 80% much smaller files (according to DoomEmacs, we get something like 80%
file savings), Emacs can load them much faster than the regular files. file savings), Emacs can load them much faster than the regular files.
Sure, it uses more CPU time uncompressing these files, but it’s Sure, it uses more CPU time uncompressing these files, but it’s
insignificant and it’s still faster than loading a heavier file. insignificant, and it’s still faster than loading a heavier file.
#+name: undo-tree-compress-files #+name: undo-tree-compress-files
#+begin_src emacs-lisp :tangle no #+begin_src emacs-lisp :tangle no
(when (executable-find "zstd") (when (executable-find "zstd")
@ -1243,11 +1243,11 @@ with an org-table.
:PROPERTIES: :PROPERTIES:
:CUSTOM_ID: Packages-Configuration-Autocompletion-Ivy84q1fl6184j0 :CUSTOM_ID: Packages-Configuration-Autocompletion-Ivy84q1fl6184j0
:END: :END:
My main menu package is ~ivy~ which I use as much as possible –I’ve My main menu package is =ivy= which I use as much as possible –I’ve
noticed ~helm~ can be slow, very slow in comparison to ~ivy~ so I’ll use noticed =helm= can be slow, very slow in comparison to =ivy=, so I’ll use
the latter as much as possible. Actually, only ~ivy~ is installed for the latter as much as possible. Actually, only =ivy= is installed for
now. I could have used ~ido~ too, but I find it to be a bit too now. I could have used =ido= too, but I find it to be a bit too
restricted in terms of features compared to ~ivy~. restricted in terms of features compared to =ivy=.
#+begin_src emacs-lisp #+begin_src emacs-lisp
(use-package ivy (use-package ivy
:straight (:build t) :straight (:build t)
@ -1377,7 +1377,7 @@ and ask the user for some input in some precise places.
(text-mode . yas-minor-mode))) (text-mode . yas-minor-mode)))
#+end_src #+end_src
Of course, yasnippet wouldn’t be as awesome as it is without premade Of course, yasnippet wouldn’t be as awesome as it is without pre-made
snippets. snippets.
#+begin_src emacs-lisp #+begin_src emacs-lisp
(use-package yasnippet-snippets (use-package yasnippet-snippets
@ -1386,7 +1386,7 @@ snippets.
:straight (:build t)) :straight (:build t))
#+end_src #+end_src
Similarly, yatemplate offers premade files rather than just strings. Similarly, yatemplate offers pre-made files rather than just strings.
That’s still yasnippet by the way. That’s still yasnippet by the way.
#+begin_src emacs-lisp #+begin_src emacs-lisp
(use-package yatemplate (use-package yatemplate
@ -1395,7 +1395,7 @@ That’s still yasnippet by the way.
:straight (:build t)) :straight (:build t))
#+end_src #+end_src
And finally, with ivy you can chose your snippets from a menu if And finally, with ivy you can choose your snippets from a menu if
you’re not sure or if you don’t remember what your snippet is. you’re not sure or if you don’t remember what your snippet is.
#+begin_src emacs-lisp #+begin_src emacs-lisp
(use-package ivy-yasnippet (use-package ivy-yasnippet
@ -1479,10 +1479,10 @@ database is to be stored.
#+end_src #+end_src
I don’t want YouTube videos to be open with my web browser when I I don’t want YouTube videos to be open with my web browser when I
invoke ~elfeed-show-visit~, so I’ll advise this function so I can modify invoke ~elfeed-show-visit~, so I’ll advise this function to make it
the behavior of said function. Oh, and I already made [[#Packages-Configuration-Misc-Ytplay-wxm9weq0r4j0][a neat package]] possible to modify the behavior of said function. Oh, and I already
for playing YouTube videos and friends through [[https://ytdl-org.github.io/youtube-dl/][youtube-dl]] or its made [[#Packages-Configuration-Misc-Ytplay-wxm9weq0r4j0][a neat package]] for playing YouTube videos and friends through
superior fork [[https://github.com/yt-dlp/yt-dlp][yt-dlp]] in mpv. [[https://ytdl-org.github.io/youtube-dl/][youtube-dl]] or its superior fork [[https://github.com/yt-dlp/yt-dlp][yt-dlp]] in mpv.
#+name: elfeed-open-youtube-with-mpv #+name: elfeed-open-youtube-with-mpv
#+begin_src emacs-lisp #+begin_src emacs-lisp
(defun my/elfeed-filter-youtube-videos (orig-fun &rest args) (defun my/elfeed-filter-youtube-videos (orig-fun &rest args)
@ -1815,8 +1815,8 @@ configuration for the ~mu4e~ package itself.
Quick sidenote: on ArchLinux, you’ll need to install either ~mu~ or Quick sidenote: on ArchLinux, you’ll need to install either ~mu~ or
~mu-git~ from the AUR in order to use mu4e. I also have a ~.desktop~ file ~mu-git~ from the AUR in order to use mu4e. I also have a ~.desktop~ file
so I can open mu4e directly from my program picker. It uses the shell to make it possible to open mu4e directly from my program picker. It
script ~emacsmail~ I’ve written [[file:bin.org::#Emacsmail-afffb7cd][here]]. uses the shell script ~emacsmail~ I’ve written [[file:bin.org::#Emacsmail-afffb7cd][here]].
#+header: :mkdirp yes #+header: :mkdirp yes
#+begin_src conf-desktop :tangle ~/.local/share/applications/mu4e.desktop #+begin_src conf-desktop :tangle ~/.local/share/applications/mu4e.desktop
[Desktop Entry] [Desktop Entry]
@ -1937,7 +1937,7 @@ Next I need an inbox dedicated to the association I’m part of.
As for the Emacs-doctor list, I need to match both the current, modern As for the Emacs-doctor list, I need to match both the current, modern
mailing list address but also its old address. The same applies for mailing list address but also its old address. The same applies for
the emacs-devel mailing list as well as Github emails related to my the emacs-devel mailing list as well as GitHub emails related to my
package ~eshell-info-banner.el~ ([[#Packages-Configuration-Emacs-built-ins-Eshell-Visual-configuratione7c2fl6184j0][see here]]). Here are the addresses to package ~eshell-info-banner.el~ ([[#Packages-Configuration-Emacs-built-ins-Eshell-Visual-configuratione7c2fl6184j0][see here]]). Here are the addresses to
match: match:
@ -1957,7 +1957,7 @@ match:
: list:/ateliers.*emacs.*/ OR t:/ateliers.*emacs.*/ OR f:/ateliers.*emacs.*/ OR contact:/ateliers.*emacs.*/ OR list:/emacs-.*@gnu.org/ OR t:/emacs-.*@gnu.org/ OR f:/emacs-.*@gnu.org/ OR contact:/emacs-.*@gnu.org/ OR list:/.*eshell-info-banner.*/ OR t:/.*eshell-info-banner.*/ OR f:/.*eshell-info-banner.*/ OR contact:/.*eshell-info-banner.*/ OR list:/.*emacsfr.*/ OR t:/.*emacsfr.*/ OR f:/.*emacsfr.*/ OR contact:/.*emacsfr.*/ : list:/ateliers.*emacs.*/ OR t:/ateliers.*emacs.*/ OR f:/ateliers.*emacs.*/ OR contact:/ateliers.*emacs.*/ OR list:/emacs-.*@gnu.org/ OR t:/emacs-.*@gnu.org/ OR f:/emacs-.*@gnu.org/ OR contact:/emacs-.*@gnu.org/ OR list:/.*eshell-info-banner.*/ OR t:/.*eshell-info-banner.*/ OR f:/.*eshell-info-banner.*/ OR contact:/.*eshell-info-banner.*/ OR list:/.*emacsfr.*/ OR t:/.*emacsfr.*/ OR f:/.*emacsfr.*/ OR contact:/.*emacsfr.*/
Another bookmark I wish to have is one dedicated to emails related to Another bookmark I wish to have is one dedicated to emails related to
more general development topics, including issues and PRs from Github. more general development topics, including issues and PRs from GitHub.
#+name: mu4e-github-mailing-lists #+name: mu4e-github-mailing-lists
- ~/.*\\.github\\.com/~ - ~/.*\\.github\\.com/~
- ~/.*\\.gitlab\\.com/~ - ~/.*\\.gitlab\\.com/~
@ -2098,9 +2098,9 @@ With this piece of code, I can simply jump to my inbox maildir with
I’m sure you have received at least one email recently from a sketchy I’m sure you have received at least one email recently from a sketchy
email address asking you something that might be completely unrelated email address asking you something that might be completely unrelated
to what you do, or at least somewhat related. Fortunately, [[https://twitter.com/Boris/status/1360208504544444417][we have a to what you do, or at least somewhat related. Fortunately, [[https://twitter.com/Boris/status/1360208504544444417][we have a
hero]]! Now, let me write a function that will insert their pre-written hero]]! Now, let me write a function that will insert their
text at point so I don’t have to go back to their Twitter thread each pre-written text at point to avoid me going back to their Twitter
time I want to shut spammers up. thread each time I want to shut spammers up.
#+begin_src emacs-lisp #+begin_src emacs-lisp
(defun reply-to-bill () (defun reply-to-bill ()
(interactive) (interactive)
@ -2336,8 +2336,8 @@ the major-mode leader and call a simple function.
:CUSTOM_ID: Packages-Configuration-Applications-Email-Composing-messagesth71fl6184j0 :CUSTOM_ID: Packages-Configuration-Applications-Email-Composing-messagesth71fl6184j0
:END: :END:
Org mime is cool and all, you can write some org-mode and then export Org mime is cool and all, you can write some org-mode and then export
it so you can send an HTML email. BUT, have you considered skipping it to either a plain-text or an HTML email. BUT, have you considered
the export part and write your emails directly in org-mode? skipping the export part and write your emails directly in org-mode?
#+begin_src emacs-lisp #+begin_src emacs-lisp
(use-package org-msg (use-package org-msg
:after (mu4e) :after (mu4e)
@ -2705,7 +2705,7 @@ left it.
Magit is an awesome wrapper around Git for Emacs! Very often, I go Magit is an awesome wrapper around Git for Emacs! Very often, I go
from disliking to really hating Git GUI clients because they often from disliking to really hating Git GUI clients because they often
obfuscate which Git commands are used to make things happen. Such a obfuscate which Git commands are used to make things happen. Such a
thing doesn’t happen with Magit, it’s pretty transparent but it still thing doesn’t happen with Magit, it’s pretty transparent, but it still
provides some awesome features and visualizations of what you are provides some awesome features and visualizations of what you are
doing and what Git is doing! In short, I absolutely love it! doing and what Git is doing! In short, I absolutely love it!
#+begin_src emacs-lisp #+begin_src emacs-lisp
@ -2759,7 +2759,7 @@ doing and what Git is doing! In short, I absolutely love it!
display in the Magit buffer a list of TODOs found in the current display in the Magit buffer a list of TODOs found in the current
project to remind you of what to do next. project to remind you of what to do next.
First, let’s setup our todo keywords with ~hl-todo~. A good few todo First, let’s se tup our todo keywords with ~hl-todo~. A good few todo
keywords are already defined in the ~hl-todo-keyword-faces~ variable. keywords are already defined in the ~hl-todo-keyword-faces~ variable.
Why not use them? ~hl-todo-mode~ enables fontlock highlight of these Why not use them? ~hl-todo-mode~ enables fontlock highlight of these
keywords in a buffer. Let’s enable this mode globally. keywords in a buffer. Let’s enable this mode globally.
@ -2816,7 +2816,7 @@ with ~magit-gitflow~:
:PROPERTIES: :PROPERTIES:
:CUSTOM_ID: Packages-Configuration-Project-Management-Forgelcq5fl6184j0 :CUSTOM_ID: Packages-Configuration-Project-Management-Forgelcq5fl6184j0
:END: :END:
Forge acts as an interface for Github, Gitlab, and Bitbucket inside Forge acts as an interface for GitHub, Gitlab, and Bitbucket inside
Magit. A lot of possibilities are present, you can read issues and Magit. A lot of possibilities are present, you can read issues and
pull requests, create them, and fork projects among other things. pull requests, create them, and fork projects among other things.
@ -2862,7 +2862,8 @@ which will be very useful when managing projects.
#+end_src #+end_src
Now, I can use projectile, which is sort of the /de facto/ standard Now, I can use projectile, which is sort of the /de facto/ standard
project manager in Emacs. I know there’s ~project.el~, but,… Eh… project manager in Emacs. I know there’s ~project.el~, but… Eh… I’m used
to projectile.
#+begin_src emacs-lisp #+begin_src emacs-lisp
(use-package projectile (use-package projectile
:straight (:build t) :straight (:build t)
@ -3367,9 +3368,9 @@ files and images.
#+end_src #+end_src
Copying files with Dired is a blocking process. It’s usually fine when Copying files with Dired is a blocking process. It’s usually fine when
there’s not a lot to copy, but it becomes more annoying when moving there’s not a lot to copy, but it becomes annoying when moving larger
larger files. The package ~dired-rsync~ allows to copy files with ~rsync~ files. The package ~dired-rsync~ allows copying files with ~rsync~ in the
in the background so we can carry on with our tasks while the copy is background; we can then carry on with our tasks while the copy is
happening. happening.
#+begin_src emacs-lisp #+begin_src emacs-lisp
(use-package dired-rsync (use-package dired-rsync
@ -3562,7 +3563,7 @@ that.
(eshell 'N)) (eshell 'N))
#+end_src #+end_src
A very useful command I use often in fish is ~z~, a port from bash’s and A very useful command I often use in fish is ~z~, a port from bash’s and
zsh’s command that allows to jump around directories based on how zsh’s command that allows to jump around directories based on how
often we go in various directories. often we go in various directories.
#+begin_src emacs-lisp #+begin_src emacs-lisp
@ -3840,11 +3841,11 @@ don’t know at which rate it is updated. And more packages down the
line will depend on this Git repository, so I might as well just clone line will depend on this Git repository, so I might as well just clone
it right now. it right now.
As you can see, in the ~:config~ secion I added to two hooks functions As you can see, I added in the ~:config~ secion to two hooks functions
so buffers are accurately renamed. While the average X window will that rename buffers accurately. While the average X window will simply
simply get the name of the current X window, I want Firefox and get the name of the current X window, I want Firefox and Qutebrowser
Qutebrowser to be prefixed with the name of the browser. Actually, all to be prefixed with the name of the browser. Actually, all these will
these will be renamed this way: be renamed this way:
#+name: exwm-renamed-buffers-list #+name: exwm-renamed-buffers-list
- Kitty - Kitty
- Qutebrowser - Qutebrowser
@ -3883,10 +3884,10 @@ these will be renamed this way:
<<exwm-gen-buffers-rename()>>))) <<exwm-gen-buffers-rename()>>)))
#+end_src #+end_src
As you can see below, in the ~:config~ section I added two advices and one As you can see below, in the ~:config~ section I added two advices and
hook in order to correctly integrate evil with EXWM. When I’m in an X one hook in order to correctly integrate evil with EXWM. When I’m in
window, I want to be in insert-mode so I can type however I want. an X window, I want to be in insert-mode in order to type however I
However, when I exit one, I want to default back to normal-mode. want. However, when I exit one, I want to default back to normal-mode.
#+name: exwm-advices-evil #+name: exwm-advices-evil
#+begin_src emacs-lisp :tangle no #+begin_src emacs-lisp :tangle no
(add-hook 'exwm-manage-finish-hook (lambda () (call-interactively #'exwm-input-release-keyboard))) (add-hook 'exwm-manage-finish-hook (lambda () (call-interactively #'exwm-input-release-keyboard)))
@ -3920,7 +3921,7 @@ completely forgotten. So I removed ~s-I~ and made ~s-<escape>~ behave like
As stated a couple of times in my different configuration files, I’m As stated a couple of times in my different configuration files, I’m
using the bépo layout, which means the default keys in the number row using the bépo layout, which means the default keys in the number row
are laid as follow: are laid as follows:
#+name: exwm-bepo-number-row #+name: exwm-bepo-number-row
#+begin_src emacs-lisp :tangle no #+begin_src emacs-lisp :tangle no
(defconst exwm-workspace-keys '("\"" "«" "»" "(" ")" "@" "+" "-" "/" "*")) (defconst exwm-workspace-keys '("\"" "«" "»" "(" ")" "@" "+" "-" "/" "*"))
@ -3952,7 +3953,7 @@ workspaces 0 to 9.
You can then see the list of the keybinds I have set for EXWM, which You can then see the list of the keybinds I have set for EXWM, which
are all prefixed with ~SPC x~ in normal mode (and ~C-SPC x~ in insert are all prefixed with ~SPC x~ in normal mode (and ~C-SPC x~ in insert
mode), with the exception of ~s-RET~ which opens an eshell terminal. mode), except for ~s-RET~ which opens an eshell terminal.
#+name: exwm-keybinds #+name: exwm-keybinds
#+begin_src emacs-lisp :tangle no #+begin_src emacs-lisp :tangle no
(exwm-input-set-key (kbd "s-<return>") (lambda () (exwm-input-set-key (kbd "s-<return>") (lambda ()
@ -4191,7 +4192,7 @@ human-friendly name."
:PROPERTIES: :PROPERTIES:
:CUSTOM_ID: Packages-Configuration-Making-my-life-easier-Buflerw215fl6184j0 :CUSTOM_ID: Packages-Configuration-Making-my-life-easier-Buflerw215fl6184j0
:END: :END:
Bufler is a package that organizes and lists buffers in a much better Bufler is a package that organises and lists buffers in a much better
way than how they are usually sorted. You can easily and quickly find way than how they are usually sorted. You can easily and quickly find
buffers by their group, not only by their name, and THIS is great buffers by their group, not only by their name, and THIS is great
news! Also, no ~helm~ please! And for some reasons the keybindings are news! Also, no ~helm~ please! And for some reasons the keybindings are
@ -4703,7 +4704,7 @@ A useful package I like is ~toc-org~ which creates automatically a table
of contents. My main usage for this however is not just to create a of contents. My main usage for this however is not just to create a
table of content of my files to quickly jump around my file (I have table of content of my files to quickly jump around my file (I have
~counsel-org-goto~ for that), but it is for creating table of contents ~counsel-org-goto~ for that), but it is for creating table of contents
for org files that will be hosted and viewable on Github. for org files that will be hosted and viewable on GitHub.
#+begin_src emacs-lisp #+begin_src emacs-lisp
(use-package toc-org (use-package toc-org
:after (org markdown-mode) :after (org markdown-mode)
@ -5881,8 +5882,8 @@ to anything user-defined. Let’s all-the-iconify this!
:END: :END:
Treesit is a native Emacs [[https://tree-sitter.github.io/tree-sitter/][tree-sitter]] implementation which provides a Treesit is a native Emacs [[https://tree-sitter.github.io/tree-sitter/][tree-sitter]] implementation which provides a
very fast and flexible way of performing code-highlighting in Emacs. very fast and flexible way of performing code-highlighting in Emacs.
It is built-in in Emacs 29 and newer, and I just need to tweak one It is built-in in Emacs 29 and newer, and I just need to tweak a couple of
variable for now so I can install grammars for different languages. variables to install grammars for different languages.
#+begin_src emacs-lisp #+begin_src emacs-lisp
(use-package treesit (use-package treesit
:defer t :defer t
@ -6482,7 +6483,7 @@ visual graphs and networks.
:END: :END:
Yes, I love org-mode and I largely prefer to use it instead of Yes, I love org-mode and I largely prefer to use it instead of
Markdown due to its far superior power and abilities. But still, Markdown due to its far superior power and abilities. But still,
sometimes I need to use Markdown because not everyone use org-mode, sometimes I need to use Markdown because not everyone uses org-mode,
unfortunately. unfortunately.
#+begin_src emacs-lisp #+begin_src emacs-lisp
(use-package markdown-mode (use-package markdown-mode
@ -6584,7 +6585,7 @@ unfortunately.
(setq markdown-fontify-code-blocks-natively t)) (setq markdown-fontify-code-blocks-natively t))
#+end_src #+end_src
Since most of my Markdown files are related to Github, I’d like to be Since most of my Markdown files are related to GitHub, I’d like to be
able to render Markdown through its API. able to render Markdown through its API.
#+begin_src emacs-lisp #+begin_src emacs-lisp
(use-package gh-md (use-package gh-md
@ -6598,7 +6599,7 @@ able to render Markdown through its API.
"cr" #'gh-md-render-buffer)) "cr" #'gh-md-render-buffer))
#+end_src #+end_src
Sometimes, I have to work with Github’s markdown flavour, but I’m not Sometimes, I have to work with GitHub’s markdown flavour, but I’m not
really a huge fan of writing it by hand. So instead, I’ll write it in really a huge fan of writing it by hand. So instead, I’ll write it in
org-mode and then export it with ~ox-gfm~. org-mode and then export it with ~ox-gfm~.
#+begin_src emacs-lisp #+begin_src emacs-lisp
@ -6874,10 +6875,10 @@ In Lisp buffers, let’s enable ~parinfer-rust-mode~.
My current window manager is StumpWM, inspired by Emacs and written in My current window manager is StumpWM, inspired by Emacs and written in
CommonLisp. ~stumpwm-mode~ offers some integration between Emacs and CommonLisp. ~stumpwm-mode~ offers some integration between Emacs and
StumpWM so we can evaluate CLisp code and see its effects in StumpWM StumpWM that makes the user able to evaluate CommonLisp code and see
immediately. Since my only use for CommonLisp is for my StumpWM its effects in StumpWM immediately. Since my only use for CommonLisp
configuration, it should be automatically enabled when entering is for my StumpWM configuration, it should be automatically enabled
~lisp-mode~. when entering ~lisp-mode~.
#+begin_src emacs-lisp #+begin_src emacs-lisp
(use-package stumpwm-mode (use-package stumpwm-mode
:straight (:build t) :straight (:build t)
@ -7016,7 +7017,7 @@ If I need to run CI on a package, [[https://github.com/cask/cask][Cask]] manages
#+end_src #+end_src
However, I recently began using [[https://github.com/emacs-eask/eask][Eask]] more and more, I find it nicer to However, I recently began using [[https://github.com/emacs-eask/eask][Eask]] more and more, I find it nicer to
work with and it has a lot more features than Cask. work with, and it has a lot more features than Cask.
#+begin_src emacs-lisp #+begin_src emacs-lisp
(use-package eask-api (use-package eask-api
:defer t :defer t
@ -7358,7 +7359,7 @@ development. First, let’s install the most important package,
:CUSTOM_ID: Packages-Configuration-Programming-languages-General-Programming-Languages-Web-programming-7ca40po085j0 :CUSTOM_ID: Packages-Configuration-Programming-languages-General-Programming-Languages-Web-programming-7ca40po085j0
:END: :END:
[[https://emmet.io/][Emmet]] is a powerful templating engine that can generate through simple [[https://emmet.io/][Emmet]] is a powerful templating engine that can generate through simple
CSS-like expression some HTML so you don’t have to write everything by CSS-like expression some HTML to avoid the user writing everything by
hand. hand.
#+begin_src emacs-lisp #+begin_src emacs-lisp
(use-package emmet-mode (use-package emmet-mode
@ -7384,8 +7385,8 @@ hand.
"ew" #'emmet-wrap-with-markup)) "ew" #'emmet-wrap-with-markup))
#+end_src #+end_src
Impatient mode serves web buffers live over HTTP so you can see your Impatient mode serves web buffers live over HTTP, including your live
editions as you type them. modifications.
#+begin_src emacs-lisp #+begin_src emacs-lisp
(use-package impatient-mode (use-package impatient-mode
:straight (:build t) :straight (:build t)
@ -7573,7 +7574,7 @@ Next.JS.
#+end_src #+end_src
~js2-refactor~ is an amazing tool for refactoring Javascript code. I ~js2-refactor~ is an amazing tool for refactoring Javascript code. I
mean, [[https://www.youtube.com/watch?v=-7yMWD1wUu4][look at this]]! And the video is only from 2013 and it still mean, [[https://www.youtube.com/watch?v=-7yMWD1wUu4][look at this]]! And the video is only from 2013, and it still
receives some commits! receives some commits!
#+begin_src emacs-lisp #+begin_src emacs-lisp
(use-package js2-refactor (use-package js2-refactor

60
org/config/fish.org
View File

@ -15,7 +15,7 @@ The file present in =~/.config/fish/config.fish= is the configuration file for
the [[https://fishshell.com/][fish shell]]. It contains custom functions, environment variables and the [[https://fishshell.com/][fish shell]]. It contains custom functions, environment variables and
abbreviations. abbreviations.
Just in case, we might need sometimes to declare the fish function =fish_title= Just in case, we might sometimes need to declare the fish function =fish_title=
as =true=, so let’s do so. as =true=, so let’s do so.
#+BEGIN_SRC fish #+BEGIN_SRC fish
function fish_title function fish_title
@ -59,10 +59,11 @@ set -gx PKG_CONFIG_PATH /usr/local/lib/pkgconfig/ $PKG_CONFIG_PATH
:PROPERTIES: :PROPERTIES:
:CUSTOM_ID: Tramp_remote_access-72aedec2 :CUSTOM_ID: Tramp_remote_access-72aedec2
:END: :END:
When accessing from a remote machine our computer from Emacs, tramp needs a When accessing from a remote machine our computer from Emacs, tramp
precise shell appearance: a simple =$= followed by a space after which to put needs a precise shell appearance: a simple =$= followed by a space after
the commands it needs to execute, and nothing else. Due to this, let’s which to put the commands it needs to execute, and nothing else. Due
deactivate and redefine some of the functions defining the appearance of fish. to this, let’s deactivate and redefine some functions defining the
appearance of fish.
#+BEGIN_SRC fish #+BEGIN_SRC fish
if test "$TERM" = "dumb" if test "$TERM" = "dumb"
function fish_prompt function fish_prompt
@ -245,16 +246,17 @@ the terminal window will come back.
:PROPERTIES: :PROPERTIES:
:CUSTOM_ID: Abbreviations-System_monitoring-bd909755 :CUSTOM_ID: Abbreviations-System_monitoring-bd909755
:END: :END:
Here I have some abbreviations which are quite useful when performing some Here I have some abbreviations which are quite useful when performing
system monitoring. With =df=, we can get an overview of our filesystem usage, some system monitoring. With =df=, we can get an overview of our
while with =diskspace= we get some more precise information. =meminfo= is a call filesystem usage, while with =diskspace= we get some more precise
to =free= with sane defaults, and similar to =meminfo=, we also have information. =meminfo= is a call to =free= with sane defaults, and similar
=gpumeminfo= so we can get a quick look at the memory-related logs of our X to =meminfo=, we also have =gpumeminfo= to get a quick look at the
session. I also declared =cpuinfo= an alias of =lscpu= in order to keep memory-related logs of our X session. I also declared =cpuinfo= an alias
consistent with =meminfo=. =pscpu= gives us information on what the CPU is of =lscpu= in order to keep consistent with =meminfo=. =pscpu= gives us
running right now, and =pscpu10= limits that to the top 10 threads. Similarly, information on what the CPU is running right now, and =pscpu10= limits
=psmem= gives us information on the memory usage of the current threads, and that to the top 10 threads. Similarly, =psmem= gives us information on
=psmem10= only the ten most important threads in terms of memory usage. the memory usage of the current threads, and =psmem10= only the ten most
important threads in terms of memory usage.
#+NAME: mgmt-abbr #+NAME: mgmt-abbr
| abbreviation | command | | abbreviation | command |
|--------------+--------------------------------------------| |--------------+--------------------------------------------|
@ -327,7 +329,7 @@ comes to compilation or Docker.
:PROPERTIES: :PROPERTIES:
:CUSTOM_ID: Abbreviations-Development-CMake-f2951675 :CUSTOM_ID: Abbreviations-Development-CMake-f2951675
:END: :END:
I have the following abbreviations so I can quickly run CMake and create a I have the following abbreviations to quickly run CMake and create a
configuration for debug or release profiles. configuration for debug or release profiles.
#+NAME: abbr-cmake #+NAME: abbr-cmake
| abbreviation | command | | abbreviation | command |
@ -374,7 +376,7 @@ I greatly prefer to use Emacsclient as my main text editor; Emacs has basically
all I need. So, it's only normal I have an abbreviation to launch a new instance all I need. So, it's only normal I have an abbreviation to launch a new instance
of it. If launched in the terminal, I’ll usually want Emacs to be displayed in of it. If launched in the terminal, I’ll usually want Emacs to be displayed in
CLI mode and not in GUI mode, otherwise I would invoke it with my WM’s shortcut. CLI mode and not in GUI mode, otherwise I would invoke it with my WM’s shortcut.
In case we want to launch Emacs in GUI mode anyways, ~egui~ is available too. In case we want to launch Emacs in GUI mode anyway, ~egui~ is available too.
#+NAME: abbr-text-ed #+NAME: abbr-text-ed
| abbreviation | command | | abbreviation | command |
@ -428,7 +430,7 @@ Here is the corresponding fish configuration:
:CUSTOM_ID: Abbreviations-LaTeX-76865eb9 :CUSTOM_ID: Abbreviations-LaTeX-76865eb9
:END: :END:
Yes, although I use org-mode, I still have some use for LaTeX, especially when Yes, although I use org-mode, I still have some use for LaTeX, especially when
it comes to PDF exports of my org files. Hence why I use the LaTeX package it comes to PDF exports of my org files. Hence, why I use the LaTeX package
manager. It is recommended to use ~tllocalmgr~ instead of ~tlmgr~, but I can manager. It is recommended to use ~tllocalmgr~ instead of ~tlmgr~, but I can
never remember the command, and the latter is faster to type, so time for an never remember the command, and the latter is faster to type, so time for an
abbreviation. Same goes for ~texhash~ which must be run as sudo. abbreviation. Same goes for ~texhash~ which must be run as sudo.
@ -447,14 +449,14 @@ Here is the corresponding fish configuration:
:PROPERTIES: :PROPERTIES:
:CUSTOM_ID: Abbreviations-Some_security_measures-489cb521 :CUSTOM_ID: Abbreviations-Some_security_measures-489cb521
:END: :END:
Some commands can be quite dangerous when not used properly, which is why I Some commands can be quite dangerous when not used properly, which is
added default flags and options so I can get warnings before things get ugly. why I added default flags and options in order to get warnings before
The =-i= and =-I= add prompts in case we might not want to do what we asked the things get ugly. The =-i= and =-I= add prompts in case we might not want
shell to do. Notice =lns= which creates symlinks, =rmd= which removes to do what we asked the shell to do. Notice =lns= which creates
directories, =rmf= which forces deletion, and =rmdf= which forces the delition symlinks, =rmd= which removes directories, =rmf= which forces deletion,
of a directory. Notice also the =--preserve-root= which will prevent me from and =rmdf= which forces the delition of a directory. Notice also the
accidentally removing the root folder. I added the same option to =chgrp=, =--preserve-root= which will prevent me from accidentally removing the
=chmod=, and =chown=. root folder. I added the same option to =chgrp=, =chmod=, and =chown=.
#+NAME: sec-abbr #+NAME: sec-abbr
| abbreviation | command | | abbreviation | command |
|--------------+--------------------------| |--------------+--------------------------|
@ -539,13 +541,13 @@ program.
abbr nsxiv 'nsxiv -abfos f' abbr nsxiv 'nsxiv -abfos f'
#+END_SRC #+END_SRC
The following abbreviation is here so I can easily launch software The following abbreviation is here to launch software with my Nvidia
with my Nvidia GPU. GPU.
#+begin_src fish #+begin_src fish
abbr nv 'env __NV_PRIME_RENDER_OFFLOAD=1 __GLX_VENDOR_LIBRARY_NAME=nvidia' abbr nv 'env __NV_PRIME_RENDER_OFFLOAD=1 __GLX_VENDOR_LIBRARY_NAME=nvidia'
#+end_src #+end_src
Finally, let's declare the following abbreviation that will launch an mpv Finally, let's declare the following abbreviation that will launch a MPV
instance displaying my webcam: instance displaying my webcam:
#+BEGIN_SRC fish #+BEGIN_SRC fish
abbr webcam 'devour mpv --demuxer-lavf-format=video4linux2 --demuxer-lavf-o-set=input_format=mjpeg av://v4l2:/dev/video0' abbr webcam 'devour mpv --demuxer-lavf-format=video4linux2 --demuxer-lavf-o-set=input_format=mjpeg av://v4l2:/dev/video0'

27
org/config/index.org
View File

@ -38,15 +38,15 @@ some games that do not offer to remap keys (I’m looking at you, Among Us).
:PROPERTIES: :PROPERTIES:
:CUSTOM_ID: Features-5ab2a2c0 :CUSTOM_ID: Features-5ab2a2c0
:END: :END:
- Emacs configuration perfectly tailored for my own use - Emacs' configuration perfectly tailored for my own use
- Beautiful and comfy StumpWM configuration - Beautiful and comfy StumpWM configuration
- And enough information below to get basically the same distro - And enough information below to get basically the same distro
install as I have on computer. install as I have on computer.
Most of the org files you will find in this repos are the actual Most of the org files you will find in this repo are the actual source
source code of much of my config files. For instance, the bootstrap code of much of my config files. For instance, the bootstrap found in
found in [[file:bootstrap.org][bootstrap.org]] exports almost all of its code snippets to [[file:bootstrap.org][bootstrap.org]] exports almost all of its code snippets to
~$HOME/.config/yadm/bootstrap~ thanks to =M-x org-babel-tangle= from =$HOME/.config/yadm/bootstrap= thanks to =M-x org-babel-tangle= from
within Emacs. Below I will also present and comment some of my short within Emacs. Below I will also present and comment some of my short
config files which do not deserve to have a full org file dedicated to config files which do not deserve to have a full org file dedicated to
them. them.
@ -186,14 +186,15 @@ welcome either.
:PROPERTIES: :PROPERTIES:
:CUSTOM_ID: Features-And-some-minor-configuration-files-Paru-1f3ef49e :CUSTOM_ID: Features-And-some-minor-configuration-files-Paru-1f3ef49e
:END: :END:
~paru~ is an AUR helper for Arch Linux which aims to be a replacement for ~yay~. ~paru~ is an AUR helper for Arch Linux which aims to be a replacement
A couple of the options you will see below aim at restoring the behavior of for ~yay~. A couple of the options you will see below aim at restoring
~yay~ in ~paru~. I also activated the sudo loop so I don’t have to enter my the behavior of ~yay~ in ~paru~. Sudo loop avoids me having to enter again
password if one package takes too much time to compile and/or compress. I know my password if one package takes too much time to compile and/or
it can be a security issue if someone ever get access to my computer while paru compress. I know it can be a security issue if someone ever get access
is running, but if it ever happens it will be already concerning enough they to my computer while paru is running, but if it ever happens it will
managed to. I also make use of [[file:bin.org::#Emacs-stuff-Dired-2eeca9da][my custom script dired]] so I can use Emacs’ Dired be already concerning enough they managed to. I also make use of [[file:bin.org::#Emacs-stuff-Dired-2eeca9da][my
as the file manager for ~paru~. custom script dired]] so I can use Emacs’ Dired as the file manager
for ~paru~.
#+BEGIN_SRC conf :tangle ~/.config/paru/paru.conf :mkdirp yes #+BEGIN_SRC conf :tangle ~/.config/paru/paru.conf :mkdirp yes
[options] [options]
BottomUp BottomUp

16
org/config/mpd.org
View File

@ -62,9 +62,9 @@ log_file "~/.config/mpd/log"
:PROPERTIES: :PROPERTIES:
:CUSTOM_ID: Optional-Parameters-hkw8zz71v8j0 :CUSTOM_ID: Optional-Parameters-hkw8zz71v8j0
:END: :END:
While these values are not strictly necessary, some are still While these values are not strictly necessary, some are still useful
extremely useful such as ~music_directory~ so we don’t have to manually such as ~music_directory~: we don’t have to manually add our music to
add our music to MPD each time we run it. MPD each time we run it.
#+name: mpd-optional-parameters #+name: mpd-optional-parameters
| Parameter | Value | Comment | | Parameter | Value | Comment |
|--------------------+---------------------+-----------------------------------------------------------| |--------------------+---------------------+-----------------------------------------------------------|
@ -83,9 +83,8 @@ add our music to MPD each time we run it.
:PROPERTIES: :PROPERTIES:
:CUSTOM_ID: Audio-outputs-emqjro81v8j0 :CUSTOM_ID: Audio-outputs-emqjro81v8j0
:END: :END:
Two audio outputs will be defined. The first one is dedicated to Two audio outputs will be defined. The first one sets Pulseaudio up so
Pulseaudio so I can actually hear my music. Its configuration is I can actually hear my music. Its configuration is simple, really.
simple, really.
#+begin_src conf-space #+begin_src conf-space
audio_output { audio_output {
type "pulse" type "pulse"
@ -93,9 +92,8 @@ audio_output {
} }
#+end_src #+end_src
Another one is created, but this time for the visualizer of ~ncmpcpp~. Another one sets up the visualizer of ~ncmpcpp~. It is not necessary to
It is not necessary to create this one if you don’t plan on using this create this one if you don’t plan on using this feature.
feature.
#+begin_src conf-space #+begin_src conf-space
audio_output { audio_output {
type "fifo" type "fifo"

6
org/config/neofetch.org
View File

@ -405,7 +405,7 @@ gtk3="off"
:PROPERTIES: :PROPERTIES:
:CUSTOM_ID: Information_settings-Hardware-CPU-CPU_brand-5b25776b :CUSTOM_ID: Information_settings-Hardware-CPU-CPU_brand-5b25776b
:END: :END:
With this variables, it is possible to show or hide the brand of a CPU in the With these variables, it is possible to show or hide the brand of a CPU in the
~cpu~ output. ~cpu~ output.
- Default value :: ~"on"~ - Default value :: ~"on"~
- Values :: - Values ::
@ -459,8 +459,8 @@ speed_type="bios_limit"
:PROPERTIES: :PROPERTIES:
:CUSTOM_ID: Information_settings-Hardware-CPU-CPU_speed_shorthand-0d15fe08 :CUSTOM_ID: Information_settings-Hardware-CPU-CPU_speed_shorthand-0d15fe08
:END: :END:
This value allows to show sorter CPU speed with less digits. This flag is not This value allows showing sorter CPU speed with fewer digits. This flag
supported in systems with CPU speed below 1GHz. is not supported in systems with CPU speed below 1GHz.
- Default value :: ~"off"~ - Default value :: ~"off"~
- Values :: - Values ::
- ~"on"~ - ~"on"~

73
org/config/picom.org
View File

@ -26,7 +26,7 @@ requested using the wintypes option.
shadow = true; shadow = true;
#+END_SRC #+END_SRC
The blur radius radius for shadows is measured in pixels, and it defaults to The blur radius for shadows is measured in pixels, and it defaults to
12px. 12px.
#+BEGIN_SRC conf #+BEGIN_SRC conf
shadow-radius = 17; shadow-radius = 17;
@ -55,8 +55,8 @@ or ~shadow-blue~.
shadow-color = "#171A20" shadow-color = "#171A20"
#+END_SRC #+END_SRC
It is possible to specify a list of conditions of windows that should have no It is possible to specify a list of conditions of windows that should
shadow. have no shadow.
| Default value | ~[]~ | | Default value | ~[]~ |
#+BEGIN_SRC conf #+BEGIN_SRC conf
shadow-exclude = [ shadow-exclude = [
@ -102,9 +102,9 @@ config file instead.
no-dock-shadow = false; no-dock-shadow = false;
#+END_SRC #+END_SRC
This option allows Picom not to draw on drag-and-drop windows. This option is This option allows Picom not to draw on drag-and-drop windows. It is
deprecated, and users should use the ~wintypes~ option in their config file deprecated, and users should use the ~wintypes~ option in their config
instead. file instead.
| Default value | ~false~ | | Default value | ~false~ |
#+BEGIN_SRC conf #+BEGIN_SRC conf
no-dnd-shadow = false; no-dnd-shadow = false;
@ -156,7 +156,8 @@ feature on or off. However, its behavior can be changed with
fading = true fading = true
#+END_SRC #+END_SRC
These values controls the opacity change between steps while fading in and out. These values control the opacity change between steps while fading in
and out.
| Default value | ~0.028~ (fade-in), ~0.03~ (fade-out) | | Default value | ~0.028~ (fade-in), ~0.03~ (fade-out) |
| Min value | ~0.01~ | | Min value | ~0.01~ |
| Max value | ~1.0~ | | Max value | ~1.0~ |
@ -268,7 +269,7 @@ focus-exclude = [
#+END_SRC #+END_SRC
The user can also specify a list of opacity rules, in the format The user can also specify a list of opacity rules, in the format
~PERCENT:PATTERN~, like ~50:name *= "Firefox"~ . ~picom-trans~ is recommended ~PERCENT:PATTERN~, like ~50:name *= "Firefox"~ . ~picom-trans~ is recommended
over this. Note we don't make any guarantee about possible conflicts with other over this. Note we don't make any guarantee about possible conflicts with other
programs that set ~_NET_WM_WINDOW_OPACITY~ on frame or client windows. programs that set ~_NET_WM_WINDOW_OPACITY~ on frame or client windows.
| Default value | ~[]~ | | Default value | ~[]~ |
@ -336,8 +337,8 @@ blur-background-exclude = [
:PROPERTIES: :PROPERTIES:
:CUSTOM_ID: General_settings-41398de7 :CUSTOM_ID: General_settings-41398de7
:END: :END:
Daemonize process. Fork to background after initialization. Causes issues with Daemonize process. Fork to background after initialization. Can cause
certain (badly-written) drivers. issues with certain (badly-written) drivers.
| Default value | ~false~ | | Default value | ~false~ |
#+BEGIN_SRC conf #+BEGIN_SRC conf
daemon = true; daemon = true;
@ -391,13 +392,10 @@ passing ~_NET_WM_OPACITY~ of client windows to frame windows.
detect-client-opacity = true; detect-client-opacity = true;
#+END_SRC #+END_SRC
Limit picom to repaint at most once every 1 / ~refresh_rate~ second to boost Limit picom to repaint at most once every 1 / ~refresh_rate~ second to
performance. This should not be used with boost performance. This should not be used with ~vsync
#+BEGIN_SRC text :tangle no drm/opengl/opengl-oml~ as they essentially do sw-opti's job already,
vsync drm/opengl/opengl-oml unless you wish to specify a lower refresh rate than the actual value.
#+END_SRC
as they essentially does sw-opti's job already, unless you wish to specify a
lower refresh rate than the actual value.
| Default value | ~""~ | | Default value | ~""~ |
#+BEGIN_SRC conf #+BEGIN_SRC conf
# sw-opti =; # sw-opti =;
@ -411,10 +409,10 @@ the WM supports it.
# use-ewmh-active-win = false; # use-ewmh-active-win = false;
#+END_SRC #+END_SRC
Unredirect all windows if a full-screen opaque window is detected, to maximize Unredirect all windows if a full-screen opaque window is detected, to
performance for full-screen windows. Known to cause flickering when maximize performance for full-screen windows. Known to cause
redirecting/unredirecting windows. paint-on-overlay may make the flickering less flickering when redirecting/unredirecting windows. =paint-on-overlay=
obvious. may make the flickering less obvious.
| Default value | ~false~ | | Default value | ~false~ |
#+BEGIN_SRC conf #+BEGIN_SRC conf
unredir-if-possible = false; unredir-if-possible = false;
@ -500,10 +498,10 @@ fullscreen based only on its size and coordinates.
no-ewmh-fullscreen = false; no-ewmh-fullscreen = false;
#+END_SRC #+END_SRC
Dimming bright windows so their brightness doesn't exceed this set value. Dimming bright windows so their brightness doesn't exceed this set
Brightness of a window is estimated by averaging all pixels in the window, so value. Brightness of a window is estimated by averaging all pixels in
this could comes with a performance hit. Setting this to 1.0 disables this the window, so this could come with a performance hit. Setting this to
behaviour. Requires ~--use-damage~ to be disabled. 1.0 disables this behaviour. Requires ~--use-damage~ to be disabled.
| Default value | ~1.0~ | | Default value | ~1.0~ |
#+BEGIN_SRC conf #+BEGIN_SRC conf
max-brightness = 1.0; max-brightness = 1.0;
@ -516,24 +514,25 @@ instead of blending on top of them.
transparent-clipping = false; transparent-clipping = false;
#+END_SRC #+END_SRC
Set the log level. Possible values are: Set the log level. Possible values in increasing level of importance are:
- ~trace~ - ~trace~
- ~debug~ - ~debug~
- ~info~ - ~info~
- ~warn~ - ~warn~
- ~error~ - ~error~
in increasing level of importance. Case doesn't matter. If using the "TRACE" log Case doesn't matter. If using the "TRACE" log level, it's better to
level, it's better to log into a file using ~--log-file~, since it can generate log into a file using ~--log-file~, since it can generate a huge stream
a huge stream of logs. of logs.
| Default value | ~"debug"~ | | Default value | ~"debug"~ |
#+BEGIN_SRC conf #+BEGIN_SRC conf
log-level = "warn"; log-level = "warn";
#+END_SRC #+END_SRC
Set the log file. If ~--log-file~ is never specified, logs will be written to Set the log file. If ~--log-file~ is never specified, logs will be
stderr. Otherwise, logs will to written to the given file, though some of the written to stderr. Otherwise, logs will to written to the given file,
early logs might still be written to the stderr. When setting this option from though some early logs might still be written to the stderr. When
the config file, it is recommended to use an absolute path. setting this option from the config file, it is recommended to use an
absolute path.
| Default value | ~''~ | | Default value | ~''~ |
#+BEGIN_SRC conf #+BEGIN_SRC conf
# log-file = '/path/to/your/log/file'; # log-file = '/path/to/your/log/file';
@ -577,10 +576,10 @@ Following per window-type options are available:
- full-shadow :: Controls whether shadow is drawn under the parts of the window - full-shadow :: Controls whether shadow is drawn under the parts of the window
that you normally won't be able to see. Useful when the window has parts of it that you normally won't be able to see. Useful when the window has parts of it
transparent, and you want shadows in those areas. transparent, and you want shadows in those areas.
- redir-ignore :: Controls whether this type of windows should cause screen to - redir-ignore :: Controls whether this type of windows should cause
become redirected again after been unredirected. If you have screen to become redirected again after being unredirected. If you
unredir-if-possible set, and doesn't want certain window to cause unnecessary have =unredir-if-possible= set, and doesn't want certain window to
screen redirection, you can set this to `true`. cause unnecessary screen redirection, you can set this to =true=.
#+BEGIN_SRC conf #+BEGIN_SRC conf
wintypes: wintypes:
{ {