Skip to main content

tmux session manager

Project description

desto

PyPI version Tests Code style: ruff Contributions welcome

desto is a modern, intuitive dashboard for managing and monitoring your tmux sessions. It provides a user-friendly web interface to start, view, and kill tmux sessions, monitor system stats, run custom or predefined scripts, and view live logs—all from your browser.


Features

🚀 Session Management: Start, view, and kill tmux sessions with a single click.

📊 System Monitoring: Real-time CPU, memory, and disk usage stats in the sidebar.

📝 Templates & Custom Scripts: View predefined templates (like recursive pattern search) or write your own bash scripts directly in the browser.

🔄 Keep Alive Option: Optionally keep sessions running after your script finishes.

📜 Live Log Viewer: View live logs for each session in a scrollable, syntax-highlighted interface.

💎 Responsive UI: Clean, modern interface built with NiceGUI.

💾 Persistent Logs & Scripts: All logs and scripts are stored in dedicated folders for easy access and reproducibility.

Requirements

Check pyproject.toml

Installation

  1. Install tmux

    Instructions for different package managers
    • Debian/Ubuntu
      sudo apt install tmux
      
    • Almalinux/Fedora
      sudo dnf install tmux
      
    • Arch Linux
      sudo pacman -S tmux
      
  2. Install desto

    Installation Steps
    • With uv:
      uv add desto
      
    • With pip:
      pip install desto
      # or
      uv pip install desto
      
  3. Run the Application

    desto
    
  4. Open in your browser
    After starting, visit http://localhost:8088 (or the address shown in your terminal).

Functionality

Dashboard Overview

Dashboard Screenshot

Launch your scripts as tmux sessions

  1. Set a tmux session name
  2. Select one of your scripts
  3. (OPTIONAL) edit and save your changes
  4. Click "Launch"!
Custom Template

Write new scripts and save them

If you want to compose a new script, you can do it right here, or simply just paste the output of your favorite LLM :)

Custom Template

Change settings

More settings to be added!

Custom Template

View your script's logs

Custom Template

License

Shield: CC BY 4.0

This work is licensed under a Creative Commons Attribution 4.0 International License.

CC BY 4.0


TODO

  • Explore possibility to pause processes running inside a session
  • Add dark mode/theme toggle for the dashboard UI

desto makes handling tmux sessions approachable for everyone—no terminal gymnastics required!

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

desto-0.1.4-py3-none-any.whl (19.7 kB view details)

Uploaded Python 3

File details

Details for the file desto-0.1.4-py3-none-any.whl.

File metadata

  • Download URL: desto-0.1.4-py3-none-any.whl
  • Upload date:
  • Size: 19.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.11.11

File hashes

Hashes for desto-0.1.4-py3-none-any.whl
Algorithm Hash digest
SHA256 5416cbd53a261245b04eae15b5f23eacdb581df2c27747b5cab4663d1851cf45
MD5 54106c4062fd4bdcc02db3524e8cc5be
BLAKE2b-256 274c237711daee195598ccf3131566470912c15fcc2a5691ea5cffa5bac369e3

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page