API Reference

import { GetState } from '../wailsjs/go/main/App';

const state = await GetState();

interface AppState {
  state: 'ready' | 'recording' | 'transcribing' | 'error';
  recordingTime: number;    // Duration in seconds
  lastTranscript: string;   // Most recent transcription
  error: string;            // Error message if state is 'error'
  currentModel: string;     // Active model name
  currentProvider: string;  // 'local' or 'openai'
  modelReady: boolean;      // Whether model is ready
  hotkeyEnabled: boolean;   // Whether hotkey is active
}

import { ToggleRecording } from '../wailsjs/go/main/App';

await ToggleRecording();

import { StartRecording } from '../wailsjs/go/main/App';

await StartRecording();

import { StopRecording } from '../wailsjs/go/main/App';

await StopRecording();

import { CancelRecording } from '../wailsjs/go/main/App';

await CancelRecording();

import { GetHistory } from '../wailsjs/go/main/App';

const history = await GetHistory();

interface HistoryItem {
  id: string;
  text: string;
  timestamp: string;
  duration: number;
  audioPath?: string;
  hasAudio: boolean;
}

import { ClearHistory } from '../wailsjs/go/main/App';

await ClearHistory();

import { CopyHistoryItem } from '../wailsjs/go/main/App';

await CopyHistoryItem(id);

import { DeleteHistoryItem } from '../wailsjs/go/main/App';

await DeleteHistoryItem(id);

import { GetAudioData } from '../wailsjs/go/main/App';

const base64Audio = await GetAudioData(id);

import { ShowInFolder } from '../wailsjs/go/main/App';

await ShowInFolder(id);

import { GetModels } from '../wailsjs/go/main/App';

const models = await GetModels();

interface ModelInfo {
  name: string;        // e.g., "base.en"
  displayName: string; // e.g., "Base (English)"
  size: string;        // e.g., "~150 MB"
  downloaded: boolean;
  englishOnly: boolean;
}

import { SetModel } from '../wailsjs/go/main/App';

await SetModel('base.en');

import { DownloadModel } from '../wailsjs/go/main/App';

await DownloadModel('small.en');

import { IsModelDownloaded } from '../wailsjs/go/main/App';

const downloaded = await IsModelDownloaded('base.en');

import { GetConfig } from '../wailsjs/go/main/App';

const config = await GetConfig();

interface Config {
  provider: string;
  model: string;
  openaiApiKey: string;
  audioInputDevice: string;
  autoPaste: boolean;
  showNotification: boolean;
  recordingHotkey: string;
  soundEnabled: boolean;
}

import { SetProvider } from '../wailsjs/go/main/App';

await SetProvider('local'); // or 'openai'

import { SetOpenAIKey } from '../wailsjs/go/main/App';

await SetOpenAIKey('sk-...');

import { SetAutoPaste } from '../wailsjs/go/main/App';

await SetAutoPaste(true);

import { SetSoundEnabled } from '../wailsjs/go/main/App';

await SetSoundEnabled(true);

import { SetRecordingHotkey } from '../wailsjs/go/main/App';

await SetRecordingHotkey('rightOption');

import { GetRecordingHotkey } from '../wailsjs/go/main/App';

const hotkey = await GetRecordingHotkey();

import { GetAudioInputDevices } from '../wailsjs/go/main/App';

const devices = await GetAudioInputDevices();

interface AudioInputDevice {
  name: string;
  isDefault: boolean;
}

import { SetAudioInputDevice } from '../wailsjs/go/main/App';

await SetAudioInputDevice('MacBook Pro Microphone');

import { GetCurrentAudioInputDevice } from '../wailsjs/go/main/App';

const device = await GetCurrentAudioInputDevice();

import { GetStats } from '../wailsjs/go/main/App';

const stats = await GetStats();

interface UsageStats {
  averageWPM: number;
  wordsThisWeek: number;
  recordingsThisWeek: number;
  timeSavedThisWeek: number;  // minutes
  totalRecordings: number;
  totalWords: number;
}

import { ShowWindow } from '../wailsjs/go/main/App';

await ShowWindow();

import { Hide } from '../wailsjs/go/main/App';

await Hide();

import { Minimize } from '../wailsjs/go/main/App';

await Minimize();

import { Quit } from '../wailsjs/go/main/App';

await Quit();

import { Events } from '@wailsjs/runtime';

Events.On('stateChanged', (state: AppState) => {
  console.log('State changed:', state);
});

Events.On('historyChanged', () => {
  // Refresh history
  const history = await GetHistory();
});

Events.On('downloadProgress', (progress: number) => {
  console.log(`Download: ${progress}%`);
});

Events.On('downloadComplete', (model: string) => {
  console.log(`Downloaded: ${model}`);
});

Events.On('downloadError', (error: string) => {
  console.error('Download failed:', error);
});