literate-dotfiles/install.org

#+TITLE: Installation
#+SETUPFILE: ./setup/org-setup-file.org

* =yay= - Package Manager
https://github.com/Jguer/yay

Installation:
#+begin_src bash
  sudo pacman -S yay
#+end_src

#+name: tab:yay_cheatsheet
#+caption: =yay= - Cheatsheet
| Command             | Usage                       |
|---------------------+-----------------------------|
| =yay=               | Perform system upgrade      |
| =yay -Ss <package>= | Search                      |
| =yay -S <package>=  | Install                     |
| =yay -Si <package>= | Get informations            |
| =yay -Rs <package>= | Uninstall                   |
| =yay -Yc=           | Clean unneeded dependencies |

To check all installed packages:
#+begin_src bash
  pacman -Qq | fzf --preview 'pacman -Qil {}' --layout=reverse --bind 'enter:execute(pacman -Qil {} | less)'
#+end_src

* =git= - Version Control System

Installation:
#+begin_src bash
  yay -S git
#+end_src

[[file:git.org][Git]] Configuration:
- =~/.gitconfig=
- =~/.gitignore_global=

[[https://github.com/so-fancy/diff-so-fancy][Diff-So-Fancy]] is a nice addition to have good-looking diffs.
It can be installed like so:
#+begin_src bash
  yay -S diff-so-fancy
#+end_src

And configured with the following command:
#+begin_src bash
  git config --global core.pager "diff-so-fancy | less --tabs=4 -RFX"
#+end_src

=pass= can be used as credential helper for git repositories.

* =termite= - Terminal
[[https://github.com/thestinger/termite][Termite]] is a very nice keyboard-centric terminal.

It can be installed like so:
#+begin_src bash
  yay -S termite
#+end_src

Its configuration file is described [[file:termite.org][here]].

#+name: tab:termite_cheatsheet
#+caption: =termite= - Cheatsheet
| Command            | Usage                   |
|--------------------+-------------------------|
| =ctrl-shift-x=     | activate url hints mode |
| =ctrl-shift-c=     | copy to CLIPBOARD       |
| =ctrl-shift-v=     | paste from CLIPBOARD    |
| =ctrl-shift-space= | start selection mode    |
| =ctrl +=           | increase font size      |
| =ctrl -=           | decrease font size      |

* =bash= - Shell
https://wiki.archlinux.org/index.php/Bash

Installation:
#+begin_src bash
  yay -S bash bash-completion zsh
#+end_src

[[file:bash.org][Bash]] configuration:
- =~/.bashrc=
- =~/.bash_profile=
- =~/.config/bash/=
- =~/.profile=

* =tmux= - Terminal Multiplexer
https://github.com/tmux/tmux

Installation:
#+begin_src bash
  yay -S tmux
#+end_src

[[file:tmux.org][TMUX]] configuration

Ressources:
- https://github.com/gpakosz/.tmux
- https://gist.github.com/MohamedAlaa/2961058
- https://blog.bugsnag.com/tmux-and-vim/
- https://github.com/tmux-plugins/tmux-resurrect
- https://github.com/rothgar/awesome-tmux
- https://thoughtbot.com/upcase/tmux

#+name: tab:tmux_cheatsheet
#+caption: =tmux= - Cheatsheet
| Command        | Usage                         |
|----------------+-------------------------------|
| =ctrl-spc=     | Prefix                        |
| =c=            | New pane                      |
| =/=, =-=       | Split Vertically/Horizontally |
| =s=            | Change session                |
| =p=, =n=       | Previous/Next Pane            |
| =ctrl-h,j,k,l= | Move between windows          |

* Fonts
My font of choice is =nerd-fonts-hack= which can be installed as so:
#+begin_src bash
 yay -S nerd-fonts-hack
#+end_src

For emojis, use:
#+begin_src bash
  yay -S noto-fonts-emoji
#+end_src

Default font used:
- Monospace Font: =Hack Nerd Font Mono=
- Serif Font: =Hack Nerd Font=
- Sans Font: =Hack Nerd Font=

To list all fonts available:
#+begin_src bash
  fc-list
#+end_src

To select fonts using a GUI, =gtk2fontsel= can be used:
#+begin_src bash
  yay -S gtk2fontsel
#+end_src

* =emacs= and =vim= - Text Editors
** Neovim
I use [[https://github.com/neovim/neovim][Neovim]] for all the small edits.

Installation:
#+begin_src bash
  yay -S neovim
#+end_src

The Neovim configuration can be found [[file:vim.org][here]].

Then install the plugin manager [[https://github.com/junegunn/vim-plug][plug]]:
#+begin_src bash
  sh -c 'curl -fLo "${XDG_DATA_HOME:-$HOME/.local/share}"/nvim/site/autoload/plug.vim --create-dirs \
      https://raw.githubusercontent.com/junegunn/vim-plug/master/plug.vim'
#+end_src

And to install/setup all the plugins:
#+begin_src bash
  nvim +PlugInstall
  nvim +UpdateRemotePlugins
#+end_src

** Emacs
I use [[https://www.gnu.org/software/emacs/][Emacs]] and the [[https://github.com/hlissner/doom-emacs][Doom]] framework.

Install Emacs:
#+begin_src bash
  yay -S emacs
#+end_src

And then the Doom framework:
#+begin_src bash
  git clone --depth 1 https://github.com/hlissner/doom-emacs ~/.emacs.d
  ~/.emacs.d/bin/doom install
#+end_src

The Emacs configuration can be found [[./doom.org][here]].

SpellCheck with Aspell:
#+begin_src bash
  yay -S aspell aspell-en aspell-fr
#+end_src

* SSH setup
Generate a new SSH key:
#+begin_src bash
  ssh-keygen -t rsa -b 4096 -C "dehaeze.thomas@gmail.com"
#+end_src

Start the ssh-agent in the background:
#+begin_src bash
  eval "$(ssh-agent -s)"
#+end_src

Add the SSH key to the ssh-agent:
#+begin_src bash
  ssh-add ~/.ssh/id_rsa
#+end_src

* GnuPG
https://gnupg.org/

Install the gnupg package:
#+begin_src bash
  yay -S gnupg
#+end_src

Create a key pair:
#+begin_src bash
  gpg --full-gen-key
#+end_src

To configure the =gpg-agent= to cache the passphrase, edit the following file =~/.gnupg/gpg-agent.conf=:
#+begin_src conf
  default-cache-ttl 60480000
  max-cache-ttl 60480000
#+end_src

Install =Gnome-Keyring= to automatically unlock the GnuPG keys:
#+begin_src bash
  yay -S gnome-keyring
#+end_src

* =rofi= - Application Launcher
[[https://github.com/DaveDavenport/rofi][Rofi]] is a very nice alternative to [[https://tools.suckless.org/dmenu/][dmenu]].

Installation:
#+begin_src bash
  yay -S dmenu rofi rofi-calc
#+end_src

To be able to run sudo commands with =rofi= ([[https://github.com/DaveDavenport/rofi/issues/584#issuecomment-384555551][github issue]]), the command =sudo -A= can be used: it opens a =rofi= prompt to ask for the password.

For that to work, we need to add the following code to =~/.profile=:
#+begin_src bash
  export SUDO_ASKPASS=~/.local/bin/askpass-rofi
#+end_src

The =askpass= script is:
#+begin_src bash
  #!/bin/sh

  rofi -dmenu \
       -password \
       -no-fixed-num-lines \
       -p "$(printf "$1" | sed s/://)"
#+end_src

* =pass= - Password Manager
https://www.passwordstore.org/

Installation:
#+begin_src bash
  yay -S pass
#+end_src

Initialize the password store as a git repository
#+begin_src bash
  pass git init
  pass git remote add origin https://github.com/tdehaeze/pass.git
#+end_src

Gui Manager: [[https://github.com/IJHack/qtpass][qtpass]]
#+begin_src bash
  yay -S qtpass
#+end_src

Integration with Rofi: [[https://github.com/carnager/rofi-pass][rofi-pass]]
#+begin_src bash
  yay -S rofi-pass
#+end_src
Then we can add a shortcut to =rofi-pass= on i3 config.

Integration with Git: [[https://github.com/languitar/pass-git-helper][pass-git-helper]]
#+begin_src bash
  yay -S pass-git-helper
#+end_src

First, add the relation between repository addresses and entries in =pass=. This is done in the following config file =.config/pass-git-helper/git-pass-mapping.ini=:
#+begin_src
[github.com*]
target=github.com/tdehaeze
#+end_src

Then, add the credential helper on the git configuration file =~/.gitconfig= and add the default username for the repositories adresses.
#+begin_src
[credential]
    helper = !pass-git-helper $@

[credential "https://github.com"]
    username = tdehaeze
#+end_src

** Integration with other programs
Integrate pass in other programs is usually very easy, here are few examples:
- =~/.msmtprc=:
  - =passwordeval "pass email/dehaeze.thomas@gmail.com"=
- =~/.mbsyncrc=
  - =PassCmd "pass email/dehaeze.thomas@gmail.com"=

** Alternative - Bitwarden
Bitwarden https://github.com/bitwarden/cli
#+begin_src bash
  yay -Ss bitwarden-bin bitwarden-cli-bin
#+end_src

* =buku= - Bookmark Manager
https://github.com/jarun/Buku

** Installation
#+begin_src bash
  yay -S buku
#+end_src

** Integration with Rofi
https://github.com/carnager/buku_run

*** Installation
#+begin_src bash
  wget https://raw.githubusercontent.com/carnager/buku_run/master/buku_run -o ~/.local/bin/buku_run
  chmod +x ~/.local/bin/buku_run
#+end_src

*** Configuration
The configuration file is here: =~/.config/buku_run/config=

** Integration with qutebrowser
[[*Integration with Buku][Integration with Buku]]

** Synchronization with a git repository
The database is stored in =~/.local/share/buku/bookmarks.db=.

We initialize a git repository in this folder:
#+begin_src bash
  cd ~/.local/share/buku/bookmarks.db
  git init
#+end_src

Then we create a script that will automatically add =bookmarks.db= and push to some repository: =buku_git_push=.

To automatically run the script every day, a systemd unit is used: =~/.config/systemd/user/bukugit.timer= and =~/.config/systemd/user/bukugit.service=

#+begin_src bash
  systemctl --user start --now bukugit.timer
#+end_src

** Import Bookmarks from Firefox and Chrome
From Firefox, export the bookmarks as html file.
Then import the bookmark file using =buku -i bookmarks.html=.
This will add a tag with current date to all bookmarks imported.
To remove them, use: =buku --replace '2018dec20' ''=

** Web Interface
Run:
#+begin_src bash
  bukuserver run --host 127.0.0.1 --port 5001
#+end_src

And then browse to http://127.0.0.1:5001.

** Cheatsheet
| Command      | Usage                  |
|--------------+------------------------|
| =buku=       | Run buku interactively |
| =buku -p=    | List all bookmarks     |
| =buku -w id= | Edit bookmark          |
| =buku -d id= | Delete bookmark        |
| =buku -s <>= | Search bookmarks       |

** Alternatives
- https://github.com/RadhiFadlillah/shiori
- https://karl-voit.at/2014/08/10/bookmarks-with-orgmode/

* =qutebrowser= - Browser
https://github.com/qutebrowser/qutebrowser

** Installation
#+begin_src bash
  yay -S qutebrowser
#+end_src

** View Pdf inside qutebrowser with pdfjs
*** Installation
#+begin_src bash
  yay -S pdfjs
#+end_src

*** Usage
When opening a pdf file on qutebrowser, you'll be ask for options:
| Command    | Usage             |
|------------+-------------------|
| =<return>= | Download the file |
| =Ctrl-x=   | Download and open |
| =Ctrl-p=   | Open with pdf.js  |
| =Alt-y=    | Yank the url      |

** Integration with Pass: the password manager
Add the key-binding on =~/.config/qutebrowser/config.py=

#+begin_src
  config.bind(',p', 'spawn --userscript password_fill')
#+end_src

The =password_fill= script can be found on [[https://github.com/qutebrowser/qutebrowser/blob/master/misc/userscripts/password_fill][github.com]].
It is configured using the =~/.config/qutebrowser/password_fill_rc= file.

** Integration with Buku
Custom key binding in =~/.config/qutebrowser/config.py=

#+begin_src
# Add current page to Buku (Bookmark Manager)
config.bind('B', 'spawn buku -a {url}')
#+end_src

** Spell Checking
#+begin_src bash
  /usr/share/qutebrowser/scripts/dictcli.py install fr-FR
  /usr/share/qutebrowser/scripts/dictcli.py install en-US
#+end_src

** =firefox=
#+begin_src bash
  yay -S firefox-developer-edition
#+end_src

Addons:
- [[https://addons.mozilla.org/fr/firefox/addon/ublock-origin/][uBlock Origin]]
- [[https://addons.mozilla.org/en-US/firefox/addon/adblock-plus/][Adblock Plus]]
- [[https://addons.mozilla.org/fr/firefox/addon/bukubrow/][Bukurow]]
- [[https://addons.mozilla.org/fr/firefox/addon/i-dont-care-about-cookies/][I don't care about cookies]]

* =xrandr= - Monitor Manager
#+begin_src bash
  yay -S xorg-xrandr arandr
#+end_src

[[https://wiki.archlinux.org/index.php/Xrandr][Xrandr]] is used in shell scripts ([[https://github.com/Ventto/mons][mons]] could be used as a layer on top of Xrandr).
[[https://christian.amsuess.com/tools/arandr/][Arandr]] is a GUI application to manage monitors.

* Music Setup
** =pulseaudio= - Sound Server
https://wiki.archlinux.org/index.php/PulseAudio

Installation:
#+begin_src bash
  yay -S pulseaudio pulseaudio-alsa pulseaudio-bluetooth
#+end_src

If sound is not working, should run =pulseaudio --kill= to kill the deamon and then =pulseaudio --daemonize= to run it again.

https://www.freedesktop.org/wiki/Software/PulseAudio/Documentation/User/Running/

** =pavucontrol= - Sound Manager
=pavucontrol= is used as a sound manager:

#+begin_src bash
  yay -S pavucontrol
#+end_src

** =mopidy= - Audio Server
https://github.com/mopidy/mopidy
https://medium.com/@theos.space/using-mopidy-with-spotify-and-ncmpcpp-44352f4a2ce8

#+begin_src bash
  yay -S mopidy
#+end_src

#+begin_src bash
  python3 -m pip install --user mopidy-mpd mopidy-jellyfin mopidy-spotify
#+end_src

To update local files:
#+begin_src bash
  mopidy local scan
#+end_src

If mopidy is used, MPD should be disabled. (=systemctl disable --user mpd.service=)

** =ncmpcpp= - MPD Client
https://wiki.archlinux.org/index.php/Ncmpcpp

Installation:
#+begin_src bash
  yay -S ncmpcpp
#+end_src

The main config is located here: =~/.ncmpcpp/config=.
The key bindings can be configured here: =~/.ncmpcpp/bindings=.

** =beets= - Library Manager
https://github.com/beetbox/beets

Installation;
#+begin_src bash
  yay -S beets
#+end_src

Configuration folder: =~/.config/beets/=

| Command                | Usage                         |
|------------------------+-------------------------------|
| =beet import <folder>= | Import folder to Music folder |

* Movies
** =mpv= - Media Player
Installation:
#+begin_src bash
  yay -S mpv
#+end_src

The configuration is set in =/.config/mpv/input.conf=.

** =catt= - Chromecast
https://github.com/skorokithakis/catt

Installation:
#+begin_src bash
  yay -S catt
#+end_src

Usage to cast videos to chromecast
| Command                                                  | Usage                    |
|----------------------------------------------------------+--------------------------|
| catt cast "https://www.youtube.com/watch?v=dQw4w9WgXcQ"  | Cast youtube video       |
| catt cast ./myvideo.mp4                                  | Cast local video         |
| catt add ./myvideo.mp4                                   | Add a video to the queue |
| catt cast -s ./mysubtitle.srt /myvideo.mp4               | Add sub title            |
| catt cast_site https://en.wikipedia.org/wiki/Rickrolling | Cast website             |

Usage for controlling the device
| Command      | Usage                                                         |
|--------------+---------------------------------------------------------------|
| ffwd         | Fastforward a video by TIME duration                          |
| rewind       | Rewind a video by TIME duration                               |
| seek         | Seek the video to TIME position                               |
| scan         | Scan the local network and show all Chromecasts and their IPs |
| status       | Show some information about the currently-playing video       |
| pause        | Pause a video                                                 |
| play         | Resume a video after it has been paused                       |
| stop         | Stop playing                                                  |
| skip         | Skip to end of content                                        |
| save         | Save the current state of the Chromecast for later use        |
| restore      | Return Chromecast to saved state                              |
| volume       | Set the volume to LVL [0-100]                                 |
| volumedown   | Turn down volume by a DELTA increment                         |
| volumeup     | Turn up volume by a DELTA increment                           |

* Contact Manager
** =khard= - Google Conctacts
https://github.com/scheibler/khard

#+begin_src bash
  yay -Ss khard
#+end_src

This is the command line interface for contact management.

Contact synchronization:
Vdirsyncer is used for contact synchronization with Google.

To search with Khard: =khard <conctact-name>=

** =mu= - Index Emails
#+begin_src bash
  yay -Ss mu
#+end_src

This looks for contacts in all indexed emails.
=mu cfind <name>=

* =weechat= - Chat Application
https://weechat.org/files/doc/stable/weechat_user.en.html
https://wiki.archlinux.org/index.php/WeeChat
https://gist.github.com/pascalpoitras/8406501

** Installation
#+begin_src bash
  yay -S weechat
#+end_src

Then we install some dependencies
#+begin_src bash
  yay -S tcl lua ruby
#+end_src

** Enable mouse support
#+begin_src text
  /mouse enable
#+end_src

** Scripts
| highmon.pl        |   |
| colorize_nicks.py |   |
| go.py             |   |
| autosort.py       |   |
| buddylist.pl      |   |
| colorize_lines.pl |   |
| multiline.pl      |   |

** Theme
https://www.bfoliver.com/technology/2017/07/15/weechat/
https://alexjj.com/blog/2016/9/setting-up-weechat/

#+begin_src conf
  /set weechat.look.prefix_same_nick "⤷"
  /set weechat.look.prefix_error "⚠"
  /set weechat.look.prefix_action "⚡"
  /set weechat.look.bar_more_down "▼▼"
  /set weechat.look.bar_more_left "◀◀"
  /set weechat.look.bar_more_right "▶▶"
  /set weechat.look.bar_more_up "▲▲"
  /set weechat.look.prefix_suffix "╡"
  /set weechat.color.chat_nick_colors red,green,brown,blue,magenta,cyan,white,lightred,lightgreen,yellow,lightblue,lightmagenta,lightcyan
  /set weechat.color.separator 31
  /set buffers.color.current_fg 31
  /set buffers.color.current_bg white
  /set buffers.color.hotlist_message_fg 229
  /set buffers.color.hotlist_private_fg 121
  /set buffers.color.hotlist_highlight_fg 163
  /set buffers.color.number 239
  /set buffers.color.number_char 245
  /set weechat.bar.title.conditions "${inactive}"
  /set weechat.bar.title.color_fg black
  /set weechat.bar.title.color_bg 31         #Or white if 31 does nothing
#+end_src

** Configuration
https://hugo.md/post/the-perfect-weechat-setup-2/
https://robots.thoughtbot.com/weechat-for-slacks-irc-gateway

Use the command =/fset=

** Multi-line messages
Solution is provided here: https://github.com/wee-slack/wee-slack/issues/118
It uses [[https://weechat.org/scripts/source/multiline.pl.html/][multiline.pl]] script.
Then alt-enter is bound to insert a new line:
#+begin_src conf
  /set plugins.var.perl.multiline.magic_paste_only on
  /key bind meta-ctrl-M /input insert \x0a
#+end_src

And enter is bound to =magic_enter= that directly sends the message if its one line, and if its multiple line, waits a little bit and then sends the message:
#+begin_src conf
  /key bind ctrl-M /input magic_enter
#+end_src

** Send message using =$EDITOR=
https://github.com/keith/edit-weechat
#+begin_src bash
  mkdir -p ~/.weechat/python/autoload
  cd ~/.weechat/python/autoload
  wget https://raw.githubusercontent.com/keith/edit-weechat/master/edit.py
#+end_src

Then, on weechat, type =/edit=.

** CheatSheet
| Command   | Usage            |
|-----------+------------------|
| =Ctlr-N=  | Next channel     |
| =Ctlr-P=  | Previous channel |
| =Esc-n=   | Toggle nicklist  |
| =alt-ent= | New line         |

** Slack Integration
https://github.com/wee-slack/wee-slack

*** Installation
#+begin_src bash
  yay -S python2-websocket-client
#+end_src


#+begin_src bash
  cd ~/.weechat/python
  wget https://raw.githubusercontent.com/wee-slack/wee-slack/master/wee_slack.py
  ln -s ../wee_slack.py autoload
#+end_src

*** Add your Slack API key(s)
Log in to Slack:
#+begin_src conf
  /slack register
#+end_src
This command prints a link you should open in your browser to authorize WeeChat with Slack. Once you've accomplished this, copy the "code" portion of the URL in the browser and pass it to this command:

#+begin_src conf
  /slack register [CODE_FROM_URL]
#+end_src

Your Slack team is now added, and you can complete setup by restarting the wee-slack script.
#+begin_src conf
  /python reload slack
#+end_src

If you don't want to store your API token in plaintext you can use the secure features of weechat:
#+begin_src conf
  /secure passphrase this is a super secret password
  /secure set slack_token [YOUR_SLACK_TOKEN]
  /set plugins.var.python.slack.slack_api_token ${sec.data.slack_token}
#+end_src

** Aspell
https://blog.qoba.lt/using_aspell_in_weechat.html

** Notifications
https://github.com/s3rvac/weechat-notify-send

** Deamon and Client
Weechat is started with the systemd service =weechat=.
It runs weechat inside tmux.

* =redshift=
http://jonls.dk/redshift/

#+begin_src bash
  yay -S redshift
#+end_src

* Mail Setup
[[file:mail.org][Link]] to the mail setup.

** =mbsync= - Synchronize Mailboxes
http://isync.sourceforge.net/
https://wiki.archlinux.org/index.php/Isync

*** Installation
#+begin_src bash
  yay -S isync
#+end_src

*** Configuration
=~/.mbsyncrc=

*** Automation using systemd
**** Retreive New mails
- =checkmail=
- =~/.config/systemd/user/checkmail.service=
- =~/.config/systemd/user/checkmail.timer=

#+begin_src bash
systemctl --user enable checkmail.timer
systemctl --user start checkmail.timer
#+end_src

**** Synchronize all the mailboxes
- =~/.config/systemd/user/syncmail.service=
- =~/.config/systemd/user/syncmail.timer=

#+begin_src bash
systemctl --user enable syncmail.timer
systemctl --user start syncmail.timer
#+end_src

** =msmtp= - Send Mails
https://marlam.de/msmtp/

*** Installation
#+begin_src bash
  yay -S msmtp
#+end_src

** =mu= - Mail Index, Search and Tagging
https://github.com/djcb/mu

** =neomutt= - Mail Client
https://github.com/neomutt/neomutt

*** Installation
#+begin_src bash
  yay -S neomutt
#+end_src

*** Display html mails
#+begin_src bash
  yay -S w3m
#+end_src

*** Open Url from mail
#+begin_src bash
  yay -S urlview
#+end_src

*** Ressources
- http://therandymon.com/woodnotes/mutt/using-mutt.html
- https://ankursinha.in/2017/12/16/transitioning-to-neomutt-and-friends-for-e-mail.html
- https://github.com/LukeSmithxyz/mutt-wizard

** Notification system
A script (=checkmail=) is used to retreive new mails and use =notify=send= is there are new received mails.

* =ranger=/=pcmanfm= - File Manager
Configuration files:
- GUI: [[file:pcmanfm.org][Pcmanfm]]
- Terminal based: [[file:ranger.org][Ranger]]

** Ranger
https://github.com/ranger/ranger
*** Installation
#+begin_src bash
yay -S ranger
#+end_src

*** Configuration
The configuration file is =~/.config/ranger/rc.conf=.

*** Display pdf
All the display of the files are defined in =~/.config/ranger/scope.sh=.

It seems that Ranger is not working well with Termite. The screen is not refreshing after viewing one image ([[https://github.com/ranger/ranger/issues/859][Github Issue]]).

It works better with Urxvt.

** GUI File Manager: pcmanfm
https://wiki.archlinux.org/index.php/PCManFM

* =sxiv= - Image viewer
https://github.com/muennich/sxiv
https://www.youtube.com/watch?v=GYW9i_u5PYs

** Installation
#+begin_src bash
  yay -S sxiv
#+end_src

** Open Gif
#+begin_src bash
  sxiv -a file.gif
#+end_src

** Cheatsheet
| Command      | Usage                    |
|--------------+--------------------------|
| =-t=         | Start in Thumbmail mode  |
| =f=          | Toggle fullscreen        |
| =Return=     | Switch to thumbmail mode |
| =<=, =>=     | Rotate the image         |
| =\vert=, =_= | Flip the image           |
| =n=, =p=     | Next, Previous image     |

* =sxhkd= - HotKey Manager
#+begin_src bash
  yay -S sxhkd
#+end_src

Configuration file: [[file:sxhkd.org][SXHKD]].

* =i3= - Windows Manager
[[file:i3.org][Link]] to the documentation

** Installation
#+begin_src bash
  yay -S i3-gaps
#+end_src

** Configuration
=~/.i3/config=

* =polybar= - Top Bar
https://polybar.github.io/

[[file:polybar.org][Link]] to the documentation.

** Installation
#+begin_src bash
  yay -S polybar
#+end_src

* =picom= - Compositor
https://wiki.archlinux.org/index.php/Picom

[[file:compositor.org][Link]] to the documentation.

** Installation
#+begin_src bash
  yay -S picom
#+end_src

** Configuration
=~/.config/picom/picom.conf=

** Automatic run as daemon
Compton is run from =.xprofile= config in the background:
#+begin_src bash
  picom --daemon
#+end_src

* =dunst= - Notification Manager
https://github.com/dunst-project/dunst
https://wiki.archlinux.org/index.php/Dunst

** Installation
#+begin_src bash
  yay -S dunst dunstify
#+end_src

** Configuration
=~/.config/dunst/dunstrc=

** Usage
#+begin_src bash
  dunstify --replace=16549 "AppName" "Message"
#+end_src

The number =--replace= can be used with an ID to merge notifications from the
same application for instance.

* Office Suite
** =libreoffice=
#+begin_src bash
  yay -S libreoffice-fresh libreoffice-fresh-fr
#+end_src

** =wps= Office
#+begin_src bash
  yay -S wps-office wps-office-extension-french-dictionary ttf-wps-fonts
#+end_src

** =sc-im= - Minimap SpreadSheet
https://github.com/andmarti1424/sc-im
https://www.youtube.com/watch?v=K_8_gazN7h0

It permits to open Excel files on the terminal very quickly.

#+begin_src bash
  yay -S sc-im
#+end_src

* =blueman= - Bluetooth Manager
Bluetooth manager: https://github.com/blueman-project/blueman

#+begin_src bash
  yay -Ss blueman
#+end_src

* =udiskie= - Automatically Mount devices
udiskie - Mount and unmount disks (https://github.com/coldfix/udiskie)

#+begin_src bash
  yay -S udiskie
#+end_src

Automatically run =udiskie= on startup.

* LaTeX
Installation
#+begin_src bash
  yay -S texlive-most
#+end_src

Biber support for the bibliography:
#+begin_src bash
  yay -S biber
#+end_src

Support for source code using minted:
#+begin_src bash
  yay -S minted
#+end_src

Every custom class or packages can be put under =~/.local/share/texmf/tex/latex/local/= folder.
In order for LaTeX to be aware of new packages/classes, run =sudo texhash= each time a new custom package is added.

* Mathematical Software
** Insect
https://github.com/sharkdp/insect

Installation
#+begin_src bash
  yay -S insect
#+end_src

| Command         | Usage        |
|-----------------+--------------|
| =3 m/s to km/h= | Convert Unit |

** Matlab
https://wiki.archlinux.org/index.php/MATLAB#Installation

[[file:matlab.org][Link]] to the configuration.

Installation
#+begin_src bash
  yay -S matlab
#+end_src

If there is a problem when opening a Simulink file, check the solution [[https://fr.mathworks.com/matlabcentral/answers/361053-can-t-reload-usr-local-matlab-r2017b-bin-glnxa64-libmwdastudio-so][here]].

** SageMath
http://www.sagemath.org/
https://wiki.archlinux.org/index.php/SageMath

Installation
#+begin_src bash
  yay -S sagemath
#+end_src

Run =sage -n jupyter= to run jupyter notebooks

** Python and Jupyter-notebook

* Download Manager
** =aria2= and =aria2p=
#+begin_src bash
  yay -S aria2
#+end_src

#+begin_src bash
  python3 -m pip install --user aria2p[tui]
#+end_src

** =transmission= and =tremc=
#+begin_src bash
  yay -S tremc
#+end_src

** =youtube-dl=
#+begin_src bash
  yay -S youtube-dl
#+end_src

* Default Applications
https://wiki.archlinux.org/index.php/Default_applications
https://www.guyrutenberg.com/2018/01/20/set-default-application-using-xdg-mime/

=~/.config/mimeapps.list=

* Desktop files
[[file:applications.org][Desktop Applications]]

=~/.local/share/applications/=

* Bibliography Management
I am using a plain bibtex file with =org-ref= ([[https://github.com/jkitchin/org-ref][link]]).

* Calendar
[[file:calendar.org][Link]] to configuration

** =vdirsyncer= - Sync calendars
https://github.com/pimutils/vdirsyncer

Installation:
#+begin_src bash
  yay -S vdirsyncer python-requests-oauthlib
#+end_src

#+begin_src bash
  sudo pip install requests-oauthlib
#+end_src

| Command           | Usage       |
|-------------------+-------------|
| =vdirsyncer sync= | Synchronize |

Setup the =google_calendar=:
#+begin_src bash
  vdirsyncer discover google_calendar
#+end_src

And start the =systemd= timer that automatically synchronize the calendars;
#+begin_src bash
  systemctl --user enable --now vdirsyncer.timer
#+end_src

To check the status of the service:
#+begin_src bash
  systemctl --user status vdirsyncer.service
#+end_src

** =khal= - Calendar Client
https://github.com/pimutils/khal

Installation:
#+begin_src bash
  yay -S khal
#+end_src

Import ICS files:
#+begin_src bash
  khal import even.ics
#+end_src

* =newsboat= - RSS Reader
GUI Alternatives:
- http://www.rssowl.org/
- https://github.com/jangernert/FeedReader

[[file:newsboat.org][Link]] to configuration.

https://github.com/newsboat/newsboat
https://wiki.archlinux.org/index.php/Newsboat

Installation:
#+begin_src bash
  yay -S newboat
#+end_src

Configuration:
https://newsboat.org/releases/2.12/docs/newsboat.html
=~/.newsboat/=

https://newsboat.org/releases/2.12/docs/newsboat.html#available-operations

* =orgmode= - Task Manager
* =zathura= - PDF Reader
https://pwmt.org/projects/zathura/
** Installation
#+begin_src bash
  yay -S zathura
#+end_src

Then add dependecies to view specific files:
#+begin_src bash
  yay -S zathura-pdf-mupdf zathura-djvu zathura-ps zathura-cb
#+end_src

It seems that mupdf is better that poppler to view pdf.

** Configuration
=~/.config/zathura/zathurarc=

** Cheatsheet
| Command | Usage                      |
|---------+----------------------------|
| =p=     | Print the current pdf      |
| =tab=   | Show the outline           |
| =r=     | Reload                     |
| =J/K=   | Next/previous page         |
| =H/L=   | Zoom in/out                |
| =a=     | Fit height                 |
| =s=     | Fit width                  |
| =D=     | Double page                |
| =f=     | Follow link                |
| =i=     | Night Mode                 |
| =<n>gg= | Go to page n               |
| =mm=    | Mark current location to m |
| ='m=    | Goto location m            |

** Multi-monitor pdf presentation - pdfpc
https://github.com/pdfpc/pdfpc

pdfpc is a great tool for showing pdf presentations. It support:
- screen splitting
- support for videos in pdf presentations
- support for notes
- support for annotations

*** Installation
#+begin_src bash
  yay -S pdfpc
#+end_src

*** Video support
#+begin_src bash
  yay -S gst-plugins-ugly gst-plugins-good gst-plugins-base-libs gst-plugins-base gst-plugins-bad gst-libav
#+end_src

*** Usage
#+begin_src bash
  pdfpc filename.pdf
#+end_src

* Display Manager
Before, I was using =lightDM=, but a single tty is enough.

However, to make tools like Anydesk or Teamviewer to work:
Add "type=x11" in =/etc/pam.d/system-login=:
#+begin_src conf
  -session optional pam_systemd.so type=x11
#+end_src

- When executing =loginctl session-status | grep Service= X11 should appear as initialized.
- =echo $XDG_SESSION_TYPE= should show =x11= instead of =tty= now

* =gtk=/=qt= - Managing Theme
** GTK Themes
Gtk2 themes are managed using the file =~/.gtkrc-2.0= while Gtk3 themes are managed using =~/.config/gtk-3.0/settings.ini=.

*** Gui Manager

To customize the look of the system using GUI application, run ~lxappearance~.

Installation:
#+begin_src bash
  yay -S lxappearance
#+end_src

*** Icons and themes
#+begin_src bash
  yay -S zukitwo-themes faenza-icon-theme
#+end_src

#+begin_src bash
  yay -S arc-gtk-theme
#+end_src

** QT Themes
Run ~qt5ct~ to manage QT Themes.

* =droidcam= - Use Android phone as webcam
#+begin_src bash
  yay -S droidcam
#+end_src

Install and run droidcam on the Android phone.
Once both are connected to the same network, run the following command:
#+begin_src bash
  droidcam-cli -v -size=1280x720 192.168.1.51 4747
#+end_src

It will create a new video device accessible for all kinds of applications.

To view the flux using mpv:
#+begin_src bash
  mpv av://v4l2:/dev/video0
#+end_src

* =inkscape= - Graphical Editor
- https://inkscape.org/
- Tikz

#+begin_src bash
  yay -S inkscape
#+end_src

* =kdenlive= - Video Editor
[[https://kdenlive.org/fr/][kdenlive]]

#+begin_src bash
  yay -S kdenlive
#+end_src

* =kazam= - Screen Recorder
* =obs-studio= - Live streaming and screen recording
https://github.com/obsproject/obs-studio/

#+begin_src bash
  yay -Ss obs-studio
#+end_src

To share the screen as a webcam:
http://dlaw.me/webcam-spoofing-with-obs/
#+begin_src bash
  yay -S obs-v4l2sink
  yay -S v4l2loopback-dkms-git
  sudo modprobe v4l2loopback exclusive_caps=1 video_nr=9
#+end_src

* =anydesk= - Remote Desktop
#+begin_src bash
  yay -S anydesk-bin
#+end_src

* =wireguard= - VPN
#+begin_src bash
  yay -S wireguard-tools
#+end_src

* =nordvpn= - VPN
https://aur.archlinux.org/packages/nordvpn-bin/
https://wiki.archlinux.org/index.php/NordVPN

Installation:
#+begin_src bash
  yay -S nordvpn-bin
#+end_src

Configuration:
#+begin_src bash
  sudo systemctl enable --now nordvpnd.service
#+end_src

| Command                   | Usage |
|---------------------------+-------|
| =nordvpn login=           |       |
| =nordvpn connect country= |       |
| =nordvpn disconnect=      |       |
| =nordvpn status=          |       |
| =nordvpn countries=       |       |

* Others
** =maim=/=flameshot= - Take Screenshots
- https://github.com/naelstrof/maim
- https://github.com/lupoDharkael/flameshot

#+begin_src bash
  yay -S maim flameshot
#+end_src

** =screenkey= - Show pressed keys
#+begin_src bash
  yay -S screenkey
#+end_src

** =croc= - File transfer
https://github.com/schollz/croc

#+begin_src bash
  yay -S croc
#+end_src

** Find Files

#+begin_src bash
  yay -S fd ripgrep fzf
#+end_src

** PDF/Image Utilities
- https://github.com/dawbarton/pdf2svg
- https://www.pdflabs.com/tools/pdftk-the-pdf-toolkit/
- https://github.com/Airblader/unclutter-xfixes

#+begin_src bash
 yay -S pdf2svg pdftk unclutter pdfarranger imagemagick
#+end_src

** Trash
=trash-cli= is used to manage the trash.
It is integrated with Ranger.

#+begin_src bash
  yay -S trash-cli
#+end_src

** Google translate from the command line
#+begin_src bash
  yay -S translate-shell
#+end_src

#+begin_src bash
  trans englishwork en:fr
#+end_src

** Show information about the machine
[[https://github.com/dylanaraps/neofetch][neofetch]]

#+begin_src bash
  yay -S neofetch
#+end_src

* Printer
https://wiki.archlinux.org/index.php/CUPS
Web based administration: http://localhost:631/

=system-config-printer=

Check the queue
#+begin_src bash
  lpq
  lpq -a # on all queues
#+end_src

Clear the queue
#+begin_src bash
  lprm   # remove last entry only
  lprm - # remove all entries
#+end_src

Print a file
#+begin_src bash
  lpr -P printer_name filename.pdf
#+end_src

List available printers
#+begin_src bash
  lpstat -a
#+end_src

Stats about the printer
#+begin_src bash
  lpstat -p printer_name
#+end_src

* Kernel Management
https://wiki.manjaro.org/index.php/Manjaro_Kernels

| Command                            | Usage                                 |
|------------------------------------+---------------------------------------|
| =mhwd-kernel -li=                  | Determine which kernel is used        |
| =sudo mhwd-kernel -i linux419=     | Install new kernel                    |
| =sudo mhwd-kernel -i linux419 rmc= | Install new kernel and remove old one |

* Format disks
https://gparted.org/

=sudo gparted= to format disks

Using command line:
- https://www.digitalocean.com/community/tutorials/how-to-partition-and-format-storage-devices-in-linux

* Usefull commands
** Readline
https://wiki.archlinux.org/index.php/Keyboard_shortcuts

| Keyboard | Shortcut Description |
|----------+----------------------|
| Ctrl+l   | Clear the screen     |

*** Cursor Movement
| Keyboard | Shortcut Description                   |
|----------+----------------------------------------|
| =Ctrl+b= | Move cursor one character to the left  |
| =Ctrl+f= | Move cursor one character to the right |
| =Alt+b=  | Move cursor one word to the left       |
| =Alt+f=  | Move cursor one word to the right      |
| =Ctrl+a= | Move cursor to start of the line       |
| =Ctrl+e= | Move cursor to end of the line         |

*** Copy & Paste
| Keyboard     | Shortcut Description                              |
|--------------+---------------------------------------------------|
| =Ctrl+u=     | Cut everything from line start to cursor          |
| =Ctrl+k=     | Cut everything from the cursor to end of the line |
| =Alt+d=      | Cut the current word after the cursor             |
| =Ctrl+w=     | Cut the current word before the cursor            |
| =Ctrl+y=     | Paste the previous cut text                       |
| =Alt+y=      | Paste the second latest cut text                  |
| =Alt+Ctrl+y= | Paste the first argument of the previous command  |
| =Alt+./=     | Paste the last argument of the previous command   |

*** History
| Keyboard | Shortcut Description                  |
|----------+---------------------------------------|
| =Ctrl+p= | Move to the previous line             |
| =Ctrl+n= | Move to the next line                 |
| =Ctrl+s= | Search                                |
| =Ctrl+r= | Reverse search                        |
| =Ctrl+j= | End search                            |
| =Ctrl+g= | Abort search (restores original line) |
| =Alt+r=  | Restores all changes made to line     |

*** Completion
| Keyboard | Shortcut Description            |
|----------+---------------------------------|
| =Tab=    | Auto-complete a name            |
| =Alt+?=  | List all possible completions   |
| =Alt+*=  | Insert all possible completions |

** Others
| [[https://github.com/tldr-pages/tldr][tldr]]          | Community-driven man pages                                   |
| [[https://github.com/chubin/wttr.in][wttr.in]]       | weather in terminal                                          |
| [[https://github.com/michael-lazar/rtv][rtv]]           | Reddit in terminal                                           |
| awk           | https://linuxhandbook.com/awk-command-tutorial/              |
| [[https://github.com/rupa/z][z]]             | Jump around                                                  |
| [[https://github.com/nvbn/thefuck][thefuck]]       | Magnificent app which corrects your previous console command |
| [[https://github.com/amanusk/s-tui/][s-tui]]         | Terminal based CPU stress and monitoring utility             |
| [[https://github.com/nicolargo/glances][glances]]       | A top/htop alternative                                       |
| [[https://github.com/asciinema/asciinema][asciinema]]     | Reccord you terminal                                         |
| [[https://dev.yorhel.nl/ncdu][ncdu]]          | See what takes place on the disk                             |
| [[https://github.com/sharkdp/bat][bat]]           | cat alternative                                              |
| [[https://github.com/dalance/procs][procs]]         | ps alternative                                               |
| [[https://github.com/chmln/sd][sd]]            | sed alternative                                              |


| =meteo=                           | Get the meteo                             |
| =sudo cputhrottle PID %PROC=      | Limiter l'accès au proc pour un processus |
| =nmap -sP “192.168.1.*"=          | Check all ip addresses on local netword   |
| =du -sh folder=                   | Return the size of the folder             |
| =df -h=                           | Report disk usage                         |

** Archive and Extract
Use =apack= and =aunpack=:
|                               |                                   |
|-------------------------------+-----------------------------------|
| =aunpack foobar.tar.gz=       | extract all files from archive    |
| =apack myarchive.zip foo bar= | create a zip archive of two files |

** Hardware
| =dmesg=     | Detected hardware and boot messages |
| =lshw=      | Display information on hardware     |
| =lsusb -tv= | Show usb devices                    |

** Network
| =ip addr show=  | Show all network interfaces and ip address |
| =ethtooo eth0=  | Tool to show ethernet status               |
| =netstat -tulp= | List all active listening ports            |

* After Install
Enable TRIM (SSD only)
#+begin_src bash
  sudo systemctl enable --now fstrim.timer
#+end_src

Set the fastest mirror for Pacman
#+begin_src bash
  sudo pacman-mirrors --fasttrack
#+end_src

* Configuration for Laptops
** Power Management Tool: Powertop
https://wiki.archlinux.org/index.php/Powertop
https://wiki.manjaro.org/index.php?title=Power_Savings

=PowerTop= a diagnostic tool used to identify and report issues with power consumption and management.
#+begin_src bash
  yay -S powertop
#+end_src


=TLP= is used for Power Management.
#+begin_src bash
  yay -S tlp
  sudo systemctl enable tlp
  sudo systemctl start tlp
  sudo systemctl enable tlp-sleep
  sudo systemctl start tlp-sleep
  sudo tlp start
#+end_src

=Thermald= is used to automatically handle CPU frequency scaling according to system load.
#+begin_src bash
  yay -S thermald
  sudo systemctl enable thermald
  sudo systemctl start thermald
#+end_src

** Lid open/close
https://wiki.archlinux.org/index.php/Power_management

Should automatic show lock screen

=/etc/systemd/logind.conf=

* Some notes - Systemd
To improve the startup time.

#+begin_src bash
  sudo systemctl disable apparmor
  sudo systemctl disable snapd
  sudo systemctl disable systemd-backlight@backlight\:intel_backlight.service
#+end_src

To see next timers
#+begin_src matlab
  systemctl --user list-timers
#+end_src

* Ressources
** Dotfiles
- https://github.com/LukeSmithxyz/voidrice
- https://github.com/wincent/wincent
- https://github.com/korolr/dotfiles
- https://github.com/Shougo/shougo-s-github
- https://github.com/addy-dclxvi/almighty-dotfiles

** Linux Softwares
- [[https://github.com/k4m4/terminals-are-sexy][terminalare.sexy]]
- [[https://www.reddit.com/r/vim/comments/3tluqr/my_list_of_applications_with_vi_keybindings/][the big list of vim like software]]
- https://github.com/jlevy/the-art-of-command-line
- https://github.com/herrbischoff/awesome-command-line-apps
- https://github.com/luongvo209/Awesome-Linux-Software
- https://wiki.archlinux.org/index.php/List_of_applications
- https://ambrevar.xyz/power-apps/
- https://enchiridion.red/2019/1/18/desktop-apps/

* List of all the install programs
** Mutt
| =neomutt=    | Teaching an Old Dog New Tricks                                  |
| =msmtp=      | SMTP client that can be used as an SMTP plugin for Mutt         |
| =isync=      | Synchronize a maildir with an IMAP server                       |
| =vdirsyncer= | Synchronize calendars and contacts                              |
| =abook=      | Address book with mutt support                                  |
| =urlview=    | URL extractor/launcher                                          |
| =w3m=        | Pager/text based browser                                        |
| =lynx=       | Text mode web browser                                           |
| =lbdb=       | Little brother's database for the mutt mail reader              |
| =mu=         | Tool for searching e-mail messages stored in the maildir-format |
| =ripmime=    | Extract attachments out of MIME encoded email packages          |
| =shared=     | mime-info - Database of common MIME types                       |

** Micro controllers
| =avrdude=     | Atmel AVR MCU programmer                                                 |
| =bootloadhid= | USB boot loader for AVR microcontrollers                                 |
| =dfu=         | programmer - Device firmware update based USB programmer for Atmel chips |
| =platformio=  | Ecosystem for IoT development (Arduino and ARM mbed compatible)          |
| =micropython= | Python implementation for microcontrollers and constrained systems       |
| =arduino=     | mk - Makefile for Arduino sketches                                       |

** File Management
| =grep=                  | GNU grep, egrep and fgrep                                      |
| =pdfgrep=               | Search PDFs for strings matching a regular expression          |
| =the_platinum_searcher= | Multi-platform code-search similar to ack and ag               |
| =the_silver_searcher=   | Code-search similar to ack                                     |
| =fdupes=                | Identify or delete duplicate files                             |
| =findutils=             | Collection of GNU find, xargs, and locate                      |
| =ranger=                | File browser                                                   |
| =vifm=                  | Ncurses based file manager with vi like keybindings            |
| =tree=                  | Display directories as trees (with optional color/HTML output) |
| =p7zip=                 | 7-Zip (high compression file archiver) implementation          |
| =unrar=                 | Extract, view, and test RAR archives                           |
| =atool= =zip=           | script for managing file archives of various types             |

** File Downloader
| =wget=   | Internet file retriever                                   |
| =htop=   | Improved top (interactive process viewer)                 |
| =httpie= | User-friendly cURL replacement (command-line HTTP client) |
| =curl=   | Get a file from an HTTP, HTTPS or FTP server              |

** Utils
| =binutils=  | GNU Binary Utilities                                      |
| =coreutils= | GNU File, Shell, and Text utilities                       |
| =gnome=     | doc-utils - Documentation utilities for the GNOME project |
| =moreutils= | Collection of tools that nobody wrote when UNIX was young |

** A trier
| =asciinema=   | Terminal session recorder                                                    |
| =automake=    | tool for automatically generating Makefile                                   |
| =cmake=       | Cross-platform make                                                          |
| =cputhrottle= | Limit the CPU usage of a process                                             |
| =ctags=       | Reimplementation of ctags                                                    |
| =gdb=         | GNU debugger                                                                 |
| =ghostscript= | Interpreter for PostScript and PDF                                           |
| =go=          | Open source programming language to build simple/reliable/efficient software |
| =hugo=        | Configurable static site generator                                           |
| =markdown=    | Text-to-HTML conversion tool                                                 |
| =pandoc=      | Swiss-army knife of markup format conversion                                 |
| =uni=         | Query the Unicode database from the commandline                              |