# play-on-apple-tv

> A command line tool to play any audio/video on an Apple TV.

Latest version **1.1.1** (published 2019-08-25) · ISC license · 0 weekly downloads

## Install

```sh
npm install play-on-apple-tv
pnpm add play-on-apple-tv
yarn add play-on-apple-tv
bun add play-on-apple-tv
```

Provides the command `play-on-apple-tv`.

## Health

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

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.1.1 |
| Published | 2019-08-25 |
| First published | 2018-01-21 |
| Weekly downloads | 0 |
| License | ISC |
| TypeScript types | none |
| Module format | CommonJS |
| Node | >=8 |
| Dependencies | 12 |
| Unpacked size | 9.9 KB |
| Known vulnerabilities | 0 (+1 in 1 direct dependencies) |
| Install scripts | no |
| GitHub stars | 27 |
| Author | Jannis R |
| Maintainers | derhuerst |
| Keywords | music, airplay, airtunes, apple tv, media, cli |

## Links

- npm: https://www.npmjs.com/package/play-on-apple-tv
- Repository: https://github.com/derhuerst/play-on-apple-tv
- Issues: https://github.com/derhuerst/play-on-apple-tv/issues
- npm.io page: https://npm.io/package/play-on-apple-tv

## Dependencies (12)

- [mri](https://npm.io/package/mri.md) ^1.1.0
- [send](https://npm.io/package/send.md) ^0.17.1
- [chalk](https://npm.io/package/chalk.md) ^2.3.0
- [lodash](https://npm.io/package/lodash.md) ^4.17.15
- [get-port](https://npm.io/package/get-port.md) ^5.0.0
- [pretty-ms](https://npm.io/package/pretty-ms.md) ^5.0.0
- [internal-ip](https://npm.io/package/internal-ip.md) ^4.3.0
- [ansi-escapes](https://npm.io/package/ansi-escapes.md) ^3.0.0
- [pretty-bytes](https://npm.io/package/pretty-bytes.md) ^5.3.0
- [airplay-protocol](https://npm.io/package/airplay-protocol.md) ^2.0.2
- [ansi-diff-stream](https://npm.io/package/ansi-diff-stream.md) ^1.2.0
- [@derhuerst/cli-on-key](https://npm.io/package/@derhuerst/cli-on-key.md) ^0.1.0

## Alternatives

- [@salesforce/cli](https://npm.io/package/@salesforce/cli.md) — 389.7K weekly downloads
- [@mintlify/cli](https://npm.io/package/@mintlify/cli.md) — 208.9K weekly downloads
- [@grafana/e2e-selectors](https://npm.io/package/@grafana/e2e-selectors.md) — 128.7K weekly downloads
- [mintlify](https://npm.io/package/mintlify.md) — 112.0K weekly downloads
- [@intlayer/cli](https://npm.io/package/@intlayer/cli.md) — 22.8K weekly downloads

## Recent versions

- 1.1.1 (latest) — 2019-08-25
- 0.1.0-alpha.1 (next) — 2018-01-21
- 1.1.0 — 2019-07-28
- 1.0.0 — 2019-07-28
- 0.1.1 — 2019-07-28
- 0.1.0 — 2018-01-21

## README

# play-on-apple-tv

**A command line tool to play any audio/video on an [Apple TV](https://en.wikipedia.org/wiki/Apple_TV).**

[![asciicast](https://asciinema.org/a/158258.png)](https://asciinema.org/a/158258)

[![npm version](https://img.shields.io/npm/v/play-on-apple-tv.svg)](https://www.npmjs.com/package/play-on-apple-tv)
![ISC-licensed](https://img.shields.io/github/license/derhuerst/play-on-apple-tv.svg)
[![chat on gitter](https://badges.gitter.im/derhuerst.svg)](https://gitter.im/derhuerst)
[![support me on Patreon](https://img.shields.io/badge/support%20me-on%20patreon-fa7664.svg)](https://patreon.com/derhuerst)


## Usage

Using [`npx`](https://www.npmjs.com/package/npx):

```shell
npx play-on-apple-tv some-audio-file.mp3 my-apple-tv.local
npx play-on-apple-tv 'http://some-server/some-audio-file.mp3' my-apple-tv.local
```

Find the name of your Apple TV using [bonjour-browser](https://www.npmjs.com/package/bonjour-browser):

```shell
npx bonjour-browser | grep airplay
```

Play a Youtube video by finding the raw video url using [`youtube-dl`](https://youtube-dl.org):

```shell
npx play-on-apple-tv $(youtube-dl -f 136 --get-url 'https://www.youtube.com/watch?v=jNQXAC9IVRw') my-apple-tv.local
```


## Contributing

If you have a question or have difficulties using `play-on-apple-tv`, please double-check your code and setup first. If you think you have found a bug or want to propose a feature, refer to [the issues page](https://github.com/derhuerst/play-on-apple-tv/issues).

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