Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/nomadhoc/sound-play

An native audio player for NodeJS.
https://github.com/nomadhoc/sound-play

Last synced: about 2 hours ago
JSON representation

An native audio player for NodeJS.

Awesome Lists containing this project

README

        

# sound-play

_Dead simple sound player for Node -- because it should be simple._

```javascript
const sound = require("sound-play");
sound.play("file.mp3");
```
- Native solution. Does not require third-party application to work on `Windows` and `MacOS`.

- Support `.wav`, `.mp3` and other extensions.

# Install

```
npm install sound-play
```

```
yarn add sound-play
```

# Examples

### Relative path

```javascript
sound.play("file.mp3");
```

or

```javascript
const path = require("path");
const filePath = path.join(__dirname, "file.mp3");
sound.play(filePath);
```

### Adjusting Volume

```javascript
/**
* 0 = silent
* 0.5 = default
* 1 = max volume
*/
volume = 0.1;
sound.play("file.mp3", volume);
```

### Absolute path

```javascript
sound.play("C:\\file.mp3");
```

### Promise

```javascript
sound.play("file.mp3").then((response) => console.log("done"));
```

### Async/await

```javascript
try {
await sound.play("file.mp3");
console.log("done");
} catch (error) {
console.error(error);
}
```

# License

MIT