Skip to content

sauloperez/dotfiles

BranchesTags
 
 

Repository files navigation

Table of Contents

Prerequisites

  • Git (2.0+ recommended)
  • Neovim

When setting up a new computer, if you have a working one at hand, it's worth enabling passwordless ssh access to the new machine first and do the setup through SSH.

ssh-copy-id <user>@<host>

Packages

Ubuntu

sudo apt install \
  git \
  ssh \
  apt-transport-https \
  ca-certificates \
  curl \
  gnupg \
  build-essential
  tree \
  htop \
  xsel \
  tmux \
  fonts-firacode \
  rcm \
  zsh \
  jq \
  gawk \
  ripgrep
sudo add-apt-repository ppa:neovim-ppa/stable
sudo apt update
sudo apt install neovim

Mac

brew install \
    git \
    neovim \
    git-delta \
    rcm \
    nodenv \
    pyenv \
    tree \
    ripgrep \
    luarocks \
    tmux \
    z \
    fzf \
    # some more generic packages Mac lacks
    gpg \
    gsed \
    jq \

Install

SSH key

The ssh key is needed to get this dotfiles from Github so it's inevitably the first step.

If I have access to another working machine, it's easier to copy the ~/.ssh through scp.

Alternatively, I can get all key pairs from 1password, the personal and the work ones.

Dotfiles

Dotfiles installion is handled by thoughtbot's rcm. A suite of tools for managing dotfiles directories. Check out whether everything will work fine:

$ lsrc

Install your dotfiles symlinking them into your home directory:

$ rcup -v

Neovim

My Neovim configuration, found under /nvchad_config, is based on NvChad with my own customizations on top. That folder contains all Noevim's config files, using NvChad as plugin. Install them with the following symlink:

ln -s ~/.dotfiles/nvchad_config ~/.config/nvim

Once done, open Neovim and run :Lazy sync to install all plugins, and :MasonInstallAll to install all LSP servers. Lastly, Copilot will require calling :Copilot setup in any new device.

Read the NvChad documentation for more details.

Fonts

Fira Code is an awesome font perfectly suited for my console usage and Nvchad need for a Nerd Font. Go install it from their website.

Despite NvChad's suggestion to use Fira Code patched with icons, it's best to install a standalone symbols package to get icon support from Kitty. Install the Symbols Nerd Font Mono from Nerd Fonts releases page. The kitty.conf file will pick it up automatically. More details: https://sw.kovidgoyal.net/kitty/faq/#kitty-is-not-able-to-use-my-favorite-font.

FZF

FZF is an awesome fuzzy-finder I use from the terminal an as vim plugin. Make sure you read https://github.com/junegunn/fzf/blob/master/README-VIM.md as well. You should also read the vim plugin's README.

Zsh

Since Zsh comes installed with Mac, you just need to install Oh My Zsh by running the following command, although check their website for up to date installation instructions:

sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

Tmux

Beyond installing Tmux we also need to install tpm, the package manager.

Z

Z is an awesome utility to move around the file system based on "frecency" which makes me move much faster.

By typing a fo I cd to ~/dev/openfoodnetwork.

There is no manual step required to install since I use its oh my zsh plugin.

Mappings

Reference to vim mappings.

General

  • ,a= Tabularize on assignment (=)
  • ,a=> Tabularize on hash rocket keys (=>)
  • ,a: Tabularize on hash/object/dict keys (:)
  • ,a, Tabularize on comma (,)
  • ,c Toggle invisibles.
  • ,ls Show buffers (same as :buffers).
  • ,p Toggle paste mode.
  • ,qs Toggle search highlight.
  • ,qq Close Quickfix window (think Ack.vim).
  • ,rp Toggle Rainbow Parenthesis.
  • ,ss Strip all trailing whitespace in buffer.
  • ,W Sudo write!
  • Y Yank from cursor to end of line (same as y$).
  • ,* Replace word under cursor.
  • ,] Indent current block.
  • ,[ Outdent current block.
  • ,⏎ Insert newline.
  • ' Actually calls ` for better mark jumping (line + column).
  • J Join lines and restore cursor position.

Splits

  • + Increase split size.
  • - Decrease split size.
  • ^j Go to split below.
  • ^k Go to split above.
  • ^h Go to split left.
  • ^l Go to split right.

Commands

  • :W Alias to :w because I'm always typing it.
  • :R Get the output of shell commands.

Shell

Most of the shell junk is setup to work in bash. Bash users should see .bash_profile and .bash_prompt.

Aliases

Check out .aliases

Scripts

This folder contained more stuff in the past, but removing the ones I didn't use left only the two scripts I did to play Pharaoh:

  • setup-pharaoh
  • boot-pharaoh

Git

I've included some handy git script additions as well as configution changes. Have a look at .gitconfig to see various aliases and settings.

Additional scripts (see .scripts directory for source):

  • git-show-merges
  • git-wtf

NodeJS

Node is needed to run things like Coopdevs' slides_template.

For that is better to install Nodenv so multiple versions can be installed. Follow its installation steps at https://github.com/nodenv/nodenv#installation.

Support for different patch versions

Oftentimes, projects define a .node_version up to the minor version leaving room for patch upgrades without having to constantly update the version.

To support this, you have to install nodenv-aliases. So you can alias versions like

nodenv alias 20.11 20.11.1

Keyboard

To map Ctrl key to Caps lock:

Ubuntu

$ sudo apt-get install gnome-tweak-tool
gnome-tweak-tool > Keyboard & Mouse > Additional Layout Options > Ctrl key position

Cool utilities

sp

sp is a Spotify cli client that allows you to play, pause, get the current song, etc. from the command line. Just what I was looking for. Install it as follows

$ sudo curl -fLo /usr/local/bin/sp \
    https://gist.githubusercontent.com/wandernauta/6800547/raw/2c2ad0f3849b1b1cd1116b80718d986f1c1e7966/sp
$ sudo chmod ag+x /usr/local/bin/sp

Now, with the Spotify app open you can do sp current or sp play. Awesome!

Stay Updated

Run the sync again!

$ rcup -v

Pok3r mech keyboard

You can find how to program the pok3r in [guide] How-to: Program your Pok3r -- Programming Layers and Dipswitch 4 from the MechanicalKeyboards subreddit.

Troubleshooting

Getting Nvidia Quadro P1000 mobile to work

I couldn't an external monitor connected to my brand new Thinkpad P1 through HDMI until I updated the propietary Nvidia drivers and disabled Kernel mode setting on the Nvidia kernel module.

Keep in mind the HDMI port is wired to the Nvidia graphics card so you'll first have to switch to it either using Nvidia X Server Settings or the prime-select command line tool. I guess the latter gets installed with the nvidia-prime package but I haven't checked. Do not forget to log out and log in again for the changes to take effect.

In order to get the latest Nvidia drivers available I added the graphics-drivers PPA repository as follows

sudo add-apt-repository ppa:graphics-drivers/ppa
sudo apt update

Because of this, now ubuntu-drivers devices (you can find a nice explanation of this command here) listed a couple more options

== /sys/devices/pci0000:00/0000:00:01.0/0000:01:00.0 ==
modalias : pci:v000010DEd00001CBBsv000017AAsd00002267bc03sc00i00
vendor   : NVIDIA Corporation
model    : GP107GLM [Quadro P1000 Mobile]
driver   : nvidia-driver-390 - distro non-free
driver   : nvidia-driver-418 - distro non-free
driver   : nvidia-driver-396 - third-party free
driver   : nvidia-driver-415 - third-party free
driver   : nvidia-driver-430 - third-party free recommended
driver   : xserver-xorg-video-nouveau - distro free builtin

Particularly nvidia-driver-430 did not show up before. Unfortunately, the command sudo apt install nvidia-driver-430 reported an unmet depedencies error so I went the GUI way. You can do so by opening the "Software & Updates" app, choosing the "Additional Drivers" tab. Then, choose "nvidia-driver-430" and "Apply Changes". This took a while.

But it turns out this wasn't enough, even after restarting the system. Finally, I found the solution in https://www.dell.com/community/Precision-Mobile-Workstations/External-Monitor-not-working-Ubuntu-nvidia/m-p/7286631#M1634. Apparently the problem is with the kernel mode setting, which needs to be disabled to work.

Editing the file /lib/modprobe.d/nvidia-kms.conf to options nvidia-drm modeset=0 fixed the problem after a reboot 🎉️.

Recovering Grub after a Lenovo's firmware upgrade

After blindly applying the last firmware upgrade Grub was gone and there was no way to boot anything other than Windows 10. Disabling secure boot and enabling legacy boot didn't help either.

First of all, https://unix.stackexchange.com/a/475245 shed some light on this giving some clues that led me to the solution. First kind of understood what UEFI is about and what a EFI system partition is, then I run

bcdedit /set {bootmgr} path \EFI\ubuntu\grubx64.efi

from Window's command prompt as admin, as detailed in https://itsfoss.com/no-grub-windows-linux/. Then reading [BCD System Store Settings for UEFI](BCD System Store Settings for UEFI) from Microsoft's Hardware Dev Center made me understand we basically told the Windows Boot Manager that it should boot grub's EFI application instead.

Pipewire

Sorry, I don't remember all the things I did to make Pipewire work with Wireplumber but https://pipewire-debian.github.io/pipewire-debian/ seems to be the best reference, togheter with https://wiki.archlinux.org/title/PipeWire, to understand and troubleshoot this.

About

My dotfiles

Resources

Readme
Activity

Stars

3 stars

Watchers

3 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

No packages published

Languages

  • Lua 64.2%
  • Shell 35.5%
  • BitBake 0.3%