add installation instructions to README

This commit is contained in:
Gaspard Jankowiak 2026-06-05 12:50:11 +02:00 committed by gapato
commit c6a52a2981

View file

@ -2,10 +2,21 @@
Chrome extension for downloading EPAS applicant files into a ZIP archive, including `applicants.csv` and an offline viewer. Chrome extension for downloading EPAS applicant files into a ZIP archive, including `applicants.csv` and an offline viewer.
## Files ## Installation
- [epas-ripper-0.1.0.crx](./epas-ripper-0.1.0.crx) - packaged extension - open `about:extensions` from Chrome
- turn on Developer mode (Entwicklermodus) if not done already
- there are then 2 options:
- on Linux, [download](./epas-ripper-0.1.0.crx) the `.crx` extension file and drag-and-drop it to the `about:extensions` tab.
- on Windows, [download](https://imsc.uni-graz.at/git/gjankowiak/epas-ripper/archive/chrome.zip) the `.zip` archive of this repository, extract it and above and drag-and-drop it to the `about:extensions` tab.
- Chrome will display security warnings which you need to check and accept.
## Usage ## Usage
Load the extension in Chrome, open an EPAS job procedure page on `personal.uni-graz.at`, and use the **rip** button to create the archive. After installing the extension in Chrome, open an EPAS job procedure page on `personal.uni-graz.at`, and use the **rip** button to create the archive.
The archive will contain:
- one directory per applicant with the corresponding files
- applicants.csv, which contains a table with the details of each applicant
- `index.html` (+ auxiliary files), a static HTML file which can be use to browse the applicants' files. After opening it in a browser, you need to load the ZIP file you just downloaded. For this to work properly, you should _extract_ the `applications[...].zip` file first. Opening `index.html` from the archive directly (like the explorer on Windows) is not going to work.