User Tools

Site Tools

Trace:
linux_setup

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
linux_setup [2024/07/14 00:52] – johnsanclinux_setup [2025/04/25 15:12] (current) – johnsanc
Line 1: Line 1:
 ====== 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.
  
 <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> <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>
Line 6: Line 6:
 ===== Install Mono ===== ===== Install Mono =====
   * Install the ''**mono-complete**'' package appropriate for your version of your Linux distro.   * Install the ''**mono-complete**'' package appropriate for your version of your Linux distro.
 +    * On Arch and derivatives, the ''**mono**'' package is correct.
  
 ===== Create a Launcher Shortcut ===== ===== Create a Launcher Shortcut =====
Line 34: Line 35:
 You can now Launch RomVault by double clicking your newly created shortcut.  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:+Alternately, you can launch RomVault via the command line with ''mono'' from the RomVault executable directory:
   - Open the **Terminal** application   - Open the **Terminal** application
   - Navigate to your RomVault executable directory   - Navigate to your RomVault executable directory
Line 40: Line 41:
  
 ===== Troubleshooting Missing Text ===== ===== Troubleshooting Missing Text =====
-There are many combinations of Linux distros, Mono versions, and system setups that could cause certain display issues like missing text or images. If there is text missing from certain areas of the application, particularly DatVault, then the most likely root cause font compatibility.+There are many combinations of Linux distros, ''mono'' versions, and system setups that could cause certain display issues like missing text or images. If there is text missing from certain areas of the application, particularly DatVault, then the most likely root cause font compatibility.
  
-If you have missing text after upgrading to the latest stable version of mono, then you can try to globally remap specific fonts that RomVault uses:+If you have missing text after upgrading to the latest stable version of ''mono'', then you can try to globally remap specific fonts that RomVault uses:
   - From console run the commands ''fc-match Arial'' then ''fc-match "Microsoft Sans Serif"'' to check if those fonts are installed.   - From console run the commands ''fc-match Arial'' then ''fc-match "Microsoft Sans Serif"'' to check if those fonts are installed.
   - If the fonts are not installed, then choose suitable fonts you would like to use. For this example we will use "Liberation Sans" for both.   - If the fonts are not installed, then choose suitable fonts you would like to use. For this example we will use "Liberation Sans" for both.
 +  - See the sections below for details about how to remap the fonts.
 +  - **OPTIONAL**: Launch RomVault with ''GTK_DATA_PREFIX= mono ROMVault36.exe'' which will force light mode.
 +  
 +==== Using Font Manager ====
 +  - Install the ''font-manager'' package appropriate for your version of your Linux distro.
 +  - Open ''font-manager'' and click on "Preferences".
 +  - Navigate to "Substitutions" on the left-hand side.
 +  
 +Repeat the following steps for both "Microsoft Sans Serif" and "Arial":
 +  - Press the "+" button at the top and enter the font family name.
 +  - Press the "+" button to the right and enter "Liberation Sans" for the substitute family.
 +  - Ensure that the dropdown next to the substitute family is set to "prefer".
 +
 +==== Manual Remapping ====
   - Modify the file ''/etc/fonts/local.conf'' with the following:  \\ \\ <code>   - Modify the file ''/etc/fonts/local.conf'' with the following:  \\ \\ <code>
 <!DOCTYPE fontconfig SYSTEM "urn:fontconfig:fonts.dtd"> <!DOCTYPE fontconfig SYSTEM "urn:fontconfig:fonts.dtd">
Line 62: Line 77:
 </fontconfig> </fontconfig>
 </code> </code>
-  - Launch RomVault with ''GTK_DATA_PREFIX= mono ROMVault36.exe'' which will force light mode 
  
  
-<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:+<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> ''$ MONO_WINFORMS_XIM_STYLE=disabled mono ROMVault3.exe''</WRAP>
 +
  
linux_setup.txt · Last modified: 2025/04/25 15:12 by johnsanc