https://github.com/timolinn/joncalhoun-dl
Downloads Go video courses from https://courses.calhoun.io
https://github.com/timolinn/joncalhoun-dl
download downloader go golang gophercises joncalhoun-dl videos youtube-dl
Last synced: 27 days ago
JSON representation
Downloads Go video courses from https://courses.calhoun.io
- Host: GitHub
- URL: https://github.com/timolinn/joncalhoun-dl
- Owner: timolinn
- License: mit
- Created: 2020-03-03T15:12:30.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2021-05-27T10:48:36.000Z (almost 4 years ago)
- Last Synced: 2025-03-28T19:11:53.400Z (about 2 months ago)
- Topics: download, downloader, go, golang, gophercises, joncalhoun-dl, videos, youtube-dl
- Language: Go
- Homepage:
- Size: 64.5 KB
- Stars: 20
- Watchers: 0
- Forks: 5
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# joncalhoun-dl 🔥⬇
Downloads Go tutorial videos from
> **Before you proceed, note that you must be a paid user for the paid content to download**
Kindly create your account [here](https://courses.calhoun.io/signup?). Jon is a great teacher, consider buying his premium courses if you want to.
## Installation
+ Ensure [youtube-dl](https://github.com/ytdl-org/youtube-dl#installation) is installed and in your PATH.
To install this package run
```bash
$ go get -u github.com/timolinn/joncalhoun-dl
```
### To build from source run
```bash
$ git clone [email protected]:timolinn/joncalhoun-dl.git
$ cd joncalhoun-dl
$ go build .
```
## How to use
If you installed via `go get`, you can simply run
```bash
$ joncalhoun-dl [email protected] -password=12345 -course=gophercises -output=your-chosen-directory
[joncalhoun-dl]: fetching video urls for gophercises
[joncalhoun-dl]: fetching data from https://courses.calhoun.io/courses/cor_gophercises...
```
If you built from source, the compiled binary should be in the current folder.
```bash
$ ./joncalhoun-dl [email protected] -password=12345 -course=gophercises -output=your-chosen-directory
[joncalhoun-dl]: fetching video urls for gophercises
[joncalhoun-dl]: fetching data from https://courses.calhoun.io/courses/cor_gophercises...
```
Also note, video downloads **resumes** from where it stopped, so should you experience network interruption nothing to worry about just make sure the output directory remains the same.
### Command [OPTIONS]
+ `--email` [required] : Your account email address. Sign up [here](https://courses.calhoun.io/signup?)
+ `--password` [required]: Your account password. _Unlike the unix password prompt, this will not hide your password by default, you'll have to keep an eye over your shoulder 😉_
+ `--course` [gophercises | algorithmswithgo | testwithgo | webdevwithgo]: This is the name of the course you want to download. **defaults** to `"gophercises"`
+ `--output` [optional]: This is the output directory, which means where you want the videos to be saved. It must be an absolute path. If this is not specified, we will try to create a `"/[course] folder"` (ie. the specified course name eg. `gophercises`) within your current working directory.
+ `--cache` [optional]: Specify your desired location where the cache will be saved. joncalhoun-dl uses the cached data to resume downloads incase of an interruption. It also prevents unecessary repeated calls to the remote server. This will **default** to a `joncalhoun-dl-cache` folder within the output directoy.
+ `--help` [optional]: Prints usage options
### Supported courses
+ [x] Gophercises - [gophercises](https://gophercises.com)
+ [x] Algorithms with Go - [algorithmswithgo](https://algorithmswithgo.com)
+ [x] Testing with Go - [testwithgo](https://testwithgo.com/)
+ [x] Web development with Go - [webdevwithgo](https://www.usegolang.com/)
### Contributing
There is still a couple features to implement, check the TODO list below.
+ Start by forking this repo
+ Create your branch
+ Implement your fixes, changes etc.
+ Open a Pull Request
### Issues
If you find a bug please create an [issue](https://github.com/timolinn/joncalhoun-dl/issues/new)
### Tests
To run existing tests
```bash
$ go test
```
## TODO
+ [x] Add caching for requests
+ [x] Add default output directory
+ [x] Add output directoy flag
+ [x] provide packaged release
+ [ ] Add more unit tests
+ [ ] check for authentication error
+ [ ] prevent signin when using cache
+ [ ] choose video quality
+ [ ] reduce cache size by storing fewer data
### Authors
+ Timothy Onyiuke - _([github](https://github.com/timolinn), [twitter](https://twitter.com/timolinn_))_
+ Damilare Lana - _([github](https://github.com/damilarelana))_
If you find this repository to be of any help, please consider giving it Star! 🔥