# New online installer/launcher

**URL:** <https://forums.ankiweb.net/t/new-online-installer-launcher/62745>\
**Category:** Beta Testing\
**Created:** [June 16, 2025, 12:48pm UTC](https://forums.ankiweb.net/t/new-online-installer-launcher/62745 "2025-06-16T12:48:45Z")\
**Posts on this page:** 20\
**Page:** 3

<div class="post-metadata">

**Author:** ![sprvlcn](https://avatars.discourse-cdn.com/v4/letter/s/54ee81/32.png) [@sprvlcn](https://forums.ankiweb.net/u/sprvlcn)\
**Post date:** [June 22, 2025, 1:14am UTC](https://forums.ankiweb.net/t/new-online-installer-launcher/62745/42 "2025-06-22T01:14:49Z")

</div>

Switching between versions was described [in dae’s post](https://forums.ankiweb.net/t/new-online-installer-launcher/62745/36) above. You do have to edit the TOML file.

---

<div class="post-metadata">

**Author:** ![sprvlcn](https://avatars.discourse-cdn.com/v4/letter/s/54ee81/32.png) [@sprvlcn](https://forums.ankiweb.net/u/sprvlcn)\
**Post date:** [June 22, 2025, 1:23am UTC](https://forums.ankiweb.net/t/new-online-installer-launcher/62745/43 "2025-06-22T01:23:52Z")

</div>

Using [25.06b5](https://github.com/ankitects/anki/releases/tag/25.06b5) ( `782645d`) on Windows,

- Typing `anki` into the Task Manager search shows nothing.
- Typing `mpv` into the Task Manager search shows “〉Python”, and clicking to expand shows “﹀ Python” with “mpv” displayed on the next line.

---

<div class="post-metadata">

**Author:** ![andrewsanchez](https://sea2.discourse-cdn.com/flex002/user_avatar/forums.ankiweb.net/andrewsanchez/32/10294_2.png) [@andrewsanchez](https://forums.ankiweb.net/u/andrewsanchez)\
**Post date:** [June 22, 2025, 12:25pm UTC](https://forums.ankiweb.net/t/new-online-installer-launcher/62745/44 "2025-06-22T12:25:37Z")

</div>

Here are a couple of add-on errors resulting from assumptions about the version string:

> **ValueError: invalid literal for int() with base 10**
>
> ```auto
> Anki 25.06b5 (782645d9) (ao)
> Python 3.13.5 Qt 6.8.1 PyQt 6.8.0
> Platform: macOS-14.6.1-arm64-arm-64bit-Mach-O
> 
> When loading AnkiConnect:
> Traceback (most recent call last):
> File "/Users/andrewsanchez/Library/Application Support/AnkiProgramFiles/.venv/lib/python3.13/site-packages/aqt/addons.py", line 250, in loadAddons
> __import__ (addon.dir_name)
> ~~~~~~~~~~ ^^^^^^^^^^^^^^^^
> File "/Users/andrewsanchez/Library/Application Support/Anki2/addons21/2055492159/ __init__.py", line 19, in <module>
> anki_version = tuple(int(segment) for segment in aqt.appVersion.split("."))
> File "/Users/andrewsanchez/Library/Application Support/Anki2/addons21/2055492159/ __init__.py", line 19, in <genexpr>
> anki_version = tuple(int(segment) for segment in aqt.appVersion.split("."))
> ~~~^^^^^^^^^
> ValueError: invalid literal for int() with base 10: '06b5'
> 
> When loading The KING of Button Add-ons:
> Traceback (most recent call last):
> File "/Users/andrewsanchez/Library/Application Support/AnkiProgramFiles/.venv/lib/python3.13/site-packages/aqt/addons.py", line 250, in loadAddons
> __import__ (addon.dir_name)
> ~~~~~~~~~~ ^^^^^^^^^^^^^^^^
> File "/Users/andrewsanchez/Library/Application Support/Anki2/addons21/374005964/ __init__.py", line 13, in <module>
> from . import answer_buttons
> File "/Users/andrewsanchez/Library/Application Support/Anki2/addons21/374005964/answer_buttons.py", line 12, in <module>
> from .nmcheck import isnightmode
> File "/Users/andrewsanchez/Library/Application Support/Anki2/addons21/374005964/nmcheck.py", line 5, in <module>
> old_anki = tuple(int(i) for i in anki_version.split(".")) < (2, 1, 20)
> ~~~~~ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> File "/Users/andrewsanchez/Library/Application Support/Anki2/addons21/374005964/nmcheck.py", line 5, in <genexpr>
> old_anki = tuple(int(i) for i in anki_version.split(".")) < (2, 1, 20)
> ~~~^^^
> ValueError: invalid literal for int() with base 10: '06b5'
> 
> ```

I also noticed on MacOS there is no Anki icon in the dock and Python 3.1.13 is apparently being used. Maybe something caused by my local uv installation 🤔 Kinda odd because my gobal system python is `3.12.9`

 ![CleanShot 2025-06-22 at 13.50.19@2x](https://us1.discourse-cdn.com/flex002/uploads/anki2/original/3X/7/0/70d62646b1bac7f79de8f8d1606eb66050914dec.png)

---

<div class="post-metadata">

**Author:** ![dishkun](https://avatars.discourse-cdn.com/v4/letter/d/94ad74/32.png) [@dishkun](https://forums.ankiweb.net/u/dishkun)\
**Post date:** [June 22, 2025, 1:07pm UTC](https://forums.ankiweb.net/t/new-online-installer-launcher/62745/45 "2025-06-22T13:07:38Z")

</div>

same issue

---

<div class="post-metadata">

**Author:** ![dae](https://sea2.discourse-cdn.com/flex002/user_avatar/forums.ankiweb.net/dae/32/65_2.png) [@dae](https://forums.ankiweb.net/u/dae)\
**Post date:** [June 22, 2025, 2:59pm UTC](https://forums.ankiweb.net/t/new-online-installer-launcher/62745/46 "2025-06-22T14:59:48Z")

</div>

I have not had time to address all the issues yet (some will require a new beta), but new launchers are now available to try:

> **[Release packaging-test: Extend launcher to other platforms + more ·...](https://github.com/ankitects/anki/releases/tag/packaging-test)**
>
> Switch to Qt 6.8 for repo default, as 6.7 depends on an older
> libwebp/tiff which is unavailable on newer installs
> Drop tools/mac-x86, as we no longer need to test against Qt 5
> Add flags to cross co...

Use the same debug console command mentioned here after installing it:

> [@New online installer/launcher](https://forums.ankiweb.net/t/new-online-installer-launcher/62745/36):
>
> A new beta has been released: Auto-update If you start Anki, you’ll notice nothing has changed, because update checks do not happen on every run. To simulate what happens after agreeing to an update pop-up, open the [debug console](https://docs.ankiweb.net/misc.html#debug-console) and run the following: from aqt.update import update\_and\_restart as u; u() Or you can remove the pyproject.toml file mentioned below. Switching between versions The standard pyproject.toml that you’ll find in your AnkiProgramFiles folder (see top post) looks like…

Make sure betas are enabled in the menu before you try to update to the latest (which is still 25.06b5).

---

<div class="post-metadata">

**Author:** ![salman](https://avatars.discourse-cdn.com/v4/letter/s/f6c823/32.png) [@salman](https://forums.ankiweb.net/u/salman)\
**Post date:** [June 22, 2025, 3:00pm UTC](https://forums.ankiweb.net/t/new-online-installer-launcher/62745/47 "2025-06-22T15:00:20Z")

</div>

> [@dae](#):
>
> ## Automatic updates
> 
> This build introduces support for automatic updates. When Anki’s ‘update available’ pop-up appears, answering yes to “download it now?” will trigger an automatic upgrade on the next launch. We can’t easily test this during beta testing, but I’ll provide steps to manually trigger it when the next beta is available (likely tomorrow), so you can see how much faster/convenient it is.

Feature request: Allow user to select beta or stable release from a drop down menu next to this option

---

<div class="post-metadata">

**Author:** ![llama](https://avatars.discourse-cdn.com/v4/letter/l/8baadc/32.png) [@llama](https://forums.ankiweb.net/u/llama)\
**Post date:** [June 22, 2025, 3:39pm UTC](https://forums.ankiweb.net/t/new-online-installer-launcher/62745/48 "2025-06-22T15:39:44Z")

</div>

The error message when trying to install the latest anki whlle `Allow betas` is off might be a bit daunting

```auto
1) Latest Anki (just press enter)
2) Choose a version
3) Keep existing version

4) Allow betas: off
5) Quit
> 1

Updating Anki...

Ignoring existing lockfile due to change in pre-release mode: `allow` vs. `if-necessary-or-explicit`
  x No solution found when resolving dependencies for split (python_full_version >= '3.10'):
  `-> Because there is no version of anki==0.1.2 and anki-release==0.1.2 depends on anki==0.1.2, we can conclude that
      anki-release==0.1.2 cannot be used.
      And because only anki-release==0.1.2 is available and your project depends on anki-release, we can conclude that
      your project's requirements are unsatisfiable.

      hint: Pre-releases are available for `anki-release` in the requested range (e.g., 25.6b5), but pre-releases
      weren't enabled (try: `--prerelease=allow`)
Install failed: Failed with code Some(1): C:\Users\User\AppData\Local\Programs\Anki\uv.exe sync --upgrade --managed-python --python 3.13.5

1) Latest Anki (just press enter)
2) Choose a version
3) Keep existing version

4) Allow betas: off
5) Quit

```

---

<div class="post-metadata">

**Author:** ![dae](https://sea2.discourse-cdn.com/flex002/user_avatar/forums.ankiweb.net/dae/32/65_2.png) [@dae](https://forums.ankiweb.net/u/dae)\
**Post date:** [June 22, 2025, 3:42pm UTC](https://forums.ankiweb.net/t/new-online-installer-launcher/62745/49 "2025-06-22T15:42:29Z")

</div>

That won’t happen once the first stable release with this system goes out.

---

<div class="post-metadata">

**Author:** ![vaibhav](https://avatars.discourse-cdn.com/v4/letter/v/c68b51/32.png) [@vaibhav](https://forums.ankiweb.net/u/vaibhav)\
**Post date:** [June 22, 2025, 3:51pm UTC](https://forums.ankiweb.net/t/new-online-installer-launcher/62745/50 "2025-06-22T15:51:29Z")

</div>

This launcher uses the classic Windows Console interface instead of the modern Terminal app even though Terminal is the default on my computer.

 ![image](https://us1.discourse-cdn.com/flex002/uploads/anki2/original/3X/3/e/3ed42f4c6d94424633e4b609158b3bfc58afc473.png)

The previous launcher used the Terminal app.

---

<div class="post-metadata">

**Author:** ![Shigeyuki](https://sea2.discourse-cdn.com/flex002/user_avatar/forums.ankiweb.net/shigeyuki/32/23878_2.png) [@Shigeyuki](https://forums.ankiweb.net/u/Shigeyuki)\
**Post date:** [June 23, 2025, 2:06am UTC](https://forums.ankiweb.net/t/new-online-installer-launcher/62745/51 "2025-06-23T02:06:27Z")

</div>

> [@andrewsanchez](#):
>
> Here are a couple of add-on errors resulting from assumptions about the version string:

This error seems to be caused by the version of Anki returned by `aqt.appVersion` in the pre-release being `25.06b5` instead of numbers. (If future official releases do not include a string like b5 this error may not occur?) If you use pointVersion instead I think it’s probably safe (pointVersion is available from Anki2.1.20+). `from anki.utils import pointVersion`

---

<div class="post-metadata">

**Author:** ![giragira](https://sea2.discourse-cdn.com/flex002/user_avatar/forums.ankiweb.net/giragira/32/29750_2.png) [@giragira](https://forums.ankiweb.net/u/giragira)\
**Post date:** [June 24, 2025, 7:25pm UTC](https://forums.ankiweb.net/t/new-online-installer-launcher/62745/52 "2025-06-24T19:25:21Z")

</div>

One thing I only noticed today, is even though I’m using an M2 Mac and had definitely installed the Apple Silicon binaries before, now apparently after using the launcher it’s all Intel binaries. I had noticed everything being a bit slower to load than before and on a hunch opened Activity Monitor to check.

 ![スクリーンショット 2025-06-24 21.24.23](https://us1.discourse-cdn.com/flex002/uploads/anki2/original/3X/3/d/3daab65a09fb8adcf8977943c36c0e20bf61427b.png)

Sorry if this is intentional for now, then I overlooked something. But if not, this would be nice to have native builds.

---

<div class="post-metadata">

**Author:** ![mbrubeck](https://sea2.discourse-cdn.com/flex002/user_avatar/forums.ankiweb.net/mbrubeck/32/19595_2.png) [@mbrubeck](https://forums.ankiweb.net/u/mbrubeck)\
**Post date:** [June 24, 2025, 8:42pm UTC](https://forums.ankiweb.net/t/new-online-installer-launcher/62745/53 "2025-06-24T20:42:18Z")

</div>

I’m using the new launcher and have Apple Silicon binaries (on an M4 machine).

---

<div class="post-metadata">

**Author:** ![giragira](https://sea2.discourse-cdn.com/flex002/user_avatar/forums.ankiweb.net/giragira/32/29750_2.png) [@giragira](https://forums.ankiweb.net/u/giragira)\
**Post date:** [June 24, 2025, 9:25pm UTC](https://forums.ankiweb.net/t/new-online-installer-launcher/62745/54 "2025-06-24T21:25:20Z")

</div>

Figured out the reason: I had the Terminal.app set to start with Rosetta emulation (you can right click \> “show info” on any app with universal binaries and there’ll be a checkbox beneath the copyright info). Because the new Anki launcher uses that to install itself in macOS, then the whole install also got emulated apparently. I guess it’s my fault, even though I would describe this kind of interaction here as unexpected.

I don’t normally use Terminal.app myself but another terminal emulator, so I didn’t notice this in daily usage of my system.

(Edit: If this happened to you and you want to switch to Apple Silicon, make sure to also remove the python binary and everything located under `.local/share/uv` otherwise it will just install the Intel version again.)

---

<div class="post-metadata">

**Author:** ![tatsumoto](https://sea2.discourse-cdn.com/flex002/user_avatar/forums.ankiweb.net/tatsumoto/32/5411_2.png) [@tatsumoto](https://forums.ankiweb.net/u/tatsumoto)\
**Post date:** [June 25, 2025, 10:48am UTC](https://forums.ankiweb.net/t/new-online-installer-launcher/62745/55 "2025-06-25T10:48:28Z")

</div>

> [@dae](#):
>
> Anki’s dependencies are placed in the following locations:  
> ~/.local/share/AnkiProgramFiles

Is it still possible to use system dependencies (the way `anki` package in the AUR does currently)? I don’t like the idea of storing dependencies in the home folder when they’re already installed in the system.

---

<div class="post-metadata">

**Author:** ![antecrescent](https://avatars.discourse-cdn.com/v4/letter/a/3be4f8/32.png) [@antecrescent](https://forums.ankiweb.net/u/antecrescent)\
**Post date:** [June 26, 2025, 9:45am UTC](https://forums.ankiweb.net/t/new-online-installer-launcher/62745/57 "2025-06-26T09:45:27Z")

</div>

Building the program with `OFFLINE_BUILD=1` and system dependencies still works. With the environment variable set, the build system skips building the launcher though, so you don’t get auto-updates.

---

<div class="post-metadata">

**Author:** ![Anon\_0000](https://avatars.discourse-cdn.com/v4/letter/a/c67d28/32.png) [@Anon\_0000](https://forums.ankiweb.net/u/Anon_0000)\
**Post date:** [June 26, 2025, 3:39pm UTC](https://forums.ankiweb.net/t/new-online-installer-launcher/62745/58 "2025-06-26T15:39:23Z")

</div>

> [@antecrescent](#):
>
> Building the program with `OFFLINE_BUILD=1` and system dependencies still works.

I’m assuming this will be phased out in the future, when the launcher becomes the default.

Though I really wish that this way of building anki (i.e having a complete offline build) will still be possible in the future.

---

<div class="post-metadata">

**Author:** ![dae](https://sea2.discourse-cdn.com/flex002/user_avatar/forums.ankiweb.net/dae/32/65_2.png) [@dae](https://forums.ankiweb.net/u/dae)\
**Post date:** [June 27, 2025, 5:11pm UTC](https://forums.ankiweb.net/t/new-online-installer-launcher/62745/59 "2025-06-27T17:11:24Z")

</div>

New launchers and a new beta are now available: [Anki 25.06 Beta - #117 by dae](https://forums.ankiweb.net/t/anki-25-06-beta/62271/117)

I’ll post a follow-up with replies to various posts either later tonight or tomorrow.

---

<div class="post-metadata">

**Author:** ![dae](https://sea2.discourse-cdn.com/flex002/user_avatar/forums.ankiweb.net/dae/32/65_2.png) [@dae](https://forums.ankiweb.net/u/dae)\
**Post date:** [June 27, 2025, 5:38pm UTC](https://forums.ankiweb.net/t/new-online-installer-launcher/62745/60 "2025-06-27T17:38:05Z")

</div>

> [@vaibhav](#):
>
> > [@dae](#):
> >
> > > [@cjdduarte](#):
> > >
> > > Let me check if I understood this correctly. From version B6 onwards, does Anki now update itself automatically whenever I open it,
> > 
> > The AnkiProgramFiles location is hard-coded, but the user can install the app elsewhere on Windows
> 
> Not a high priority thing, but hardcoded by whom?

(Getting deja vu - apologies if I’m repeating myself here)

We can’t just use the place Anki’s installed, as it may be a read-only location, and it definitely is on macOS & on Linux when installed in a system folder.

> [@cjdduarte](#):
>
> Let me check if I understood this correctly. From version B6 onwards, does Anki now update itself automatically whenever I open it,

From the latest installer/beta, you can use the new option in the tools menu to update to a different release. The old pop-up notifications will also work to update, but they aren’t sent out for every minor update, and certainly not betas.

There are some caveats/surprises. You lose the upgrade/downgrade menu option in older versions, though an add-on could provide that, or you can manually re-run the Windows installer, bump the pyproject.toml mtime, or remove the AnkiProgramFiles folder. And older versions won’t be able to play audio unless mpv is on the path. But this should only be an issue for stable releases made prior to this launcher.

> [@sommerluk](#):
>
> With the new installer package, I cannot launch Anki anymore:
> 
> > Preparing to start Anki…
> > 
> > Using CPython 3.13.5  
> > Creating virtual environment at: .venv  
> > Resolved 64 packages in 12.90s  
> > error: Distribution `anki==25.6b5 @ registry+https://pypi.org/simple` can’t be installed because it doesn’t have a source distribution or wheel for the current platform
> > 
> > hint: You’re on Linux (`manylinux_2_35_x86_64`)

Recent builds require glibc2.36 or later. glibc has no way of targeting older versions, so the glibc you build on is the oldest you can target, and we need a modern-enough one that can also support ARM64 for development.

> [@sommerluk](#):
>
> Will Flathub be able to still deliver up-to-date Anki packages?

> [@Anon\_0000](#):
>
> > [@antecrescent](#):
> >
> > Building the program with `OFFLINE_BUILD=1` and system dependencies still works.
> 
> I’m assuming this will be phased out in the future, when the launcher becomes the default.

The launcher is an additional layer. As I [covered earlier](https://forums.ankiweb.net/t/new-online-installer-launcher/62745/26#p-173243-third-party-packages-3), distros doing 1 or 2 should only require minor changes, and the launcher is optional.

> [@Shigeyuki](#):
>
> This error seems to be caused by the version of Anki returned by `aqt.appVersion` in the pre-release being `25.06b5` instead of numbers.

> [@Anki 25.06 Beta](https://forums.ankiweb.net/t/anki-25-06-beta/62271/79):
>
> Thanks. HyperTTS looks to be vendoring some third-party code that I’m guessing has broken with the switch to Python 3.13 on Windows. @lucw The other ones are caused by the add-ons trying to parse the version number instead of using [Porting tips for Anki 23.10](https://forums.ankiweb.net/t/porting-tips-for-anki-23-10/35916). If they follow recommended practice, it’ll fix the problem. Those errors won’t happen for stable releases - they’re caused by the beta/rc tag being included in the version number now.

---

<div class="post-metadata">

**Author:** ![SyperEblostrel](https://avatars.discourse-cdn.com/v4/letter/s/9de053/32.png) [@SyperEblostrel](https://forums.ankiweb.net/u/SyperEblostrel)\
**Post date:** [June 27, 2025, 8:37pm UTC](https://forums.ankiweb.net/t/new-online-installer-launcher/62745/61 "2025-06-27T20:37:14Z")

</div>

Sorry maybe I missed this, but I have a few q’s:  
Is there (still) any way to run it with system Qt?  
Does this affect building and running from source package in any way?

---

<div class="post-metadata">

**Author:** ![MatejKafka](https://avatars.discourse-cdn.com/v4/letter/m/7ab992/32.png) [@MatejKafka](https://forums.ankiweb.net/u/MatejKafka)\
**Post date:** [June 27, 2025, 10:09pm UTC](https://forums.ankiweb.net/t/new-online-installer-launcher/62745/62 "2025-06-27T22:09:00Z")

</div>

Unfortunately, this installer format is a showstopper for portable installation, such as what Scoop or Pog (my project) are doing.

Both package managers download the installer .exe, but unpack it using 7zip and then run Anki by passing `-b path/to/portable/data/dir`. With launchers, there’s not really any way to unpack them, so I’ll have to drop support for new versions of Anki, and I suspect Scoop will do the same.

If you want to keep the launcher, could you please at least provide a static .zip for each version with everything necessary to run Anki?

[Previous page](https://forums.ankiweb.net/t/new-online-installer-launcher/62745.md?page=2)

[Next page](https://forums.ankiweb.net/t/new-online-installer-launcher/62745.md?page=4)
