Metadata-Version: 2.4
Name: desto
Version: 0.0.5
Summary: tmux session manager
License-File: LICENSE
Requires-Python: >=3.11
Requires-Dist: ipython>=9.2.0
Requires-Dist: loguru>=0.7.3
Requires-Dist: nicegui>=2.16.1
Requires-Dist: psutil>=7.0.0
Requires-Dist: twine>=6.1.0
Description-Content-Type: text/markdown

# desto

desto is a simple and intuitive dashboard for managing and monitoring `tmux` sessions. It provides a user-friendly interface to start, view, and kill `tmux` sessions, as well as monitor system stats and view session logs.

## Usage

For example, 
* Type "sess" as the Session Name and in the Command field type:  
`'for i in {1..1000}; do echo -e "$i\\n"; sleep 0.1; done; echo'`  
* Click `RUN IN SESSION` and see it appear on top of the dashboard.  
* You can check its logs by clicking on `VIEW LOG` or `KILL` it.


## Features

- **Session Management**: Start, view, and kill `tmux` sessions with ease.
- **System Monitoring**: Real-time CPU, memory, and disk usage stats.
- **Log Viewer**: View live session logs in a clean, scrollable interface.

## Installation

1. **Install `tmux`**:
    <details>
    <summary>Instructions for different package managers</summary>

    - For Debian/Ubuntu:
      ```bash
      sudo apt install tmux
      ```

    - For Almalinux/Fedora:
      ```bash
      sudo dnf install tmux
      ```

    - For Arch Linux:
      ```bash
      sudo pacman -S tmux
      ```

    </details>

2. **Install `desto`**:
    <details>
    <summary>Installation Steps</summary>

    - By adding it to your project:
      ```bash
      uv add desto
      ```

    - Using `pip`:
      ```bash
      pip install desto
      OR
      uv pip install desto
      ```

    </details>

3. **Run the Application**:  
Simply type `desto` in your terminal from any directory to start the application.

4. **View on the browser**:  
You will see the message:  
    >NiceGUI ready to go on http://localhost:8088, and http://192.168.0.114:8088
    Opening in existing browser session.

## Dashboard
![Dashboard Screenshot](images/dashboard.png "Desto Dashboard")
