Differences

This shows you the differences between two versions of the page.

--- dcc:itsol:whisper:setup [2024/07/31 08:35] – giulio
+++ dcc:itsol:whisper:setup [2026/09/25 10:19] (current) – alba
@@ Line 1: / Line 1: @@
 {{indexmenu_n>1}}
-===== Tool setup and installation =====
-This page is under construction.
+====== Before you start ======
+Whisper runs on Hábrók and reads your recordings from one directory there, writing the transcripts to another. You need:
+  * a Hábrók account;
+  * space in your Hábrók ''%%scratch%%'' directory for the recordings and the results; and
+  * the language spoken in the recording, if you know it.
+===== Get access =====
+**Request an account.** Staff members and PhD students request a P-account. Students request an S-account, which needs approval from their course, thesis, or project supervisor. Both request forms are on the [[https://portal.hb.hpc.rug.nl/public/start.html|Hábrók web portal start page]], and [[:habrok:introduction:policies|Accounts, access and policies]] explains who is eligible. You can skip this step if you already use Hábrók.
+**Log in to the web portal.** Once your account is active, open the [[https://portal.hb.hpc.rug.nl/public/start.html|start page]] and use the Login link in the top right corner. Everything in this guide happens in the portal.
+{{ :dcc:itsol:whisper:login.webm?800x450 |}}
+===== Check your scratch space =====
+The app reads recordings from and writes results to your ''%%scratch%%'' directory. The default quota is 250 GB. ''%%scratch%%'' is not backed up, so keep the results you need somewhere else. See [[:habrok:data_management:storage_areas|Storage areas]] for details.
+===== Create input and output directories =====
+You only need to do this once.
+  - In the web portal, open the ''%%Files%%'' menu and choose your ''%%scratch%%'' directory, which is ''%%/scratch/%%'' followed by your username, for example ''%%/scratch/p123456%%''. The file browser opens.
+  - Click ''%%New Directory%%'', type ''%%whisper%%'', and click ''%%OK%%''.
+  - Click the new ''%%whisper%%'' directory to open it.
+  - Create an ''%%input%%'' and an ''%%output%%'' directory inside it in the same way.
+Your ''%%scratch%%'' directory now contains:
+<code>
+whisper/
+├── input/
+└── output/
+</code>
+Use these lowercase names. The form then proposes the right directories for you, inside the ''%%scratch%%'' directory you opened in step 1. If your recordings live elsewhere, for example in a group ''%%scratch%%'' directory, check the ''%%Folder for input files%%'' and ''%%Folder for output files%%'' fields when you fill in the form; see [[dcc:itsol:whisper:running#input_and_output_directories|Input and Output Directories]].
+Put only the recordings for the current run in ''%%whisper/input%%''. **The app hands every entry in the input directory to Whisper, so any other file makes the job fail**. The job script is the usual cause for this: leave ''%%Script Location%%'' pointing at ''%%whisper/%%'', never at ''%%whisper/input%%'', because the script and the job log would then be treated as recordings.
+{{ :dcc:itsol:whisper:create_dirs.webm?800x450 |}}
+===== Upload recordings =====
+  - In the file browser, open ''%%whisper%%'' and then ''%%input%%''.
+  - Click ''%%Upload%%''.
+  - Drag the audio or video files into the window, or click ''%%browse files%%'' and select them.
+  - Click the green ''%%Upload%%'' button, which shows the number of files, for example ''%%Upload 3 files%%''.
+  - Wait until every upload has finished before you start the job.
+{{ :dcc:itsol:whisper:upload.webm?800x450 |}}
+<WRAP half column>[[dcc:itsol:whisper|← Previous: Whisper Guide]]</WRAP>
+<WRAP half column rightalign>[[dcc:itsol:whisper:running|Next: Run a Whisper Job →]]</WRAP>
+<WRAP clear></WRAP>
-[[dcc:itsol:whisper:scripts| → Move to the next step]]