This repository uses stow hierarchy: clone it into $HOME and use stow --no-folding <package> to create the symlinks automatically for each package. For more information about stow read its documentation: stow(8).
Color schemes and vim/neovim files are not into this repository. Find them into:
Configuration files:
- Distro : Debian
- WM : i3-wm (i3-gaps)
- Menu : rofi
- Shell : zsh
- Terminal : urxvt, xterm
- Multiplexer : tmux
- Font : Terminess Powerline
- CVS : git
- Editor : vim, neovim
- Files : vifm, ranger
- Finder : fzf
- Youtube : ytfzf
- IRC : irssi
- Email : mutt
- Music : cmus
- Video : mpv
- Images : feh
- Reader : mupdf, apvlv, zathura
- Browser : w3m
- Interface : surfraw
- Bittorrent : transmission-cli
Add the user to the sudoers file
-
Enter to the root mode:
su -(then, root password) -
Edit the file
/etc/sudoers:
sudo visudo -f /etc/sudoers
- Add this line after
ROOT ALL (ALL:ALL) ALL:
<user> ALL (ALL:ALL) ALL
Disable autologin on LXDE:
- Edit the following file:
sudo nano /etc/lightdm/lightdm.conf
-
Find the line
#autologin-user=. -
Uncomment the line and add the user:
autologin-user=<user>
Install i3-radius. It's i3-wm with gaps and rounded corners. Just clone the linked repository and run sh build.sh. From the i3-wm version 4.22, i3-gaps settings will be included.
Make sure you have installed the following libraries, which are a requirement to run my setup properly:
- compton: compositor based on xcompmgr with some improvements.
- dunst: a customizable and lightweight notification-daemon.
- libnotify-bin: a program to send desktop notifications.
- lxappearance: customize look and feel (lxde-native).
- lxpolkit: authorization manager for the desktop.
- lxqt-openssh-askpass: handle password access.
- pulseaudio-utils: to run pulse audio controls from the keyboard.
- rofi: a window switcher, run dialog and dmenu replacement.
- rxvt-unicde-256color: VT102 emulator for the X window system.
- udiskie: automounter for removable media (flash drives).
- volumeicon-alsa: volume icon for the system tray.
- wicd: Wired and wireless network connection manager.
- xbacklight: adjust backlight brightness using RandR extension.
- xsel: command-line tool to manipulate the X selection.
Optional:
- arandr: can be useful to generate xrandr *.sh scripts.
- libfm-pref-apps and exo-preferred-applications: the name is self-descriptive.
- redshift: adjusts the color temperature of your screen according to your surroundings. This may help your eyes hurt less or reduce the risk for delayed sleep phase syndrome if you are working in front of the screen at night.
Useful tools: uuid, fbreader, simplescreenrecorder, translate-shell, trash-cli
Install it from the repositories:
sudo apt-get install zsh
Install Oh My Zsh following the instructions from its page.
Via curl:
sh -c "$(curl -fsSL https://raw.githubusercontent.com/robbyrussell/oh-my-zsh/master/tools/install.sh)"
Via wget:
sh -c "$(wget https://raw.githubusercontent.com/robbyrussell/oh-my-zsh/master/tools/install.sh -O -)"
Atomic theme must be downloaded from Atomic repository.
Enable zsh-syntax-highlighting:
git clone https://github.com/zsh-users/zsh-syntax-highlighting $HOME/.syntax
Enable zsh-autosuggestions:
git clone https://github.com/zsh-users/zsh-autosuggestions ~/.zsh/zsh-autosuggestions
Symlink the zsh settings:
cd $HOME/dotfiles && stow --no-folding zsh
Change the current shell:
$ chsh -s /usr/bin/zsh
Log out and log in to see the new shell as default.
Install it from the repositories:
sudo apt-get install rxvt-unicode-256color
Symlink the rxvt-unicode settings:
cd $HOME/dotfiles && stow --no-folding X
Atomic color scheme is already included.
Install the scripts:
cd $HOME/dotfiles && stow --no-folding urxvt
To check for newer versions on Github:
- The script
resize-font: https://github.com/simmel/urxvt-resize-font - The script
url-select: https://github.com/johntyree/urxvt-perls - The script
clipboard: https://github.com/pkkolos/urxvt-scripts - The script
unichr: https://emergent.unpythonic.net/
The version from the repositories is too old. Install it from the source code:
- Download a tar.gz from github.
- Unzip:
tar -zxvf tmux-2.7.tar.gz - Join to the directory created:
cd tmux-2.7 - Compile it:
./configure; make; sudo checkinstall - Install the required dependencies and repeat the
./configure
Then, install the package urlview:
sudo apt-get install urlview
Symlink the tmux settings:
cd $HOME/dotfiles && stow --no-folding tmux
Install it from the repositories:
sudo apt-get install git
Symlink the git settings:
cd $HOME/dotfiles && stow --no-folding git
Clone the Powerline fonts repository:
git clone https://github.com/powerline/fonts
And install it:
cd fonts && ./install.sh.
Fontconfig
«In some distributions (e.g. Debian), Terminess Powerline is ignored by default and must be explicitly allowed. A fontconfig file is provided which enables it. Copy this file from the fontconfig directory to your home folder under ~/.config/fontconfig/conf.d (create it if it doesn't exist) and re-run fc-cache -vf». Paragraph extracted from Powerline.
Install it from the repositories:
sudo apt-get install fonts-font-awesome
(Not using anymore, though).
Install it from the repositories (the stable version is enough):
sudo apt-get install vim vim-gtk3
The package vim-gtk3 adds the 'huge version' with a lot of features (+python3, +clipboard...), and the GTK3 GUI.
Install the plugins manager vim-plug; follow the instructions from its repository:
curl -fLo ~/.vim/autoload/plug.vim --create-dirs \
https://raw.githubusercontent.com/junegunn/vim-plug/master/plug.vimInstall the plugins with the command:
:PlugInstall.
To make it compatible with the plugin Shougo/deoplete.nvim, it requires two plugins (roxma/vim-hug-neovim-rpc and roxma/nvim-yarp) that require neovim installed from pip3, so first install python3-pip and then install neovim from there:
sudo apt-get install python3-pip
pip3 install neovim
pip3 install pynvim
From the Vim command line:
:pythonx import pynvim
My vim config files are into vimrc.
Neovim is available from github, so download the AppImage from the releases section.
Move the file nvim.appimage to /opt/neovim/:
sudo mv nvim.appimage /opt/neovim/
Join to the folder and create the symlink:
sudo ln -sf /opt/neovim/nvim.appimage /usr/local/bin/nvim
Give permissions to the file:
sudo chmod 755 /opt/neovim/nvim.appimage
A desktop file is not needed because it's a terminal application.
Finally, install vim-plug for neovim using this command:
curl -fLo ~/.local/share/nvim/site/autoload/plug.vim --create-dirs \
https://raw.githubusercontent.com/junegunn/vim-plug/master/plug.vimMy neovim config files are into vimrc.
Install clang from the repositories:
sudo apt-get install clang libclang-dev
The package libclang-dev is required on Debian.
Inistall golang from the repositories:
sudo apt-get install golang
Open Vim and run the following command:
:GoInstallBinaries
Note: check pyenv to install other Python versions.
Install pylint from pip3:
sudo pip3 install pylint
Install vint from pip3:
sudo pip3 install vim-vint
Install shellcheck from the repositories:
sudo apt-get install shellcheck
Install chktex from the repositories:
sudo apt-get install chktex
Download Node.js from https://nodejs.org.
Unzip the binary archive (v.10.15.3 in my case):
sudo mkdir /usr/lib/nodejs
sudo tar -xJvf node-v10.15.3-linux-x64.tar.xz -C /usr/lib/nodejs
sudo mv /usr/lib/nodejs/node-v10.15.3-linux-x64 /usr/lib/nodejs/node-v10.15.3Symlink the executables:
sudo ln -s /usr/lib/nodejs/node-v10.15.3/bin/node /usr/bin/node
sudo ln -s /usr/lib/nodejs/node-v10.15.3/bin/npx /usr/bin/npx
sudo ln -s /usr/lib/nodejs/node-v10.15.3/bin/npm /usr/bin/npmTest the installation using:
node -v
npm versionMake a directory to install global npm modules:
mkdir ~/.npm-global
Configure npm to use the new directory path:
npm config set prefix '~/.npm-global'
Add the path to ~/.zshrc file:
export PATH=~/.npm-global/bin:$PATH
Update the system variables:
source ~/.zshrc
Finally install the packages using npm:
npm install -g tern
npm install -g jshint
npm install -g csslintInstall pyenv:
curl -L https://raw.githubusercontent.com/pyenv/pyenv-installer/master/bin/pyenv-installer | bashAdd pyenv to the path:
echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.zprofile
echo 'export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.zprofile
echo 'eval "$(pyenv init --path)"' >> ~/.zprofile
echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.profile
echo 'export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.profile
echo 'eval "$(pyenv init --path)"' >> ~/.profile
echo 'eval "$(pyenv init -)"' >> ~/.zshrcInstall a Python version. For example:
pyenv install 3.8.0Activate the Python version:
pyenv local 3.8.0Then use pip3.8 to install some Python tools: youtube-dl, skyfield, pylint, etc.
How to use again the system version:
pyenv local systemHow to list all the available versions:
pyenv versionsInstall the dependencies:
sudo apt install git curl libssl-dev libreadline-dev zlib1g-dev autoconf bison build-essential libyaml-dev libreadline-dev libncurses5-dev libffi-dev libgdbm-dev
Then install Rbenv:
curl -sL https://github.com/rbenv/rbenv-installer/raw/master/bin/rbenv-installer | bash -
Add Rbenv to the PATH in ~/.zshrc:
export PATH="$HOME/.rbenv/bin:$PATH"
eval "$(~/.rbenv/bin/rbenv init - zsh)"Install the wanted Ruby version:
rbenv install 2.6.4
And make it global:
rbenv global 2.6.4
Finally install the last Jekyll version:
gem install jekyll
If the Ruby version is missing, upgrade ruby-build:
cd /home/gerard/.rbenv/plugins/ruby-build && git pull && cd -
Then install the newer version:
rbenv install 3.2.0
Then update Jekyll:
gem install jekyll -v 4.3.3
Some updates:
gem update --system
bundle update --bundler
Install it from the repositories:
sudo apt-get install w3m
Symlink the w3m settings:
cd $HOME/dotfiles && stow --no-folding w3m
Install it from the repositories:
sudo apt-get install ranger
Symlink the ranger settings:
cd $HOME/dotfiles && stow --no-folding ranger
Install it from the repositories:
sudo apt-get install vifm
Symlink the vifm settings:
cd $HOME/dotfiles && stow --no-folding vifm
Install the atomic theme for vifm:
mkdir $HOME/.mutt
git clone https://github.com/gerardbm/atomic
cp atomic/vifm/atomic.vifm $HOME/.config/vifm/colors/Install it following the instructions from fzf Github page.
git clone --depth 1 https://github.com/junegunn/fzf.git ~/.fzf
~/.fzf/installInstall it following the instructions from ytfzf Github page.
git clone https://github.com/pystardust/ytfzf
cd ytfzf
sudo make installInstall it from the repositories:
sudo apt-get install mutt
Copy the mutt settings (no symlink):
cp $HOME/dotfiles/mutt/.muttrc $HOME/
Install the atomic theme for mutt:
mkdir $HOME/.mutt
git clone https://github.com/gerardbm/atomic
cp atomic/mutt/atomic.muttrc $HOME/.muttInstall it from the repositories:
sudo apt-get install cmus
Symlink the cmus settings:
cd $HOME/dotfiles && stow --no-folding cmus
Install the atomic theme for cmus:
git clone https://github.com/gerardbm/atomic
cp atomic/cmus/atomic.theme $HOME/.config/cmusFrom cmus command line:
- Set the colorscheme:
:colorscheme atomic - Add the playlist:
:add $HOME/.config/cmus/playlist.pl
Install it from the repositories:
sudo apt-get install irssi
Create the folder first and then copy (no symlink) the irssi settings:
mkdir $HOME/.irssi && cp $HOME/dotfiles/irssi/.irssi/config $HOME/.irssi/
Copy the script to install the plugins for the first time:
cp $HOME/dotfiles/irssi/.irssi/config $HOME/.irssi/
Run it:
. ./iip.sh
Less config is into a binarry file called $HOME/.less.
Compile the file $HOME/.lesskey with lesskey command to generate it.
Sources: https://www.systutorials.com/docs/linux/man/1-lesskey/#lbAE
Download it from the repositories:
sudo apt-get install youtube-dl
Update it to the last version:
sudo -H pip install --upgrade youtube-dl
Packages for VirtualBox are not available in Debian 9. To install VirtualBox you must use the stretch-backports repository or the upstream third-party repository. More info, here: https://wiki.debian.org/VirtualBox.
All shortcuts are vim-style (H, J, K, L + U, D) and they are configured to work without conflicts coherently between i3wm, tmux, (neo)vim et al. Explanation:
Horizontal navigation between WM workspaces, tmux windows and vim buffers only has two directions: left and right. In this case, a modifier in combination with H and L is coherent with vim-style.
Four directions navigation (e.g. i3wm windows, tmux panes, vim windows) needs four keys: for left, right, top and bottom. In this case, a modifier in combination with H, J, K, L is coherent with vim-style.
Vertical navigation to scroll up/down tmux windows, vim buffers or man pages has two directions but as well two speeds. In this case, a modifier in combination with J, K, U and D is coherent with vim-style.
These are the guidelines:
- Vim-like navigation.
- Make it intuitive.
- Reduce the keystrokes.
- Improve the workflow.
That said, it is very logical to have different modifier keys for every application:
- Super to control the windows manager (i3wm in my case).
- Alt to control the terminal multiplexer (tmux in my case).
- Control to control a specific program (vim, w3m, irssi).
Tmux and vim share Alt+{hjkl} to navigate between tmux panes and vim windows; thanks to the plugin vim-tmux-navigator.
Tmux uses a prefix key to separate all the shortcuts from the system. This idea is very convenient to avoid conflicts between shortcuts, however it implies too much keystrokes. This prefix also has some disadvantages, because it uses the default Control+b: you lose a useful readline command (backward character). Some people remap it to Control+a because it's easier to press, so they lose a useful readline command (go to the start of the line). Also, it is used into vim to increase a numeric value.
My recommendation is to use the Alt key to remap some tmux bind-keys (using the -n flag), skipping the prefix for the most used actions.
The following table shows the main workflow:
| ACTION | I3WM | TMUX | VIM |
| $mod key | Super | Alt | Control |
| ------------- | ------------- | ------------ | ------------ |
| | (workspaces) | (windows) | (buffers) |
| Next | Ctrl+Super+l | Ctrl+Alt+l | Ctrl+l |
| Previous | Ctrl+Super+h | Ctrl+Alt+h | Ctrl+h |
| Last | Ctrl+Super+p | Ctrl+Alt+p | Ctrl+p Enter |
| ------------- | ------------- | ------------ | ------------ |
| | | (windows) | (buffers) |
| Up: 1 line | | Alt+space k | Ctrl+k |
| Down: 1 line | | Alt+space j | Ctrl+j |
| Up: ½ page | | Alt+space u | Ctrl+u |
| Down: ½ page | | Alt+space d | Ctrl+d |
| ------------- | ------------- | ------------ | ------------ |
| | (windows) | (panes) | (windows) |
| Focus ← | Super+h | Alt+h | Alt+h |
| Focus → | Super+l | Alt+l | Alt+l |
| Focus ↑ | Super+k | Alt+k | Alt+k |
| Focus ↓ | Super+j | Alt+j | Alt+j |
| Focus last | | | Ctrl+w p |
| Focus next | | | Ctrl+w l |
| Focus prev | | | Ctrl+w h |
| Focus #1 | Super+1 | Alt+1 | |
| Focus #2 | Super+2 | Alt+2 | |
| Focus #3 | Super+3 | Alt+3 | |
| Focus #4 | Super+4 | Alt+4 | |
| Focus #5 | Super+5 | Alt+5 | |
| Focus #6 | Super+6 | Alt+6 | |
| Focus #7 | Super+7 | Alt+7 | |
| Focus #8 | Super+8 | Alt+8 | |
| Focus #9 | Super+9 | Alt+9 | |
| New terminal | Super+n | Alt+n | Ctrl+t |
| Kill active | Super+x | Alt+x | Ctrl+w j |
| New terminal | Ctrl+Super+n | Ctrl+Alt+n | Ctrl+t |
| Kill active | Ctrl+Super+j | Ctrl+Alt+j | Ctrl+w j |
| Only active | | | Ctrl+w o |
| ------------- | ------------- | ------------ | ------------ |
| | (windows) | (panes) | (windows) |
| Fullscreen | Super+f | Alt+f | Ctrl+f |
| Resize ← | Super+r h | Alt+H | > |
| Resize → | Super+r l | Alt+L | < |
| Resize ↑ | Super+r k | Alt+K | - |
| Resize ↓ | Super+r j | Alt+J | + |
| Split v | Super+. | Alt+. | Ctrl+w . |
| Split h | Super+- | Alt+- | Ctrl+w - |
| ------------- | ------------- | ------------ | ------------ |
| | (windows) | (panes) | (windows) |
| Move to ← | Super+H | | Ctrl+w H |
| Move to → | Super+L | | Ctrl+w L |
| Move to ↑ | Super+K | Alt+K | Ctrl+w K |
| Move to ↓ | Super+J | Alt+J | Ctrl+w J |
| Move to last | Super+Shift+p | | |
| Move to # WS | Super+Shift+# | | |
Command line tools:
| ACTION | man (less) | w3m | irssi |
| ------------- | ------------- | ------------ | ------------ |
| | (pages) | (tabs) | (windows) |
| Next | | Ctrl+l | Ctrl+j |
| Previous | | Ctrl+h | Ctrl+k (1) |
| ------------- | ------------- | ------------ | ------------ |
| | (buffers) | (websites) | (buffers) |
| Up: 1 line | k | k | |
| Down: 1 line | j | j | |
| Up: ½ page | u | u | Alt+u, Alt+p |
| Down: ½ page | d | d | Alt+d, Alt+n |
| | | | (2) |
---
| ACTION | vifm | ranger | cmus | mutt |
| ------------- | ------------- | ------------- | ------------ | ------------ |
| | (files, dirs) | (files, dirs) | (playlists) | (emails) |
| Up: 1 line | k | k | k | k |
| Down: 1 line | j | j | j | j |
| Custom ← | h, fold | h, fold | h, seek -5 | |
| Custom → | l, unfold | l, unfold | l, seek +5 | |
---
1. Irssi windows are displayed in a column (vertical) according to my setup.
2. Alt+p and Alt+n are configured by default into irssi.
PDF and images:
| ACTION | mupdf | apvlv | feh |
| ------------- | ------------- | ------------- | ------------ |
| | (pdfs) | (pdfs) | (images) |
| ← | h | h | h |
| → | l | l | l |
| ↑ | k | k | k |
| ↓ | j | j | j |
| Zoom in | + | z | z |
| Zoom out | - | Z | Z |
| Up: ½ page | b | u | |
| Down: ½ page | space | d | |
| Rotate | R, L | r | <, > |
| Quit | q | q | q |
Audio:
| ACTION | cmus |
| ------------- | ------------- |
| ← (-seek) | h |
| → (+seek) | l |
| ↑ | k |
| ↓ | j |
| Pause | c |
| Stop | v |
| Volume up | + |
| Volume down | - |
| Quit | q |
Video:
| ACTION | mpv |
| ------------- | ------------- |
| ← (-seek) | h |
| → (+seek) | l |
| ← | Ctrl+h |
| → | Ctrl+l |
| ↑ | Ctrl+k |
| ↓ | Ctrl+j |
| Reset | Ctrl+p |
| Zoom in | z |
| Zoom out | Z |
| Reset zoom | Ctrl+z |
| Rotate | r |
| Reset rotate | Ctrl+r |
| Volume up | + |
| Volume down | - |
| Quit | q |
Yes, a mouse would make the life easier. And slower ;-)
This setup works in Debian 9 or later.