givetray 0.1.0

Run terminal commands from the Linux system tray
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139

# givetray

`givetray` runs terminal commands from the Linux system tray using named profiles.
Each profile can run one command, show live logs, and manage desktop entries.

![givetray icon](assets/icon.png)

## Dependencies (Linux)

This app uses GTK for windows and AppIndicator for tray integration.

Debian/Ubuntu:

```bash
sudo apt install libgtk-3-dev libxdo-dev libappindicator3-dev
```

Arch/Manjaro:

```bash
sudo pacman -S gtk3 xdotool libappindicator-gtk3
```

## Install and Run

From source with Cargo:

```bash
cargo install --path .
givetray -c default
```

From crates.io (after publishing):

```bash
cargo install givetray
givetray -c default
```

Build manually:

```bash
cargo build --release
./target/release/givetray -c default
```

On first run, `givetray` creates `~/.config/givetray/configs/<profile>.toml`.
Then open `Configuration` from the tray menu and set your command/script.

## CLI Usage

`-c/--config PROFILE` is required for app mode and desktop-file mode.

```bash
givetray -c PROFILE [--icon ICON_PATH] [--log-file LOG_PATH]
givetray desktop-file -c PROFILE [--output-dir DIR] [--autostart] [--icon ICON_PATH]
givetray --help
givetray --version
```

Examples:

```bash
givetray -c scrcpy
givetray -c scrcpy --icon /path/to/icon.png
givetray -c scrcpy --log-file ~/.local/share/givetray/logs/scrcpy.log
givetray desktop-file -c scrcpy
givetray desktop-file -c scrcpy --autostart
```

## Desktop Entries

- Desktop filename format: `givetray_<profile>.desktop`
- Applications location: `~/.local/share/applications`
- Autostart location: `~/.config/autostart`
- `desktop-file` writes to Applications by default
- `--autostart` switches default target to autostart
- Configuration toggles can create/remove entries in both locations

## GUI Features

### Tray Menu

- `Start/Stop`: run or stop the configured command
- `Logs`: open live log window
- `Configuration`: edit profile command and toggles
- `About`: show app info and links
- `Exit`: stop current process and quit this instance

### Logs Window

- Live stdout/stderr streaming
- Rolling in-memory buffer with line count
- `Copy All` and `Clear` actions
- Optional file logging per profile

### Configuration Window

- Command/script editor for the active profile
- Run command on launch toggle
- Write logs to file toggle
- Applications entry toggle
- Session autostart toggle
- Saved/unsaved status with close confirmation

### About Window

- App icon, version, author, and license details
- GitHub link and Buy Me a Coffee link

## Sudo Behavior

If the configured command starts with `sudo`, `givetray` prompts for password on each Start.
The password is passed to `sudo` via stdin (`sudo -S`) and is not stored in config.

## Contributing

Contributions are welcome.

- Open an issue first for significant changes so scope and approach can be aligned.
- Keep pull requests focused and include clear reproduction or verification notes.

By submitting a contribution, you agree that your work is licensed under
`MIT OR Apache-2.0`.

## License

Licensed under either of:

- MIT license (`LICENSE-MIT`)
- Apache License, Version 2.0 (`LICENSE-APACHE`)

at your option.

## Support

If `givetray` helps your workflow, you can support development:

https://buymeacoffee.com/allenguarnes