Files
2026-04-06 11:35:45 +07:00

51 lines
2.8 KiB
Markdown

# Zsh / tmux / Neovim setup
This directory holds dotfiles and an installer that targets **Debian/Ubuntu** (APT + `sudo`).
## Run the installer
From this repository, run the script **from the `zsh` directory** so the `cp` steps resolve `init.lua`, `p10k.zsh`, `tmux.conf`, and `tmuxinator.yml`:
```bash
cd zsh
bash install.sh
```
## What `install.sh` does
1. **System packages** — `apt-get update` / `upgrade`, then installs: `zsh`, `tmux`, `wget`, `curl`, `git`, `vim`, `nmon`, `neofetch`, `nload`, `htop`.
2. **Oh My Zsh** — If `${ZSH:-~/.oh-my-zsh}` is not already a directory, runs the official install script from [ohmyzsh](https://github.com/ohmyzsh/ohmyzsh) with `CHSH=no` and `RUNZSH=no` (non-interactive). Otherwise prints a skip message. Uses `env -u ZSH` so a pre-exported `ZSH` does not confuse the installer.
3. **Zsh plugins** — Clones [zsh-autosuggestions](https://github.com/zsh-users/zsh-autosuggestions) and [zsh-syntax-highlighting](https://github.com/zsh-users/zsh-syntax-highlighting) into `$ZSH_CUSTOM/plugins/`, then edits `~/.zshrc` so the `plugins=(...)` line includes `zsh-autosuggestions` and `zsh-syntax-highlighting`.
4. **Powerlevel10k** — Clones [powerlevel10k](https://github.com/romkatv/powerlevel10k) under `$ZSH_CUSTOM` (see `install.sh` for the exact path).
5. **Tmux Plugin Manager (TPM)** — Clones [tpm](https://github.com/tmux-plugins/tpm) to `~/.tmux/plugins/tpm`.
6. **Neovim** — Downloads the latest **Linux x86_64 AppImage** from the Neovim releases, installs it as `/usr/local/bin/nvim`.
7. **Tmuxinator** — Installs the Zsh completion file to `/usr/local/share/zsh/site-functions/_tmuxinator`, and appends `alias mux=tmuxinator` to `~/.zshrc` when that exact line is not already present.
8. **Local configs** — Copies repo files into your home/config:
| Source (this repo) | Destination |
| ------------------ | ----------- |
| `init.lua` | `~/.config/nvim/init.lua` |
| `p10k.zsh` | `~/.p10k.zsh` |
| `tmux.conf` | `~/.tmux.conf` |
| `tmuxinator.yml` | `~/.tmuxinator/project.yml` |
9. **Default shell** — Runs `sudo chsh -s "$(command -v zsh)"` for the invoking user (`SUDO_USER` when the script was started with `sudo`), so new login sessions use zsh without running interactive `chsh`.
## After install
- **New login shell:** Log out and back in (or open a new SSH session) so the `chsh` change applies. Until then you can run `exec zsh` in the current terminal.
- In tmux, install TPM plugins per your `tmux.conf` (often `prefix` + `I` once TPM is loaded).
If `sudo chsh` failed (e.g. zsh not listed in `/etc/shells`), set the shell manually after fixing: `chsh -s "$(command -v zsh)"`.
## Further reading
- Tmux-oriented setup notes: [Terminal setup with zsh, tmux, Dracula theme](https://dev.to/andrenbrandao/terminal-setup-with-zsh-tmux-dracula-theme-48lm)