Ankiconnect Android
Ankiconnect Android allows you to utilize the standard Anki mining workflow on Android devices like phones and eReaders.
Create Anki cards using Yomitan on Firefox Browser and add them straight into your Anki deck!
Mine on the go in the same way as you mine on your desktop pc.
Forvo and local audio are now supported!
Ankiconnect Android is a from scratch unofficial reimplementation of the desktop Ankiconnect extension, desktop Forvo Server extension and desktop Local Audio Server for Yomitan.
It reimplements the core APIs used by Yomitan to work with Ankidroid.
Table of Contents
Instructions
Here’s how to set everything up from scratch (if you’ve already got Yomitan working, then skip to step 5):
- Install Firefox Browser
- Install Ankidroid
- Install Ankiconnect Android - Download from the Releases Section or from IzzyOnDroid repo
- Start the Ankiconnect Android app, accept the permissions and hit start service
- Install the Yomitan extension in Firefox Browser
- Configure Yomitan general settings
- Ensure advanced settings is enabled (button at the bottom right corner)
- Dictionaries:
Import 1+ dictionaries by clicking Configure installed and enabled dictionaries and then Import under Dictionaries section (external resources)
- General: It is recommended to lower the value of
Maximum number of results to prevent unnecessary lag. A sane value would be 8
- Configure Yomitan Scanning settings
- Scanning:
Scan delay can feel laggy and so can be set to 0
- Scanning: Navigate to
Scanning → Configure advanced scanning inputs
- Ensure that advanced options within the
Scanning Inputs window is enabled. To do this, scroll to the right, and tap on the three dots.
-
For Yomitan, use the defaults or match your settings to be like this image: (click here)
- Navigate to
Scanning → Support inputs for devices with touch screens
- Ensure that
Touch inputs is checked, and Pointer inputs is NOT checked.
- Scanning: If you are studying Japanese/Chinese and don’t want to popup to appear on any other languages disable
Search text with non-Japanese, Chinese, or Cantonese characters.
- Configure Yomitan Anki settings
- Anki: Toggle
Enable Anki integration on
- Anki: Click on
Configure Anki card format and choose the deck, model and field/values you desire. (For further customization you can write/modify the script under Configure Anki card templates)
- Anki: Ensure
Show Card Tags is set to “Never”
Easier Yomitan setup: If you import settings from a computer, ensure that step 7 and step 8.3 are still followed
Additional Instructions: Forvo Audio
The default audio sources from Yomitan should already work.
However, Forvo can be added as an audio source.
It is recommended that you add this Forvo audio source
because Forvo significantly extends the coverage of audio
compared to the default audio sources from Yomitan.
-
Click on Configure audio playback sources and under the Audio section
-
Click the Add button (top right corner)
-
Select Custom URL (JSON) and copy paste the following into the URL box:
http://localhost:8765/?term={term}&reading={reading}
NOTE: This is NOT the same URL as from your PC, the port is different
By default, the show card button will not work.
The following is a completely optional set of instructions for getting the show card button to work:
-
Install a pre-release (alpha) version of AnkiDroid from their releases page. This cannot be a parallel build.
- As of writing this (2023/01/03), the stable release of AnkiDroid
(i.e. the released version on Google Play) does not support the feature of
opening the card browser window
from another app. Therefore, the first step is to manually download and install
the most recent alpha version of AnkiDroid.
- This carries all the risks of using a pre-release version! Only download it
if you know what you are doing.
-
After installing AnkiDroid, you must allow Ankiconnect Android to open apps in the background.
- Under Ankiconnect Android, tap on the settings gear at the top right corner.
- Tap on the
Access Overlay Permissions option. This should lead you to Android’s settings page.
- Activate the switch for
Ankiconnect Android within this settings page.
From here, you should be able to use the show card button as normal.
Warning:
Make sure you save your note changes if you edit your note! If you do not
save your changes and re-click on the “show card” button from Firefox Browser, you will
lose all your current note changes!
Additional Instructions: Local Audio
The (desktop) local audio server
setup for Yomitan has been ported over to Ankiconnect Android, and can be used similarly.
Again, this is a completely optional setup that does not need to be done.
General information about the setup, including reasons for and against using the setup,
can be found within the above link.
Warning:
This setup takes up about 5gb of space on your Android device! Ensure you have enough space before setting this up.
-
Ensure you have set up the latest version of the desktop local audio server setup.
If you already have the add-on installed, check for updates by navigating to Tools → Add-ons → (select “Local Audio Server for Yomitan”) → Check for Updates.
-
Generate the Android database.
Note:
For Windows users, please temporarily disable Windows defender before doing this step.
It seems like generating the Android database with Windows Defender enabled can slow it
down by a factor of 6, meaning a step that should only take 5 minutes
can easily take over half an hour.
To generate the database, navigate to (Anki) → Tools (top left corner) → Local Audio Server → Generate Android database. Expect this to take a while (at least a few minutes).
Example Image (click here)
This database stores all the audio files into one large file, in order to make file transfer to Android much faster (transferring the folder took about 24 hours, while transferring the large file took less than 3 minutes).
-
Copy the files from desktop to Android.
-
Locate the add-on folder on desktop.
To do this, navigate to Tools → Add-ons → (select “Local Audio Server for Yomitan”) → View Files.
When you are here, navigate to user_files.
-
Locate AnkiConnect Android’s data folder. By default, it is under:
(phone)/Android/data/com.kamwithk.ankiconnectandroid/files/
However, one can verify the location of the folder by going into the settings
(gear at the top right corner), and tapping on Print Local Audio Directory.
The following output specifies that the folder is indeed in the default position:
/storage/emulated/0/Android/data/com.kamwithk.ankiconnectandroid/files/
-
Alternatively locate a different folder. This will require later customisation.
-
After locating the two folders, copy android.db from the desktop’s add-on folder
into Ankiconnect Android’s data folder.
-
If you chose a different folder than the default, additional customisation is necessary on the settings page.
- Locate the
Local Audio Settings section
- If you selected a different storage device such as an external SD card, you may need to update the
Choose Local Audio Storage Device option.
- The first option will always be the internal storage. If you think you have more than one storage device, it may be that android treats it as one, in which case there will only be one option.
- If you selected a different directory such as
Documents, Audio etc, you may need to update the Choose Local Audio Directory setting.
- If you selected a user-owned directory like the aforementioned
Documents, Audio and similar, you may also need to allow Manage All Files permission for Ankiconnect Android.
- The
Manage All Files permission is only necessary for folders outside of the app-owned /Android/data/com.kamwithk.ankiconnectandroid/ directory.
- If you make a mistake you can always reset the settings using
Reset Local Audio settings. This will reset all the local audio settings and revert it to the default.
-
Setup local audio on Firefox Browser’s Yomitan. (Warning: this URL is different than the one on desktop!)
-
Click on Configure audio playback sources and under the Audio section
-
Click the Add button (top right corner)
-
Select Custom URL (JSON) and copy paste the following into the url box (tap the code box, and then tap the button to the right to copy the text to the clipboard):
http://localhost:8765/localaudio/get/?term={term}&reading={reading}
-
Ensure it works.
- You can do the
exact same check
as the desktop local audio server (the last step),
by scanning 読む and checking that all sources appear.
Be sure to play all of the sources to ensure that the audio is properly fetched.
Common Errors and Solutions
First Steps
If you are having issues with anything, such as Yomitan being unable to connect to AnkiDroid, please ensure all these steps are followed before continuing:
- Make sure the latest app release is installed.
- If you imported the settings from the PC, try to use the sanitized version upon import, and manually re-add the handlebars after.
- Double check that your Yomitan settings are correct. In particular, check that the
Configure Anki card format... section, and the audio sources section is correct.
- On rare occasions, settings exported from the computer and imported into your Android device may not work. Instead, try to reset Yomitan’s settings and redo everything from scratch.
- Battery saving/automatic optimisation is turned off for Ankidroid, Ankiconnect Android and optionally (but recommended) Firefox browser.
- You allowed Ankiconnect Android to be running in the background (if this option is available on your device).
Try going through step 5 of the instructions.
In particular, see the step that says
Ensure Scanning Inputs is optimized for mobile (prevents lookups on scrolling).
This usually happens if Enable Content Scanning is switched off.
To fix this, simply switch it on (under Yomitan Settings → General → Enable content scanning).
Note:
If you have this switched off in the first place, it is also very likely that the popup is
showing up at unwanted times, i.e. while scrolling through a page.
To solve this, try going through step 5 of the instructions.
- Check that the
Enable Anki integration setting in Yomitan is indeed enabled, and properly connected.
- Under
Anki → Configure Anki flashcards..., ensure that the Deck and Model at the top right corner
are not highlighted in red. If they are, please select the correct deck and/or model.
- Under
Anki → Configure Anki flashcards..., delete extraneous formats, leaving just one.
- Under
Anki → Show card tags, make sure this is set to Never.
Problem: Duplicate checks aren’t working
To determine that duplicate checks aren’t working:
- Enable duplicate checks in the Yomitan settings (under
Anki → Check for card duplicates),
- Select a word and add a card
- Tap outside of the popup, and re-select the word. Normally, you should not be able to add a card here.
If you are able to add a card (i.e. you see the plus button), then duplicate checks are indeed not working.
Check that your first field name does not include spaces,
and your first field contents do not include quotes (") or spaces.
If either of those are true, the only way to solve it is by using the Alpha version of AnkiDroid, and
enable the new backend
under the advanced settings.
Problem: Forvo audio won’t load
Please make sure that this exact URL under
Additional Instructions: Forvo Audio is used.
This URL is different from the one on PC.
Note:
There is always a chance that Forvo has changed the layout of their website,
which can lead to AnkiConnect Android improperly fetching the audio.
If you suspect this is the case, please create an issue on Github.
Problem: On card add, I get Incorrect flds argument
This happens when you change the fields of a card. For example, if you added a field,
renamed a field, or deleted a field, then this error may pop up.
To fix it, navigate to Yomitan Settings → Anki → Configure Anki card format...,
and update the model fields (i.e. by switching it to a different model and back).
I still have a problem
If you’ve gone through the instructions and are still having trouble, feel free to create an issue here on GitHub or @/dm me on Discord (@KamWithK#0634 on TheMoeWay). Most related discussions happen in the AnkiConnect Android thread.
Limitations
Because Ankiconnect Android is a small project with a limited scope, not all API queries/cases are implemented/considered.
Currently every known essential feature has been added into the app, however some niche edge cases have been ignored.
Some examples:
- Duplicate checks always occur across the full Anki collection instead of whatever deck is selected (no matter what options are selected, assuming this feature is left enabled)
- The show card button will not work on the latest stable release of AnkiDroid. Instead, you must manually install a pre-release version of AnkiDroid for it to work. Please see these instructions for more details on how to make the show card button work.
- When viewing the note, the note cannot be viewed directly within card editor. Instead, the note is shown from the card search screen.
- You are unable to view the note tags on duplicate notes.
Developer Info
For developers who are interested in using the API, please see docs/api.md for a list of all supported API calls.
Contributing
The primary goal of Ankiconnect Android was to support card creation with Yomitan.
Therefore, many API calls are not implemented.
In the spirit of
Anki-Connect itself,
this project operates on a self-serve model.
Feature requests will not be serviced.
If you would like a new API call, make a PR with the following criteria:
- Ensure that your API call matches an existing Anki-Connect action. New actions, or outward modifications to existing actions (i.e. new input parameters) will not be accepted.
- Note: your API call does not have to have the full capability that Anki-Connect provides, so long as
it is documented (see the second point below).
- Add the relevant documentation to docs/api.md, including any edge cases and
important implementation details.
- Attempt to match the code style of the project.
评论