https://github.com/gagath/bleep

Modern beep command replacement.
https://github.com/gagath/bleep

Last synced: about 5 hours ago
JSON representation

Modern beep command replacement.

• Host: GitHub
• URL: https://github.com/gagath/bleep
• Owner: gagath
• License: gpl-3.0
• Created: 2021-09-28T20:22:11.000Z (about 3 years ago)
• Default Branch: main
• Last Pushed: 2023-07-09T13:39:57.000Z (over 1 year ago)
• Last Synced: 2024-04-16T02:12:15.919Z (7 months ago)
• Language: Rust
• Size: 223 KB
• Stars: 1
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE-GPL-3.0

Awesome Lists containing this project

README

        


    



[![Build](https://github.com/MicroJoe/bleep/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/MicroJoe/bleep/actions/workflows/ci.yml)

[![Latest version](https://img.shields.io/crates/v/bleep.svg)](https://crates.io/crates/bleep)

[![License](https://img.shields.io/crates/l/bleep.svg)](https://crates.io/crates/bleep)

# bleep

Modern beep command replacement.

## Basic usage

Run a command, beep on completion or failure:

```

$ bleep run my-long-command

```

## Run manual beeps

Any beep can be played using the following commands:

```

$ bleep play success  # plays the "success" beep once and exits

$ bleep loop failure  # plays the "failure" beep infinitely in a loop

$ bleep loop -n3 warning  # plays the "warning" beep three times and exits

```

These commands can be combined to build an equivalent of the `bleep run`

command:

```

$ my-long-command && bleep play success || bleep loop failure

```

## Remote server

Start the server on the machine with the audio system — usually your local

development machine:

```

$ bleep server

Listenning on localhost:12345 (bleep TCP)

Listenning on localhost:12346 (beep on TCP connect)

```

Running bleep using the remote server:

```

$ bleep run --remote localhost:12345 my-long-command

```

## License

Licensed under the [GNU GENERAL PUBLIC LICENSE, version 3.0](LICENSE-GPL-3.0).

Unless you explicitly state otherwise, any contribution intentionally submitted

for inclusion in this project by you shall be licensed as above, without any

additional terms or conditions.