https://github.com/danielparks/yanki

Build Anki decks from text files containing YouTube URLs
https://github.com/danielparks/yanki

anki anki-deck

Last synced: 1 day ago
JSON representation

Build Anki decks from text files containing YouTube URLs

• Host: GitHub
• URL: https://github.com/danielparks/yanki
• Owner: danielparks
• Created: 2024-11-27T08:06:49.000Z (2 months ago)
• Default Branch: main
• Last Pushed: 2025-01-25T22:31:00.000Z (6 days ago)
• Last Synced: 2025-01-25T23:30:02.229Z (6 days ago)
• Topics: anki, anki-deck
• Language: Python
• Homepage:
• Size: 1.24 MB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 5
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Build Anki decks from text files containing YouTube URLs

```

uv run yanki asl/lesson-01.deck

```

That will produce an `asl/lesson-01.apkg` file.

### Example deck file

```text

title: Lifeprint ASL::Phrases::Lesson 01

overlay_text: Phrase

more: rst:From `Lifeprint `_ ASLU `lesson 1 `_

tags: lesson_01 phrase

audio: strip

https://www.youtube.com/watch?v=FHPszRvL9pg YOU what-NAME?

https://www.youtube.com/watch?v=UyfRF3TeLPs YOUR NAME?

https://www.youtube.com/watch?v=zW8cpOVeKZ4 DEAF YOU?

https://www.youtube.com/watch?v=xqKENRGkOUQ STUDENT YOU?

https://www.youtube.com/watch?v=OYvy_O_hhfw YOU UNDERSTAND THEM?

# You can extend a line by inserting tabs or spaces before any text:

https://www.youtube.com/watch?v=wskcwTX27RU

  INDEX-[that-person] WHO?

  (Who is that person?)

https://www.youtube.com/watch?v=l0nVGVuHHB8 AGAIN, NAME YOU?

# These cards are similar, but distinct:

https://www.youtube.com/watch?v=0Kvv6FpF348 YOUR TEACHER what-NAME?

https://www.youtube.com/watch?v=Th7pOg8YbCU YOUR TEACHER NAME WHAT?

# You can change tags used for future tags at any time:

tags: lesson_01 vocabulary extra

https://www.youtube.com/watch?v=b_qv-0Jbqn0 CLEAN-UP

```

### Note GUIDs

Anki uses the GUID (Globally Unique ID) field to identify notes for update.

Yanki generates GUIDs based on the deck ID (generated from the deck title), the

video URL, the clip of the video (e.g. `@0:01-0:02`), and the direction of the

note (e.g. `<->`).

You can customize how the GUID is generated with the `note_id` configuration:

    # Default:

    note_id: {deck_id} {url} {clip}

    # Use the text that corresponds to the video:

    note_id: {deck_id} {text}

Leaving out `{deck_id}` can be useful if you may need to move notes between

decks later on. The import will not actually move notes from one deck to

another, but it will update them in the other deck, and then you can manually

move them. This is useful if you want to keep your study progress.

If you do leave out `{deck_id}`, you should probably include something else to

make sure the GUID is unique outside of your repository.

    title: Really Cool Cards::subdeck 1

    note_id: Really Cool Cards {url} {clip}