hlfw.ca

ytcli

ref: b6c4030d1499955944c9977f4c2accd4dcabbace
dir: /README.md/

# ytcli - POSIX sh


## Installation:

	just include in your path. 

## Usage: 
	
	ytcli [search|playlist|user|channel] [ -t ] KEYWORD
	ytcli [channel-id] KEYWORD

# ytcli - Go

## Building: 

	`go get github.com/halfwit/ytcli`

## Installation:

	`go install github.com/halfwit/ytcli`
	

Requests:

```
# Usage
 ytcli [ -trpucf ] [ -a apikey ] KEYWORD
	
# Search for a list of videos matching string
ytcli <query>

# Search for videos related to url
ytcli -r 'https://youtube.com/someurl'

# Search for playlists matching strings
ytcli -p <query>

# List of videos by user
ytcli -u <user name>

# List of playlists by user
ytcli -u -p <user name>

# List of videos by channel
ytcli -c <channel name>

# List of playlists by channel
ytcli -c -p <channel name>

# Link to channels' RSS feed
ytcli -f <channel name>

# Normally ytcli will query the factotum for an API key (this requires plan9port, plan9, etc)
# To set a key explicitely:
ytcli -a myapikey

# Include thumbnails
-t 

```

# API Keys

1. Navigate to https://console.developers.google.com/apis/credentials (log in with your Google account if required) 
2. Create a new project, labelled `ytcli`
3. Enable Youtube v3 API usage
4. Create new credentials, selecting to use an API key
5. Add this key to your local factotum, or simply pass it along with the `-a` flag to ytcli