Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/Mange/tydra

Shortcut menu-based task runner, inspired by Emacs Hydra
https://github.com/Mange/tydra

Last synced: about 2 months ago
JSON representation

Shortcut menu-based task runner, inspired by Emacs Hydra

Host: GitHub
URL: https://github.com/Mange/tydra
Owner: Mange
License: mit
Archived: true
Created: 2018-06-24T22:07:27.000Z (over 6 years ago)
Default Branch: master
Last Pushed: 2022-08-24T19:24:10.000Z (over 2 years ago)
Last Synced: 2024-08-03T15:11:04.865Z (5 months ago)
Language: Rust
Size: 157 KB
Stars: 42
Watchers: 5
Forks: 4
Open Issues: 5
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE

Awesome Lists containing this project

README

| | |
|---|---|
| ⚠️ | **NOTE:** This repository is now marked as read-only and has been officially abandoned due to lack of use and motivation to keep it going. |

# tydra

> Terminal Hydra

Tydra is a menu-based shortcut runner based on the great [Hydra
system](https://github.com/abo-abo/hydra) for Emacs by Oleh Krehel.

It works by reading an "action file" that defines the full menu. Each menu has
several pages, where one page at a time can be shown. Each page has one or more
entries, each of which has a shortcut key, a command, and a label.

With these building blocks you can build deeply nested menus with a diverse
range of commands, all behind a very simple shortcut system.

Contrast having to remember long commands (in terminal), or long complicated
shortcuts (in GUI), with a single command/shortcut and then having a menu
overlaid with each entry a single keystroke away.

Tydra makes it easier to add new things to your setup without having to come up
with a globally unique shortcut, while still being possible to remember it even
when it is not used often.

Some possible use-cases:

* Control your media player.
* Change your screen brightness and volume without RSI.
* Bookmark programs with specific arguments, or websites.
* Keep track of commonly used "recipes" and scripts.

[![](doc/screenshot1.png)](doc/screenshot1.png)

## Usage

See [doc/tydra.1.md](doc/tydra.1.md) for more information.

**Note:** If you install through the AUR, then this documentation is also
availabe as `man` pages `tydra(1)` and `tydra-actions(5)`.

## Installing

This package is available through Arch Linux's AUR repository as `tydra`. You
may also compile it from source by downloading the source code and install it
using `cargo` (Rust's build system and package manager):

```bash
cargo install
```

### Completions

This command comes with support for shell autocompletions for **bash**,
**zsh**, **fish**, **powershell**, and **elvish**.

**Note:** If you install through the AUR, then most of these completions are
already installed for you automatically.

You can generate and install the common completions globally:

```bash
tydra --generate-completions zsh > _tydra
tydra --generate-completions bash > tydra.bash
tydra --generate-completions fish > tydra.fish

sudo install -Dm644 _tydra \
/usr/share/zsh/site-functions/_tydra

sudo install -Dm644 tydra.bash \
/usr/share/bash-completion/completions/tydra

sudo install -Dm644 tydra.fish \
/usr/share/fish/completions/tydra.fish
```

If you have a local source for completions, redirect the output of the
`--generate-completions` command to the appropriate location.

## Copyright

Code is released under MIT license, see `LICENSE`.