ReneR97 · Chugeno · Dec 11, 2024 · Dec 11, 2024 · Dec 11, 2024 · Dec 11, 2024
diff --git a/.env.example b/.env.example
@@ -0,0 +1,3 @@
+# Domestika Credentials
+DOMESTIKA_SESSION=your_session_cookie_here
+DOMESTIKA_CREDENTIALS=your_credentials_here 
diff --git a/.gitignore b/.gitignore
@@ -1,133 +1,33 @@
-# Download directory
+# Archivos de configuración y credenciales
+.env
+credentials.js
+node_modules/
+backups/
+
+# Carpetas de proyecto
 domestika_courses/
+logs/
+N_m3u8DL-RE/
 
-# Logs
-logs
+# Archivos de log
 *.log
 npm-debug.log*
 yarn-debug.log*
 yarn-error.log*
 lerna-debug.log*
 .pnpm-debug.log*
 
-# Diagnostic reports (https://nodejs.org/api/report.html)
-report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json
-
-# Runtime data
-pids
-*.pid
-*.seed
-*.pid.lock
-
-# Directory for instrumented libs generated by jscoverage/JSCover
-lib-cov
-
-# Coverage directory used by tools like istanbul
-coverage
-*.lcov
-
-# nyc test coverage
-.nyc_output
-
-# Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)
-.grunt
-
-# Bower dependency directory (https://bower.io/)
-bower_components
-
-# node-waf configuration
-.lock-wscript
-
-# Compiled binary addons (https://nodejs.org/api/addons.html)
-build/Release
-
-# Dependency directories
-node_modules/
-jspm_packages/
-
-# Snowpack dependency directory (https://snowpack.dev/)
-web_modules/
-
-# TypeScript cache
-*.tsbuildinfo
-
-# Optional npm cache directory
-.npm
-
-# Optional eslint cache
-.eslintcache
-
-# Optional stylelint cache
-.stylelintcache
+# Archivos del sistema
+.DS_Store
+Thumbs.db
 
-# Microbundle cache
-.rpt2_cache/
-.rts2_cache_cjs/
-.rts2_cache_es/
-.rts2_cache_umd/
-
-# Optional REPL history
-.node_repl_history
-
-# Output of 'npm pack'
-*.tgz
-
-# Yarn Integrity file
-.yarn-integrity
-
-# dotenv environment variable files
-.env
-.env.development.local
-.env.test.local
-.env.production.local
-.env.local
-
-# parcel-bundler cache (https://parceljs.org/)
-.cache
-.parcel-cache
-
-# Next.js build output
-.next
-out
-
-# Nuxt.js build / generate output
-.nuxt
-dist
-
-# Gatsby files
+# Archivos temporales
+*.tmp
+*.temp
 .cache/
-# Comment in the public line in if your project uses Gatsby and not Next.js
-# https://nextjs.org/blog/next-9-1#public-directory-support
-# public
-
-# vuepress build output
-.vuepress/dist
-
-# vuepress v2.x temp and cache directory
-.temp
-.cache
-
-# Docusaurus cache and generated files
-.docusaurus
-
-# Serverless directories
-.serverless/
-
-# FuseBox cache
-.fusebox/
-
-# DynamoDB Local files
-.dynamodb/
-
-# TernJS port file
-.tern-port
-
-# Stores VSCode versions used for testing VSCode extensions
-.vscode-test
 
-# yarn v2
-.yarn/cache
-.yarn/unplugged
-.yarn/build-state.yml
-.yarn/install-state.gz
-.pnp.*
+# Resto de configuraciones de desarrollo
+.vscode/
+.idea/
+*.sublime-project
+*.sublime-workspace
diff --git a/README.md b/README.md
@@ -1,80 +1,146 @@
-# Node JS Tool to download full courses from Domestika
+# Domestika Course Downloader V2
 
-This script is a simple way to download a full course from Domestika.
+[🇪🇸 Leer en Español](README_ES.md)
 
-> **Warning**
-> You need to own the course you want to download. So you either have to have bought it or got it for "free" with your premium account.
+⚠️ **IMPORTANT NOTICE**: Currently, this version is optimized and tested for macOS only. We are working on Windows compatibility.
 
-## Installation
-
-Once you downloaded the Project, open the "index.js" file.
+This is an enhanced version of the [Original Domestika Course Downloader](https://github.com/ReneR97/domestika-downloader) created by ReneR97.
 
-You will find the following variables:
+New version developed by Chugeno, with code implementation by Claude Sonnet (Anthropic).
 
-```javascript
-  const course_url = "";
-  const subtitle_lang = "en";
-  const machine_os = "";
-  const cookies;
-  const _credentials_ = "";
-```
+⚠️ **IMPORTANT:** This tool only works with courses you have purchased. It cannot and should not be used to download courses you haven't bought. You must be the legitimate owner of the courses you want to download.
 
-The `course_url` is just the full URL of the course you want to download. For example:
+## Support the Project!
 
-https://www.domestika.org/en/courses/3086-creating-animated-stories-with-after-effects/course
+If you find this tool useful, consider supporting its development! Your support helps maintain and improve the project.
 
-IMPORTANT: you have to be on the "content" page. You know you are on the right site when at the end of the URL it says "/course".
+### Buy Me a Coffee
+[![Buy Me A Coffee](https://img.shields.io/badge/Buy%20Me%20A%20Coffee-Support-yellow.svg)](http://buymeacoffee.com/chugeno)
 
-To get the _domestika_session and the \_credentials_ you will need to install a chrome extension called Cookie-Editor.
+### MercadoPago (for Latin American supporters)
+[![MercadoPago](https://img.shields.io/badge/MercadoPago-Support-blue.svg)](https://link.mercadopago.com.ar/eugenioazurmendi)
 
-After you installed the extension, log into domestika and open the extension.
+Your support helps keep this project alive and enables new features! ☕️
 
-In the window popup, look for "\_domestika_session", click to open it and copy the contents of the Value field into the value field under cookies.
+## Features
 
-Then look for the "_credentials_" cookie, copy the value of that into the "_credentials_" variable.
+- ✨ Download multiple courses simultaneously
+- 🔄 Accepts any Domestika URL format:
+  - Specific unit URLs (`/units/...`)
+  - Course main page URLs
+  - Complete URLs (`/course`)
+- 🔐 Automatic credential management:
+  - Secure storage in `.env` file
+  - Interactive cookie request when needed
+  - Credential validation
+- 📝 Support for subtitles in multiple languages:
+  - Spanish
+  - English
+  - Portuguese
+  - French
+  - German
+  - Italian
+  - Subtitles are embedded as tracks in MP4 video
+  - Independent SRT file is generated with the same video name
+- 🚀 Additional features:
+  - Parallel video downloads
+  - Detailed download progress
+  - Smart error handling
+  - Automatic retries with invalid cookies
 
-If you want to change the subtitles that will be downloaded, just put the preferred language into the "subtitle_lang" variable. But make sure the language is avaiable first.
+## Prerequisites
 
-The machine_os is just to specify whether the machine you are on is Windows or MacOS/Linux. If you are on a Windows machine, be sure to set:
-```javascript
-const machine_os = "win";
-```
-Otherwise if you are on MacOS or Linux:
-```javascript
-const machine_os = "mac";
+1. **ffmpeg**:
+```bash
+brew install ffmpeg
 ```
 
-Before you can start it, you have to download N_m3u8DL-RE from here: https://github.com/nilaoda/N_m3u8DL-RE/releases. Get the lastest version binary and place it in the root directory of the folder. To do so, simply scroll down to the 'Assets' section and download the appropriate binary based on your machine. Note there are binaries for Windows (on arm64 and x64 architectures), MacOS (on arm64 and x64 architectures) and Linux (on arm64 and x64 architectures). Download the compressed file that corresponds to your machine and architecture, unzip it, then place the binary in this repo's root folder. 
-
-NOTE: For Windows, the file will be called "N_m3u8DL-RE.exe", while on MacOS and Linux, the file will be called "N_m3u8DL-RE". Do not change these names.
+2. **N_m3u8DL-RE**:
+- Download the latest version from [GitHub](https://github.com/nilaoda/N_m3u8DL-RE/releases)
+- Place it in the project folder
+- Rename it to "N_m3u8DL-RE" (without extension)
+- Make sure it has execution permissions:
+```bash
+chmod +x N_m3u8DL-RE
+```
 
-Also be sure you have ffmpeg installed.
+3. **Node.js and npm**
 
-After you have done that, navigate to the repo, open a terminal and type
+## Installation
 
+1. Clone the repository:
 ```bash
-npm i
+git clone [REPOSITORY_URL]
+cd domestika-downloader
 ```
 
-After that, to start the script type
-
+2. Install dependencies:
 ```bash
-npm run start
+npm install
 ```
 
-NOTE: On MacOS and Linux, depending on your perimssions, you may encounter an error from `N_m3u8DL-RE`:
+## Usage
+
+1. Run the program:
 ```bash
-N_m3u8DL-RE: Permission denied
+npm start
 ```
 
-If this occurs, open a terminal and grant execute permissions for the binary:
-```bash
-chmod +x N_m3u8DL-RE
+2. The program will guide you interactively:
+
+   a. **URL Input**:
+   - You can enter one or multiple URLs separated by spaces
+   - URLs can be from any course page
+   - Valid examples:
+     ```
+     https://www.domestika.org/en/courses/1234-course-name
+     https://www.domestika.org/en/courses/1234-course-name/units/5678-unit
+     https://www.domestika.org/en/courses/1234-course-name/course
+     ```
+
+   b. **Subtitle Selection**:
+   - Choose if you want to download subtitles and in which language
+
+3. **Credential Management**:
+   - On first use or if cookies are invalid, the program will ask you to:
+     1. Open Developer Tools (F12)
+     2. Go to Storage -> Cookies tab
+     3. Copy the cookie values:
+        - `_domestika_session`
+        - `_credentials`
+   - Credentials are automatically saved in `.env`
+
+4. **During Download**:
+   - You'll see the progress of each video
+   - Detailed status messages will be shown
+   - In case of error, you'll be offered to update cookies
+
+## File Structure
+
+Courses are downloaded to the `domestika_courses/` folder with the following structure:
 ```
-This should resolve the issue, and you can re-run the start command.
+domestika_courses/
+└── Course Name/
+    └── Section/
+        ├── Course Name - U1 - 1_Video Name.mp4
+        └── Course Name - U1 - 1_Video Name.srt
+```
+
+## Notes
+
+- This version is optimized for macOS
+- Credentials are stored locally in `.env` (not uploaded to GitHub)
+- If you encounter invalid cookie errors, the program will guide you to update them
+- Videos are downloaded in the best available quality (1920x1080)
+
+## Credits
 
-All the courses will be downloaded in a folder called "domestika_courses/{coursename}/".
+- Original project: [ReneR97](https://github.com/ReneR97/domestika-downloader)
+- New version: Chugeno
+- Code implementation: Claude Sonnet (Anthropic)
 
-## Special Thanks
+## Limitations
 
-Special thanks to [@Cybasaint](https://www.github.com/Cybasaint) for helping with the project and giving me access to his domestika account for testing.
+- Current version is for macOS only
+- Requires a Domestika account with course access
+- Cookies need to be updated periodically