Watch your elopage course on the airplane.
There are still places in this world where you have no internet connection and thus cannot keep on learning all the good stuff you purchased on elopage.
This little helper makes it comfortable to fetch the course contents (videos, PDFs, and other files) of your purchased elopage online course to disk, so that you can load them onto your phone or tablet and study on the airplane.
No. There is no hacking involved. This tool does not give you access to anything you would not otherwise have access to.
What it does is really quite trivial, and you could do it by hand using your browser devtool's network tab. It would just take you longer - and why do it by hand if you can automate the task?
Please be aware that lots of small-scale solo-entrepreneur teachers and coaches make their living by gathering expertise, creating online courses - which takes a considerable amount of effort and time to do! - and offering them for other people to learn from.
Respect their work!
This also means that if you purchased a time-based license, you must delete the offline-cached course contents when your license expires!
No prebuilt binaries are provided. To compile the tool, simply get rustup and cargo by following the instructions at rustup.rs.
Then git clone this repository (or download as .zip file and extract), and run cargo build --release in the project folder. Cargo will make sure to download all dependencies from crates.io, install and compile them; then it will compile the app for you.
The finished executable binary will be found at <project folder>/target/release/elopage-dl on Linux or Mac,
or at <project folder>/target/release/elopage-dl.exe on Windows. (Note that Windows might not work out of the box. Try it and open an Issue if it does not work.)
To offline-cache your elopage course for your offline airplane journey, you will run the executable in your terminal. However, first you must gather some information and your elopage API authorization token.
Open your browser, and on a new tab, open its developer tools (commonly you can use the F12) key. Switch to the Network panel.
Log into elopage and navigate to the course you want to study while offline.
In the address bar, you will find a URL in the form of https://elopage.com/payer/s/<SELLER USERNAME>/courses/<COURSE SLUG>?course_session_id=<SOME NUMBERS>
Copy the numeric course ID which follows ?course_session_id=.
Now, back to your browser's developer tools panel:
In the Network tab, pick one of the requests going out to api.elopage.com.
You can help yourself to find an appropriate request:
- Toggle the
XHRrequest type filter, and / or - Type
api.elopage.cominto the request search box.
After clicking the request in the network requests list, you will see Response Headers and Request Headers. Under Request Headers find Authorization: ey... and copy the entire value starting after the : (thus, starting with ey).
You will need to provide the directory / folder where your offline cache will live. Get the path to that directory.
In this directory, a structure will be created: ./Elopage/<SELLER USERNAME> (<SELLER FULL NAME)/<COURSE NAME>/. Each category and each lesson get their own subfolder.
In your terminal, enter the following, while replacing the <MARKERS> with the information you gathered above:
./target/release/elopage-dl -vv --course-id '<COURSE ID>' --token '<AUTH TOKEN>' --output-dir 'path/to/target/directory'You can replace --course-id by -c, --token by -t and --output-dir by -o.
You can optionally provide --parallel <number> to enable multiple files being offline-cached at the same time, rather than one after the other.
After pressing Enter, you should see a bunch of stuff printed into your terminal, depending on how many -v you pass:
- None to only show errors.
-vto also show warnings.-vvto show info messages. (This is commonly what you want if you are interested in following the download progress.)-vvvto show debug messages. (This is only useful if something is going wrong.)
You can also define the environment variable RUST_LOG=elopage_dl=debug to read debug output produced by the helper while skipping debug output produced by its dependencies, such as the hyper HTTP library.
Look at the output or ignore as you please - the interesting part will happen at your target directory.
You should see the above described folder structure having been created, with course videos and files being downloaded one by one.
Some courses might not use elopage's built-in wistia support, but rather use vimeo embeds. You need yt-dlp to fetch these. If yt-dlp can be invoked on your computer by just typing yt-dlp then you're good. Otherwise, use the --yt-dlp-bin <PATH TO yt-dlp> option to provide a full path.
Not by default - and it's not meant to be. Downloading all files in parallel would be rather trivial, but also a good way to hit the rate limits of either the elopage API or the wistia/vimeo/youtube video source.
However, if you like living on the edge, you can use the --parallel command line option to pass the number of lessons which should be processed at the same time. You can use --parallel 50 to offline-cache videos of 50 lessons in parallel, but you might easily get throttled or rate-limited for doing so.
Note that debug (-vvv or RUST_LOG=elopage_dl=debug) output becomes hard to follow and make sense of when parallel downloading is enabled.
Usage: elopage-dl [OPTIONS] --course-id <COURSE_ID> --token <TOKEN> --output-dir <OUTPUT_DIR>
Options:
-c, --course-id <COURSE_ID> The Course ID [env: COURSE_ID=]
-t, --token <TOKEN> The authorization token [env: AUTH_TOKEN=]
-o, --output-dir <OUTPUT_DIR> Target-dir [env: ELOPAGE_DIR=]
-u, --user-agent <USER_AGENT> User agent (browser signature) [env: USER_AGENT=] [default: "User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:109.0) Gecko/20100101 Firefox/112.0"]
-l, --language <LANGUAGE> Content language tag, such as "fr", "de-CH" or "en-CA" [env: CONTENT_LANGUAGE=] [default: en]
-p, --parallel <PARALLEL> Download files of up to N lessons at the same time [env: PARALLEL_DOWNLOADS=] [default: 1]
-y, --yt-dlp-bin <YT_DLP_BIN> Path to the `yt-dlp` binary - required only if vimeo iframes are used [env: YT_DLP_BIN=] [default: yt-dlp]
-v, --verbose... More output per occurrence
-q, --quiet... Less output per occurrence
-h, --help Print help
-V, --version Print version
[env: <VARIABLE>=] indicates that you can define an environment variable in place of passing a command line option. This can be useful if you are planning to travel the world for a few months and need to fetch more then a single course.
[default: <VALUE>] indicate that no command line option is required if you're fine with using the default value.
This little tool is standing on the shoulders of giants.
- 🦀 The Rust programming language
- 🗼 The Tokio async runtime and ecosystem
- 📺 The downloader for everything except vimeo showcases:
yt-dlp - 🌏 The
reqwestHTTP client and its underlyinghyperHTTP library - 💥
color-eyreand its predecessoranyhowfor ergonomic error handling - 💬 The
clapcommandline argument parsing library - 🍵 Jon Gjengset and his awesome "Crust of Rust" series of videos (You should totally buy his book!)
This little helper has been built to help create a supposedly legal temporary offline cache of your purchased elopage course videos and files, imitating the way a browser would fetch and offline-cache videos while you study the course.
Make sure you hold the copyright of, or another granted license to any material, and tread on safe legal ground according to the country you live in, before you use this.
Respect the work and effort, as well as the copyright of the course sellers. Never steal or share online course contents! You are badly hurting small-scale businesses if you do!