goldendict-ng/website/docs/install.md

<a href="https://repology.org/project/goldendict-ng/versions">
    <img src="https://repology.org/badge/vertical-allrepos/goldendict-ng.svg" alt="Packaging status" align="right">
</a>

## Download

GoldenDict-ng is available pre-built for Windows and macOS. It is available in a few Linux/Unix repos and FlatHub.

* [Latest stable version](https://github.com/xiaoyifang/goldendict/releases/latest) 
* [Pre-release test builds](https://github.com/xiaoyifang/goldendict/releases).

Because it is open source, you can always [build it for yourself](howto/build_from_source.md).

## Windows 

Choose either

* `****-installer.exe ` for traditional installer experience
* `****-installer.7z` for simply unzip and run experience

If Qt's version is not changed, you can also download a single `goldendict.exe` and drop it into previous installation's folder (If uncertain, don't do this).

Requires Windows 10 (1809 or later).

## Linux

<a href='https://flathub.org/apps/io.github.xiaoyifang.goldendict_ng'><img width='240' alt='Download on Flathub' src='https://dl.flathub.org/assets/badges/flathub-badge-en.svg'/></a>

* See the right side for available packages in various Linux distros.
* In Debian 12 and Ubuntu 23.04, `goldendict-webengine` is available (For later versions it is `goldendict-ng`).
* For ArchLinux, pre-built binary is available from [archlinuxcn's repo](https://github.com/archlinuxcn/repo/tree/master/archlinuxcn/goldendict-ng-git).
* [Gentoo package from PG_Overlay](https://gitlab.com/Perfect_Gentleman/PG_Overlay/-/tree/master/app-text/goldendict-ng)

Minimum supported "Linux" versions is supposedly the current Ubuntu LTS or Debian's old stable or Qt6.4.

## macOS

Uses one of the `.dmg` installers in the [Download](#download).

Requires at least macOS 13.

## Versioning and Releasing

This project uses Calendar Versioning: `YY.MM.Patch`.

Releases will tentatively be done twice a year, considering factors like the major releases of Qt and the package freeze dates of Linux distros like Ubuntu.
doc: updates * use repology.org to replace manually created linux package list [0] * update debian/ubuntu dependencies (delete outdated fedora one) * update all build doc to qt6 * add cmake flags info * merge all build instructions into one * add more ocr examples * add links and fix dictionary formats info * misc 2023-07-06 02:20:43 +00:00			`<a href="https://repology.org/project/goldendict-ng/versions">`
			`<img src="https://repology.org/badge/vertical-allrepos/goldendict-ng.svg" alt="Packaging status" align="right">`
			`</a>`

feat(website): initial proper website 2023-04-16 00:53:40 +00:00			`## Download`

update docs 2024-10-23 22:49:11 +00:00			`GoldenDict-ng is available pre-built for Windows and macOS. It is available in a few Linux/Unix repos and FlatHub.`
feat(website): initial proper website 2023-04-16 00:53:40 +00:00
doc: codify minimum supported OS / versioning / releasing 2024-06-03 18:33:08 +00:00			`* [Latest stable version](https://github.com/xiaoyifang/goldendict/releases/latest)`
			`* [Pre-release test builds](https://github.com/xiaoyifang/goldendict/releases).`
feat(website): initial proper website 2023-04-16 00:53:40 +00:00
doc: codify minimum supported OS / versioning / releasing 2024-06-03 18:33:08 +00:00			`Because it is open source, you can always [build it for yourself](howto/build_from_source.md).`
doc: updates * use repology.org to replace manually created linux package list [0] * update debian/ubuntu dependencies (delete outdated fedora one) * update all build doc to qt6 * add cmake flags info * merge all build instructions into one * add more ocr examples * add links and fix dictionary formats info * misc 2023-07-06 02:20:43 +00:00
feat(website): initial proper website 2023-04-16 00:53:40 +00:00			`## Windows`

			`Choose either`

			* `****-installer.exe ` for traditional installer experience
update docs 2024-10-23 22:49:11 +00:00			* `****-installer.7z` for simply unzip and run experience
feat(website): initial proper website 2023-04-16 00:53:40 +00:00
doc: codify minimum supported OS / versioning / releasing 2024-06-03 18:33:08 +00:00			If Qt's version is not changed, you can also download a single `goldendict.exe` and drop it into previous installation's folder (If uncertain, don't do this).

			`Requires Windows 10 (1809 or later).`
feat(website): initial proper website 2023-04-16 00:53:40 +00:00
			`## Linux`

add flathub badge to install.md 2023-10-29 09:22:58 +00:00			`<a href='https://flathub.org/apps/io.github.xiaoyifang.goldendict_ng'><img width='240' alt='Download on Flathub' src='https://dl.flathub.org/assets/badges/flathub-badge-en.svg'/></a>`

			`* See the right side for available packages in various Linux distros.`
doc: updates * use repology.org to replace manually created linux package list [0] * update debian/ubuntu dependencies (delete outdated fedora one) * update all build doc to qt6 * add cmake flags info * merge all build instructions into one * add more ocr examples * add links and fix dictionary formats info * misc 2023-07-06 02:20:43 +00:00			* In Debian 12 and Ubuntu 23.04, `goldendict-webengine` is available (For later versions it is `goldendict-ng`).
update docs 2024-10-23 22:49:11 +00:00			`* For ArchLinux, pre-built binary is available from [archlinuxcn's repo](https://github.com/archlinuxcn/repo/tree/master/archlinuxcn/goldendict-ng-git).`
			`* [Gentoo package from PG_Overlay](https://gitlab.com/Perfect_Gentleman/PG_Overlay/-/tree/master/app-text/goldendict-ng)`
feat(website): initial proper website 2023-04-16 00:53:40 +00:00
doc: codify minimum supported OS / versioning / releasing 2024-06-03 18:33:08 +00:00			`Minimum supported "Linux" versions is supposedly the current Ubuntu LTS or Debian's old stable or Qt6.4.`

feat(website): initial proper website 2023-04-16 00:53:40 +00:00			`## macOS`

doc: codify minimum supported OS / versioning / releasing 2024-06-03 18:33:08 +00:00			Uses one of the `.dmg` installers in the [Download](#download).

update docs 2024-10-23 22:49:11 +00:00			`Requires at least macOS 13.`
doc: codify minimum supported OS / versioning / releasing 2024-06-03 18:33:08 +00:00
			`## Versioning and Releasing`

			This project uses Calendar Versioning: `YY.MM.Patch`.

			`Releases will tentatively be done twice a year, considering factors like the major releases of Qt and the package freeze dates of Linux distros like Ubuntu.`