Laracasts Downloader

Downloads new lessons and series from laracasts if there are updates. Or the whole catalogue.

Currently looking for maintainers.

Description

Syncs your local folder with the laracasts website, when there are new lessons the app download it for you. If your local folder is empty, all lessons and series will be downloaded!

A .skip file is used to prevent downloading deleted lessons for these with space problems. Thanks to @vinicius73

Just call php makeskips.php before deleting the lessons.

You need an active subscription account to use this script.

Requirements

PHP >= 7.2
php-cURL
php-xml
php-json
Composer
FFmpeg (required if DOWNLOAD_SOURCE=vimeo)

Docker

Installation

Clone this repo to your local machine.
Make a local copy of the .env file:
```
$ cp .env.example .env
```
Update your Laracasts account credentials (EMAIL, PASSWORD) in .env
Decide whether you want to use vimeo or laracasts as DOWNLOAD_SOURCE. By using Laracasts link you are limited to 30 downloads per day and can't customize video quality.
Choose your preferred quality (240p, 360p, 540p, 720p, 1080p, 1440p, 2160p) by changing VIDEO_QUALITY in .env. (will be ignored if DOWNLOAD_SOURCE=laracasts)
The next steps, choose if you want a local installation or a Docker based installation and follow along.

Details About Vimeo

If you using vimeo source, will download 2 files for each episode, a video file and an audio file.

After all download will be done, the project will merge files and will moving to your respective folder.

Using your local machine

Install project dependencies:
```
$ composer install
```
To run a download of all content, run the following command:
```
$ php start.php
```
See downloading specific series or lessons for optional flags.

Using Docker

Build the image:
```
$ docker-compose build
```
Install project dependencies:
```
$ docker-compose run --rm composer
```
Then, run the command of your choice as if we were running it locally, but instead against the docker container:
```
$ docker-compose run --rm laracastdl php ./start.php [empty for all OR provide flags]
```
See downloading specific series or lessons for optional flags.

Also works in the browser, but is better from the cli because of the instant feedback.

Options

Disable Scrapping

The script scraps each Laracasts pages and caches them to memories its latest state and stores them in Downloads/cache.php. If you already make sure this file is updated and do not want to experience impatience of scrapping; you can use --cache-only option.

php start.php --cache-only

Download specific series

You can either use the Series slug (preferred):

$ php start.php -s "series-slug-example"
$ php start.php --series-name "series-slug-example"

Or the Series name (NOT recommended):

$ php start.php -s "Series name example"
$ php start.php --series-name "Series name example"

Download specific episodes

You can provide episode number(s) separated by comma ,:

$ php start.php -s "lesson-slug-example" -e "12,15"
$ php start.php --series-name "series-slug-example" --series-episodes "12,15"

This will only download episodes which you mentioned in -e or --series-episodes flag, it will also ignore already downloaded episodes as usual.

$ php start.php -s "nuxtjs-from-scratch" -e "12,15" -s "laravel-from-scratch" -e "5"

It will download episode 12 and 15 for "nuxtjs-from-scratch" and episode 5 for "laravel-from-scratch" course.

$ php start.php -s "nuxtjs-from-scratch" -e "12,15" -s "laravel-from-scratch"

It will download episode 12 and 15 for "nuxtjs-from-scratch" course and all episodes for "laravel-from-scratch" course.

Troubleshooting

If you have a cURL error 60: SSL certificate problem: self signed certificate in certificate chain or SLL error: cURL error 35 do this:

Download http://curl.haxx.se/ca/cacert.pem
Add curl.cainfo = "PATH_TO/cacert.pem" to your php.ini

And you are done! If using apache you may need to restart it.

License

This library is under the MIT License, see the complete license here

carlosflorencio / laracasts-downloader

readme