tmuxtop
Tmux Top - Summary of tmux on your pc plus the ability to backup and restore
Overview
TmuxTop is an advanced Tmux process monitoring tool that provides a top-like interface for managing and monitoring processes within Tmux sessions. This tool leverages a terminal user interface (TUI) to display real-time data on CPU and memory usage of processes running in Tmux panes. Additionally, TmuxTop includes features for exporting session data, and backing up and restoring Tmux sessions.
Screenshots
Features
- Real-time Monitoring: View real-time CPU and memory usage for processes within Tmux panes.
- Session Management: Easily navigate through Tmux sessions, windows, and panes.
- Export Data: Export session and process data to a JSON file for further analysis.
- Backup Sessions: Create backup scripts of your current Tmux sessions, preserving the state and commands.
- Restore Sessions: Restore Tmux sessions from previously created backup scripts.
- Intuitive Interface: User-friendly terminal interface with navigation and interaction using keyboard shortcuts.
Installation
Ensure you have Python 3 and the required dependencies installed:
pip install psutil curses argparse Usage —–
Run the TmuxTop tool:
sh
Copy code
python tmuxtop.py
Command Line Options
--export: Export session and process data to a JSON file.--backup: Backup current Tmux sessions to a shell script.--restore: Restore Tmux sessions from the latest backup script.
Interactive Commands
While running TmuxTop, use the following keys to interact with the interface:
- q: Quit the application.
- e: Export session data to
tmuxtop_export.json. - b: Backup current Tmux sessions.
- r: Restore Tmux sessions from the latest backup script.
- Up/Down Arrow Keys: Scroll through the list of processes and sessions.
Example
Here’s an example of how to use TmuxTop:
Start TmuxTop
sh
Copy code
python tmuxtop.py
Export Session Data
sh
Copy code
python tmuxtop.py --export
Backup Sessions
sh
Copy code
python tmuxtop.py --backup
Restore Sessions
sh
Copy code
python tmuxtop.py --restore
Advanced Usage
Real-Time Process Monitoring
TmuxTop provides real-time monitoring of processes within Tmux panes. It displays crucial metrics such as CPU and memory usage, user, process IDs, and more, helping you keep track of system resource consumption and performance.
Session and Window Navigation
TmuxTop organizes processes by Tmux sessions and windows, making it easy to navigate and view detailed information about each pane. This hierarchical view helps in managing complex setups with multiple sessions and windows efficiently.
Exporting Data
The export feature allows you to save the current state of Tmux sessions and processes to a JSON file. This can be useful for later analysis or reporting. Simply press ‘e’ while running TmuxTop or use the --export option when starting the script.
Backing Up and Restoring Sessions
TmuxTop’s backup and restore functionalities enable you to save and reload your Tmux environment. This is particularly handy for preserving your workflow across reboots or system changes. Use ‘b’ to backup and ‘r’ to restore sessions directly within the interface.
Contributing
Contributions are welcome! Please submit a pull request or open an issue to discuss any changes or enhancements. Your feedback and suggestions are valuable to make TmuxTop even better.
License
This project is licensed under the MIT License. See the LICENSE file for more details.
By using TmuxTop, you can enhance your Tmux experience with powerful monitoring and session management capabilities. Whether you’re managing complex development environments or simply want better insight into your Tmux processes, TmuxTop is the tool for you.