Differences

This shows you the differences between two versions of the page.

--- linux_setup [2021/12/26 12:21] – johnsanc
+++ linux_setup [2023/08/19 08:11] – johnsanc
@@ Line 1: / Line 1: @@
-~~NOTOC~~
+====== Setting up RomVault on Linux ======
-====== Setting up ROMVault on Linux ======
+RomVault is designed as a Windows application, but it will run on many Linux distros using mono. The instructions below outline the basic steps to initially setup RomVault on Linux using the Ubuntu distro as an example.
-ROMVault is designed as a Windows application, but it will run on many Linux distros using mono. The instructions below outline the basic steps to initially setup ROMVault on Linux using the Ubuntu distro as an example.
-|**⚠ CAUTION:** \\ There may be Linux and mono specific bugs. Please refer to the [[bugs_known_issues|Bugs / Known Issues]] page for more details. Please join the [[https://discord.gg/fVJQPA8|ROMVault Discord server]] to report any new bugs.|
+<WRAP important>There may be Linux and mono specific bugs. Please refer to the [[https://romvault.convas.io/bugs?tags=Linux|Bugs & Known Issues]] page and filter for the Linux tag for more details. Please join the [[https://discord.gg/fVJQPA8|ROMVault Discord server]] to report any new bugs.</WRAP>
 ===== Install Mono =====
@@ Line 9: / Line 8: @@
 ===== Create a Launcher Shortcut =====
-The ROMVault application is designed to write configuration files and its Cache file to the same directory as the executable. Its important to launch ROMVault using mono from the same directory as the ROMVault executable. You may find it helpful to create a launcher shortcut to do this.
+The RomVault application is designed to write configuration files and its Cache file to the same directory as the executable. Its important to launch RomVault using mono from the same directory as the RomVault executable. You may find it helpful to create a launcher shortcut to do this.
   - Open a text editor
@@ Line 30: / Line 29: @@
   - Right click the file and select **Allow Launching**
-You should now be able to double click the shortcut to launch ROMVault with mono with the correct working directory.
+<WRAP info>RomVault does not come packaged with a separate icon file. You can use your own .png or .ico file for your launcher shortcut image.</WRAP>
-|**ⓘ NOTE:** \\ ROMVault does not come packaged with a separate icon file. You can use your own .png or .ico file for your launcher shortcut image.|
+===== Launch RomVault =====
+You can now Launch RomVault by double clicking your newly created shortcut.
+Alternately, you can launch RomVault via the command line with mono from the RomVault executable directory:
+  - Open the **Terminal** application
+  - Navigate to your RomVault executable directory
+  - Launch with ''mono ./ROMVault3.exe''
+<WRAP tip>If RomVault does not start properly or if certain features like DatVault do not work, then the issue may be related to a WinForms style that is deprecated in mono. If you run into this issue, try setting the following variable when launching the application:
+''$ MONO_WINFORMS_XIM_STYLE=disabled mono ROMVault3.exe''</WRAP>