Repository navigation
Releases
1.2.2
Full Changelog: 1.2.1...1.2.2
What's Changed
- added build date on make by @caesar003 in #11
Full Changelog: 1.2.1...1.2.2
[1.2.1] 2025-08-05
TLM v1.2.1 - Layout Editor
🎉 New Features
Layout Editing (-e/--edit)
- Edit layouts directly: Use
tlm -e [layout_name]to edit layout files in your preferred editor - Smart editor selection: Uses
DEFAULT_EDITORfrom config, falling back to$VISUAL,$EDITOR, orvim - Auto-creation: Creates new layout files with a helpful template when they don't exist
- JSON validation: Automatically validates syntax after editing and provides clear feedback
- Default layout editing: Run
tlm -ewithout arguments to edit your default layout
Usage Examples
tlm -e # Edit default layout
tlm -e myproject # Edit specific layout
tlm -e newlayout # Creates and edits new layout with template[1.1.1] - 2025-08-05
1.1.0
🚀 Tmux Layout Manager v1.2.0
🔍 Major New Feature: Layout Inspection
This release introduces comprehensive layout inspection capabilities, making it easier than ever to debug, understand, and manage your tmux layouts.
✨ What's New
🆕 --detail Flag
tlm -d- Shows system overview and all layout summariestlm -d <layout>- Deep dive into specific layout configurations
📊 System Information Display
- Configuration directory paths
- Default layout settings
- Version and system status
- Layout validation overview
🔧 Detailed Layout Analysis
- Window-by-window breakdown
- Pane split configuration
- JSON validation status
- Raw configuration display for debugging
🎯 Enhanced Tab Completion
- Full support for the new
--detailflag - Layout name completion for inspection commands
📝 Example Usage
# System overview and all layouts
tlm -d
# Inspect specific layout
tlm -d node
# Output example:
Layout Details: node
============================================
File: ~/.config/tlm/layouts/node.json
Status: Valid
Windows: 2
Window 1: editor
- Single pane
Window 2: git + npm
- Split into 2 panes📚 Documentation Updates
- ✅ Updated README with comprehensive inspection examples
- ✅ Enhanced manual page with detailed flag documentation
- ✅ Improved help text and usage examples
- ✅ Updated bash completion script
🔧 Technical Improvements
- New Functions:
show_layout_details(),show_layout_detail() - Better Error Handling: Clear validation and file status reporting
- Enhanced JSON Processing: Improved layout file validation
- Code Organization: Clean separation of inspection logic
🔄 Compatibility
- ✅ Fully backward compatible - all existing commands work unchanged
- ✅ No breaking changes to configuration or layout files
- ✅ Drop-in replacement for v1.0.4
🐛 Bug Fixes
- Improved error messages for invalid layout files
- Better handling of missing configuration directories
- Enhanced JSON validation feedback
📦 Installation
Upgrade from v1.0.4:
# If installed via script
./install.sh
# If using .deb package
sudo dpkg -i tlm_1.2.0.debFresh Installation:
# Download from releases page
wget https://github.com/caesar003/tlm/releases/download/v1.2.0/tlm_1.2.0.deb
sudo dpkg -i tlm_1.2.0.deb🙏 Feedback
Try out the new inspection features and let us know what you think! The --detail flag is designed to make layout management and debugging much more intuitive.
Full Changelog: v1.0.4...v1.2.0
What's Changed
- feat: add flexible session naming with directory-based auto-naming by @caesar003 in #1
- feat: added build script automation by @caesar003 in #2
- feat: add comprehensive layout inspection with --detail flag by @caesar003 in #3
- Revert "feat: add comprehensive layout inspection with --detail flag" by @caesar003 in #4
- build script by @caesar003 in #5
- fix: version number sync by @caesar003 in #6
- Feat/session detail by @caesar003 in #7
New Contributors
- @caesar003 made their first contribution in #1
Full Changelog: 1.0.4...1.1.0
1.0.4
Overview
Enhances TLM with intelligent session naming to solve the issue of identifying tmux sessions after terminal crashes.
Problem
Previously, sessions were named with only timestamps (session_1234567890), making it difficult to identify which session belonged to which project after a terminal emulator crash.
Solution
- Directory-based auto-naming: Uses current directory name as session base (e.g.,
OrderService-Frontend_1234567890) - Custom session names: Optional parameter for user-defined session names
- Smart shell completion: Suggests session names including current directory name
- Comprehensive documentation: Updated README, man page, and help text
Usage Examples
# Auto-naming from directory
cd ~/projects/OrderService-Frontend
tlm -i node # Creates: OrderService-Frontend_1234567890
# Custom naming
tlm -i node myproject # Creates: myproject_1234567890Full Changelog: 1.0.3...1.0.4
1.0.3
1.0.1
Tmux Layout Manager (TLM) is a command-line tool designed to simplify the management of Tmux sessions and layouts. With TLM, you can easily load, list, and initialize predefined layouts to streamline your workflow in Tmux.
Key Features:
- Load Tmux layouts using configuration files.
- List all available layouts for quick access.
- Easy installation with a Debian package for convenient deployment.
- Bash completion support for seamless command-line usage.
- Manual page included for comprehensive documentation.
Installation:
You can install TLM by cloning the repository and running the provided install script, or by downloading the Debian package from the release page.
# install script
git clone https://github.com/caesar003/tlm.git && cd tlm
chmod +x ./install.sh
./install.shRequirements:
- Tmux must be installed and running.
Usage:
- Load a layout:
./tlm -i <layout_name> - List available layouts:
./tlm -l - Show version:
./tlm -v - Display help:
./tlm -h
Getting Started:
For more detailed instructions, please refer to the README.md.
Tmux Layout Manager (TLM) - Release 1.0.0
Tmux Layout Manager (TLM) is a command-line tool designed to simplify the management of Tmux sessions and layouts. With TLM, you can easily load, list, and initialize predefined layouts to streamline your workflow in Tmux.
Key Features:
- Load Tmux layouts using configuration files.
- List all available layouts for quick access.
- Easy installation with a Debian package for convenient deployment.
- Bash completion support for seamless command-line usage.
- Manual page included for comprehensive documentation.
Installation:
You can install TLM by cloning the repository and running the provided install script, or by downloading the Debian package from the release page.
# install script
git clone https://github.com/caesar003/tlm.git && cd tlm
chmod +x ./install.sh
./install.shRequirements:
- Tmux must be installed and running.
Usage:
- Load a layout:
./tlm -i <layout_name> - List available layouts:
./tlm -l - Show version:
./tlm -v - Display help:
./tlm -h
Getting Started:
For more detailed instructions, please refer to the README.md.