NimCoon

Play videos from YouTube and PeerTube from the command line using your preferred desktop media player.

This application is implemented in Nim language using only the standard library.

Features

• [x] Search for videos using keywords
• [x] Stream videos and music from YouTube
• [x] Play direct links from YouTube and PeerTube
• [x] Stream video and music from magnet links
• [x] Download music
• [x] Download video
• [ ] Configuration options

Installation

Nim Coon depends on the following:

• youtube-dl
• mpv (recommended) or vlc
• peerflix (for magnet links)

Download the latest build from GitlabCI (amd64 GNU/Linux only).

wget https://gitlab.com/njoseph/nimcoon/-/jobs/artifacts/master/download?job=compile -O artifacts.zip
unzip artifacts.zip

For other platforms, you can install from source by running the following command:

nimble install

Usage

nimcoon "emacs"

# If your search query has multiple words, use quotes
nimcoon "nim lang"

# Play audio of the first search result
nimcoon -m -l "counting stars"

# Download audio of the first search result
nimcoon -mld "counting stars"

# Play direct video link
nimcoon https://www.youtube.com/watch?v=QOEMv0S8AcA

# Add -d to download or -m to select only audio or both
nimcoon -md https://www.youtube.com/watch?v=hT_nvWreIhg

After the search results are displayed, you can enter a number to play one result, "all" to play all the results or "q" to quit the program.

If a number is entered, after the selected search result is played, the results are redisplayed, so that you can play the other results without having to search again.

Command line arguments

Feel free to use these options in any combination. NimCoon will show a helpful error message if you pick incompatible options.

Development

One-liner for compiling and running

nim c -d:ssl -r src/nimcoon.nim 'nim lang'