Manual · Viska för Mac · v1.0

Manual.

Allt du behöver veta — installation, gester, modeller, inställningar, sekretess.

Installation

Drag in den. Klart.

  1. Ladda hem Viska.dmg från denna sida (eller från GitHub Releases).
  2. Öppna DMG-filen. Dra Viska-ikonen till Applications-mappen.
  3. Starta Viska från Applications eller via Spotlight.
  4. Första gången: bevilja behörigheter i dialogen som visas. Viska behöver hjälpmedel, mikrofon, och (om du vill använda ⇧-läget) påminnelser.
  5. Första körningen laddar också hem KB Whisper Small (cirka 460 MB). Sen är allt offline.

Systemkrav

macOS 13 (Ventura) eller senare. Apple Silicon-Mac (M1, M2, M3, M4). Viska kör inte på Intel-Mac eftersom MLX kräver Apple Silicon.

Gester

Två sätt att tala.

Viska bor i menyfältet som en liten våg-ikon. Du behöver inte öppna något fönster — gesterna fungerar var du än är på din Mac.

Vanlig diktering

Håll ⌥ Höger (höger Option-tangent). Tala. Släpp tangenten. Texten transkriberas och klistras in där markören står.

Det fungerar i vilket textfält som helst — Mail, Meddelanden, Anteckningar, Pages, ChatGPT, terminalen, allt.

Påminnelse

Håll ⇧ + ⌥ Höger samtidigt. Tala. Släpp. Viska skapar en påminnelse i Påminnelser.app med titel och tid baserat på vad du sa.

Byta hotkey

I Inställningar kan du byta från höger Option till vänster Option eller någon av Control-tangenterna. Påminnelse-gesten är alltid ⇧ + den valda hotkeyn.

Datum & tid

Säg det naturligt.

I ⇧-läget parsar Viska din röst och sätter rätt tid på påminnelsen. Den förstår både svenska och engelska och hanterar saker som "kl fyra", "halv åtta", "om två timmar" och "i kväll" — du behöver inte uttala siffror.

Exempel

— i"ring mamma imorgon kl fyra"→imorgon · 16:00
— ii"boka tandläkare om två timmar"→+2 timmar
— iii"köp mjölk i kväll"→ikväll · 20:00
— iv"halv åtta imorgon"→imorgon · 07:30
— v"kvart över fem på fredag"→fredag · 17:15
— vi"lunch med Sara på fredag"→fredag · 12:00
— vii"väck mig kl sex"→imorgon · 06:00
— viii"remind me to call dad tomorrow at four"→tomorrow · 16:00

PM som default

Säger du bara "kl fyra" eller "kl sex" antar Viska att du menar eftermiddagen, alltså 16:00 eller 18:00. Säger du "kl fyra på morgonen" eller "väck mig kl sex" tolkas det som morgon. Tidpunkter 7–12 lämnas som de är.

Om tiden redan har passerat idag rullas datumet automatiskt till imorgon.

Inställningar

Justera varsamt.

Klicka på Viska-ikonen i menyfältet och välj Inställningar…

Språksvenska eller engelska
Auto-detekteras från ditt system. Påverkar transkriberingen — Viska tolkar bara det språk du valt.
Modelltre val
Vilken Whisper-modell som används. Mer om detta i § V nedan.
Hotkeyfyra val
Höger Option, vänster Option, höger Control eller vänster Control. Default är höger Option.
Mikrofonauto-detekteras
Viska väljer din standardmikrofon automatiskt. Byter du mikrofon (t.ex. kopplar in headset) byter Viska över utan att du gör något. Knappen Kalibrera mäter omgivande ljudnivå om Viska har svårt att höra dig.
Ordlistaförbättra igenkänning
Ord och namn som Viska ofta hör fel kan läggas till. En per rad eller kommaseparerat. Bra för ovanliga namn, branschtermer, varumärken.
Återställ urklippstandardvärde: på
När Viska klistrar in text använder den klippbordet kort. Med inställningen på återställs ditt tidigare klippbordsinnehåll efteråt.
Ljudfeedbackstandardvärde: av
Spelar ett kort ljud när inspelning börjar och slutar.
Visa senastestandardvärde: på
De tio senaste transkriberingarna visas i menyn. Klicka på en för att kopiera den igen.
Logga till filstandardvärde: på
Skriver händelser till ~/Library/Logs/Viska.log. Bra för felrapporter. Stäng av om du vill ha noll spår.
Modeller

Tre val.

Viska levereras utan modell — den laddas hem från Hugging Face första gången du väljer en. Sen är den cachad lokalt i ~/.cache/huggingface/ och behöver inget nät.

Du kan byta modell när som helst i Inställningar. Den nya modellen laddas hem om den inte redan finns, sen är den redo direkt utan omstart.

KB Smalldefault · ca 460 MB
KB Whisper Small från Kungliga Biblioteket, MLX-konverterad. Optimerad för svenska. Snabb (cirka 0.5 sek per chunk på M1). Bra default för de flesta — utmärkt på svenska, hyfsad på engelska.
KB Largeca 1.5 GB
KB Whisper Large. Bästa möjliga kvaliteten på svenska. Något långsammare (cirka 2 sek per chunk på M1). Välj denna om du dikterar längre texter eller känsliga sammanhang där varje ord ska bli rätt.
Turboca 810 MB
Whisper Large v3 Turbo (mlx-community). Bäst för engelska och andra språk än svenska. Använd om du främst dikterar på engelska eller om du inte har svenska som systemspråk.

Var modellen ligger

Alla modeller ligger i ~/.cache/huggingface/hub/. Du kan trygt radera mappar där om du vill frigöra utrymme — Viska laddar bara hem igen vid behov.

Behörigheter

Tre frågor från macOS.

Beviljas via Systeminställningar → Integritet och säkerhet. Dialog visas första gången Viska behöver respektive behörighet.

Hjälpmedelobligatorisk
Behövs för att läsa hotkey-tangenten och simulera Cmd+V för inklistring. Utan denna fungerar Viska inte alls.
Mikrofonobligatorisk
Behövs för transkriberingen. Aktiv bara medan du håller hotkey-tangenten — Viska lyssnar inte annars.
Påminnelservalfri
Bara om du använder ⇧-läget. Viska frågar första gången du försöker skapa en påminnelse. Beviljar du inte fungerar vanlig diktering ändå.
Sekretess

Allt stannar hos dig.

Viska gör transkriberingen lokalt på din Mac med Apples MLX-ramverk. Inget ljud, ingen text och inget metadata lämnar din maskin. Du kan koppla från nätet och Viska fungerar fortfarande.

Viska har inga konton, inga analytics, ingen telemetri, ingen "call home"-anrop, inga A/B-test, inga error-rapporteringar till oss. Vi har inga servrar du går igenom.

Det enda nätverksanropet sker när du laddar hem en modell första gången — då hämtas filen från Hugging Face. Sen aldrig mer.

Påminnelser

När du skapar en påminnelse via ⇧-läget sker det via Apples EventKit-API direkt till Påminnelser.app, lokalt. Synkar din Apple ID till iCloud sköts av Apple, inte av oss.

Loggar

Om du har logging aktiverat sparas händelser i ~/Library/Logs/Viska.log (tid, modellnamn, ungefärlig längd på transkriberingen). Ingen råtext sparas. Filen rensas automatiskt när den blir större än 256 KB eller äldre än en timme.

Källkod

Läs själv. MIT.

Viska för Mac är open source under MIT-licens. Hela koden finns på GitHub: github.com/leonideang/viska-mac.

Du kan klona repot, bygga själv, läsa koden, ändra som du vill. Vi accepterar inga PR:s just nu, men issues för buggrapporter är välkomna.

Bygga själv

git clone https://github.com/leonideang/viska-mac.git
cd viska-mac
./build-bundle.sh

Kräver uv (brew install uv) och Xcode Command Line Tools. För notariserade builds: sätt SIGN_IDENTITY till din egen Developer ID-cert och kör ./build-notarize.sh efteråt.

Felsökning

Om något klickar.

Hotkeyn gör ingenting

Du har förmodligen inte beviljat Hjälpmedel. Öppna Systeminställningar → Integritet och säkerhet → Hjälpmedel. Hitta Viska i listan och slå på den. Om den inte finns i listan: klicka på Viska-ikonen i menyfältet och välj Inställningar — dialogen för Hjälpmedel ska komma upp då.

Inget händer när jag pratar

Kontrollera att rätt mikrofon är vald i Inställningar → Mikrofon. Klicka på Kalibrera i en tyst miljö för att låta Viska mäta omgivningsljudet på nytt.

Texten klistras inte in

Trolig orsak: Hjälpmedel revokat eller appen behöver omstart efter macOS-uppdatering. Stäng Viska helt (menyfält → Avsluta) och starta igen.

Modellen laddas inte hem

Första nedladdningen kräver nätet. Kontrollera att du har anslutning. Om nedladdningen avbryts kan du rensa ~/.cache/huggingface/hub/models--Leonidng--kb-whisper-small-mlx/ och försöka igen.

Påminnelsen skapas men utan tid

Viska kunde inte tolka tidsuttrycket i din mening. Försök igen med ett tydligare uttryck ("imorgon kl fyra", "om två timmar", "fredag 15:00").

Jag vill rapportera en bugg

Öppna ett issue på GitHub. Bifoga gärna Diagnostik-bunten från Inställningar → Diagnostik → Kopiera (innehåller version, macOS, modellnamn, sista loggrader).