From c6a52a2981e32518eb17ae785f289bf68eb3eb60 Mon Sep 17 00:00:00 2001 From: Gaspard Jankowiak Date: Fri, 5 Jun 2026 12:50:11 +0200 Subject: [PATCH] add installation instructions to README --- README.md | 17 ++++++++++++++--- 1 file changed, 14 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 011848c..1f83a0b 100644 --- a/README.md +++ b/README.md @@ -2,10 +2,21 @@ 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 -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.