# Interview Review Assistant

An Obsidian desktop plugin that transcribes interview recordings and creates a structured interview-review report.

## Features

- Transcribe supported audio files and video files.
- Review an existing transcript without uploading a media file.
- Generate a structured report with dimension scores, question-by-question feedback, strengths, improvement priorities, and an action plan.
- Save transcripts and reports as Markdown files in the current Obsidian vault.
- Use a license key to check the available review quota.

## Requirements

- Obsidian desktop 1.4.0 or later. Mobile is not supported.
- An active license key issued by the service operator.
- An internet connection. This plugin is not an offline transcription tool.

## Data and Privacy

Before using the plugin, read [PRIVACY.md](PRIVACY.md).

When a review is requested, the selected media file (or transcript), interview metadata, job description, and license key are sent over HTTPS to the configured processing service. The plugin saves generated reports locally in the user's vault. Do not submit information that you are not permitted to share.

## Installation

### From the Obsidian Community Plugins directory

1. Open **Settings** -> **Community plugins** in Obsidian.
2. Search for **Interview Review Assistant**.
3. Install and enable the plugin.
4. Open the plugin settings and enter a license key.

### Manual installation

1. Download `main.js`, `manifest.json`, and `styles.css` from a GitHub release.
2. Place the files in `<vault>/.obsidian/plugins/interview-review/`.
3. Reload Obsidian, enable the plugin, and enter a license key in its settings.

## Usage

1. Select **Review interview recording/video** from the command palette, or select the microphone ribbon icon.
2. Select a supported media file or paste an existing transcript.
3. Provide interview context such as the company, role, interview stage, and optional job description.
4. Start the review. The transcript and report are saved in the configured report folder.

Each completed review consumes one license quota. Transcription and AI analysis are processed through the hosted service; the operator may offer trial or paid quotas separately.

## Supported formats

Audio: MP3, WAV, M4A, AAC, FLAC, and OGG.

Video: MP4, MOV, AVI, MKV, WebM, FLV, and WMV.

## Development

```bash
npm install
npm run build
```

The release artifact must contain the generated `main.js` together with `manifest.json` and `styles.css`. See [RELEASING.md](RELEASING.md) for the release checklist.

## License

This project is licensed under the [MIT License](LICENSE).