Laverna

the goddess of the thieves, helps you steal translation speeches from the G-daddy monopoly.

Installation

Grab Binaries

You can find the binaries through GitHub releases.

Install Via Go

  go install github.com/occamist/laverna@latest

Sample Usage

Basic

Let's create example CSV

speed,voice,text
normal,th,สวัสดีครับ
slower,en,Hello there
slowest,ja,こんにちは~

Running below command will generate audios in the same directory.

  laverna run --file example.csv

Anki

Make sure you have Laverna Anki Addon installed first. Then you can proceed with the below CSV format.

Text,HelperText,TextA,TextB,TextC,TextD
ฉันชอบ{{c1::ฟัง}}เพลง,I like to listen to music,ฟัง,เล่น,ดู,อ่าน
เขา{{c1::เล่น}}ฟุตบอลทุกวัน,He plays football every day,เล่น,ฟัง,ดู,อ่าน
คุณ{{c1::อ่าน}}หนังสือนี้ไหม,Do you read this book,อ่าน,ฟัง,เล่น,ดู

  laverna anki --profile Talha --deck my-thai-deck --voice th --file ./testdata/anki-th-example.csv

Now your new deck is created in Anki with the audio.

Yomitan

Run a local HTTP server that acts as a custom audio source (JSON) for Yomitan. In Yomitan, go to Settings → Audio → Configure Audio Playback Sources → Add, choose type Custom URL (JSON), and set the URL to below if you intend to host locally:

http://localhost:8770?term={term}&reading={reading}&language={language}

Then open a terminal and run below to ensure the server is listening on your machine while you use Yomitan on the browser.

  laverna yomitan
2026/08/08 00:00:00 listening on "localhost:8770"

---

If you wish to not host locally, you can use my own hosting server. This is the only option you have on your phone or on your tablet etc. :)

https://yomitan.occamist.dev/?term={term}&reading={reading}&language={language}

Shell Completions

Output shell completion script for bash, zsh, fish, or Powershell. Source the output to enable completion.

Bash / Zsh

source <(laverna completion bash) or source <(laverna completion zsh)

Fish

laverna completion fish > ~/.config/fish/completions/laverna.fish