https://github.com/code-butter/selektor
A nice pop-up GUI selector for your scripts.
https://github.com/code-butter/selektor
cross-platform scripting tool
Last synced: 5 months ago
JSON representation
A nice pop-up GUI selector for your scripts.
- Host: GitHub
- URL: https://github.com/code-butter/selektor
- Owner: code-butter
- License: mit
- Created: 2024-04-22T23:38:02.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2024-04-26T19:12:34.000Z (about 2 years ago)
- Last Synced: 2024-04-27T15:44:28.167Z (about 2 years ago)
- Topics: cross-platform, scripting, tool
- Language: Svelte
- Homepage:
- Size: 1.71 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# selektor
Select from available options with scripting. This is a simple GUI application that pipes the selected option back to
the script.
## Installation
### Prebuilt Binaries
* Visit the latest release to get the binary for your platform.
* Copy it to a directory in your PATH environment variable.
* rename it to 'selektor' if you downloaded the MacOS or Linux version
The MacOS build is universal and will work on Intel and ARM Macs.
These binaries are not currently signed, but will be eventually.
### Build it yourself
* [Install all the dependencies for Tauri development](https://tauri.app/v1/guides/getting-started/prerequisites/)
* `npm install`
* `npm run tauri build`
Copy the resulting binary nested somewhere in `src-tauri/target` to a directory in your PATH.
## Usage
Pass a JSON object with this format into `selektor`: `[{label: "Label value", value: "Program value"}]`. You can pass this
in either through an environment variable `SELEKTOR_OPTIONS`, through a CLI argument `--options json-text`, or through STDIN.
If you use STDIN, append a newline to the JSON string.
If you'd like to change the prompt in the text box you can do it through the environment variable `SELKTOR_PROMPT` or
through the CLI argument `--prompt "Your Prompt Here..."`.
## Example
This can be run in Python 3. You can similarly use this in other languages and in shell scripts.
```python
#!/usr/env python3
import sys
import json
import subprocess
data = [
{"label": "Test Option 1", "value": "test_option_1"},
{"label": "Test Option 2", "value": "test_option_2"},
{"label": "Test Option 3", "value": "test_option_3"}
]
process = subprocess.Popen(["selektor", "--prompt", "Choose a thing"], text=True, stdin=subprocess.PIPE,
stdout=subprocess.PIPE, stderr=subprocess.PIPE)
stdout, stderr = process.communicate("%s\n" % json.dumps(data))
sys.stderr.write(stderr)
if process.returncode != 0:
sys.stderr.write("Process exited with code %d\n" % process.returncode)
else:
sys.stdout.write("You selected %s\n" % stdout)
```