Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/yunger7/zicott

A CLI tool to easily download YouTube music
https://github.com/yunger7/zicott

cli music typescript youtube

Last synced: 3 months ago
JSON representation

A CLI tool to easily download YouTube music

Host: GitHub
URL: https://github.com/yunger7/zicott
Owner: yunger7
License: mit
Created: 2022-09-22T20:17:37.000Z (over 2 years ago)
Default Branch: main
Last Pushed: 2024-06-14T01:10:43.000Z (7 months ago)
Last Synced: 2024-10-11T22:15:48.027Z (3 months ago)
Topics: cli, music, typescript, youtube
Language: TypeScript
Homepage:
Size: 482 KB
Stars: 2
Watchers: 1
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README


   ______     __     ______     ______     ______   ______  

  /\___  \   /\ \   /\  ___\   /\  __ \   /\__  _\ /\__  _\ 

  \/_/  /__  \ \ \  \ \ \____  \ \ \/\ \  \/_/\ \/ \/_/\ \/ 

    /\_____\  \ \_\  \ \_____\  \ \_____\    \ \_\    \ \_\ 

    \/_____/   \/_/   \/_____/   \/_____/     \/_/     \/_/ 

    

    A CLI tool to easily download YouTube music.

## About
Zicott is a Gluegun-powered CLI for quickly downloading YouTube videos as MP3. It's a simple tool that I've build for my personal usage, so don't expect it to be heavily maintained. Personally, I've been using YouTube to listen to music, but there are a couple of problems with it:
- Ads.
- Videos get taken down all the time.
- No offline mode.
- Message popup saying *"Are you still watching?"*.

So that's why this tool exists.

**⚠ Important:** To run this CLI, you need to have [FFmpeg](https://www.ffmpeg.org/) installed on your computer. Also, keep in mind that downloading audio from videos other than your own is against YouTube TOS, use this tool at your own risk.

## Install
```
$ npm install -g zicott
$ zicott --help
```

## Usage
```
$ zicott --help

USAGE
zicott [flags]

FLAGS
--help (h) Show help about a command
--version (v) Show installed version
--output (o) Path to output mp3 file (defaults to current working directory)
--playlist (p) Download the entire playlist
--ffmpeg Path to FFmpeg binary

EXAMPLES
$ zicott
$ zicott https://youtu.be/1weNnjzaXbY
$ zicott https://youtu.be/d7V3M2DAq1E --output ~/Downloads/myfile.mp3
$ zicott -p "https://www.youtube.com/watch?v=wmi_lZU392Q&list=PLjJC3hyewH5BqfdAhehFXDQ5zZjZMCGez&index=90"
```

## License
Licensed under the MIT License. See `LICENSE` for more details.