The Alpheios 3.0 Browser extensions can be installed in the latest versions of the Chrome, Firefox and Safari browsers on the desktop. They cannot be installed in the mobile versions of these browsers and may not work in older versions of them. If you want to use Alpheios on a mobile device, please use the Alpheios Mobile Reader in the latest mobile version of Chrome, Firefox or Safari. Alpheios does not work in Internet Explorer on either the desktop or mobile devices.

Details on minimum supported browser and operating system versions can be found in our System Requirements.

Alpheios can be used on mobile devices via the Alpheios Mobile Reader and on pages which include the Alpheios Embedded Library. The browser extensions do not work on mobile devices because the mobile browsers don't all support browser extensions.

The Alpheios Browser Extensions do work in Google Docs in Chrome and Firefox. They do not currently work in Google Docs in Safari.

If you have a long wordlist and are accessing Alpheios from a new browser over a slow connection, it may take a few minutes to fully download the wordlist into the browser's cache. Once downloaded to the cache, speed issues should be resolved.

The Alpheios wordlists use the "utf-8" character set encoding. You must be sure to specify utf-8 as the character set encoding in whatever program you import the downloaded file into (such as a spreadsheet program).

If you are using Alpheios in multiple browser tabs, the wordlist will be updated across all tabs with every lookup but you will need to refresh the page in order to see the updates immediately.

This could be caused by one of the following:

  • When we export a wordlist for use in a flashcard program, we exclude any words for which we were not able to retrieve short definitions.
  • The download for flashcards is also limited by default to 25 items. This is to guard against performance issues upon download. You can change this default in the Feature Options but we advise not more than 50.

Some text publishers use partial word markup, for example to use Leiden Conventions to indicate editorial decisions, or to emphasize a part of the word with bold or italics. For words which have this partial word markup, Alpheios will not automatically be able to identify the full word when you select it for lookup. It is possible for the publisher of a webpage to indicate to Alpheios that such markup should be ignored. This can be done by adding an extra html attribute to the page markup.

The data-alpheios-word-node attribute can be used to indicate that an element contains a complete word, and the text should be that of the entire node, including the child node text. The default value of default means that the word will be treated to default Alpheios word cleanup behavior, which includes stripping language-specific punctuation (of which the standard Leiden Conventions punctuation marks are included for Latin and Greek). A value of exact can be used to specify that the text contents should be taken exactly as supplied (excluding node markup).

For example:

  • <span data-alpheios-word-node="default"><b>f</b>ero</span> indicates the word should be analyzed as 'fero'
  • <span data-alpheios-word-node="default">f[ero</span> will also be analyzed as 'fero'
  • <span data-alpheios-word-node="exact">f[ero</span> will be analyzed as 'f[ero'

Under some circumstances, it might be possible for the Alpheios popup to be dragged outside the boundaries of the visible page. If you have done this, and double-clicking on the word does not make the popup reappear, then try refreshing your browser page. It should reappear upon the next lookup. If it does not, then go to the Options tab and click Reset All. This will reset all stored settings, including the last known coordinates of the popup. Note that you will have to reconfigure any defaults you have changed after doing so.

In order for the Alpheios extension to be able to work as it does, providing access to language learning resources for the words on any page you choose to read, it has to have the ability to function as a part of the browser. The messages from the browser requesting permission upon installation are alarming-sounding but are fairly normal for browser extensions (and we actually request very limited permissions compared to what is possible). See the Alpheios Privacy Policy for more information.