Linux Patch - Revision history

Parricc: /* Linux Flatpaks */ completed flatpak runtime list

2024-09-13T04:03:03Z

Linux Flatpaks: completed flatpak runtime list

← Older revision		Revision as of 21:03, 12 September 2024
Line 294:		Line 294:
	===Linux Flatpaks===		===Linux Flatpaks===

			:The following flatpaks use org.freedesktop.Platform 24.08:
			:* com.retro_exo.aria2c
			:*com.retro_exo.dosbox-staging-081-2
			:*com.retro_exo.dosbox-x-08220
			:*com.retro_exo.dosbox-x-20240701
			:*com.retro_exo.gzdoom-4-11-3
			:*com.retro_exo.mcomix
			:*com.retro_exo.scummvm-2-2-0
			:*com.retro_exo.scummvm-2-3-0-git15811-gf97bfb7ce1
	:The following flatpaks use org.freedesktop.Platform 23.08:		:The following flatpaks use org.freedesktop.Platform 23.08:
	~~:* com.retro_exo.wine~~
	~~:* com.retro_exo.mpv~~
	:* com.retro_exo.dosbox-074r3-1		:* com.retro_exo.dosbox-074r3-1
	~~:* com.retro_exo.dosbox-gridc-4-3-1~~
	:* com.retro_exo.dosbox-ece-r4301		:* com.retro_exo.dosbox-ece-r4301
	:* com.retro_exo.dosbox-ece-r4358		:* com.retro_exo.dosbox-ece-r4358
	:* com.retro_exo.dosbox-ece-r4482		:* com.retro_exo.dosbox-ece-r4482
	:The following flatpaks use		:* com.retro_exo.dosbox-gridc-4-3-1
			:* com.retro_exo.mpv
			:*com.retro_exo.wine
			:The following flatpaks use org.gnome.Platform 46:
			:* com.retro_exo.abiword
			:* com.retro_exo.gnumeric
			:The following flatpaks use org.kde.Platform 6.7:
			:* com.retro_exo.falkon
			:* com.retro_exo.okular
	===Linux Update and Patch Files===		===Linux Update and Patch Files===

Parricc: /* util_linux.zip */ add runtime details

2024-09-13T03:46:36Z

util_linux.zip: add runtime details

← Older revision		Revision as of 20:46, 12 September 2024
Line 292:		Line 292:
	: <span style="color: green">'''Note:'''</span> All of the case inconsistency fixes and game specific changes are manually added to the '''regenerate.bash''' script. There is no magic voodoo code to determine what needs to be changed to make each game work correctly.		: <span style="color: green">'''Note:'''</span> All of the case inconsistency fixes and game specific changes are manually added to the '''regenerate.bash''' script. There is no magic voodoo code to determine what needs to be changed to make each game work correctly.

			===Linux Flatpaks===

			:The following flatpaks use org.freedesktop.Platform 23.08:
			:* com.retro_exo.wine
			:* com.retro_exo.mpv
			:* com.retro_exo.dosbox-074r3-1
			:* com.retro_exo.dosbox-gridc-4-3-1
			:* com.retro_exo.dosbox-ece-r4301
			:* com.retro_exo.dosbox-ece-r4358
			:* com.retro_exo.dosbox-ece-r4482
			:The following flatpaks use
	===Linux Update and Patch Files===		===Linux Update and Patch Files===

Parricc: /* Overview */ Add overview references to the lite version, media pack, and GLP.

2024-09-12T23:00:14Z

Overview: Add overview references to the lite version, media pack, and GLP.

← Older revision		Revision as of 16:00, 12 September 2024
Line 3:		Line 3:
	=== Overview ===		=== Overview ===

	The eXoDOS Linux patch is a complete conversion to make all features of eXoDOS work on Linux systems just as they would in Windows. An official Linux frontend, called exogui, is included as part of this conversion. Additionally, the patch is written to ensure that the collection works as expected in dual-boot environments. After the Linux patch is installed, if eXoDOS is updated or games are installed, this will be reflected in both Linux and Windows environments.		The eXoDOS Linux patch is a complete conversion to make all features of eXoDOS work on Linux systems just as they would in Windows, including both the lite and full versions. An official Linux frontend, called exogui, is included as part of this conversion. Additionally, the patch is written to ensure that the collection works as expected in dual-boot environments. After the Linux patch is installed, if eXoDOS is updated or games are installed, this will be reflected in both Linux and Windows environments.

	As it is encouraged to seed the collection, installing the Linux patch will not alter any torrent files. The patch does not change the existing eXoDOS framework, but instead supplements it.		As it is encouraged to seed the collection, installing the Linux patch will not alter any torrent files. The patch does not change the existing eXoDOS framework, but instead supplements it.

	At this time of this writing, the latest eXoDOS Linux Patch is for version 6.4.		At this time of this writing, the latest eXoDOS Linux Patch is for version 6.4.

			An add-on zip is also available as a separate download to add Linux support to the Media Pack.

			<nowiki></nowiki>Note: The German Language Pack has not yet been converted

Parricc: Finished updating document for eXoDOS 6.

2024-09-12T01:29:42Z

Finished updating document for eXoDOS 6.

@@ Line 175: / Line 175: @@
 '''Content/DOS_linux_Magazines.zip''' - Linux supplement for the Media Pack - This contains Linux DOSBox configuration, launcher, and cue files related to magazines and disk magazines (bat, bsh, command, conf, cue).
-====Custom Scripts====
+====Development Scripts====
 :<span style="color: green">'''Note:'''</span> For the rest of this document, files will be described using their locations after installing eXoDOS.
@@ Line 287: / Line 287: @@
 : <span style="color: green">'''Note:'''</span> All of the case inconsistency fixes and game specific changes are manually added to the '''regenerate.bash''' script. There is no magic voodoo code to determine what needs to be changed to make each game work correctly.
-===Note on Updates===
+===Linux Update and Patch Files===
-:<span style="color: red">'''IMPORTANT:'''</span> If preparing a full copy of the eXoDOS Linux patch, any existing eXoDOS update files should be considered before packaging the files for final release. The initial eXoDOS 5 Linux patch included the eXoDOS 5.1 update. For completeness as well as the convenience of anyone installing the Linux patch without an active Internet connection, any new versions of '''exodos5-linux-patch.zip''' should always include the latest updates. At the same time, a cumulative update patch file, '''update_linux.zip''', is also maintained for people that would like to simply update their already installed version of eXoDOS 5. The details of how the update works will be discussed later. However, it should be noted that both the '''exodos5-linux-patch.zip''' file as well as '''update_linux.zip''' should contain the latest versions of everything at their time of release.
+:The Update directory is extracted from '''EXTDOS_linux.zip''' to the '''eXo/Update''' location. It contains the scripts to run the eXoDOS updater as well as subdirectories for updates and patch files. The '''eXo/Update''' directory may initially look something like the following:
+<pre>
-:In the '''exodos5-linux-patch.zip''' file, any cumulative updates for bat, conf, and sh files are merged into the '''Content/!DOSmetadata_linux.zip''' and '''Content/Magazines_linux.zip''' files, overwriting the ones from the eXoDOS 5.0 release. Updates to game archives, on the other hand, are included in the '''eXo/util/update_linux.zip''' file.
+├── changelog.txt
-:<span style="color: red">'''CAUTION:'''</span> The '''update_linux.zip''' file hosted online is for cumulative updates and is different than the '''eXo/util/update_linux.zip''' file contained in the full release of the Linux patch. Any references in this document to the two files can be differentiated by the presence or absence of '''eXo/util/'''.
+:Executing the '''update.command''' script will run an update for eXoDOS. This normally will be done in exogui from the eXoDOS game entry. Both the Windows version of eXoDOS and the Linux patch download the same updates. Updates work identically regardless of the operating system.
 ===Preparing For Manual Conversion===

Parricc: Added more updates for eXoDOS 6.

2024-09-12T00:51:40Z

Added more updates for eXoDOS 6.

Show changes

Parricc: /* Using eXoDOS */ WIP to update for eXoDOS 6

2024-09-11T22:32:41Z

Using eXoDOS: WIP to update for eXoDOS 6

Show changes

Parricc: /* Step 3 - Installing eXoDOS */ Updated to eXoDOS 6.

2024-09-11T21:06:35Z

Step 3 - Installing eXoDOS: Updated to eXoDOS 6.

← Older revision		Revision as of 14:06, 11 September 2024
Line 48:		Line 48:
	: The final step is to run the eXoDOS Setup.		: The final step is to run the eXoDOS Setup.

	:~~To do this through exogui~~, ~~select "~~''eXoDOS Setup''" on the ~~home tab~~. ~~Alternatively~~, you ~~may run '''Setup~~.~~sh'''~~ from ~~a terminal window~~.		:In your file manager, double-click on the '''eXoDOS Setup.command''' file to start the setup, and then follow the on-screen instructions. If you are asked whether you want to execute the file, click yes. If you are using Nautilus or Gnome and are not given this option, right click the file and select Run as Program.
			:
			:The setup file will check for required files and warn you if any are missing. It will also check for files from the Media Pack Add-On.

	:This will unpack the required eXoDOS files, including the LaunchBox assets and the games front end assets/configs to run the collection. In addition, it will extract the Linux game launcher and setup files. It will make the collection work on both Windows and Linux computers ~~and ensure updates work correctly for both operating systems~~.		:This will unpack the required eXoDOS files, including the LaunchBox assets and the games front end assets/configs to run the collection. In addition, it will extract the Linux game launcher and setup files. It will make the collection work on both Windows and Linux computers.

	:Do not extract ~~these~~ files manually. ~~They~~ are location sensitive.		:It is important to run the setup and not extract any files manually. Not only are the files location sensitive, but the setup makes some changes to them.

	:The eXoDOS Setup will give you the opportunity to customize your set. This includes the option to remove Adult games from the exogui and LaunchBox menu. This removes games with sex or nudity from the LaunchBox XML file. This does not remove violent games. Please make use of the ratings category in LaunchBox if you would like to filter the games further.		:The eXoDOS Setup will give you the opportunity to customize your set. This includes the option to remove Adult games from the exogui and LaunchBox menu. This removes games with sex or nudity from the LaunchBox XML file. This does not remove violent games. Please make use of the ratings category in LaunchBox if you would like to filter the games further.

	:You will also be prompted as to if you would like your global defaults to be Fullscreen or Windowed and whether or not you would like to default to Aspect Ratio On or Off~~. If you choose windowed mode, you will have the option between 640x480 or 1280x960~~.		:You will also be prompted as to if you would like your global defaults to be Fullscreen or Windowed and whether or not you would like to default to Aspect Ratio On or Off.

	:Once it is complete, ~~you may either launch the game shell files directly or~~ run exogui to dive right in.		:Once it is complete, run exogui to dive right in.

	:The eXoDOS collection can be run from any directory, as all launch files are designed to use relative paths to each other. ~~Note, however~~, if you choose to add a desktop shortcut to exogui and then later move eXoDOS to a new location, you will need to ~~rerun~~ the ~~setup~~ to update the shortcut~~. Note that the setup gives an option~~ to ~~reconfigure previous installations of eXoDOS rather than running through~~ the ~~entire setup process over again~~.		:<span style="color: green">'''Note:'''</span> The eXoDOS collection can be run from any directory, as all launch files are designed to use relative paths to each other. However, if you choose to add a desktop shortcut to exogui and then later move eXoDOS to a new location, you will need to run the '''eXoDOS Updater''' to update the shortcut to point to the new location. The '''eXoDOS Updater''' will allow you to reconfigure all of the installation options instead of running through the entire setup process again.

	~~====Important Note====~~
	~~:*<span style="color: red">~~'''~~DO NOT RUN'''</span> the main Windows '''Setup.bat~~''' ~~file after installing the Linux patch. It~~ will ~~undo the changes necessary for Linux compatibility.~~
	~~:*Running~~ the ~~'''Setup.sh'''~~ installation ~~on an eXoDOS instance that was previously installed in Windows will clear~~ the ~~Windows installed games playlist in LaunchBox (due to LaunchBox being reinstalled)~~.

	===Using eXoDOS===		===Using eXoDOS===

Parricc: eXoDOS 6 description, and installation process steps 1-2.

2024-09-11T20:41:42Z

eXoDOS 6 description, and installation process steps 1-2.

← Older revision		Revision as of 13:41, 11 September 2024
Line 29:		Line 29:
	:Alternatively, you may open the zip with a utility such as Ark, and drag the files and folders into the root eXoDOS directory.		:Alternatively, you may open the zip with a utility such as Ark, and drag the files and folders into the root eXoDOS directory.
	:The important thing is to ensure the files are extracted into the root directory of the collection, and not into a newly created subdirectory.		:The important thing is to ensure the files are extracted into the root directory of the collection, and not into a newly created subdirectory.
			:If you have also downloaded the eXoDOS Media Pack, ensure it has been downloaded the the same directory as the base eXoDOS collection. Then, download and place the "''DOS_linux_Magazines.zip''" file in the Content directory. Do not unzip this file.
	:After this has been done, proceed to the next step.		:After this has been done, proceed to the next step.

	====Step 2 - Installing Dependencies====		====Step 2 - Installing System Dependencies====

	:The next step is to install the software needed to run the collection. The '''install_dependencies.command''' script will run you through a guided setup to do this.<blockquote><span style="color: green">'''Note:'''</span> If you are using Thunar or XFCE, you will first need to enable running shell files as executables. To do this, open a terminal and run the following command: <code>xfconf-query --channel thunar --property /misc-exec-shell-scripts-by-default --create --type bool --set true</code></blockquote>In your file manager, double-click on '''install_dependencies.command''' to start the dependency installer. If you are asked whether you want to execute the file, click yes.		:The next step is to install the software needed to run the collection. The '''install_dependencies.command''' script will run you through a guided setup to do this.<blockquote><span style="color: green">'''Note:'''</span> If you are using Thunar or XFCE, you will first need to enable running shell files as executables. To do this, open a terminal and run the following command: <code>xfconf-query --channel thunar --property /misc-exec-shell-scripts-by-default --create --type bool --set true</code></blockquote>In your file manager, double-click on '''install_dependencies.command''' to start the dependency installer. If you are asked whether you want to execute the file, click yes.
	:If you are using Nautilus or Gnome and are not given this option to run by double-clicking, right click the file and select Run as Program.<blockquote><span style="color: green">'''Note:'''</span> This step will need to be done on any Linux computer that has not previously ran eXoDOS 6, even if the full setup has already been completed on a portable drive. Also note that the flatpaks are installed at a user level. As such, other users will need to run the dependency installer separately as well. If you update your video drivers, you may also need to follow that up with a flatpak update. Rerunning a dependency installer installation will handle that for you.</blockquote>Upon running the dependency installer, you will be prompted with a guided setup that gives the following options: <br />The "[D]ownload the latest setup" option will only grab the newest version of the eXo Dependency Installer, not eXoDOS itself. This may be useful if there is a problem with the dependency installer or if new flatpaks are needed. If the dependency installer is updated, it should be reran to launch the new version. To proceed with installing the dependencies, choose "[P]roceed with installation" and follow the on-screen ~~instructions~~.		:If you are using Nautilus or Gnome and are not given this option to run by double-clicking, right click the file and select Run as Program.<blockquote><span style="color: green">'''Note:'''</span> This step will need to be done on any Linux computer that has not previously ran eXoDOS 6, even if the full setup has already been completed on a portable drive. Also note that the flatpaks are installed at a user level. As such, other users will need to run the dependency installer separately as well. If you update your video drivers, you may also need to follow that up with a flatpak update. Rerunning a dependency installer installation will handle that for you.</blockquote>Upon running the dependency installer, you will be prompted with a guided setup that gives the following options: <br />The "[D]ownload the latest setup" option will only grab the newest version of the eXo Dependency Installer, not eXoDOS itself. This may be useful if there is a problem with the dependency installer or if new flatpaks are needed. If the dependency installer is updated, it should be reran to launch the new version. To proceed with installing the dependencies, choose "[P]roceed with installation" and follow the on-screen instruction.
	<pre>		<pre>
	[P]roceed with installation		[P]roceed with installation
Line 40:		Line 41:
	[R]emove all installed eXo packages		[R]emove all installed eXo packages
	[A]bort installation		[A]bort installation

	The "[D]ownload the latest setup" option will only grab the newest version of the eXo Dependency Installer, not eXoDOS itself. This may be useful if there is a problem with the dependency installer or if new flatpaks are needed. If the dependency installer is updated, it should be reran to launch the new version.

	~~To proceed with installing the dependencies, choose "[P]roceed with installation" and follow the on-screen instructions.~~
	</pre>		</pre>
	:		:The "''[D]ownload the latest setup''" option will only grab the newest version of the eXo Dependency Installer, not eXoDOS itself. This may be useful if there is a problem with the dependency installer or if new flatpaks are needed. If the dependency installer is updated, it should be reran to launch the new version. To proceed with installing the dependencies, choose "''[P]roceed with installation''" and follow the on-screen instructions.

	:*

	~~:Updates will be periodically released to ensure that compatibility is maintained as newer distributions come out. Simply choose~~ the ~~update menu~~ option to grab the newest version of the ~~setup~~.
	~~:If you would like to request support for your distro to~~ be ~~added, feel free to reach out in~~ the ~~#linux_port_for_nerds channel of our Discord.~~

	~~:When running this setup, you will be given an option to choose between~~ flatpaks ~~and native DOSBox packages. There~~ are ~~some advantages and disadvantages of each.~~

	~~:<u>Flatpaks</u>: Flatpaks have an advantage over native DOSBox packages in that they are more portable~~. If ~~you are using an unsupported distribution~~, ~~they will make~~ it ~~much easier~~ to ~~get~~ the ~~collection working~~. ~~However~~, ~~our tests have shown that some computers (not most) have distorted FluidSynth output in ECE when using flatpaks.~~

	~~:<u>Native Packages</u>: Native packages do not have this issue, but must be regularly maintained~~ and ~~updated as newer distributions come out. Upgrading your version of Linux may break a previously installed native package. We will occasionally release updates to ensure compatibility is maintained~~.

	==== Step 3 - Installing eXoDOS====		==== Step 3 - Installing eXoDOS====

Parricc at 20:15, 11 September 2024

2024-09-11T20:15:20Z

Show changes

Parricc at 22:29, 12 November 2021

2021-11-12T22:29:02Z

← Older revision		Revision as of 15:29, 12 November 2021
Line 352:		Line 352:
	: <span style="color: red">'''IMPORTANT:'''</span> If preparing a full copy of the eXoDOS Linux patch, any existing eXoDOS update files should be considered before packaging the files for final release. The initial eXoDOS 5 Linux patch included the eXoDOS 5.1 update. For completeness as well as the convenience of anyone installing the Linux patch without an active Internet connection, any new versions of '''exodos5-linux-patch.zip''' should always include the latest updates. At the same time, a cumulative update patch file, '''update_linux.zip''', is also maintained for people that would like to simply update their already installed version of eXoDOS 5. The details of how the update works will be discussed later. However, it should be noted that both the '''exodos5-linux-patch.zip''' file as well as '''update_linux.zip''' should contain the latest versions of everything at their time of release.		: <span style="color: red">'''IMPORTANT:'''</span> If preparing a full copy of the eXoDOS Linux patch, any existing eXoDOS update files should be considered before packaging the files for final release. The initial eXoDOS 5 Linux patch included the eXoDOS 5.1 update. For completeness as well as the convenience of anyone installing the Linux patch without an active Internet connection, any new versions of '''exodos5-linux-patch.zip''' should always include the latest updates. At the same time, a cumulative update patch file, '''update_linux.zip''', is also maintained for people that would like to simply update their already installed version of eXoDOS 5. The details of how the update works will be discussed later. However, it should be noted that both the '''exodos5-linux-patch.zip''' file as well as '''update_linux.zip''' should contain the latest versions of everything at their time of release.

	: In the '''exodos5-linux-patch.zip''' file, any cumulative updates for bat, conf, and sh files are merged into the 'Content/!DOSmetadata_linux.zip' and 'Content/Magazines_linux.zip' files, overwriting the ones from the eXoDOS 5.0 release. Updates to game archives, on the other hand, are included in the '''eXo/util/update_linux.zip''' file.		: In the '''exodos5-linux-patch.zip''' file, any cumulative updates for bat, conf, and sh files are merged into the '''Content/!DOSmetadata_linux.zip''' and '''Content/Magazines_linux.zip''' files, overwriting the ones from the eXoDOS 5.0 release. Updates to game archives, on the other hand, are included in the '''eXo/util/update_linux.zip''' file.

	: <span style="color: red">'''CAUTION:'''</span> The '''update_linux.zip''' file hosted online is for cumulative updates and is different than the '''eXo/util/update_linux.zip''' file contained in the full release of the Linux patch. Any references in this document to the two files can be differentiated by the presence or absence of '''eXo/util/'''.		: <span style="color: red">'''CAUTION:'''</span> The '''update_linux.zip''' file hosted online is for cumulative updates and is different than the '''eXo/util/update_linux.zip''' file contained in the full release of the Linux patch. Any references in this document to the two files can be differentiated by the presence or absence of '''eXo/util/'''.