Git Product home page Git Product logo

tmux-sessionx's Introduction

Tmux SessionX

A fuzzy Tmux session manager with preview capabilities, deleting, renaming and more!

image

Prerequisits 🛠️

Install 💻

Add this to your .tmux.conf and run Ctrl-I for TPM to install the plugin.

set -g @plugin 'omerxx/tmux-sessionx'

Configure ⚙️

The default binding for this plugin is <prefix>+O You can change it by adding this line with your desired key:

# I recommend using `o` if not already in use, for least key strokes when launching
set -g @sessionx-bind '<mykey>'

Additional configuration options:

# `C-x` is a customizeable, by default it indexes directories in `$HOME/.config`, 
# but this can be changed by adding the config below.
# e.g. set -g @sessionx-x-path '~/dotfiles'
set -g @sessionx-x-path '<some-path>'

# A comma delimited absolute-paths list of custom paths 
# always visible in results and ready to create a session from. 
# Tip: if you're using zoxide mode, there's a good chance this is redundant
set -g @sessionx-custom-paths '/Users/me/projects,/Users/me/second-brain'

# By default, the current session will not be shown on first view
# This is to support quick switch of sessions
# Only after other actions (e.g. rename) will the current session appear
# Setting this option to 'false' changes this default behavior
set -g @sessionx-filter-current 'false' 

# Window mode can be turned on so that the default layout
# Has all the windows listed rather than sessions only
set -g @sessionx-window-mode 'on' 

# Preview location and screenspace can be adjusted with these
# Reminder: it can be toggeled on/off with `?`
set -g @sessionx-preview-location 'right'
set -g @sessionx-preview-ratio '55%'

# Change window dimensions
set -g @sessionx-window-height '90%'
set -g @sessionx-window-width '75%'

# When set to 'on' a non-result will be sent to zoxide for path matching
# Requires zoxide installed
set -g @sessionx-zoxide-mode 'on'

# If you're running fzf lower than 0.35.0 there are a few missing features
# Upgrade, or use this setting for support
set -g @sessionx-legacy-fzf-support 'on'

Working with SessionX 👷

Launching the plugin pops up an fzf-tmux "popup" with fizzy search over existing session (-current session). If you insert a non-existing name and hit enter, a new session with that name will be created.

  • alt+backspace will delete the selected session
  • C-u scroll preview up
  • C-d scroll preview down
  • C-r "read": will launch a read prompt to rename a session within the list
  • C-w "window": will reload the list with all the available windows and their preview
  • C-x will fuzzy read ~/.config or a configureable path of your choice (with @session-x-path)
  • C-e "expand": will expand PWD and search for local directories to create additional session from
  • C-b "back": reloads the first query. Useful when going into window or expand mode, to go back
  • C-t "tree": reloads the preview with the tree of sessions+windows familiar from the native session manager (C-S)
  • ? toggles the preview pane

WARNING ⚠️

  • If you're running fzf lower than 0.35.0 there are a few missing missing features that might break the plugin. Either consider upgrading or add @sessionx-legacy-fzf-support 'on' to your config (see configuration)
  • This plugin is not designed to be used outside Tmux, although PRs are happily recieved!

Thanks ❤️

Inspired by these:

tmux-sessionx's People

Contributors

omerxx avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.