# prism-media

> Easy-to-use stream-based media transcoding

Latest version **1.3.5** (published 2023-02-27) · Apache-2.0 license · 0 weekly downloads

## Install

```sh
npm install prism-media
pnpm add prism-media
yarn add prism-media
bun add prism-media
```

## Health

**Score 25/100 (F)** — status: abandoned.

Positive: has types; no vulnerabilities; high quality score.

Warnings: low downloads; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.3.5 |
| Published | 2023-02-27 |
| First published | 2017-04-15 |
| Weekly downloads | 0 |
| License | Apache-2.0 |
| TypeScript types | bundled |
| Module format | CommonJS |
| Dependencies | 0 |
| Unpacked size | 44 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 258 |
| Author | Amish Shah |
| Maintainers | hydrabolt |
| Keywords | audio, media, ffmpeg, opus, pcm, webm, ogg |

## Links

- npm: https://www.npmjs.com/package/prism-media
- Repository: https://github.com/hydrabolt/prism-media
- Homepage: https://github.com/hydrabolt/prism-media#readme
- Issues: https://github.com/hydrabolt/prism-media/issues
- npm.io page: https://npm.io/package/prism-media

## Alternatives

- [cli-color](https://npm.io/package/cli-color.md) — 3.4M weekly downloads
- [log](https://npm.io/package/log.md) — 1.3M weekly downloads
- [logstash-client](https://npm.io/package/logstash-client.md) — 4.5K weekly downloads
- [@nocobase/plugin-logger](https://npm.io/package/@nocobase/plugin-logger.md) — 2.0K weekly downloads
- [child-process-debug](https://npm.io/package/child-process-debug.md) — 695 weekly downloads

## Recent versions

- 1.3.5 (latest) — 2023-02-27
- 2.0.0-alpha.0 (alpha) — 2021-08-09
- 1.3.4 — 2022-07-09
- 1.3.2 — 2021-08-09
- 1.3.1 — 2021-06-12
- 1.3.0 — 2021-06-12
- 1.2.9 — 2021-03-20
- 1.2.8 — 2021-03-13
- 1.2.7 — 2021-02-17
- 1.2.6 — 2021-02-13
- 1.2.5 — 2021-02-03
- 1.2.4 — 2021-02-03
- 1.2.3 — 2020-12-02
- 1.2.2 — 2020-05-02
- 1.2.1 — 2020-02-26
- … 17 more at https://npm.io/package/prism-media/versions

## README

[![Logo](https://hydrabolt.me/assets/prism-media-logo.svg)](https://amishshah.github.io/prism-media/)

<div align="center">

[![Build Status](https://travis-ci.org/amishshah/prism-media.svg?branch=master)](https://travis-ci.org/hydrabolt/prism-media)
[![dependencies](https://david-dm.org/amishshah/prism-media/status.svg)](https://david-dm.org/hydrabolt/prism-media)
[![npm](https://img.shields.io/npm/dt/prism-media.svg)](https://www.npmjs.com/package/prism-media)
[![Patreon](https://img.shields.io/badge/donate-patreon-F96854.svg)](https://www.patreon.com/discordjs)

</div>

## What is it?

An easy-to-use stream-based toolkit that you can use for media processing. All the features provided have predictable
abstractions and join together coherently.

```js
// This example will demux and decode an Opus-containing OGG file, and then write it to a file.
const prism = require('prism-media');
const fs = require('fs');

fs.createReadStream('./audio.ogg')
  .pipe(new prism.opus.OggDemuxer())
  .pipe(new prism.opus.Decoder({ rate: 48000, channels: 2, frameSize: 960 }))
  .pipe(fs.createWriteStream('./audio.pcm'));
```

The example above can work with either a native or pure JavaScript Opus decoder - you don't need to worry about changing
your code for whichever you install.

- FFmpeg support (either through npm modules or a normal installation) 
- Opus support (native or pure JavaScript)
- Demuxing for WebM/OGG files (no modules required!)
- Volume Altering (no modules required!)

## Dependencies

The following dependencies are all optional, and you should only install one from each category (the first listed in
each category is preferred)

- Opus
  - [`@discordjs/opus`](https://github.com/discordjs/opus)
  - [`node-opus`](https://github.com/Rantanen/node-opus)
  - [`opusscript`](https://github.com/abalabahaha/opusscript)
- FFmpeg
  - [`ffmpeg-static`](http://npmjs.com/ffmpeg-static)
  - `ffmpeg` from a [normal installation](https://www.ffmpeg.org/download.html)

## Useful Links

- [Documentation](https://amishshah.github.io/prism-media)
- [Examples](https://github.com/amishshah/prism-media/tree/master/examples)
- [Patreon](https://www.patreon.com/discordjs)

## License

> Copyright 2019 - 2022 Amish Shah
> 
> Licensed under the Apache License, Version 2.0 (the "License");
> you may not use this file except in compliance with the License.
> You may obtain a copy of the License at
> 
>    http://www.apache.org/licenses/LICENSE-2.0
> 
> Unless required by applicable law or agreed to in writing, software
> distributed under the License is distributed on an "AS IS" BASIS,
> WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
> See the License for the specific language governing permissions and
> limitations under the License.

---
_Source: https://npm.io/package/prism-media · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._