desto 0.1.12

tmux session manager

desto lets you run and manage your bash scripts in the background (inside tmux sessions) through a simple web dashboard. Launch scripts, monitor their and your system's status, view live logs, and control sessions—all from your browser.

---

The key features are:

• One-click session control: Start, monitor, and stop tmux sessions from your browser.
• Live system stats: See real-time CPU, memory, and disk usage at a glance.
• Script management: Use your existing scripts, write new ones, edit, save, or delete them directly in the dashboard.
• Script chaining: Queue multiple scripts to run sequentially in a single session.
• Scheduling: Schedule scripts or script chains to launch at a specific date and time.
• Live log viewer: Watch script output in real time and view logs for each session.
• Persistent storage: Scripts and logs are saved in dedicated folders for easy access.

⚡ Quick Start

👀 Dashboard Overview

---

🚀 Launch your scripts as tmux sessions

When you start desto, it creates desto_scripts/ and desto_logs/ folders in your current directory. Want to use your own locations? Just change these in the settings, or set the DESTO_SCRIPTS_DIR and DESTO_LOGS_DIR environment variables.

Your scripts show up automatically—no setup needed. Ready to launch? Just:

1. Name your tmux session
2. Select one of your scripts
3. (OPTIONAL) edit and save your changes
4. Click "Launch"! 🎬

🟢 Keep Alive: Want your session to stay open after your script finishes? Just toggle the switch. This adds tail -f /dev/null at the end, so you can keep the session active and continue viewing logs, even after your script completes.

---

✍️ 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 :)

---

⚙️ Change settings

More settings to be added!

---

📜 View your script's logs

Requirements

• Python 3.11+
• tmux

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, simply run:

     uv add desto
     

     This will install desto in your project ✅ Or if you don't have a project yet, you can set up everything with uv:

     1. Install uv by following the instructions on the official site.

     2. Create and set up your project:

        mkdir myproject && cd myproject
        uv init
        uv venv
        source .venv/bin/activate
        uv add desto
        

        Done!

   • With pip:

     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).

---

License

Shield:

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

---

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!