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

https://github.com/handstandsam/saydle

"Saydle 🔊", real-time audio notifications for Gradle.
https://github.com/handstandsam/saydle

Last synced: 12 months ago
JSON representation

"Saydle 🔊", real-time audio notifications for Gradle.

Awesome Lists containing this project

README

          

# Saydle 🔊 - "Say Gradle"
Saydle is a Wrapper for the Gradle Wrapper that notifies you via the OSX [`say`](https://ss64.com/osx/say.html) command whether a task failed or succeeded.

# Why?
Knowing when a Gradle build is done is super helpful when there are long running tasks. This allows you to be notified instead of checking the terminal.

[![Tweet about Using the Say Command with Gradle](static/saydle-tweet.png)](https://twitter.com/HandstandSam/status/1463207029007339520)

# System Requirements
* You must be Running Mac OSX

# Installation Instructions
Run the following command from the terminal in the root of your Android Project (where the `gradlew` file is)
```
curl -O "https://raw.githubusercontent.com/handstandsam/saydle/main/saydlew" && chmod +x saydlew
```

This will download the [`saydlew`](https://github.com/handstandsam/saydle/blob/main/saydlew) file and put it next to your `gradlew` file in the root of your Gradle project. It then ensures there is permission to execute the file.

# Usage
* Instead of using `./gradlew`, use `./saydlew` instead. That's it!
* Example: `./saydlew app:assembleDebug`

# Advanced Configuration Options
You can edit these options in the `saydlew` file itself.
* success_phrase="Success"
* failed_phrase="Failed"
* voice="Alex"

## Alternate Voices for the "say" Command
[OSX Say Command Documentation](https://ss64.com/osx/say.html)

**Available English Speaking Voices**
```
Alex en_US # Most people recognize me by my voice.
Fred en_US # I sure like being inside this fancy computer
Samantha en_US # Hello, my name is Samantha. I am an American-English voice.
Victoria en_US # Isn't it nice to have a computer that will talk to you?
```

**Other Languages**
Find other voices by running: `say -v '?'`

# How Does Saydle 🔊 Work?

Saydle 🔊 forwards your command to Gradle, and then looks at the execution result to say either "Success" or "Failed".

![Process Diagram](static/saydle-diagram.jpg)