# ytsearch

> Search YouTube from the command-line without an API key.

Latest version **1.0.4** (published 2015-03-24) · MIT license · 0 weekly downloads

## Install

```sh
npm install ytsearch
pnpm add ytsearch
yarn add ytsearch
bun add ytsearch
```

Provides the command `ytsearch`.

## 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.0.4 |
| Published | 2015-03-24 |
| First published | 2014-12-01 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 8 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 5 |
| Author | Mister Hat |
| Maintainers | misterhat |
| Keywords | youtube, search, command, cli, music |

## Links

- npm: https://www.npmjs.com/package/ytsearch
- Repository: https://github.com/misterhat/ytsearch
- Issues: https://github.com/misterhat/ytsearch/issues
- npm.io page: https://npm.io/package/ytsearch

## Dependencies (8)

- [colors](https://npm.io/package/colors.md) ^1.0.3
- [slashes](https://npm.io/package/slashes.md) ^1.0.5
- [minimist](https://npm.io/package/minimist.md) ^1.1.0
- [timelabel](https://npm.io/package/timelabel.md) ^1.0.2
- [format-number](https://npm.io/package/format-number.md) ^1.0.2
- [get-youtube-id](https://npm.io/package/get-youtube-id.md) ^0.1.3
- [youtube-search](https://npm.io/package/youtube-search.md) ^0.2.0
- [youtube-best-video](https://npm.io/package/youtube-best-video.md) 0.0.6

## 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.0.4 (latest) — 2015-03-24
- 1.0.3 — 2014-12-01
- 1.0.2 — 2014-12-01
- 1.0.1 — 2014-12-01
- 1.0.0 — 2014-12-01

## README

# ytsearch
Search YouTube from the command-line without an API key. It can fetch URLs and
various meta content in whatever output format you'd like. Out of the box it
pairs well with ytdl.

## Installation

    # npm install -g ytsearch

## Examples
Output the first five results for a search term with a pretty interface:

    $ ytsearch "the beatles" -p -l 5

Display the first five searches for terms with title, descriptions and URLs:

    $ ytsearch "dr katz" -f "%t\n%d\n%u\n\n" --limit 5

Stream a TV show to mplayer:

    $ ytdl "$(ytsearch "dr katz episode 2")" | mplayer -

Find the link for a music track, stream the download to ffmpeg which strips the
video, saves it to disk and finally streams the audio to mplayer:

    $ ytdl "$(ytsearch altogether\ now\ beatles --music)" | ffmpeg -i pipe:0  \
    -vn -f mp3 altogether.mp3 -f mp3 pipe:1 | mplayer -

## Manual
```
Usage: ytsearch <terms> [options]

-h, --help
        Display this screen.
-p, --pretty
        Sets the format to something pleasing to look at.
        default: false
-f, --format "%t %a %d %D %c %T %v %f %u %p"
        Format a video's meta data with a specific format string.

        %t - title
        %a - author
        %d - description
        %D - duration
        %c - category
        %T - thumbnail
        %v - views
        %f - favorites
        %u - url
        %p - published

        default: "%u"
-l, --limit <number>
        Limit the amount of videos returned by the specified number.
        default: 1
-o, --offset <number>
        Offset the returned videos by the specified number.
        default: 1
-m, --music
        Select the best music track for the specified terms. Note that this
        flag ignores limit and offset if set as it only returns one video.
        default: false
--nostrip
        Don't strip the backslashes from the format string.
        default: false
--inhuman
        Don't humanize any of the meta information.
        default: false
```

## License
MIT

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