Before you start [CIT Research Documentation]

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
{{indexmenu_n>1}}

====== 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>