Skip to content

Commit

Permalink
Drop Qt5 references
Browse files Browse the repository at this point in the history
  • Loading branch information
dae committed Dec 9, 2024
1 parent bb51e74 commit 2f8b368
Show file tree
Hide file tree
Showing 6 changed files with 5 additions and 105 deletions.
17 changes: 0 additions & 17 deletions src/platform/linux/display-issues.md
Original file line number Diff line number Diff line change
@@ -1,22 +1,5 @@
## Display Issues on Linux

### Qt5

Hardware acceleration defaults to off. Enabling it in the preferences screen and
restarting Anki may make Anki’s interface more responsive, but some users may
experience missing menubars, blank windows or crashes when it is enabled.
(Blank windows may also be caused by [this problem](./blank-window.md).)

You can adjust the display driver in Anki's Preferences screen. We
recommend you try both settings, and see which one works best for you.

If you're unable to open Anki, you can adjust the driver in a terminal, by
writing either `auto` or `software` into `~/.local/share/Anki2/gldriver`. Please
note that if you’re using nouveau, it is known to be buggy, and it only supports
software mode.

### Qt6

Hardware acceleration defaults to on. If you experience blank screens
or display issues, you can try enabling software rendering using the terminal:

Expand Down
21 changes: 1 addition & 20 deletions src/platform/linux/installing.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,8 +27,7 @@ Anki's build system only supports glibc, so musl-based distros are not currently

To install Anki:

1. Download Anki from <https://apps.ankiweb.net> to your Downloads folder. See the next section
for how to choose between -qt5 and -qt6.
1. Download Anki from <https://apps.ankiweb.net> to your Downloads folder.
2. If zstd is not already installed on your system, you'll need to install it (e.g `sudo apt install zstd`).
3. Open a terminal and run the following commands, replacing the filename as appropriate.

Expand All @@ -43,24 +42,6 @@ On some Linux systems, you may need to use `tar xaf --use-compress-program=unzst
4. You can then start Anki by typing 'anki' and hitting enter. If you encounter
any issues, please see the links on the left.

## Qt5 vs. Qt6

Recent Anki versions come in separate Qt5 and Qt6 variants. The Qt6 version
is recommended for most users.

Advantages of the Qt6 version:

- Compatibility with recent glibc versions (fixes [blank screens on recent distros](./blank-window.md)).
- Better HiDPI support.
- Better Wayland support.
- Various bugfixes, including things like better support for less common languages.
- Security updates. Support for the Qt5 library was discontinued in Nov 2020,
meaning that any security flaws discovered since then will remain unfixed.

Disadvantages of the Qt6 version include:

- Some add-ons currently only work with the Qt5 version.

## Upgrading

If you were running Anki from a .deb/.rpm/etc in the past, please make
Expand Down
22 changes: 1 addition & 21 deletions src/platform/mac/installing.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,31 +10,11 @@ The last Anki release that supported macOS 10.10 to 10.13.3 was [Anki 2.1.35-alt

## Installing

1. Download Anki from <https://apps.ankiweb.net>. See the next section
for how to choose between -qt5 and -qt6.
1. Download Anki from <https://apps.ankiweb.net>.
2. Save the file to your desktop or downloads folder.
3. Open it, and drag Anki to your Applications folder or desktop.
4. Double-click on Anki in the location you placed it.

## Qt5 vs. Qt6

Recent Anki versions come in separate Qt5 and Qt6 variants. The Qt6 version
is recommended for most users.

Advantages of the Qt6 version:

- Native support for recent Apple Silicon Macs (faster, better battery life).
- Various bugfixes, including things like better support for less common languages.
- Security updates. Support for the Qt5 library was discontinued in Nov 2020,
meaning that any security flaws discovered since then will remain unfixed.

Disadvantages of the Qt6 version:

- Tabbed windows (e.g in full screen) are no longer possible.
- Some Mac users have reported that the Intel Qt5 version was faster and
more reliable for them.
- Some add-ons currently only work with the Qt5 version.

## Upgrading

To upgrade, close Anki if it is open, and then follow the steps above. Drag
Expand Down
27 changes: 1 addition & 26 deletions src/platform/windows/display-issues.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,32 +8,7 @@ other options that are faster: _OpenGL_ and _ANGLE_. They are faster, but they
may not work, or may cause display issues such as missing menubars, blank
windows, and so on. Which one works best will depend on your computer.

If and how you can change this display method depends on which Anki version you
are using, more precisely on the version of the used Qt toolkit.

## Qt5

This toolkit is used by all Anki versions prior to 2.1.50.
Here, the display driver can be adjusted via the Tools>Preferences menu. Make sure
you restart Anki after adjusting it.

If you’re unable to get to Anki’s preferences screen, and restarting Anki a few
times does not help, you may need to manually adjust the graphics driver. You
can do this by starting cmd.exe and typing the following:

```bat
echo auto > %APPDATA%\Anki2\gldriver
```

It will not print anything. You can then start Anki again.

The default is `software`; the other two drivers you can try are `angle` and `auto`.

## Qt6

Anki 2.1.50+ is available with the more recent Qt6 toolkit. The new toolkit
defaults to having graphics acceleration enabled. If you run into display issues,
you can try switching to software mode via cmd:
If you run into display issues, you can try switching to software mode via cmd:

```bat
echo software > %APPDATA%\Anki2\gldriver6
Expand Down
21 changes: 1 addition & 20 deletions src/platform/windows/installing.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,32 +16,13 @@ If you're on an old machine, you can obtain old releases from the [releases page

To install Anki:

1. Download Anki from <https://apps.ankiweb.net>. See the next section
for how to choose between -qt5 and -qt6.
1. Download Anki from <https://apps.ankiweb.net>.
2. Save the installer to your desktop or downloads folder.
3. Double-click on the installer to run it. If you see an error
message, please see the [installation issues page](installation-issues.md).
4. Once Anki is installed, double-click on the new star icon on your
desktop to start Anki.

## Qt5 vs. Qt6

Recent Anki versions come in separate Qt5 and Qt6 variants. The Qt6 version is
recommended for most users.

Advantages of the Qt6 version:

- Various bugfixes, including things like better support for less common languages.
- Very large images load faster than the Qt5 version.
- Security updates. Support for the Qt5 library was discontinued in Nov 2020,
meaning that any security flaws discovered since then will remain unfixed.
- Some users experience freezes when using [a custom shortcut key to switch input languages](https://github.com/ankitects/anki/issues/1105)
in Qt5.

Disadvantages of the Qt6 version:

- Some add-ons currently only work with the Qt5 version.

## Upgrading

If upgrading from Anki 2.1.6+, there is no need to uninstall the previous
Expand Down
2 changes: 1 addition & 1 deletion src/platform/windows/startup-issues.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ If you start Anki and it fails to appear, without
any error message, you can try the following:

- Disconnect multiple/external displays.
- Install the [latest Anki version](https://apps.ankiweb.net/) (try both qt6 and qt5).
- Install the [latest Anki version](https://apps.ankiweb.net/).
- Adjust [your decimal separator](https://forums.ankiweb.net/t/windows-update-broke-anki/1822/75), if it is not a period.
- Install the old [2.1.35-alternate build](https://github.com/ankitects/anki/releases/tag/2.1.35) of Anki.

Expand Down

0 comments on commit 2f8b368

Please sign in to comment.