Main Page
From ankiqpe
Contents |
About AnkiQT Lite
AnkiQT Lite (also known as Anki QPE) is a port of ankiqt (the GUI component of Anki) to the QT Palmtop Environment. It allows Anki to be run on a lower spec device, such as a PDA. AnkiQT Lite uses the same underlying library component (libanki) as the original Anki project.
Targeted devices are Sharp Zaurus hand-helds. As AnkiQT Lite uses an earlier version of Trolltech's QT framework, it may also be run on other devices, in particular those that do not have the version of QT required for Anki (QT4).
Old project requirements (legacy only) are stored here.
Quick-start Instructions
The instructions below assume that you will be installing to the program area.
For instructions on how to install to a CF/SD card, please see here.
- Download and install the pre-requisites (below)
- Download and install the latest version of libanki
- Download and install the latest version of ankiqpe
- anki_qpe_launcher.py --deck=deckname.anki to open the deck. Alternatively, use the `Open' menu item under the `Deck' menu to select a deck file. Once you do this for the first time, the deck will appear in the recent decks list in the Deck menu.
- anki_qpe_launcher.py --deck=deckname.anki --action=sync to sync. You may also use the Deck menu option `Save and Sync'. If you don't specify a deck using --deck=filename.anki, the program will attempt to sync all the recent decks, one by one. Specifying a --retry=num_retries option will force the program to retry the sync in case of failure.
- Keyboard shortcuts: press 'o' to show the answer for the current card being displayed. Press '1' to '4' to answer. Alternatively, use the space bar (or the 'E' key) -- it will show the answer if a new card is being shown, or answer with difficulty of '3' if the answer is being shown. This behaviour is similar to the desktop version of Anki.
Upgrading
If you're upgrading from a previous version, please uninstall the older version of the package you're upgrading first.
If you run into problems, please try this before asking for help:
- Remove ~/.ankiqt-lite. This file contains the saved user preferences, and may not be compatible across versions.
- Check your deck with the desktop version of Anki:
- Copy the deck to your PC
- Make a backup of the deck
- Open the deck in Anki
- Click on "Check database" and "Optimise database" in the "Advanced" menu
- Save the deck
- Copy the deck to your Zaurus
Other Features -- Application Preferences
This details the options available through the Edit/Preferences menu.
- You can select a font for the application and the review area. Lcfont with a point-size greater than 20 generally works well.
- You can customise the GUI by hiding parts of it in order to maximise screen space.
- You can set the username and password to be used when syncing.
Pre-requisites
You need to have the following installed:
- libcrypto
- libsqlite3
- python
- pyqt
- python-sqlite2
- python-simplejson
- python-sqlalchemy
- zlib
- libssl
Binaries for the Zaurus (Sharp distro) are available from the downloads area
ImportError loading _md5 module
If you experience an error reading "ImportError: No module named _md5", try symlinking _md5.so to _hashlib.so in lib-dynload directory of your Python installation.
Daylight Savings Time issues
If you experience issues with incorrect DST adjustments, please see here.
Disk Space
Python and the pre-requisites can take up a considerable amount of disk space. If you're running low on space, consider the following options:
- Install to an SD or CF card, and use the separate launcher utilities provided
- Symlink ~/.anki/backups to some location with ample space. Anki creates backups of your decks each time you touch them, and this can quickly build up to consume space
- Empty your ~/.anki/backups directory from time to time. If you're working on both your Zaurus and a PC, this is fine as the deck files are now compatible across platforms.
Deck Files
If you have a recent build of libsqlite3 (libsqlite3_3.5.6_mixed_endian and above), then you may copy the .anki deck files across from your PC and use them on the Zaurus. This is the recommended option.
If you have an older build of libsqlite3 (libsqlite3_3.5.6 and below), then you need to read these instructions.
