3 Play videos from YouTube and PeerTube from the
4 command line using your preferred desktop media player.
6 NewPipe app offers similar features for Android.
8 This application is implemented in [Nim language](https://nim-lang.org) using
9 only the standard library.
11 ![nimcoon screenshot with search term 'baby yoda'](screenshot.png)
15 - [x] Search for videos using keywords
16 - [x] Stream videos and music from YouTube
17 - [x] Play direct links from YouTube and PeerTube
18 - [x] Stream video and music from magnet links and hyperlinks to torrent files
21 - [x] Play YouTube playlists (MPV only)
22 - [ ] Download YouTube playlists
23 - [x] Stream video from torrent file URLs
24 - [x] BitTorrent is preferred for PeerTube video links
25 - [ ] Search PeerTube (3.0 or later)
26 - [ ] YouTube Autoplay
27 - [ ] Configuration options
29 | | YouTube | PeerTube (HTTP) | PeerTube (BitTorrent) | Direct Magnet Link |
30 | -------- | -------- | -------- | -------- | -------- |
31 | Music Streaming | ✅ | ✅ | ✅ | ✅ |
32 | Video Streaming | ✅ | ✅ | ✅ | ✅ |
33 | Music Download | ✅ | ✅ | | |
34 | Video Download | ✅ | ✅ | | |
38 Nim Coon depends on the following:
40 - mpv (recommended) or vlc
41 - peerflix and webtorrent (for magnet links)
43 Install MPV or VLC using your distribution's package manager.
47 pip3 install --user youtube-dl
50 Install PeerFlix and WebTorrent
52 npm install --global peerflix webtorrent-cli
55 (Optional) If you want your YouTube downloads to be faster, install `aria2` download manager.
57 ### Installing using Nimble
59 NimCoon can be installed from Nimble repositories:
62 nimble install nimcoon
65 You can also install from source by running the following command:
73 Download the latest build from GitlabCI (amd64 GNU/Linux only).
76 wget https://gitlab.com/njoseph/nimcoon/-/jobs/artifacts/master/download?job=compile -O artifacts.zip
80 Copy the binary to somewhere on your path like /usr/local/bin
87 # If your search query has multiple words, use quotes
90 # Play audio of the first search result
91 nimcoon -m -l "counting stars"
93 # Download audio of the first search result
94 nimcoon -mld "counting stars"
96 # Play direct video link
97 nimcoon https://www.youtube.com/watch?v=QOEMv0S8AcA
99 # Add -d to download or -m to select only audio or both
100 nimcoon -md https://www.youtube.com/watch?v=hT_nvWreIhg
103 After the search results are displayed, you can enter a number to play one
104 result, "all" to play all the results or "q" to quit the program.
106 If a number is entered, after the selected search result is played, the results
107 are redisplayed, so that you can play the other results without having to search
110 ### Command line arguments
112 | **Arguments** | **Explanation** |
113 |-------------------|--------------------------------------------|
114 | -m, --music | Play Music only, no video |
115 | -l, --lucky | Try your luck with the first search result |
116 | -f, --full-screen | Play video in full screen |
117 | -d, --download | Download video or music |
119 Feel free to use these options in any combination. NimCoon will show a helpful
120 error message if you pick incompatible options.
124 One-liner for compiling and running
127 nim c -d:ssl -r src/nimcoon.nim 'nim lang'
132 To avoid storing your nimcoon searches in `zsh` history, run this command
135 setopt histignorespace
138 Then, add a space before typing nimcoon in the shell, like " nimcoon"
141 nimcoon "this is private"
144 The same can be achieved in `bash` by setting an environment variable
146 export HISTCONTROL=ignoreboth