commit 36eb210b5277bfbf12d01cfaa3653a614c80b952 Author: Jali Date: Sun Oct 19 23:38:08 2025 +0200 initial commit diff --git a/README.md b/README.md new file mode 100644 index 0000000..1403b1a --- /dev/null +++ b/README.md @@ -0,0 +1,39 @@ +# TMUX - configuration + +## Overview + +This project contains a tmux-configuration, that allows loading different +plugins and layouts, that can be used to use tmux in conjunction with the helix +editor as an integrated development environment. It can be used to edit source +code, write texts with LaTeX and many other things. It requires the tmux plugin +manager to be installed, in order to provide all neccessary or desired +extensions. + +## Prerequisites + +Several packages must be available, in order to run the IDE in different +modes/layouts: + +- [tmux](https://github.com/tmux/tmux/wiki): The terminal multiplexer itself +- [git](https://git-scm.com): The git version control system +- [tpm](https://github.com/tmux-plugins/tpm?tab=readme-ov-file): The tmux plugin + manager +- [lazygit](https://github.com/jesseduffield/lazygit): A simple text based UI + for using git +- [helix](https://helix-editor.com): A postmodern text editor. Replaces + vim/neovim. + +For some plugins, extra tools are required. These are optional, and only needed, +when the plugins are installed: + +- [yq](https://github.com/mikefarah/yq): A commandline yaml parser. Required by + [tmux nerd font window name plugin](https://github.com/joshmedeski/tmux-nerd-font-window-name). + +## Installation + +Before any plugins can be loaded, it is neccesary to install the plugin-manager +itself. This has to be done manually, and can easily be done by using git: + +```bash +git clone https://github.com/tmux-plugins/tpm ~/.config/tmux/plugins/tpm +``` diff --git a/tmux.conf b/tmux.conf new file mode 100644 index 0000000..9ae3e9c --- /dev/null +++ b/tmux.conf @@ -0,0 +1,17 @@ +# TMUX configuration for using tmux as an IDE +# This file contains a minimal configuration and diffent layout. + +# enable the mouse mode +set -g mouse on + +# Use xclop to copy and paste with the system clipboard +bind C-c run "tmux save-buffer - | xclip -i sel clip" +bind C-v run "tmux set-buffer ${xclip -o sel clip}; tmux paste-buffer" + +# Configure the plugin manager +# List of plugins +set -g @plugin 'tmux-plugins/tpm' +set -g @plugin 'tmux-plugins/tmux-sensible' + +# Initialize TMUX plugin manager (keep this line at the very bottom of tmux.conf) +run '~/.tmux/plugins/tpm/tpm'