Clippy is a simple web scraper and downloader for NOVA School of Science and Technology's internal e-learning platform, CLIP.
The program scrapes a user's courses for available downloads and syncs them with a local folder.
CLIP's files are organized in subcategories for each academic course like this: Academic year >> Course documents >> Document subcategory >> Files list
Clippy successfully navigates the site in order to scrape it, and compares it to a local folder with a similar structure, keeping it in sync with the server.
Please note that the program is only available in Portuguese while it's still in BETA.
- Cross-platform (tested on MacOS, Arch Linux, Windows AND Android!)
- Extremely fast thanks to its asynchronous execution (allows checking up to 8 courses simultaneously).
- Transfer multiple files (up to 4 files simultaneously).
- Automatic file synchronization between CLIP and the user's folder.
- Support for choosing the academic year you want to download.
- Support for securely saving your credentials using your OS's keyring service.
- Completely private, free, and open-source.
clippy.mov
NOTE: This program is in beta. Star this repository to support the project and be notified of updates!
Python ≥ v3.8 must be installed to build from source.
Termux or a similar terminal emulator needs to be installed on Android devices. (experimental)
Recommended (All platforms): Build and install with uv:
cd <folder-where-clippy-is> && \
uv sync --frozen && \
uv tool install .
This will install Clippy in your user's PATH in a contained environment.
Docker (All platforms): Build and run with Docker:
docker build --build-arg CLIP_USERNAME=<username> -t clippy . && \
docker run --name clippy-container -it clippy
After it is created you can start the container with:
docker start clippy-container && \
docker exec -it clippy-container clippy ...`
Alternative (Windows only): Download clippy.exe from the latest release page and move it to where you want Clippy to save your files, then run it.
Report any bugs here or to ab.sousa@campus.fct[...etc]. You can use the --debug option to generate a debug.log file that you can attach in the email.
Usage: clippy [OPTIONS] COMMAND [ARGS]
Help pages: clippy --help | clippy batch --help | clippy single --help
There are two main modes (commands): batch (default) and single
Downloads all available files for all the user's courses for the year.
clippySaves the files on a CLIP subfolder of the current path.clippy --relogin --path C:\CLIPIgnores saved credentials and saves the files in a CLIP folder inside the C: drive.clippy --no-auto -p ~/CLIPLets the user choose which year they want to download and saves the files in a CLIP subfolder inside the home directory.
All options are, by definition, optional.
--username -u The user's username in CLIP.
--path -p The folder where CLIP files will be stored. Will use current working directory if empty.
--year -y The year to download.
--auto Automatically chooses the latest year available. (on by default)
--relogin Ignores saved login credentials. (off by default)
--version Show program version.
--help Show this message and exit.
Downloads all available files for a single, specified course.
The user does not have to be enrolled to scrape the specified course. This is specially useful to download past files for a different course / year / semester that the user is not enrolled in.
If I enrolled in Análise Matemática I (ID 11504 in CLIP) in 2023/2024 but I want to access the slides and exams for the previous school year (2022/2023), in the first semester, I just type:
clippy single 11504 2023 1
The program will now download all the files for the class for that semester.
All options are, by definition, optional.
--username -u The user's username in CLIP.
--path -p The folder where CLIP files will be stored. Will use current working directory if empty.
--is-trimester -t The course is trimestral.
--is-semester -s The course is semestral (default)
--relogin Ignores saved login credentials. (off by default)
--help Show this message and exit.
The user's credentials are transmitted only to the CLIP servers and can optionally be saved in the local computer for future use. The program also checks the Github releases page for updates. It does not connect to any other third-party servers.
The author does not obtain any information regarding the user or how the program is used, not even for telemetry purposes.
This program is provided "as is" and is strictly intended for private use, limited to its file download functionalities. By using this program, the user agrees to release the author from any liability for damages or consequences arising from misuse, including but not limited to, bugs, server errors, or unauthorized use of functionalities not originally intended.
Clippy was made in 2023 by Afonso Brás Sousa, a (then) first-year computer science and engineering student @ FCT-NOVA.
Licensed under the GPL v3.
CLIP (c) 2023 FCT NOVA - Faculdade de Ciências e Tecnologia, 2829-516 Caparica, Portugal