AnkiQuickTags

Tag your Anki cards quickly!

Installation

Download and run the latest AnkiQuickTags.ankiaddon release.

Usage

QuickTags are defined in the tags.json file found inside the add-on's user_files folder:

addons21/AnkiQuickTags
├── src/
└── user_files
    └── tags.json

Configuration

The default tags.json file defines a single QuickTag--Tag-01--along with its shortcut Ctrl+Alt+T.

{
    "tags": [
        {
            "name": "Tag-01",
            "shortcut": "Ctrl+Alt+T"
        }
    ],
    "other-tags": {
        "visible": true,
        "limit": 10
    }
}

Shortcuts are defined by concatenating combinations of Shift, Ctrl, Alt and Meta with a + sign followed by a single letter e.g. Ctrl+Alt+T. Shortcuts are not case-sensitive so ctrl+alt+t and CTRL+ALT+T will bind the same key sequence.

Note that on macOS the key mapping is a bit different:

Ctrl maps to the Command key

Meta maps to the Control key

Context-Menu

While reviewing and editing cards, QuickTags are added to the right-click context-menu. Optionally, an other-tags sub-menu can be enabled which consists of an alphabetical list of existing tags not defined as QuickTags. The number of other-tags can be limited via the add-on's configuration.

┌─────────────────┐
│ Cut             │
│ Copy            │
│ Paste           │
├─────────────────┤
│ ■ Tag-01        │
│ □ Tag-02        │
│ □ Tag-03        ├───────────────┐
│ Other tags... > │ □ Other-Tag-A │
└─────────────────┤ ■ Other-Tag-B │
                  │ ■ Other-Tag-C │
                  └───────────────┘

Example Config

An example config can be found at: tnahs/anki-addon-configs:AnkiQuickTags.

Development

Install the required [python-version]. See the Anki development docs for more information.
```
pyenv install [python-version]
```

Clone this repository.

git clone git@github.com:tnahs/AnkiQuickTags.git

Set [python-version] as the local version:

cd ./AnkiQuickTags
pyenv local [python-version]

Create and enter a virtual environment:

python -m venv .venv
source .venv/bin/activate
pip install --upgrade pip

Install required packages:
```
pip install -r requirements.txt
```
Set development environment variables. See Anki development | Environment Variables for more information.

Required:
```
export ANKI_ADDON_DEVELOPMENT=1
```
Optional:
```
export ANKIDEV=1
export LOGTERM=1
export DISABLE_QT5_COMPAT=1
```
Run Anki from the terminal.
```
anki
```