desktop-tui

Crates.iodesktop-tui
lib.rsdesktop-tui
version0.3.1
created_at2025-09-06 20:43:15.557311+00
updated_at2025-09-21 20:50:53.022996+00
descriptionA desktop environment without graphics (tmux-like)
homepagehttps://github.com/Julien-cpsn/desktop-tui
repositoryhttps://github.com/Julien-cpsn/desktop-tui
max_upload_size
id1827476
size6,547,962
Julien C. (Julien-cpsn)

documentation

https://github.com/Julien-cpsn/desktop-tui

README

Desktop-TUI 🖥️

License: MIT GitHub Release Crates.io

A desktop environment without graphics (tmux-like).

Features:

  • Parse shortcut files containing apps
    • Custom additional commands
    • Custom window options
    • Custom terminal options
  • Display any application or command that uses stdout
    • Move and resize windows
    • Handle and display application error
  • Change tilling options
  • Can let the user select a file or a folder to use its path as a command argument
  • Clock

demo

How to use

Install

cargo install desktop-tui

Compile

cargo build
cargo build --release

Run

You can replace cargo run -- with desktop-tui

cargo run -- <shortcut_folder_path>

Or in release :

cargo run --release -- <shortcut_folder_path>

Shortcut file

Example helix.toml shortcut file:

# Window name
name = "Text editor"

# Command to execute
command = "hx"
# Each command argument
args = []

[taskbar]
# Shortcut position on the action bar
# Optional
position = 3

# Optional
[[taskbar.additional_commands]]
# Command name
name = "Open folder"
# Command to execute
command = "hx"
# <FILE_PATH> or <FOLDER_PATH> will be replaced by a path selected in a dialog
args = ["<FOLDER_PATH>"]

[[taskbar.additional_commands]]
name = "Open file"
command = "hx"
args = ["<FILE_PATH>"]

[window]
resizable = true
close_button = true
fixed_position = false
# Optional
size = { width = 10, height = 5 }

[terminal]
# Pad inner window
padding = [0, 0]
# Optional
background_color = { r = 30, g = 30, b = 30 }

Star history

Star History Chart

License

The MIT license for this project can be seen here

Commit count: 25

cargo fmt