From c92fe1b633f31028aea23456bf71c6bbdd2545ce Mon Sep 17 00:00:00 2001 From: ActuallyTheOwner Date: Tue, 22 Jul 2025 18:02:17 -0500 Subject: [PATCH 1/2] Fix INSTALL.MD Add Gentoo and Debian to the INSTALL.MD Clarify steps for Linux Mint Minimum windows version is windows 7 from what I can tell, this should be stated for older machines. --- INSTALL.md | 69 ++++++++++++++++++++++++++++++++---------------------- 1 file changed, 41 insertions(+), 28 deletions(-) diff --git a/INSTALL.md b/INSTALL.md index 27fd57bd..ec3fbb20 100644 --- a/INSTALL.md +++ b/INSTALL.md @@ -1,16 +1,14 @@ # Installation -**Note**: For Windows and macOS, installation is not required to use Porymap. You can download the latest release to begin using Porymap immediately. +For installation, Porymap requires tools for Qt 5.14.2 & C++11 or newer. + +**Note**: For Windows 7 or newer, and macOS, installation is not required to use Porymap. You can download the latest release to begin using Porymap immediately. - [Download Porymap for Windows](https://github.com/huderlem/porymap/releases/latest/download/porymap-windows.zip). - [Download Porymap for macOS latest (arm)](https://github.com/huderlem/porymap/releases/latest/download/porymap-macos-latest.zip). - [Download Porymap for macOS 13 (intel)](https://github.com/huderlem/porymap/releases/latest/download/porymap-macos-13.zip). - -For installation, Porymap requires Qt 5.14.2 & C++11. - ## macOS - The easiest way to get Qt is through [homebrew](https://brew.sh/). Once homebrew is installed, run these commands in Terminal: @@ -30,37 +28,52 @@ make ./porymap.app/Contents/MacOS/porymap ``` -## Windows - +## Windows 7+ Install [Qt development tools](https://www.qt.io/download-qt-installer), and use Qt Creator, the official Qt IDE, for development purposes. -## Ubuntu +## Gentoo Linux +You need to install Qt dev tools. You can set version of your Qt packages with flags such as `qt6`. +25.04.2 is porymap's minumum supported dev-util/kdevelop version. +https://wiki.gentoo.org/wiki/Qt + +```bash +sudo emerge dev-util/kdevelop +sudo emerge --depclean +qmake6 +make +./porymap +``` + +## Debian /Linux derivatives (Non Ubuntu exception to Mint) +You need to install Qt6. +Qt 5.14.2 is porymap's minumum supported qt version qt 6 is recomended since Debian Bookworm + +```bash +sudo apt-get install qmake6 +qmake6 +make +./porymap +``` + +## Arch Linux derivatives +You need to install Qt. You can check the version of your Qt packages with `qtdiag` or `qmake --version`. +Qt 5.14.2 is porymap's minumum supported qt version. + +```bash +sudo pacman -S qt6-declarative qt6-charts +qmake +make +./porymap +``` + +## Ubuntu derivatives (Non Mint) You need to install Qt. The minimum supported version is currently Qt 5.14.2. You can check your Qt version -with `qtdiag` or `qmake --version`. +with `qtdiag`. ```bash sudo apt-get install qt6-declarative-dev # if your distro does not have qt6-declarative-dev, try sudo apt-get install qtdeclarative5-dev - -git clone https://github.com/huderlem/porymap -cd porymap - -qmake -make -./porymap -``` - -## Arch Linux - -You need to install Qt. You can check the version of your Qt packages with `qtdiag` or `qmake --version`. - -```bash -sudo pacman -S qt6-declarative qt6-charts - -git clone https://github.com/huderlem/porymap -cd porymap - qmake make ./porymap From d45a1dce00da05d3911fb4de32fd00804f3b0624 Mon Sep 17 00:00:00 2001 From: ActuallyTheOwner Date: Thu, 14 Aug 2025 08:26:32 -0500 Subject: [PATCH 2/2] Simplify things Clarify that windows 10 is needed for qt6 https://doc.qt.io/qt-6/windows.html Source about qt6 being needed for windows https://github.com/huderlem/porymap/pull/759#discussion_r2226324372 I had KDE installed, but at least on latest updates, Ubuntu instructions are very similar, and you need more than qmake6 --- INSTALL.md | 81 +++++++++++++++++++++++++++++++++--------------------- 1 file changed, 50 insertions(+), 31 deletions(-) diff --git a/INSTALL.md b/INSTALL.md index ec3fbb20..bc13f3eb 100644 --- a/INSTALL.md +++ b/INSTALL.md @@ -1,14 +1,16 @@ # Installation -For installation, Porymap requires tools for Qt 5.14.2 & C++11 or newer. - -**Note**: For Windows 7 or newer, and macOS, installation is not required to use Porymap. You can download the latest release to begin using Porymap immediately. +**Note**: For Windows and macOS, installation is not required to use Porymap. You can download the latest release to begin using Porymap immediately. - [Download Porymap for Windows](https://github.com/huderlem/porymap/releases/latest/download/porymap-windows.zip). - [Download Porymap for macOS latest (arm)](https://github.com/huderlem/porymap/releases/latest/download/porymap-macos-latest.zip). - [Download Porymap for macOS 13 (intel)](https://github.com/huderlem/porymap/releases/latest/download/porymap-macos-13.zip). + +For installation, Porymap requires Qt 5.14.2 & C++11. + ## macOS + The easiest way to get Qt is through [homebrew](https://brew.sh/). Once homebrew is installed, run these commands in Terminal: @@ -28,52 +30,69 @@ make ./porymap.app/Contents/MacOS/porymap ``` -## Windows 7+ -Install [Qt development tools](https://www.qt.io/download-qt-installer), and use Qt Creator, the official Qt IDE, for development purposes. +## Windows 10+ + +Install [Qt development tools](https://www.qt.io/download-qt-installer), and use Qt Creator, the official Qt IDE, for development purposes. (for qt6) + +## Debian /Linux derivatives (Non Ubuntu with an exception to Mint) +Although porymap can be made on other platforms with Qt 5.14.2, Debian requires qt6 + +```bash +git clone https://github.com/huderlem/porymap +cd porymap + +apt install qt6-declarative-dev + +qmake6 +make +./porymap +``` ## Gentoo Linux You need to install Qt dev tools. You can set version of your Qt packages with flags such as `qt6`. -25.04.2 is porymap's minumum supported dev-util/kdevelop version. +25.04.2 is porymap's minimum supported dev-util/kdevelop version. https://wiki.gentoo.org/wiki/Qt ```bash -sudo emerge dev-util/kdevelop -sudo emerge --depclean +git clone https://github.com/huderlem/porymap +cd porymap + +emerge dev-util/kdevelop +emerge --depclean + qmake6 make ./porymap ``` -## Debian /Linux derivatives (Non Ubuntu exception to Mint) -You need to install Qt6. -Qt 5.14.2 is porymap's minumum supported qt version qt 6 is recomended since Debian Bookworm - -```bash -sudo apt-get install qmake6 -qmake6 -make -./porymap -``` - -## Arch Linux derivatives -You need to install Qt. You can check the version of your Qt packages with `qtdiag` or `qmake --version`. -Qt 5.14.2 is porymap's minumum supported qt version. - -```bash -sudo pacman -S qt6-declarative qt6-charts -qmake -make -./porymap -``` - ## Ubuntu derivatives (Non Mint) + You need to install Qt. The minimum supported version is currently Qt 5.14.2. You can check your Qt version -with `qtdiag`. +with `qtdiag` or `qmake --version`. ```bash sudo apt-get install qt6-declarative-dev # if your distro does not have qt6-declarative-dev, try sudo apt-get install qtdeclarative5-dev + +git clone https://github.com/huderlem/porymap +cd porymap + +qmake +make +./porymap +``` + +## Arch Linux derivatives + +You need to install Qt. You can check the version of your Qt packages with `qtdiag` or `qmake --version`. + +```bash +sudo pacman -S qt6-declarative qt6-charts + +git clone https://github.com/huderlem/porymap +cd porymap + qmake make ./porymap